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

Link Tableau into Analyze and Visualize, reorganize tools for query-data and process-data, fix URLs (#5011) 

* chore(v3): copy pandas .info and .describe example to new Summarize Data page

* fix(v3): url

* chore(v3): link Tableau guide in Analyze and Visualize, move Analyze and Visualize (query-data/tools) to process-data/tools, alias sql/execute-queries as query-data/tools/, cleanup aliases and relateds, fix urls. (closes #5010)

* chore(v3): update links with new tools URLs

* fix(v3): transposed URLs
pull/5013/head
Jason Stirnaman 2023-07-06 12:39:02 -05:00 committed by GitHub
parent daf513a6b7
commit 28e3a809fe
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
47 changed files with 717 additions and 126 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
content/influxdb/cloud-dedicated/api-compatibility/v1/_index.md
View File

@ -464,8 +464,8 @@ Use one of the following values for timestamp precision:
- [`influx3` data CLI](https://github.com/InfluxCommunity/influxdb3-python-cli)
- [InfluxDB v3 client libraries](/influxdb/cloud-dedicated/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-dedicated/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-dedicated/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)

4
content/influxdb/cloud-dedicated/api-compatibility/v2/_index.md
View File

@ -223,8 +223,8 @@ To setup and start using client libraries, see the [Get started](/influxdb/cloud
- [`influx3` data CLI](https://github.com/InfluxCommunity/influxdb3-python-cli)
- [InfluxDB v3 client libraries](/influxdb/cloud-dedicated/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-dedicated/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-dedicated/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)

4
content/influxdb/cloud-dedicated/get-started/query.md
View File

@ -47,8 +47,8 @@ The examples in this section of the tutorial query the
- [`influx3` data CLI](?t=influx3+CLI#execute-an-sql-query){{< req "\* " >}}
- [InfluxDB v3 client libraries](/influxdb/cloud-dedicated/reference/client-libraries/v3/)
- [Flight SQL clients](?t=Go#execute-an-sql-query){{< req "\* " >}}
- [Superset](/influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-dedicated/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)

2
content/influxdb/cloud-dedicated/process-data/_index.md
View File

@ -20,7 +20,7 @@ Data processing tasks all follow essentially the same workflow:
2. Process data using tools available in the external runtime.
3. _(Optional)_ Write the processed data back to InfluxDB.
The following guides utilize [InfluxDB v3 client libraries](/influxdb/cloud-serverless/reference/client-libraries/v3/)
The following guides utilize [InfluxDB v3 client libraries](/influxdb/cloud-dedicated/reference/client-libraries/v3/)
to demonstrate how to process data.
{{< children >}}

97
content/influxdb/cloud-dedicated/process-data/summarize.md Normal file
View File

@ -0,0 +1,97 @@
---
title: Summarize query results and data distribution
description: >
Query data stored in InfluxDB and use tools like pandas to summarize the results schema and distribution.
menu:
influxdb_cloud_dedicated:
name: Summarize data
parent: Process data
weight: 101
influxdb/cloud-dedicated/tags: [analysis, pandas, pyarrow, python, schema]
related:
- /influxdb/cloud-dedicated/query-data/sql/execute-queries/python/
---
Query data stored in InfluxDB and use tools like pandas to summarize the results schema and distribution.
{{% note %}}
#### Sample data
The following examples use the sample data written in the
[Get started writing data guide](/influxdb/cloud-dedicated/get-started/write/).
To run the example queries and return results,
[write the sample data](/influxdb/cloud-dedicated/get-started/write/#write-line-protocol-to-influxdb)
to your {{% cloud-name %}} database before running the example queries.
{{% /note %}}
### View data information and statistics
#### Using Python and pandas
The following example uses the [InfluxDB client library for Python](/influxdb/cloud-dedicated/reference/client-libraries/v3/python/) to query an {{% cloud-name %}} database,
and then uses pandas [`DataFrame.info()`](https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.info.html) and [`DataFrame.describe()`](https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.describe.html) methods to summarize the schema and distribution of the data.
1. In your editor, create a file (for example, `pandas-example.py`) and enter the following sample code:
<!-- tabs-wrapper allows code-placeholders to work when indented -->
{{% tabs-wrapper %}}
{{% code-placeholders "DATABASE_TOKEN|DATABASE_NAME" %}}
```py
# pandas-example.py
import influxdb_client_3 as InfluxDBClient3
import pandas
client = InfluxDBClient3.InfluxDBClient3(token='DATABASE_TOKEN',
host='cluster-id.influxdb.io',
database='DATABASE_NAME',
org="",
write_options=SYNCHRONOUS)
table = client.query("select * from home where room like '%'")
dataframe = table.to_pandas()
# Print information about the results DataFrame,
# including the index dtype and columns, non-null values, and memory usage.
dataframe.info()
# Calculate descriptive statistics that summarize the distribution of the results.
print(dataframe.describe())
```
{{% /code-placeholders %}}
{{% /tabs-wrapper %}}
2. Enter the following command in your terminal to execute the file using the Python interpreter:
```sh
python pandas-example.py
```
The output is similar to the following:
```sh
<class 'pandas.core.frame.DataFrame'>
RangeIndex: 411 entries, 0 to 410
Data columns (total 8 columns):
# Column Non-Null Count Dtype
--- ------ -------------- -----
0 co 405 non-null float64
1 host 2 non-null object
2 hum 406 non-null float64
3 room 411 non-null object
4 sensor 1 non-null object
5 sensor_id 2 non-null object
6 temp 411 non-null float64
7 time 411 non-null datetime64[ns]
dtypes: datetime64[ns](1), float64(3), object(4)
memory usage: 25.8+ KB
co hum temp time
count 405.000000 406.000000 411.000000 411
mean 5.320988 35.860591 23.803893 2008-06-12 13:33:49.074302208
min 0.000000 20.200000 18.400000 1970-01-01 00:00:01.641024
25% 0.000000 35.900000 22.200000 1970-01-01 00:00:01.685054600
50% 1.000000 36.000000 22.500000 2023-03-21 05:46:40
75% 9.000000 36.300000 22.800000 2023-07-15 21:34:10
max 26.000000 80.000000 74.000000 2023-07-17 02:07:00
std 7.640154 3.318794 8.408807 NaN
```

6
content/influxdb/cloud-dedicated/query-data/tools/_index.md → content/influxdb/cloud-dedicated/process-data/tools/_index.md
View File

@ -1,13 +1,13 @@
---
title: Use analysis and visualization tools with InfluxDB Cloud (IOx) APIs
title: Analyze and visualize data stored in InfluxDB
description: >
Use popular tools to analyze and visualize time series data stored in an
InfluxDB database.
weight: 201
weight: 101
menu:
influxdb_cloud_dedicated:
name: Analyze and visualize data
parent: Query data
parent: Process data
influxdb/cloud-dedicated/tags: [analysis, visualization, tools]
aliases:
- /influxdb/cloud-dedicated/visualize-data/

28
content/influxdb/cloud-dedicated/process-data/tools/grafana.md Normal file
View File

@ -0,0 +1,28 @@
---
title: Use Grafana to query and visualize data
seotitle: Use Grafana to query and visualize data stored in InfluxDB Cloud Dedicated
list_title: Grafana
description: >
Install and run [Grafana](https://grafana.com/) to query and visualize data stored in InfluxDB.
weight: 101
menu:
influxdb_cloud_dedicated:
name: Use Grafana
parent: Analyze and visualize data
identifier: visualize_with_grafana
influxdb/cloud-dedicated/tags: [query, visualization]
aliases:
- /influxdb/cloud-dedicated/visualize-data/grafana/
related:
- /influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana/
alt_engine: /influxdb/cloud/tools/grafana/
---
Use Grafana to query and visualize data stored in {{% cloud-name %}}.
To get started with Grafana and InfluxDB, see [Use Grafana to query data](/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana/).
## Build visualizations with Grafana
For a comprehensive walk-through of creating visualizations with
Grafana, see the [Grafana documentation](https://grafana.com/docs/grafana/latest/).

13
content/influxdb/cloud-dedicated/query-data/tools/pandas.md → content/influxdb/cloud-dedicated/process-data/tools/pandas.md
View File

@ -1,5 +1,6 @@
---
title: Use pandas to analyze and visualize data
list_title: pandas
seotitle: Use Python and pandas to analyze and visualize data
description: >
Use the [pandas](https://pandas.pydata.org/) Python data analysis library
@ -9,11 +10,12 @@ menu:
influxdb_cloud_dedicated:
parent: Analyze and visualize data
name: Use pandas
identifier: analyze-with-pandas
influxdb/cloud-dedicated/tags: [analysis, pandas, pyarrow, python, visualization]
aliases:
- /influxdb/cloud-dedicated/visualize-data/pandas/
related:
- /influxdb/cloud-dedicated/query-data/tools/python/
- /influxdb/cloud-dedicated/query-data/tools/pyarrow/
- /influxdb/cloud-dedicated/query-data/sql/
- /influxdb/cloud-dedicated/query-data/sql/execute-queries/python/
list_code_example: |
```py
...
@ -136,10 +138,11 @@ reader = client.do_get(info.endpoints[0].ticket)
dataframe = reader.read_pandas()
# Print a summary of the DataFrame to stdout
# Print information about the results DataFrame,
# including the index dtype and columns, non-null values, and memory usage.
dataframe.info()
# Calculate summary statistics for the data
# Calculate descriptive statistics that summarize the distribution of the results.
print(dataframe.describe())
```

8
content/influxdb/cloud-dedicated/query-data/tools/pyarrow.md → content/influxdb/cloud-dedicated/process-data/tools/pyarrow.md
View File

@ -1,5 +1,6 @@
---
title: Use the PyArrow library to analyze data
list_title: PyArrow
description: >
Use [PyArrow](https://arrow.apache.org/docs/python/) to read and analyze InfluxDB query results.
weight: 101
@ -7,11 +8,12 @@ menu:
influxdb_cloud_dedicated:
parent: Analyze and visualize data
name: Use PyArrow
identifier: analyze_with_pyarrow
influxdb/cloud-dedicated/tags: [analysis, arrow, pyarrow, python]
related:
- /influxdb/cloud-dedicated/query-data/tools/pandas/
- /influxdb/cloud-dedicated/query-data/tools/pyarrow/
- /influxdb/cloud-dedicated/query-data/sql/
- /influxdb/cloud-dedicated/query-data/sql/execute-queries/python/
aliases:
- /influxdb/cloud-dedicated/visualize-data/pyarrow/
list_code_example: |
```py
...

4
content/influxdb/cloud-dedicated/query-data/tools/superset.md → content/influxdb/cloud-dedicated/process-data/tools/superset.md
View File

@ -10,12 +10,12 @@ menu:
influxdb_cloud_dedicated:
parent: Analyze and visualize data
name: Use Superset
identifier: visualize_with_superset
identifier: visualize-with-superset
influxdb/cloud-dedicated/tags: [query, visualization]
aliases:
- /influxdb/cloud-dedicated/visualize-data/superset/
related:
- /influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/
- /influxdb/cloud-dedicated/query-data/sql/execute-queries/superset/
---
Use [Apache Superset](https://superset.apache.org/) to query and visualize data

33
content/influxdb/cloud-dedicated/process-data/tools/tableau.md Normal file
View File

@ -0,0 +1,33 @@
---
title: Use Tableau to visualize data
seotitle: Use Tableau to visualize data stored in InfluxDB
list_title: Tableau
description: >
Use [Tableau](https://www.tableau.com/) to query, analyze, and visualize data
stored in an InfluxDB database.
weight: 101
menu:
influxdb_cloud_dedicated:
parent: Analyze and visualize data
name: Use Tableau
identifier: visualize-with-tableau
influxdb/cloud-dedicated/tags: [query, visualization, Tableau]
aliases:
- /influxdb/cloud-dedicated/visualize-data/tableau/
related:
- /influxdb/cloud-dedicated/query-data/sql/execute-queries/tableau/
---
Use [Tableau](https://www.tableau.com/) to query, analyze, and visualize data
stored in an InfluxDB database.
> Tableau is a visual analytics platform transforming the way we use data to
> solve problems—empowering people and organizations to make the most of their data.
>
> {{% cite %}}[tableau.com](https://www.tableau.com/why-tableau/what-is-tableau){{% /cite %}}
To get started connecting to InfluxDB as a Tableau data source, see [Use Tableau to query data with SQL](/influxdb/cloud-dedicated/query-data/execute-queries/sql/tableau/).
## Build visualizations with Tableau
After you've connected Tableau to your InfluxDB database, see the Tableau documentation to [Set Up Data Sources](https://help.tableau.com/current/pro/desktop/en-us/datasource_prepare.htm) and begin working with data.

251
content/influxdb/cloud-dedicated/query-data/influxql/execute-queries/grafana.md Normal file
View File

@ -0,0 +1,251 @@
---
title: Use Grafana to query data with SQL
seotitle: Use Grafana to query data stored in InfluxDB Cloud Dedicated
list_title: Use Grafana
description: >
Install and run [Grafana](https://grafana.com/) to query data stored in InfluxDB.
weight: 101
menu:
influxdb_cloud_dedicated:
name: Use Grafana
parent: influxql-execute-queries
identifier: query-with-grafana-influxql
influxdb/cloud-dedicated/tags: [query, visualization]
aliases:
- /influxdb/cloud-dedicated/query-data/tools/grafana/
related:
- /influxdb/cloud-dedicated/process-data/tools/grafana/
---
Use [Grafana](https://grafana.com/) to query data stored in
{{% cloud-name %}}.
{{% cloud-name %}} supports both **SQL** and **InfluxQL** query languages.
Install the [Grafana FlightSQL plugin](https://grafana.com/grafana/plugins/influxdata-flightsql-datasource/)
to query InfluxDB with **SQL** using the Flight SQL protocol.
Use the **InfluxDB** core Grafana plugin to query data with **InfluxQL**.
> [Grafana] enables you to query, visualize, alert on, and explore your metrics,
> logs, and traces wherever they are stored.
> [Grafana] provides you with tools to turn your time-series database (TSDB)
> data into insightful graphs and visualizations.
>
> {{% caption %}}[Grafana documentation](https://grafana.com/docs/grafana/latest/introduction/){{% /caption %}}
<!-- TOC -->
- [Install Grafana or login to Grafana Cloud](#install-grafana-or-login-to-grafana-cloud)
- [Install the FlightSQL plugin](#install-the-flightsql-plugin)
- [Use grafana-cli](#use-grafana-cli)
- [Use the Grafana UI](#use-the-grafana-ui)
- [Create a datasource](#create-a-datasource)
- [Query InfluxDB with Grafana](#query-influxdb-with-grafana)
- [Build visualizations with Grafana](#build-visualizations-with-grafana)
<!-- /TOC -->
## Install Grafana or login to Grafana Cloud
If using the open source version of **Grafana**, follow the
[Grafana installation instructions](https://grafana.com/docs/grafana/latest/setup-grafana/installation/)
to install Grafana for your operating system.
If using **Grafana Cloud**, login to your Grafana Cloud instance.
## Install the FlightSQL plugin
If you want to query {{% cloud-name %}} with **SQL**, install the
[Grafana FlightSQL plugin](https://grafana.com/grafana/plugins/influxdata-flightsql-datasource/).
{{< tabs-wrapper >}}
{{% tabs %}}
[Local Grafana](#)
[Grafana Cloud](#)
{{% /tabs %}}
{{% tab-content %}}
<!---------------------------- BEGIN LOCAL GRAFANA ---------------------------->
When using the local version of Grafana, you can install the FlightSQL plugin
with the [`grafana-cli` CLI](https://grafana.com/docs/grafana/latest/cli/) or in
the Grafana user interface (UI).
- [Use grafana-cli](#use-grafana-cli)
- [Use the Grafana UI](#use-the-grafana-ui)
### Use grafana-cli
Run the following command to install the FlightSQL plugin:
```sh
grafana-cli plugins install influxdata-flightsql-datasource
```
After installing the plugin, you may need to restart your Grafana server.
### Use the Grafana UI
1. In the Grafana UI, navigate to **Configuration** > **Plugins**.
2. Search for and select the **FlightSQL** plugin.
3. Click **Install**.
<!----------------------------- END LOCAL GRAFANA ----------------------------->
{{% /tab-content %}}
{{% tab-content %}}
<!---------------------------- BEGIN GRAFANA CLOUD ---------------------------->
1. In your Grafana Cloud instance, navigate to **Administration** > **Plugins**.
2. Search for and select the **FlightSQL** plugin.
3. Click **Install via grafana.com** to navigate to the plugin page.
4. On the plugin page, click **Install plugin**.
After a moment, Grafana Cloud completes the plugin installation in your
Grafana Cloud instance.
<!----------------------------- END GRAFANA CLOUD ----------------------------->
{{% /tab-content %}}
{{< /tabs-wrapper >}}
## Create a datasource
Which datasource you create depends on which query language you want to use to
query {{% cloud-name %}}:
- To query with **SQL**, create a **FlightSQL** datasource.
- To query with **InfluxQL**, create an **InfluxDB** datasource.
{{< tabs-wrapper >}}
{{% tabs %}}
[SQL](#)
[InfluxQL](#)
{{% /tabs %}}
{{% tab-content %}}
<!--------------------------------- BEGIN SQL --------------------------------->
1. In your Grafana user interface (UI), navigate to **Data Sources**.
2. Click **Add new data source**.
3. Search for and select the **FlightSQL** plugin.
4. Provide a name for your datasource.
5. Add your connection credentials:
- **Host**: Provide the host and port of your Flight SQL client.
For {{% cloud-name %}}, this is your cluster URL and port 443:
```
cluster-id.influxdb.io:443
```
- **AuthType**: Select **token**.
- **Token**: Provide your InfluxDB [database token](/influxdb/cloud-dedicated/admin/tokens/) with read access to the
databases you want to query.
- **Require TLS/SSL**: Enable this toggle.
6. Add connection **MetaData**.
Provide key-value pairs to send to your Flight SQL client.
{{% cloud-name %}} requires your **database name**:
- **Key**: `database`
- **Value**: Database name
7. Click **Save & test**.
{{< img-hd src="/img/influxdb/cloud-dedicated-grafana-flightsql-datasource.png" alt="Grafana FlightSQL datasource for InfluxDB Cloud Dedicated" />}}
If successful, click **Explore** to begin querying InfluxDB with Flight SQL and Grafana.
<!---------------------------------- END SQL ---------------------------------->
{{% /tab-content %}}
{{% tab-content %}}
<!------------------------------- BEGIN INFLUXQL ------------------------------>
1. In your Grafana user interface (UI), navigate to **Data Sources**.
2. Click **Add new data source**.
3. Search for and select the **InfluxDB** core plugin.
4. Provide a name for your datasource.
5. Under **Query Language**, select **InfluxQL**.
_{{% cloud-name %}} does not support Flux._
6. Under **HTTP**:
- **URL**: Provide your {{% cloud-name %}} cluster URL using the HTTPS
protocol:
```
https://cluster-id.influxdb.io
```
7. Under **InfluxDB Details**:
- **Database**: Provide a default database name to query.
- **User**: Provide an arbitrary string.
_This credential is ingored when querying {{% cloud-name %}}, but it cannot be empty._
- **Password**: Provide an InfluxDB [database token](/influxdb/cloud-dedicated/admin/tokens/)
with read access to the databases you want to query.
7. Click **Save & test**.
{{< img-hd src="/img/influxdb/cloud-dedicated-grafana-influxdb-datasource.png" alt="Grafana InfluxDB datasource for InfluxDB Cloud Dedicated" />}}
<!-------------------------------- END INFLUXQL ------------------------------->
{{% /tab-content %}}
{{< /tabs-wrapper >}}
## Query InfluxDB with Grafana
After you [configure and save a FlightSQL or InfluxDB datasource](#create-a-datasource),
use Grafana to build, run, and inspect queries against your InfluxDB database.
{{< tabs-wrapper >}}
{{% tabs %}}
[SQL](#)
[InfluxQL](#)
{{% /tabs %}}
{{% tab-content %}}
<!--------------------------------- BEGIN SQL --------------------------------->
{{% note %}}
{{% sql/sql-schema-intro %}}
To learn more, see [Query Data](/influxdb/cloud-dedicated/query-data/sql/).
{{% /note %}}
1. Click **Explore**.
2. In the dropdown, select the **FlightSQL** data source that you want to query.
3. Use the SQL query form to build your query:
- **FROM**: Select the measurement that you want to query.
- **SELECT**: Select one or more fields and tags to return as columns in query results.
In Grafana, you must specify a **time** column in the `SELECT` list.
- **WHERE**: To filter the query results, enter a conditional expression.
- **GROUP BY**: To `GROUP BY` one or more fields or tags, enter them as a comma-delimited list.
If you include an aggregate function in the **SELECT** list,
then you must include one or more of the queried columns in
a `GROUP BY` or `PARTITION BY` clause.
SQL will return the aggregation for each group or partition.
4. Click **Run query** to execute the query.
<!---------------------------------- END SQL ---------------------------------->
{{% /tab-content %}}
{{% tab-content %}}
<!------------------------------- BEGIN INFLUXQL ------------------------------>
1. Click **Explore**.
2. In the dropdown, select the **InfluxDB** data source that you want to query.
3. Use the InfluxQL query form to build your query:
- **FROM**: Select the measurement that you want to query.
- **WHERE**: To filter the query results, enter a conditional expression.
- **SELECT**: Select fields to query and an aggregate function to apply to each.
The aggregate function is applied to each time interval defined in the
`GROUP BY` clause.
- **GROUP BY**: By default, Grafana groups data by time to downsample results
and improve query performance.
You can also add other tags to group by.
4. Click **Run query** to execute the query.
<!-------------------------------- END INFLUXQL ------------------------------->
{{% /tab-content %}}
{{< /tabs-wrapper >}}
To learn about query management and inspection in Grafana, see the
[Grafana Explore documentation](https://grafana.com/docs/grafana/latest/explore/).
## Build visualizations with Grafana
For a comprehensive walk-through of creating visualizations with
Grafana, see the [Grafana documentation](https://grafana.com/docs/grafana/latest/).

8
content/influxdb/cloud-dedicated/query-data/influxql/execute-queries/python.md
View File

@ -11,8 +11,8 @@ menu:
identifier: query-with-python-influxql
influxdb/cloud-dedicated/tags: [query, influxql, python]
related:
- /influxdb/cloud-dedicated/query-data/tools/pandas/
- /influxdb/cloud-dedicated/query-data/tools/pyarrow/
- /influxdb/cloud-dedicated/process-data/tools/pandas/
- /influxdb/cloud-dedicated/process-data/tools/pyarrow/
- /influxdb/cloud-dedicated/reference/influxql/
list_code_example: |
```py
@ -281,5 +281,5 @@ print(table.to_pandas().to_markdown())
Next, learn how to use Python tools to work with time series data:
- [Use PyArrow](/influxdb/cloud-dedicated/query-data/tools/pyarrow/)
- [Use pandas](/influxdb/cloud-dedicated/query-data/tools/pandas/)
- [Use PyArrow](/influxdb/cloud-dedicated/process-data/tools/pyarrow/)
- [Use pandas](/influxdb/cloud-dedicated/process-data/tools/pandas/)

1
content/influxdb/cloud-dedicated/query-data/sql/execute-queries/_index.md
View File

@ -11,6 +11,7 @@ menu:
influxdb/cloud-dedicated/tags: [query, sql]
aliases:
- /influxdb/cloud-dedicated/query-data/execute-queries/
- /influxdb/cloud-dedicated/query-data/tools/
---
The InfluxDB SQL implementation uses [Arrow DataFusion](https://arrow.apache.org/datafusion/)

12
content/influxdb/cloud-dedicated/query-data/tools/grafana.md → content/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana.md
View File

@ -1,21 +1,21 @@
---
title: Use Grafana to query and visualize data
seotitle: Use Grafana to query and visualize data stored in InfluxDB Cloud Dedicated
title: Use Grafana to query data with SQL
seotitle: Use Grafana to query data stored in InfluxDB Cloud Dedicated
list_title: Use Grafana
description: >
Install and run [Grafana](https://grafana.com/) to query and visualize data stored in InfluxDB.
Install and run [Grafana](https://grafana.com/) to query data stored in InfluxDB.
weight: 101
menu:
influxdb_cloud_dedicated:
name: Use Grafana
parent: Analyze and visualize data
parent: sql-execute-queries
identifier: query-with-grafana-sql
influxdb/cloud-dedicated/tags: [query, visualization]
aliases:
- /influxdb/cloud-dedicated/query-data/tools/grafana/
alt_engine: /influxdb/cloud/tools/grafana/
---
Use [Grafana](https://grafana.com/) to query and visualize data stored in
Use [Grafana](https://grafana.com/) to query data stored in
{{% cloud-name %}}.
{{% cloud-name %}} supports both **SQL** and **InfluxQL** query languages.
Install the [Grafana FlightSQL plugin](https://grafana.com/grafana/plugins/influxdata-flightsql-datasource/)

12
content/influxdb/cloud-dedicated/query-data/sql/execute-queries/python.md
View File

@ -1,5 +1,6 @@
---
title: Use Python to query data with SQL
list_title: Use Python
description: >
Use the `influxdb_client_3` Python module and SQL to query data stored in InfluxDB.
weight: 101
@ -11,9 +12,10 @@ menu:
influxdb/cloud-dedicated/tags: [query, flightsql, python, sql]
aliases:
- /influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/python/
- /influxdb/cloud-dedicated/query-data/tools/python/
related:
- /influxdb/cloud-dedicated/query-data/tools/pandas/
- /influxdb/cloud-dedicated/query-data/tools/pyarrow/
- /influxdb/cloud-dedicated/process-data/tools/pandas/
- /influxdb/cloud-dedicated/process-data/tools/pyarrow/
- /influxdb/cloud-dedicated/reference/sql/
list_code_example: |
```py
@ -194,7 +196,7 @@ _To query data with **InfluxQL** and Python, see
Install the following dependencies:
{{< req type="key" text="Already installed in the [Write data section](/influxdb/cloud-serverless/get-started/write/?t=Python#write-line-protocol-to-influxdb)" color="magenta" >}}
{{< req type="key" text="Already installed in the [Write data section](/influxdb/cloud-dedicated/get-started/write/?t=Python#write-line-protocol-to-influxdb)" color="magenta" >}}
- `influxdb3-python` {{< req text="\* " color="magenta" >}}: Provides the `influxdb_client_3` module and also installs the [`pyarrow` package](https://arrow.apache.org/docs/python/index.html) for working with Arrow data returned from queries.
- `pandas`: Provides [pandas modules](https://pandas.pydata.org/) for analyzing and manipulating data.
@ -277,5 +279,5 @@ print(table.to_pandas().to_markdown())
Next, learn how to use Python tools to work with time series data:
- [Use PyArrow](/influxdb/cloud-dedicated/query-data/tools/pyarrow/)
- [Use pandas](/influxdb/cloud-dedicated/query-data/tools/pandas/)
- [Use PyArrow](/influxdb/cloud-dedicated/process-data/tools/pyarrow/)
- [Use pandas](/influxdb/cloud-dedicated/process-data/tools/pandas/)

4
content/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset.md
View File

@ -1,6 +1,7 @@
---
title: Use Superset to query data
seotitle: Use Apache Superset to query data stored in InfluxDB Cloud Dedicated
list_title: Use Superset
description: >
Install and run [Apache Superset](https://superset.apache.org/)
to query data stored in InfluxDB.
@ -12,7 +13,8 @@ menu:
identifier: query-with-superset
influxdb/cloud-dedicated/tags: [query, flightsql, superset]
aliases:
- /influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/
- /influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/
- /influxdb/cloud-dedicated/query-data/tools/superset/
related:
- /influxdb/cloud-dedicated/visualize-data/superset/
---

7
content/influxdb/cloud-dedicated/query-data/sql/execute-queries/tableau.md
View File

@ -1,6 +1,7 @@
---
title: Use Tableau to query data with SQL
seotitle: Use Tableau to query data stored in InfluxDB Cloud Dedicated
list_title: Use Tableau
description: >
Install and use [Tableau](https://www.tableau.com/) to query data stored in InfluxDB.
weight: 401
@ -11,8 +12,10 @@ menu:
identifier: query-with-tableau
influxdb/cloud-dedicated/tags: [query, flightsql, tableau, sql]
aliases:
- /influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/
- /influxdb/cloud-dedicated/visualize-data/superset/
- /influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/tableau/
- /influxdb/cloud-dedicated/query-data/tools/tableau/
related:
- /influxdb/cloud-dedicated/visualize-data/tableau/
---
Use [Tableau](https://www.tableau.com/) to query and visualize time series data

4
content/influxdb/cloud-dedicated/reference/client-libraries/v2/_index.md
View File

@ -30,8 +30,8 @@ This endpoint can't query an {{% cloud-name %}} cluster.
- [InfluxDB v3 client libraries](/influxdb/cloud-dedicated/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-dedicated/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-dedicated/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)

4
content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/_index.md
View File

@ -29,8 +29,8 @@ This endpoint can't query an {{% cloud-name %}} cluster.
- [`influx3` data CLI](https://github.com/InfluxCommunity/influxdb3-python-cli)
- [InfluxDB v3 client libraries](/influxdb/cloud-dedicated/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-dedicated/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-dedicated/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)

4
content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/browser.md
View File

@ -31,8 +31,8 @@ This endpoint can't query an {{% cloud-name %}} database.
- [InfluxDB v3 client libraries](/influxdb/cloud-dedicated/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-dedicated/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-dedicated/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)

4
content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/nodejs/_index.md
View File

@ -29,8 +29,8 @@ This endpoint can't query an {{% cloud-name %}} database.
- [InfluxDB v3 client libraries](/influxdb/cloud-dedicated/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-dedicated/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-dedicated/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)

16
content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/nodejs/install.md
View File

@ -6,10 +6,10 @@ menu:
influxdb_cloud_dedicated:
name: Install
parent: Node.js
influxdb/cloud-serverless/tags: [client libraries, JavaScript]
influxdb/cloud-dedicated/tags: [client libraries, JavaScript]
weight: 100
aliases:
- /influxdb/cloud-serverless/reference/api/client-libraries/nodejs/install
- /influxdb/cloud-dedicated/reference/api/client-libraries/nodejs/install
---
{{% note %}}
@ -23,11 +23,11 @@ This endpoint can't query an {{% cloud-name %}} database.
{{% cloud-name %}} supports many different tools for querying data, including:
- [InfluxDB v3 client libraries](/influxdb/cloud-serverless/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-serverless/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/tools/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-serverless/primers/api/v1/#query-using-the-v1-api)
- [InfluxDB v3 client libraries](/influxdb/cloud-dedicated/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-dedicated/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-dedicated/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)
{{% /note %}}
@ -106,6 +106,6 @@ Set environment variables or update `env.js` with your InfluxDB [database](/infl
## Next steps
Once you've installed the client library and configured credentials, you're ready to [write data](/influxdb/cloud-serverless/api-guide/client-libraries/nodejs/write/) to InfluxDB.
Once you've installed the client library and configured credentials, you're ready to [write data](/influxdb/cloud-dedicated/api-guide/client-libraries/nodejs/write/) to InfluxDB.
{{< page-nav next="/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/nodejs/write/" keepTab=true >}}

2
content/influxdb/cloud-dedicated/reference/influxql/math-operators.md
View File

@ -226,7 +226,7 @@ In each case, the constant you need can be calculated as `(2 ** width) - 1`.
### Mathematical operators with wildcards and regular expressions
InfluxQL does not support combining mathematical operations with a wildcard (`*`)
or [regular expression](/influxdb/cloud-serverless/query-data/influxql/regular-expressions/)
or [regular expression](/influxdb/cloud-dedicated/query-data/influxql/regular-expressions/)
in the `SELECT` clause.
The following queries are invalid and the output is an error:

4
content/influxdb/cloud-serverless/api-compatibility/v1/_index.md
View File

@ -457,8 +457,8 @@ Use one of the following values for timestamp precision:
- [`influx3` data CLI](https://github.com/InfluxCommunity/influxdb3-python-cli)
- [InfluxDB v3 client libraries](/influxdb/cloud-serverless/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-serverless/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-serverless/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-serverless/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)

6
content/influxdb/cloud-serverless/api-compatibility/v2/_index.md
View File

@ -176,7 +176,7 @@ To setup and start using interactive clients, see the [Get started](/influxdb/cl
InfluxDB [v3 client libraries](/influxdb/cloud-serverless/reference/client-libraries/v3/) and [v2 client libraries](/influxdb/cloud-serverless/reference/client-libraries/v2/) can write data to the InfluxDB v2 API `/api/v2/write` endpoint.
Client libraries are language-specific packages that integrate InfluxDB APIs with your application.
To setup and start using client libraries, see the [Get started](/influxdb/cloud-dedicated/get-started/) tutorial.
To setup and start using client libraries, see the [Get started](/influxdb/cloud-serverless/get-started/) tutorial.
## Query data
@ -194,8 +194,8 @@ InfluxDB v3 provides the following protocols for executing a query:
- [`influx3` data CLI](https://github.com/InfluxCommunity/influxdb3-python-cli)
- [InfluxDB v3 client libraries](/influxdb/cloud-serverless/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-serverless/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-serverless/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-serverless/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)

4
content/influxdb/cloud-serverless/get-started/query.md
View File

@ -48,8 +48,8 @@ The examples in this section of the tutorial query the [**get-started** bucket](
- [`influx3` data CLI](?t=influx3+CLI#execute-an-sql-query){{< req "\* " >}}
- [InfluxDB v3 client libraries](/influxdb/cloud-serverless/reference/client-libraries/v3/)
- [Flight SQL clients](?t=Go#execute-an-sql-query){{< req "\* " >}}
- [Superset](/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-serverless/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana/)
- [Chronograf](/{{< latest "Chronograf" >}}/)
- [InfluxDB HTTP API](?t=InfluxDB+API#execute-an-sql-query){{< req "\* " >}}
- [`influx` CLI](?t=influx+CLI#execute-an-sql-query){{< req "\* " >}}

97
content/influxdb/cloud-serverless/process-data/summarize.md Normal file
View File

@ -0,0 +1,97 @@
---
title: Summarize query results and data distribution
description: >
Query data stored in InfluxDB and use tools like pandas to summarize the results schema and distribution.
menu:
influxdb_cloud_serverless:
name: Summarize data
parent: Process data
weight: 101
influxdb/cloud-serverless/tags: [analysis, pandas, pyarrow, python, schema]
related:
- /influxdb/cloud-serverless/query-data/sql/execute-queries/python/
---
Query data stored in InfluxDB and use tools like pandas to summarize the results schema and distribution.
{{% note %}}
#### Sample data
The following examples use the sample data written in the
[Get started writing data guide](/influxdb/cloud-serverless/get-started/write/).
To run the example queries and return results,
[write the sample data](/influxdb/cloud-serverless/get-started/write/#write-line-protocol-to-influxdb)
to your {{% cloud-name %}} bucket before running the example queries.
{{% /note %}}
### View data information and statistics
#### Using Python and pandas
The following example uses the [InfluxDB client library for Python](/influxdb/cloud-serverless/reference/client-libraries/v3/python/) to query an {{% cloud-name %}} bucket,
and then uses pandas [`DataFrame.info()`](https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.info.html) and [`DataFrame.describe()`](https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.describe.html) methods to summarize the schema and distribution of the data.
1. In your editor, create a file (for example, `pandas-example.py`) and enter the following sample code:
<!-- tabs-wrapper allows code-placeholders to work when indented -->
{{% tabs-wrapper %}}
{{% code-placeholders "API_TOKEN|BUCKET_NAME" %}}
```py
# pandas-example.py
import influxdb_client_3 as InfluxDBClient3
import pandas
client = InfluxDBClient3.InfluxDBClient3(token='API_TOKEN',
host='cloud2.influxdata.com',
database='BUCKET_NAME',
org="",
write_options=SYNCHRONOUS)
table = client.query("select * from home where room like '%'")
dataframe = table.to_pandas()
# Print information about the results DataFrame,
# including the index dtype and columns, non-null values, and memory usage.
dataframe.info()
# Calculate descriptive statistics that summarize the distribution of the results.
print(dataframe.describe())
```
{{% /code-placeholders %}}
{{% /tabs-wrapper %}}
2. Enter the following command in your terminal to execute the file using the Python interpreter:
```sh
python pandas-example.py
```
The output is similar to the following:
```sh
<class 'pandas.core.frame.DataFrame'>
RangeIndex: 411 entries, 0 to 410
Data columns (total 8 columns):
# Column Non-Null Count Dtype
--- ------ -------------- -----
0 co 405 non-null float64
1 host 2 non-null object
2 hum 406 non-null float64
3 room 411 non-null object
4 sensor 1 non-null object
5 sensor_id 2 non-null object
6 temp 411 non-null float64
7 time 411 non-null datetime64[ns]
dtypes: datetime64[ns](1), float64(3), object(4)
memory usage: 25.8+ KB
co hum temp time
count 405.000000 406.000000 411.000000 411
mean 5.320988 35.860591 23.803893 2008-06-12 13:33:49.074302208
min 0.000000 20.200000 18.400000 1970-01-01 00:00:01.641024
25% 0.000000 35.900000 22.200000 1970-01-01 00:00:01.685054600
50% 1.000000 36.000000 22.500000 2023-03-21 05:46:40
75% 9.000000 36.300000 22.800000 2023-07-15 21:34:10
max 26.000000 80.000000 74.000000 2023-07-17 02:07:00
std 7.640154 3.318794 8.408807 NaN
```

7
content/influxdb/cloud-serverless/query-data/tools/_index.md → content/influxdb/cloud-serverless/process-data/tools/_index.md
View File

@ -1,15 +1,14 @@
---
title: Use analysis and visualization tools with InfluxDB Cloud Serverless APIs
title: Use analysis and visualization tools with InfluxDB Cloud Serverless
description: Use popular tools to analyze and visualize time series data stored in an InfluxDB Cloud Serverless bucket.
weight: 201
weight: 101
menu:
influxdb_cloud_serverless:
name: Analyze and visualize data
parent: Query data
parent: Process data
influxdb/cloud-serverless/tags: [analysis, visualization, tools]
aliases:
- /influxdb/cloud-serverless/visualize-data/
- /influxdb/cloud-serverless/process-data/
---
{{< children >}}

30
content/influxdb/cloud-serverless/process-data/tools/grafana.md Normal file
View File

@ -0,0 +1,30 @@
---
title: Use Grafana to query and visualize data
seotitle: Use Grafana to query and visualize data stored in InfluxDB
list_title: Grafana
description: >
Install and run [Grafana](https://grafana.com/) to query and visualize data
stored in InfluxDB.
weight: 101
menu:
influxdb_cloud_serverless:
name: Use Grafana
parent: Analyze and visualize data
identifier: visualize_with_grafana
influxdb/cloud-serverless/tags: [query, visualization, Grafana]
aliases:
- /influxdb/cloud-serverless/visualize-data/grafana/
related:
- /influxdb/cloud-serverless/query-data/sql/execute-queries/grafana/
alt_engine: /influxdb/cloud/tools/grafana/
---
Use [Grafana](https://grafana.com/) to query and visualize data stored in
{{% cloud-name %}}.
To get started with Grafana and InfluxDB, see [Use Grafana to query data](/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana/).
## Build visualizations with Grafana
For a comprehensive walk-through of creating visualizations with
Grafana, see the [Grafana documentation](https://grafana.com/docs/grafana/latest/).

35
content/influxdb/cloud-serverless/query-data/tools/pandas.md → content/influxdb/cloud-serverless/process-data/tools/pandas.md
View File

@ -1,5 +1,6 @@
---
title: Use pandas to analyze and visualize data
list_title: pandas
seotitle: Use Python and pandas to analyze and visualize data
description: >
Use the [pandas](https://pandas.pydata.org/) Python data analysis library
@ -9,23 +10,26 @@ menu:
influxdb_cloud_serverless:
parent: Analyze and visualize data
name: Use pandas
identifier: analyze-with-pandas
influxdb/cloud-serverless/tags: [analysis, pandas, pyarrow, python, visualization]
aliases:
- /influxdb/cloud-serverless/visualize-data/pandas/
- /influxdb/cloud-serverless/visualize-data/python/
related:
- /influxdb/cloud-serverless/query-data/tools/python/
- /influxdb/cloud-serverless/query-data/tools/pyarrow/
- /influxdb/cloud-serverless/query-data/sql/
- /influxdb/cloud-serverless/process-data/tools/pyarrow/
- /influxdb/cloud-serverless/query-data/sql/
list_code_example: |
```py
...
dataframe = reader.read_pandas()
dataframe = dataframe.set_index('time')
```py
...
dataframe = reader.read_pandas()
dataframe = dataframe.set_index('time')
print(dataframe.index)
print(dataframe.index)
resample = dataframe.resample("1H")
resample = dataframe.resample("1H")
resample['temp'].mean()
```
resample['temp'].mean()
```
---
Use [pandas](https://pandas.pydata.org/), the Python data analysis library, to process, analyze, and visualize data
@ -52,13 +56,13 @@ stored in an InfluxDB Cloud Serverless bucket.
The examples in this guide assume using a Python virtual environment and the Flight SQL library for Python.
Installing `flightsql-dbapi` also installs the [`pyarrow`](https://arrow.apache.org/docs/python/index.html) library that provides Python bindings for Apache Arrow.
For more information, see how to [get started querying InfluxDB with Python and flightsql-dbapi](/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/python/)
For more information, see how to [get started querying InfluxDB with Python and flightsql-dbapi](/influxdb/cloud-serverless/query-data/sql/execute-queries/python/)
## Install pandas
To use pandas, you need to install and import the `pandas` library.
In your terminal, use `pip` to install `pandas` in your active [Python virtual environment](/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/python/#create-a-project-virtual-environment):
In your terminal, use `pip` to install `pandas` in your active [Python virtual environment](/influxdb/cloud-serverless/query-data/sql/execute-queries/python/#create-a-project-virtual-environment):
```sh
pip install pandas
@ -136,10 +140,11 @@ reader = client.do_get(info.endpoints[0].ticket)
dataframe = reader.read_pandas()
# Print a summary of the DataFrame to stdout
# Print information about the results DataFrame,
# including the index dtype and columns, non-null values, and memory usage.
dataframe.info()
# Calculate summary statistics for the data
# Calculate descriptive statistics that summarize the distribution of the results.
print(dataframe.describe())
```

11
content/influxdb/cloud-serverless/query-data/tools/pyarrow.md → content/influxdb/cloud-serverless/process-data/tools/pyarrow.md
View File

@ -1,5 +1,6 @@
---
title: Use the PyArrow library to analyze data
list_title: PyArrow
description: >
Use [PyArrow](https://arrow.apache.org/docs/python/) to read and analyze
InfluxDB query results from InfluxDB Cloud Serverless.
@ -8,11 +9,13 @@ menu:
influxdb_cloud_serverless:
parent: Analyze and visualize data
name: Use PyArrow
identifier: analyze-with-pyarrow
influxdb/cloud-serverless/tags: [analysis, arrow, pyarrow, python]
aliases:
- /influxdb/cloud-serverless/visualize-data/pyarrow/
related:
- /influxdb/cloud-serverless/query-data/tools/pandas/
- /influxdb/cloud-serverless/query-data/tools/pyarrow/
- /influxdb/cloud-serverless/query-data/sql/
- /influxdb/cloud-serverless/process-data/tools/pandas/
- /influxdb/cloud-serverless/query-data/sql/
list_code_example: |
```py
...
@ -43,7 +46,7 @@ The PyArrow library provides efficient computation, aggregation, serialization,
## Install prerequisites
The examples in this guide assume using a Python virtual environment and the Flight SQL library for Python.
For more information, see how to [get started using Python to query InfluxDB](/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/python/)
For more information, see how to [get started using Python to query InfluxDB](/influxdb/cloud-serverless/query-data/sql/execute-queries/python/)
Installing `flightsql-dbapi` also installs the [`pyarrow`](https://arrow.apache.org/docs/python/index.html) library that provides Python bindings for Apache Arrow.

7
content/influxdb/cloud-serverless/query-data/tools/superset.md → content/influxdb/cloud-serverless/process-data/tools/superset.md
View File

@ -10,12 +10,12 @@ menu:
influxdb_cloud_serverless:
parent: Analyze and visualize data
name: Use Superset
identifier: visualize_with_superset
identifier: visualize-with-superset
influxdb/cloud-serverless/tags: [query, visualization]
aliases:
- /influxdb/cloud-serverless/visualize-data/superset/
related:
- /influxdb/cloud-serverless/query-data/execute-queries/flight-sql/superset/
- /influxdb/cloud-serverless/query-data/sql/execute-queries/superset/
---
Use [Apache Superset](https://superset.apache.org/) to query and visualize data
@ -28,7 +28,8 @@ stored in an InfluxDB Cloud Serverless bucket.
>
> {{% caption %}}[Apache Superset documentation](https://superset.apache.org/docs/intro){{% /caption %}}
To get started with Superset and InfluxDB, see [Use Superset to query data](/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/superset/).
To get started with Superset and InfluxDB, see [Use Superset to query data](/influxdb/cloud-serverless/query-data/sql/execute-queries/superset/).
## Build visualizations with Superset
Use Superset to create visualizations and dashboards for InfluxDB IOx queries.

33
content/influxdb/cloud-serverless/process-data/tools/tableau.md Normal file
View File

@ -0,0 +1,33 @@
---
title: Use Tableau to visualize data
seotitle: Use Tableau to visualize data stored in InfluxDB
list_title: Tableau
description: >
Use [Tableau](https://www.tableau.com/) to query, analyze, and visualize data
stored in an InfluxDB database.
weight: 101
menu:
influxdb_cloud_serverless:
parent: Analyze and visualize data
name: Use Tableau
identifier: visualize-with-tableau
influxdb/cloud-serverless/tags: [query, visualization, Tableau]
aliases:
- /influxdb/cloud-serverless/visualize-data/tableau/
related:
- /influxdb/cloud-serverless/query-data/sql/execute-queries/tableau/
---
Use [Tableau](https://www.tableau.com/) to query, analyze, and visualize data
stored in an InfluxDB database.
> Tableau is a visual analytics platform transforming the way we use data to
> solve problems—empowering people and organizations to make the most of their data.
>
> {{% cite %}}[tableau.com](https://www.tableau.com/why-tableau/what-is-tableau){{% /cite %}}
To get started connecting to InfluxDB as a Tableau data source, see [Use Tableau to query data with SQL](/influxdb/cloud-serverless/query-data/execute-queries/sql/tableau/).
## Build visualizations with Tableau
After you've connected Tableau to your InfluxDB database, see the Tableau documentation to [Set Up Data Sources](https://help.tableau.com/current/pro/desktop/en-us/datasource_prepare.htm) and begin working with data.

8
content/influxdb/cloud-serverless/query-data/influxql/execute-queries/python.md
View File

@ -11,8 +11,8 @@ menu:
identifier: query-with-python-influxql
influxdb/cloud-serverless/tags: [query, influxql, python]
related:
- /influxdb/cloud-serverless/query-data/tools/pandas/
- /influxdb/cloud-serverless/query-data/tools/pyarrow/
- /influxdb/cloud-serverless/process-data/tools/pandas/
- /influxdb/cloud-serverless/process-data/tools/pyarrow/
- /influxdb/cloud-serverless/reference/influxql/
list_code_example: |
```py
@ -293,5 +293,5 @@ print(table.to_pandas().to_markdown())
Next, learn how to use Python tools to work with time series data:
- [Use PyArrow](/influxdb/cloud-serverless/query-data/tools/pyarrow/)
- [Use pandas](/influxdb/cloud-serverless/query-data/tools/pandas/)
- [Use PyArrow](/influxdb/cloud-serverless/process-data/tools/pyarrow/)
- [Use pandas](/influxdb/cloud-serverless/process-data/tools/pandas/)

1
content/influxdb/cloud-serverless/query-data/sql/execute-queries/_index.md
View File

@ -11,6 +11,7 @@ menu:
influxdb/cloud-serverless/tags: [query]
aliases:
- /influxdb/cloud-serverless/query-data/execute-queries/
- /influxdb/cloud-serverless/query-data/tools/
---
The InfluxDB SQL implementation uses [Arrow DataFusion](https://arrow.apache.org/datafusion/)

14
content/influxdb/cloud-serverless/query-data/tools/grafana.md → content/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana.md
View File

@ -1,19 +1,19 @@
---
title: Use Grafana to query and visualize data
seotitle: Use Grafana to query and visualize data stored in InfluxDB
list_title: Use Grafana
title: Use Grafana to query data
seotitle: Use Grafana to query data stored in InfluxDB
list_title: Grafana
description: >
Install and run [Grafana](https://grafana.com/) to query and visualize data
Install and run [Grafana](https://grafana.com/) to query data
stored in InfluxDB.
weight: 101
menu:
influxdb_cloud_serverless:
name: Use Grafana
parent: Analyze and visualize data
influxdb/cloud-serverless/tags: [query, visualization]
parent: Execute SQL queries
identifier: query-with-grafana-sql
influxdb/cloud-serverless/tags: [query, visualization, Grafana]
aliases:
- /influxdb/cloud-serverless/query-data/tools/grafana/
alt_engine: /influxdb/cloud/tools/grafana/
---
Use [Grafana](https://grafana.com/) to query and visualize data stored in

4
content/influxdb/cloud-serverless/query-data/sql/execute-queries/java.md
View File

@ -11,9 +11,9 @@ menu:
identifier: query_with_java
influxdb/cloud-serverless/tags: [query, flightsql, java]
aliases:
- /influxdb/cloud-serverless/query-data/execute-queries/flight-sql/java/
- /influxdb/cloud-serverless/query-data/tools/java/
related:
- /influxdb/cloud-serverless/query-data/sql/
- /influxdb/cloud-serverless/query-data/sql/
list_code_example: |
```java
public class Query {

10
content/influxdb/cloud-serverless/query-data/sql/execute-queries/python.md
View File

@ -10,10 +10,10 @@ menu:
identifier: query-with-python-sql
influxdb/cloud-serverless/tags: [query, flightsql, python, sql]
aliases:
- content/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/python/
- /influxdb/cloud-serverless/query-data/tools/python/
related:
- /influxdb/cloud-serverless/query-data/tools/pandas/
- /influxdb/cloud-serverless/query-data/tools/pyarrow/
- /influxdb/cloud-serverless/process-data/tools/pandas/
- /influxdb/cloud-serverless/process-data/tools/pyarrow/
- /influxdb/cloud-serverless/query-data/sql/
list_code_example: |
```py
@ -282,5 +282,5 @@ print(table.to_pandas().to_markdown())
Next, learn how to use Python tools to work with time series data:
- [Use PyArrow](/influxdb/cloud-serverless/query-data/tools/pyarrow/)
- [Use pandas](/influxdb/cloud-serverless/query-data/tools/pandas/)
- [Use PyArrow](/influxdb/cloud-serverless/process-data/tools/pyarrow/)
- [Use pandas](/influxdb/cloud-serverless/process-data/tools/pandas/)

6
content/influxdb/cloud-serverless/query-data/sql/execute-queries/superset.md
View File

@ -12,7 +12,7 @@ menu:
identifier: query_with_superset
influxdb/cloud-serverless/tags: [query, flightsql, superset]
aliases:
- content/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/superset/
- /influxdb/cloud-serverless/query-data/tools/superset/
related:
- /influxdb/cloud-serverless/visualize-data/superset/
---
@ -30,8 +30,8 @@ stored in an InfluxDB Cloud Serverless bucket.
<!-- TOC -->
- [Set up Docker for Superset and Flight SQL](#set-up-docker-for-superset-and-flight-sql)
- [Install prerequisites for Superset and Flight SQL](#install-prerequisites-for-superset-and-flight-sql)
- [Set up Docker for Superset](#set-up-docker-for-superset)
- [Install prerequisites for Superset and Flight SQL](#install-prerequisites-for-superset-and-flight-sql)
- [Set up Docker for Superset](#set-up-docker-for-superset)
- [Start the Superset Docker containers](#start-the-superset-docker-containers)
- [Log in to Superset](#log-in-to-superset)
- [Create a database connection for InfluxDB](#create-a-database-connection-for-influxdb)

2
content/influxdb/cloud-serverless/reference/client-libraries/v2/go.md
View File

@ -20,7 +20,7 @@ integrates with Go applications to write data to an {{% cloud-name %}} bucket.
InfluxDB v2 client libraries use the InfluxDB API `/api/v2/query` endpoint.
This endpoint can't query an {{% cloud-name %}} cluster.
Use the [InfluxDB v3 Go client library](/influxdb/cloud-dedicated/reference/client-libraries/v3/go/)
Use the [InfluxDB v3 Go client library](/influxdb/cloud-serverless/reference/client-libraries/v3/go/)
to write and query data stored in {{% cloud-name %}}.
{{% /note %}}

4
content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/_index.md
View File

@ -29,8 +29,8 @@ This endpoint can't query an {{% cloud-name %}} cluster.
- [`influx3` data CLI](https://github.com/InfluxCommunity/influxdb3-python-cli)
- [InfluxDB v3 client libraries](/influxdb/cloud-serverless/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-serverless/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-serverless/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-serverless/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)

4
content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/browser.md
View File

@ -31,8 +31,8 @@ This endpoint can't query an {{% cloud-name %}} cluster.
- [InfluxDB v3 client libraries](/influxdb/cloud-serverless/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-serverless/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-serverless/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/tools/grafana/)
- [Superset](/influxdb/cloud-serverless/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-serverless/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)

10
content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/nodejs/_index.md
View File

@ -29,11 +29,11 @@ This endpoint can't query an {{% cloud-name %}} cluster.
{{% cloud-name %}} supports many different tools for querying data, including:
- [InfluxDB v3 client libraries](/influxdb/cloud-dedicated/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-dedicated/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/tools/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-dedicated/primers/api/v1/#query-using-the-v1-api)
- [InfluxDB v3 client libraries](/influxdb/cloud-serverless/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-serverless/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-serverless/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-serverless/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)
{{% /note %}}

10
content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/nodejs/install.md
View File

@ -23,11 +23,11 @@ This endpoint can't query an {{% cloud-name %}} cluster.
{{% cloud-name %}} supports many different tools for querying data, including:
- [InfluxDB v3 client libraries](/influxdb/cloud-dedicated/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-dedicated/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-dedicated/query-data/execute-queries/flight-sql/superset/)
- [Grafana](/influxdb/cloud-dedicated/query-data/tools/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-dedicated/primers/api/v1/#query-using-the-v1-api)
- [InfluxDB v3 client libraries](/influxdb/cloud-serverless/reference/client-libraries/v3/)
- [Flight clients](/influxdb/cloud-serverless/reference/client-libraries/flight-sql/)
- [Superset](/influxdb/cloud-serverless/query-data/sql/execute-queries/superset/)
- [Grafana](/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana/)
- [InfluxQL with InfluxDB v1 HTTP API](/influxdb/cloud-serverless/primers/api/v1/#query-using-the-v1-api)
- [Chronograf](/{{< latest "Chronograf" >}}/)
{{% /note %}}

2
content/influxdb/cloud-serverless/reference/client-libraries/v2/python.md
View File

@ -112,4 +112,4 @@ write_api.write(bucket=bucket, org=org, record=p)
## Query data from InfluxDB with Python
To use query your InfluxDB Cloud Serverless bucket, use a Python [Flight SQL client with gRPC](/influxdb/cloud-dedicated/reference/client-libraries/flight-sql/).
To query your {{% cloud-name %}} bucket, use the [Python client library for InfluxDB v3](/influxdb/cloud-serverless/reference/client-libraries/v3/python/).

2
content/influxdb/cloud-serverless/reference/client-libraries/v3/python.md
View File

@ -281,7 +281,7 @@ following _point_ data structure:
- **measurement** (str): the measurement name
- **tags** (dict): a dictionary of tag key-value pairs
- **fields** (dict): a dictionary of field key-value pairs
- **time**: the [timestamp](/influxdb/cloud-dedicated/reference/glossary/#timestamp) for the record
- **time**: the [timestamp](/influxdb/cloud-serverless/reference/glossary/#timestamp) for the record
The following example shows how to define a `dict` that represents a point, and then write the
data to InfluxDB.