Note that `from()` can query remote sources (#3074)

Closes #3073.

Co-authored-by: pierwill <pierwill@users.noreply.github.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
pull/3082/head
pierwill 2021-08-31 12:00:18 -05:00 committed by GitHub
parent 05e406cfa0
commit d576ce2068
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 4 deletions

View File

@ -40,12 +40,9 @@ from(
{{% note %}}
#### Query remote InfluxDB data sources
Use `from()` to retrieve data from remote InfluxDB 2.0 OSS and InfluxDB Cloud instances.
Use `from()` to retrieve data from remote InfluxDB OSS 1.7+, InfluxDB Enterprise 1.9+, and InfluxDB Cloud.
To query remote InfluxDB sources, include the [host](#host), [token](#token), and
[org](#org) (or [orgID](#orgid)) parameters.
`from()` **cannot retrieve data** from **remote** InfluxDB OSS 1.x or InfluxDB Enterprise 1.x data sources
_(including hosted, single-tenant InfluxDB Enterprise clusters)_.
{{% /note %}}
## Parameters
@ -53,11 +50,15 @@ _(including hosted, single-tenant InfluxDB Enterprise clusters)_.
### bucket
Name of the bucket to query.
**InfluxDB 1.x or Enterprise**: provide an empty string (`""`)
_**Data type:** String_
### bucketID
String-encoded bucket ID to query.
**InfluxDB 1.x or Enterprise**: provide an empty string (`""`)
_**Data type:** String_
### host
@ -69,6 +70,8 @@ _**Data type:** String_
### org
Organization name.
**InfluxDB 1.x or Enterprise**: provide an empty string (`""`)
_**Data type:** String_
### orgID
@ -79,6 +82,11 @@ _**Data type:** String_
### token
InfluxDB [API token](/influxdb/v2.0/security/tokens/).
**InfluxDB 1.x or Enterprise**:
If authentication is _disabled_, provide an empty string (`""`).
If authentication is _enabled_, provide your InfluxDB username and password
using the `<username>:<password>` syntax.
_**Data type:** String_
## Examples