Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Merge branch 'alpha-21' into alpha-21-changelog

pull/669/head
Nora 2019-12-12 13:33:22 -08:00
parent db3007f94a 1c24d1f30f
commit 2d6586d516
33 changed files with 451 additions and 52 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
content/v2.0/get-started.md
View File

@ -27,7 +27,7 @@ This article describes how to get started with InfluxDB OSS. To get started with
### Download and install InfluxDB v2.0 alpha
Download InfluxDB v2.0 alpha for macOS.
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_2.0.0-alpha.20_darwin_amd64.tar.gz" download>InfluxDB v2.0 alpha (macOS)</a>
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_2.0.0-alpha.21_darwin_amd64.tar.gz" download>InfluxDB v2.0 alpha (macOS)</a>
### Unpackage the InfluxDB binaries
To unpackage the downloaded archive, **double click the archive file in Finder**
@ -36,7 +36,7 @@ or run the following command in a macOS command prompt application such
```sh
# Unpackage contents to the current working directory
tar zxvf ~/Downloads/influxdb_2.0.0-alpha.20_darwin_amd64.tar.gz
tar zxvf ~/Downloads/influxdb_2.0.0-alpha.21_darwin_amd64.tar.gz
```
#### (Optional) Place the binaries in your $PATH
@ -45,7 +45,7 @@ prefix the executables with `./` to run then in place.
```sh
# (Optional) Copy the influx and influxd binary to your $PATH
sudo cp influxdb_2.0.0-alpha.20_darwin_amd64/{influx,influxd} /usr/local/bin/
sudo cp influxdb_2.0.0-alpha.21_darwin_amd64/{influx,influxd} /usr/local/bin/
```
{{% note %}}
@ -72,7 +72,7 @@ Currently, when you first attempt to run `influxd` or `influx`, macOS will preve
To manually authorize the InfluxDB binaries:
1. Attempt to run the `influx` or `influxd` commands.
2. Open **System Preferences** and click **Security & Privacy**.
2. Open **System Preferences** and click **Security & Privacy**.
3. Under the **General** tab, there is a message about `influxd` or `influx` being blocked.
Click **Open Anyway**.
4. Repeat this process for both binaries.
@ -105,8 +105,8 @@ influxd --reporting-disabled
### Download and install InfluxDB v2.0 alpha
Download the InfluxDB v2.0 alpha package appropriate for your chipset.
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_2.0.0-alpha.20_linux_amd64.tar.gz" download >InfluxDB v2.0 alpha (amd64)</a>
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_2.0.0-alpha.20_linux_arm64.tar.gz" download >InfluxDB v2.0 alpha (arm)</a>
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_2.0.0-alpha.21_linux_amd64.tar.gz" download >InfluxDB v2.0 alpha (amd64)</a>
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_2.0.0-alpha.21_linux_arm64.tar.gz" download >InfluxDB v2.0 alpha (arm)</a>
### Place the executables in your $PATH
Unpackage the downloaded archive and place the `influx` and `influxd` executables in your system `$PATH`.
@ -115,10 +115,10 @@ _**Note:** The following commands are examples. Adjust the file names, paths, an
```sh
# Unpackage contents to the current working directory
tar xvzf path/to/influxdb_2.0.0-alpha.20_linux_amd64.tar.gz
tar xvzf path/to/influxdb_2.0.0-alpha.21_linux_amd64.tar.gz
# Copy the influx and influxd binary to your $PATH
sudo cp influxdb_2.0.0-alpha.20_linux_amd64/{influx,influxd} /usr/local/bin/
sudo cp influxdb_2.0.0-alpha.21_linux_amd64/{influx,influxd} /usr/local/bin/
```
{{% note %}}

18
content/v2.0/query-data/guides/sql.md
View File

@ -13,8 +13,9 @@ weight: 207
The [Flux](/v2.0/reference/flux) `sql` package provides functions for working with SQL data sources.
[`sql.from()`](/v2.0/reference/flux/stdlib/sql/from/) lets you query SQL data sources
like [PostgreSQL](https://www.postgresql.org/) and [MySQL](https://www.mysql.com/)
and use the results with InfluxDB dashboards, tasks, and other operations.
like [PostgreSQL](https://www.postgresql.org/), [MySQL](https://www.mysql.com/),
and [SQLite](https://www.sqlite.org/index.html), and use the results with InfluxDB
dashboards, tasks, and other operations.
- [Query a SQL data source](#query-a-sql-data-source)
- [Join SQL data with data in InfluxDB](#join-sql-data-with-data-in-influxdb)
@ -37,6 +38,7 @@ To query a SQL data source:
{{% code-tabs %}}
[PostgreSQL](#)
[MySQL](#)
[SQLite](#)
{{% /code-tabs %}}
{{% code-tab-content %}}
@ -62,6 +64,18 @@ sql.from(
)
```
{{% /code-tab-content %}}
{{% code-tab-content %}}
```js
import "sql"
sql.from(
driverName: "sqlite3",
dataSourceName: "file:test.db?cache=shared&mode=memory",
query: "SELECT * FROM example_table"
)
```
{{% /code-tab-content %}}
{{< /code-tabs-wrapper >}}
_See the [`sql.from()` documentation](/v2.0/reference/flux/stdlib/sql/from/) for

30
content/v2.0/reference/cli/influx/_index.md
View File

@ -43,20 +43,22 @@ retrieving authentication tokens._
{{% /note %}}
## Commands
| Command | Description |
|:------- |:----------- |
| [auth](/v2.0/reference/cli/influx/auth) | Authorization management commands |
| [bucket](/v2.0/reference/cli/influx/bucket) | Bucket management commands |
| [delete](/v2.0/reference/cli/influx/delete) | Delete points from InfluxDB |
| [help](/v2.0/reference/cli/influx/help) | Help about any command |
| [org](/v2.0/reference/cli/influx/org) | Organization management commands |
| [ping](/v2.0/reference/cli/influx/ping) | Check the InfluxDB `/health` endpoint |
| [query](/v2.0/reference/cli/influx/query) | Execute a Flux query |
| [repl](/v2.0/reference/cli/influx/repl) | Interactive REPL (read-eval-print-loop) |
| [setup](/v2.0/reference/cli/influx/setup) | Create default username, password, org, bucket, etc. |
| [task](/v2.0/reference/cli/influx/task) | Task management commands |
| [user](/v2.0/reference/cli/influx/user) | User management commands |
| [write](/v2.0/reference/cli/influx/write) | Write points to InfluxDB |
| Command | Description |
|:------- |:----------- |
| [auth](/v2.0/reference/cli/influx/auth) | Authorization management commands |
| [bucket](/v2.0/reference/cli/influx/bucket) | Bucket management commands |
| [delete](/v2.0/reference/cli/influx/delete) | Delete points from InfluxDB |
| [help](/v2.0/reference/cli/influx/help) | Help about any command |
| [org](/v2.0/reference/cli/influx/org) | Organization management commands |
| [ping](/v2.0/reference/cli/influx/ping) | Check the InfluxDB `/health` endpoint |
| [pkg](/v2.0/reference/cli/influx/pkg) | Manage InfluxDB packages |
| [query](/v2.0/reference/cli/influx/query) | Execute a Flux query |
| [repl](/v2.0/reference/cli/influx/repl) | Interactive REPL (read-eval-print-loop) |
| [setup](/v2.0/reference/cli/influx/setup) | Create default username, password, org, bucket, etc. |
| [task](/v2.0/reference/cli/influx/task) | Task management commands |
| [transpile](/v2.0/reference/cli/influx/transpile) | Manually transpile an InfluxQL query to Flux |
| [user](/v2.0/reference/cli/influx/user) | User management commands |
| [write](/v2.0/reference/cli/influx/write) | Write points to InfluxDB |
{{% influx-cli-global-flags %}}

13
content/v2.0/reference/cli/influx/bucket/create.md
View File

@ -16,11 +16,12 @@ influx bucket create [flags]
```
## Flags
| Flag | Description | Input type |
|:---- |:----------- |:----------: |
| `-h`, `--help` | Help for the `create` command | |
| `-n`, `--name` | Name of bucket that will be created | string |
| `--org-id` | The ID of the organization that owns the bucket | string |
| `-r`, `--retention` | Duration in nanoseconds data will live in bucket | duration |
| Flag | Description | Input type |
|:---- |:----------- |:----------: |
| `-h`, `--help` | Help for the `create` command | |
| `-n`, `--name` | Name of bucket that will be created | string |
| `-o`, `--org` | The name of the organization that owns the bucket | string |
| `--org-id` | The ID of the organization that owns the bucket | string |
| `-r`, `--retention` | Duration in nanoseconds data will live in bucket | duration |
{{% influx-cli-global-flags %}}

40
content/v2.0/reference/cli/influx/pkg/_index.md Normal file
View File

@ -0,0 +1,40 @@
---
title: influx pkg – package management commands
description: The 'influx pkg' command and its subcommands manage packages in InfluxDB.
menu:
v2_0_ref:
name: influx pkg
parent: influx
weight: 101
v2.0/tags: [packages]
---
The `influx pkg` command manages packages in InfluxDB.
## Usage
```
influx pkg [flags]
influx pkg [command]
```
## Available commands
| Command | Description |
|:--------|----------------------------------------------------------------|
| `all` | Export all existing resources for an organization as a package |
## Flags
| Flag | Description | Input Type |
|:----------------------|:--------------------------------------------------------------------------------|-----------------|
| `--buckets` | Comma-separated list of bucket IDs | list of strings |
| `--dashboards` | Comma-separated list of dashboard IDs | list of strings |
| `-d`, `--description` | Package description | string |
| `-f`, `--file` | Package output file. Defaults to stdout. Use `.yml` or `.json` file extensions. | string |
| `-h`, `--help` | Help for the `export` command | |
| `--labels` | Comma-separated list of label IDs | list of strings |
| `-n`, `--name` | Package name | string |
| `--resource-type` | Resource type associated with all IDs via stdin | string |
| `--variables` | Comma-separated list of variable IDs | list of strings |
| `-v`, `--version` | Package version | string |
{{% influx-cli-global-flags %}}

28
content/v2.0/reference/cli/influx/transpile/_index.md Normal file
View File

@ -0,0 +1,28 @@
---
title: influx transpile – Transpile InfluxQL to Flux
description: >
The 'influx transpile' command transpiles an InfluxQL query to Flux source code.
menu:
v2_0_ref:
name: influx transpile
parent: influx
weight: 101
v2.0/tags: [influxql, flux]
---
The `influx transpile` command transpiles an InfluxQL query to Flux source code.
The transpiled query assumes the bucket name is `<database>/<retention policy>`
and includes absolute time ranges using the provided `--now` time.
## Usage
```
influx transpile [InfluxQL query] [flags]
```
## Flags
| Flag | Description |
|:---- |:----------- |
| `-h`, `--help` | Help for the `transpile` command |
| `--now` | RFC3339Nano timestamp to use as `now()` time (default is current UTC time) |
{{% influx-cli-global-flags %}}

4
content/v2.0/reference/flux/language/lexical-elements.md
View File

@ -74,8 +74,8 @@ empty in or package builtin
The following character sequences represent operators:
```
+ == != ( )
- < !~ [ ]
+ == != ( ) =>
- < !~ [ ] ^
* > =~ { }
/ <= = , :
% >= <- . |>

4
content/v2.0/reference/flux/stdlib/built-in/transformations/join.md
View File

@ -67,10 +67,10 @@ _**Data type:** String_
###### Possible Values:
- `inner`
- `cross`
<!-- - `cross`
- `left`
- `right`
- `full`
- `full` -->
{{% note %}}
The `on` parameter and the `cross` method are mutually exclusive.

2
content/v2.0/reference/flux/stdlib/built-in/transformations/range.md
View File

@ -28,6 +28,7 @@ range(start: -15m, stop: now())
### start
The earliest time to include in results.
Results **include** points that match the specified start time.
Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`.
Durations are relative to `now()`.
@ -36,6 +37,7 @@ _**Data type:** Duration | Time_
### stop
The latest time to include in results.
Results **exclude** points that match the specified stop time.
Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`.
Durations are relative to `now()`.

2
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/bool.md
View File

@ -24,6 +24,8 @@ bool(v: "true")
### v
The value to convert.
_**Data type:** Float | Integer | String | Uinteger_
## Examples
```js
from(bucket: "sensor-data")

2
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/bytes.md
View File

@ -24,6 +24,8 @@ bytes(v: "1m")
### v
The value to convert.
_**Data type:** String_
## Examples
```js
from(bucket: "sensor-data")

7
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/duration.md
View File

@ -24,6 +24,13 @@ duration(v: "1m")
### v
The value to convert.
_**Data type:** Integer | String | Uinteger_
{{% note %}}
`duration()` assumes **numeric** input values are **nanoseconds**.
**String** input values must use [duration literal representation](#/v2.0/reference/flux/language/lexical-elements/#duration-literals).
{{% /note %}}
## Examples
```js
from(bucket: "sensor-data")

2
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/float.md
View File

@ -24,6 +24,8 @@ float(v: "3.14")
### v
The value to convert.
_**Data type:** Boolean | Integer | Numeric String | Uinteger_
## Examples
```js
from(bucket: "sensor-data")

9
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/int.md
View File

@ -24,6 +24,15 @@ int(v: "4")
### v
The value to convert.
_**Data type:** Boolean | Duration | Float | Numeric String | Time | Uinteger_
For duration and time values, `int()` returns the following:
| Input type | Returned value |
|:---------- |:-------------- |
| Duration | The number of nanoseconds in the specified duration |
| Time | A nanosecond epoch timestamp |
## Examples
```js
from(bucket: "sensor-data")

2
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/string.md
View File

@ -24,6 +24,8 @@ string(v: 123456789)
### v
The value to convert.
_**Data type:** Boolean | Bytes | Duration | Float | Integer | Time | Uinteger_
## Examples
```js
from(bucket: "sensor-data")

6
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/time.md
View File

@ -24,6 +24,12 @@ time(v: "2016-06-13T17:43:50.1004002Z")
### v
The value to convert.
_**Data type:** Integer | String | Uinteger_
{{% note %}}
`time()` assumes all numeric input values are nanosecond epoch timestamps.
{{% /note %}}
## Examples
```js
from(bucket: "sensor-data")

3
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/tobool.md
View File

@ -14,12 +14,13 @@ weight: 501
The `toBool()` function converts all values in the `_value` column to booleans.
_**Function type:** Type conversion_
_**Output data type:** Boolean_
```js
toBool()
```
_**Supported data types:** Float | Integer | String | Uinteger_
{{% note %}}
To convert values in a column other than `_value`, define a custom function
patterned after the [function definition](#function-definition),

8
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/toduration.md
View File

@ -18,12 +18,18 @@ weight: 501
The `toDuration()` function converts all values in the `_value` column to durations.
_**Function type:** Type conversion_
_**Output data type:** Duration_
```js
toDuration()
```
_**Supported data types:** Integer | String | Uinteger_
{{% note %}}
`duration()` assumes **numeric** input values are **nanoseconds**.
**String** input values must use [duration literal representation](#/v2.0/reference/flux/language/lexical-elements/#duration-literals).
{{% /note %}}
{{% note %}}
To convert values in a column other than `_value`, define a custom function
patterned after the [function definition](#function-definition),

3
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/tofloat.md
View File

@ -14,12 +14,13 @@ weight: 501
The `toFloat()` function converts all values in the `_value` column to floats.
_**Function type:** Type conversion_
_**Output data type:** Float_
```js
toFloat()
```
_**Supported data types:** Boolean | Integer | Numeric String | Uinteger_
{{% note %}}
To convert values in a column other than `_value`, define a custom function
patterned after the [function definition](#function-definition),

10
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/toint.md
View File

@ -14,12 +14,20 @@ weight: 501
The `toInt()` function converts all values in the `_value` column to integers.
_**Function type:** Type conversion_
_**Output data type:** Integer_
```js
toInt()
```
_**Supported data types:** Boolean | Duration | Float | Numeric String | Time | Uinteger_
For duration and time values, `toInt()` returns the following:
| Input type | Returned value |
|:---------- |:-------------- |
| Duration | The number of nanoseconds in the specified duration |
| Time | A nanosecond epoch timestamp |
{{% note %}}
To convert values in a column other than `_value`, define a custom function
patterned after the [function definition](#function-definition),

3
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/tostring.md
View File

@ -14,12 +14,13 @@ weight: 501
The `toString()` function converts all values in the `_value` column to strings.
_**Function type:** Type conversion_
_**Output data type:** String_
```js
toString()
```
_**Supported data types:** Boolean | Bytes | Duration | Float | Integer | Time | Uinteger_
{{% note %}}
To convert values in a column other than `_value`, define a custom function
patterned after the [function definition](#function-definition),

7
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/totime.md
View File

@ -14,12 +14,17 @@ weight: 501
The `toTime()` function converts all values in the `_value` column to times.
_**Function type:** Type conversion_
_**Output data type:** Time_
```js
toTime()
```
_**Supported data types:** Integer | String | Uinteger_
{{% note %}}
`toTime()` assumes all numeric input values are nanosecond epoch timestamps.
{{% /note %}}
{{% note %}}
To convert values in a column other than `_value`, define a custom function
patterned after the [function definition](#function-definition),

10
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/touint.md
View File

@ -14,12 +14,20 @@ weight: 501
The `toUInt()` function converts all values in the `_value` column to UIntegers.
_**Function type:** Type conversion_
_**Output data type:** UInteger_
```js
toUInt()
```
_**Supported data types:** Boolean | Duration | Float | Integer | Numeric String | Time_
For duration and time values, `toUint()` returns the following:
| Input type | Returned value |
|:---------- |:-------------- |
| Duration | The number of nanoseconds in the specified duration |
| Time | A nanosecond epoch timestamp |
{{% note %}}
To convert values in a column other than `_value`, define a custom function
patterned after the [function definition](#function-definition),

9
content/v2.0/reference/flux/stdlib/built-in/transformations/type-conversions/uint.md
View File

@ -24,6 +24,15 @@ uint(v: "4")
### v
The value to convert.
_**Data type:** Boolean | Duration | Float | Integer | Numeric String | Time_
For duration and time values, `uint()` returns the following:
| Input type | Returned value |
|:---------- |:-------------- |
| Duration | The number of nanoseconds in the specified duration |
| Time | A nanosecond epoch timestamp |
## Examples
```js
from(bucket: "sensor-data")

31
content/v2.0/reference/flux/stdlib/experimental/http/_index.md Normal file
View File

@ -0,0 +1,31 @@
---
title: Flux HTTP package
list_title: HTTP package
description: >
The Flux Experimental HTTP package provides functions for transferring data
using HTTP protocol.
Import the `experimental/http` package.
menu:
v2_0_ref:
name: HTTP
identifier: HTTP-exp
parent: Experimental
weight: 201
v2.0/tags: [functions, http, package]
---
The Flux Experimental HTTP package provides functions for transferring data
using HTTP protocol.
{{% warn %}}
The experimental HTTP package is subject to change at any time.
By using this package, you accept the [risks of experimental functions](/v2.0/reference/flux/stdlib/experimental/#use-experimental-functions-at-your-own-risk).
{{% /warn %}}
Import the `experimental/http` package:
```js
import "experimental/http"
```
{{< children type="functions" show="pages" >}}

90
content/v2.0/reference/flux/stdlib/experimental/http/get.md Normal file
View File

@ -0,0 +1,90 @@
---
title: http.get() function
description: >
The `http.get()` function submits an HTTP GET request to the specified URL and
returns the HTTP status code, response body, and response headers.
menu:
v2_0_ref:
name: http.get
parent: HTTP-exp
weight: 301
---
The `http.get()` function submits an HTTP GET request to the specified URL and
returns the HTTP status code, response body, and response headers.
_**Function type:** Miscellaneous_
{{% warn %}}
The `http.get()` function is currently experimental and subject to change at any time.
By using this function, you accept the [risks of experimental functions](/v2.0/reference/flux/stdlib/experimental/#use-experimental-functions-at-your-own-risk).
{{% /warn %}}
```js
import "experimental/http"
http.get(
url: "http://localhost:9999/",
headers: {x:"a", y:"b", z:"c"},
timeout: 30s
)
```
## Parameters
### url
The URL to send the GET request to.
_**Data type:** String_
### headers
Headers to include with the GET request.
_**Data type:** Object_
### timeout
Timeout for the GET request.
Default is `30s`.
_**Data type:** Duration_
## Response format
`http.get` returns an object that contains the following:
- [statusCode](#statuscode)
- [body](#body)
- [headers](#headers)
### statusCode
The HTTP status code returned by the GET request.
_**Data type:** Integer_
### body
The response body.
_**Data type:** Byte Array_
### headers
Headers included with the response.
_**Data type:** Object_
## Examples
##### Get the status of InfluxDB
```js
import "influxdata/influxdb/secrets"
import "experimental/http"
token = secrets.get(key: "READONLY_TOKEN")
response = http.get(
url: "http://localhost.com:9999/health",
headers: {Authorization: "Token ${token}"}
)
httpStatus = response.statusCode
responseBody = string(v: response.body)
responseHeaders = response.headers
```

6
content/v2.0/reference/flux/stdlib/sql/_index.md
View File

@ -2,7 +2,8 @@
title: Flux SQL package
list_title: SQL package
description: >
The Flux SQL package provides tools for working with data in SQL databases such as MySQL and PostgreSQL.
The Flux SQL package provides tools for working with data in SQL databases such
as MySQL, PostgreSQL, and SQLite.
Import the `sql` package.
aliases:
- /v2.0/reference/flux/functions/sql/
@ -14,7 +15,8 @@ weight: 202
v2.0/tags: [functions, sql, package, mysql, postgres]
---
SQL Flux functions provide tools for working with data in SQL databases such as MySQL and PostgreSQL.
SQL Flux functions provide tools for working with data in SQL databases such as
MySQL, PostgreSQL, and SQLite.
Import the `sql` package:
```js

21
content/v2.0/reference/flux/stdlib/sql/from.md
View File

@ -35,20 +35,24 @@ The following drivers are available:
- mysql
- postgres
- sqlite3
### dataSourceName
The connection string used to connect to the SQL database.
The data source name (DSN) or connection string used to connect to the SQL database.
The string's form and structure depend on the [driver](#drivername) used.
_**Data type:** String_
##### Driver dataSourceName examples
```sh
# Postgres Driver:
# Postgres Driver DSN
postgres://pqgotest:password@localhost/pqgotest?sslmode=verify-full
# MySQL Driver:
# MySQL Driver DSN
username:password@tcp(localhost:3306)/dbname?param=value
# SQLite Driver DSN
file:test.db?cache=shared&mode=memory
```
### query
@ -79,3 +83,14 @@ sql.from(
query:"SELECT * FROM ExampleTable"
)
```
### Query an SQLite database
```js
import "sql"
sql.from(
driverName: "sqlite3",
dataSourceName: "file:test.db?cache=shared&mode=memory",
query:"SELECT * FROM ExampleTable"
)
```

34
content/v2.0/reference/flux/stdlib/sql/to.md
View File

@ -20,7 +20,8 @@ import "sql"
sql.to(
driverName: "mysql",
dataSourceName: "username:password@tcp(localhost:3306)/dbname?param=value",
table: "ExampleTable"
table: "ExampleTable",
batchSize: 10000
)
```
@ -35,20 +36,24 @@ The following drivers are available:
- mysql
- postgres
- sqlite3
### dataSourceName
The connection string used to connect to the SQL database.
The data source name (DSN) or connection string used to connect to the SQL database.
The string's form and structure depend on the [driver](#drivername) used.
_**Data type:** String_
##### Driver dataSourceName examples
```sh
# Postgres Driver
# Postgres Driver DSN
postgres://pqgotest:password@localhost/pqgotest?sslmode=verify-full
# MySQL Driver
# MySQL Driver DSN
username:password@tcp(localhost:3306)/dbname?param=value
# SQLite Driver DSN
file:test.db?cache=shared&mode=memory
```
### table
@ -56,6 +61,16 @@ The destination table.
_**Data type:** String_
### batchSize
The number of parameters or columns that can be queued within each call to `Exec`.
Defaults to `10000`.
_**Data type:** Integer_
{{% note %}}
If writing to a **SQLite** database, set `batchSize` to `999` or less.
{{% /note %}}
## Examples
### Write data to a MySQL database
@ -79,3 +94,14 @@ sql.to(
table: "ExampleTable"
)
```
### Write data to an SQLite database
```js
import "sql"
sql.to(
driverName: "sqlite3",
dataSourceName: "file:test.db?cache=shared&mode=memory",
table: "ExampleTable"
)
```

74
content/v2.0/reference/release-notes/flux.md
View File

@ -11,11 +11,83 @@ aliases:
---
{{% note %}}
_The latest release of InfluxDB v2.0 alpha includes **Flux v0.54.0**.
_The latest release of InfluxDB v2.0 alpha includes **Flux v0.57.0**.
Though newer versions of Flux may be available, they will not be included with
InfluxDB until the next InfluxDB v2.0 release._
{{% /note %}}
## v0.57.0 [2019-12-10]
### Features
- Categorize more flux errors with codes.
- Teach flux-config how to download the sources when using vendor.
- Opentracing in query execution runtime.
- Reduce memory allocations for operations in values.
- Translate FlatBuffers semantic graph to Go.
- Add types for some universe builtins.
- Add type declarations for builtins.
- Add Numeric and Row kind constraints.
### Bug fixes
- Enable strict mode by default.
---
## v0.56.0 [2019-12-05]
### Features
- Crate for typing Flux standard library.
- Serialize type environment.
- Improve filter performance when filtering on values.
- Update usage duration test to exclude queue and requeue time.
- Add types for some built-ins.
- Add `timeout` parameter to experimental `http.get()`.
### Bug fixes
- Properly use a fake version with `flux-config` when no version is present.
- Address clippy lints.
- Add bytes monotype to Rust semantic module.
- Allow underscores (`_`) in type expressions.
---
## v0.55.1 [2019-12-02]
### Bug fixes
- Fix e2e usage test so that their queries are properly pushed down.
---
## v0.55.0 [2019-12-02]
### Breaking changes
- Expand the interface for `BufferedTable`.
### Features
- Expose optimized `pivot()` function.
- Create utility program for building `libflux`.
- Create a tool that measures performance of calling Rust from Go.
- Inject types in the semantic graph.
- MonoType and PolyType flatbuffer encodings.
- MonoType and PolyType flatbuffer schemas.
- Update Rust flatbuffers to more closely match Rust semantic graph.
- Flatbuffers AST to Go AST.
- Port immutable walk and fix mutable walk.
- Define the flatbuffers schema for semantic graph.
- Infer imported package types.
- Unify and infer function types.
- Add support for safely converting bytes to strings.
- Add sqlite3 support.
- Add internal table utility for streaming tables.
### Bug fixes
- Update semantic graph FlatBuffers schema for identifiers.
- Ignore order when comparing record types.
- Operands for `<=` and `>=` are comparable AND equatable.
- Constrain unary expressions to be same type as operand.
---
## v0.54.0 [2019-11-11]
### Features

3
content/v2.0/visualize-data/visualization-types/graph-single-stat.md
View File

@ -58,6 +58,9 @@ next to the visualization dropdown in the upper right.
- **Custom**: Manually specify the value range of the y-axis.
- **Min**: Minimum y-axis value.
- **Max**: Maximum y-axis value.
- **Positioning**:
- **Overlaid**: Display graph lines overlaid on each other.
- **Stacked**: Display graph lines stacked on top of each other.
###### Customize Single-Stat
- **Prefix**: Prefix to be added to the single stat.

4
content/v2.0/visualize-data/visualization-types/graph.md
View File

@ -51,6 +51,10 @@ to the visualization dropdown in the upper right.
- **Custom**: Manually specify the value range of the y-axis.
- **Min**: Minimum y-axis value.
- **Max**: Maximum y-axis value.
- **Positioning**:
- **Overlaid**: Display graph lines overlaid on each other.
- **Stacked**: Display graph lines stacked on top of each other.
## Graph Examples

2
layouts/shortcodes/influx-cli-global-flags.md
View File

@ -4,5 +4,5 @@
|:----------------|:--------------------------------------------------------------------------------------------|:----------:|
| `--host` | HTTP address of InfluxDB (default `http://localhost:9999`) | string |
| `--local` | Run commands against the local filesystem | |
| `-t`, `--token` | API token to use in client calls | string |
| `--skip-verify` | Skip certificate verification (use when connecting over TLS with a self-signed certificate) | |
| `-t`, `--token` | API token to use in client calls | string |