From 28e3a809fe7c342635c8cb79b0e7d4a40b802c01 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Thu, 6 Jul 2023 12:39:02 -0500 Subject: [PATCH] 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 --- .../api-compatibility/v1/_index.md | 4 +- .../api-compatibility/v2/_index.md | 4 +- .../cloud-dedicated/get-started/query.md | 4 +- .../cloud-dedicated/process-data/_index.md | 2 +- .../cloud-dedicated/process-data/summarize.md | 97 +++++++ .../tools/_index.md | 6 +- .../process-data/tools/grafana.md | 28 ++ .../tools/pandas.md | 13 +- .../tools/pyarrow.md | 8 +- .../tools/superset.md | 4 +- .../process-data/tools/tableau.md | 33 +++ .../influxql/execute-queries/grafana.md | 251 ++++++++++++++++++ .../influxql/execute-queries/python.md | 8 +- .../query-data/sql/execute-queries/_index.md | 1 + .../{tools => sql/execute-queries}/grafana.md | 12 +- .../query-data/sql/execute-queries/python.md | 12 +- .../sql/execute-queries/superset.md | 4 +- .../query-data/sql/execute-queries/tableau.md | 7 +- .../reference/client-libraries/v2/_index.md | 4 +- .../client-libraries/v2/javascript/_index.md | 4 +- .../client-libraries/v2/javascript/browser.md | 4 +- .../v2/javascript/nodejs/_index.md | 4 +- .../v2/javascript/nodejs/install.md | 16 +- .../reference/influxql/math-operators.md | 2 +- .../api-compatibility/v1/_index.md | 4 +- .../api-compatibility/v2/_index.md | 6 +- .../cloud-serverless/get-started/query.md | 4 +- .../process-data/summarize.md | 97 +++++++ .../tools/_index.md | 7 +- .../process-data/tools/grafana.md | 30 +++ .../tools/pandas.md | 35 +-- .../tools/pyarrow.md | 11 +- .../tools/superset.md | 7 +- .../process-data/tools/tableau.md | 33 +++ .../influxql/execute-queries/python.md | 8 +- .../query-data/sql/execute-queries/_index.md | 1 + .../{tools => sql/execute-queries}/grafana.md | 14 +- .../query-data/sql/execute-queries/java.md | 4 +- .../query-data/sql/execute-queries/python.md | 10 +- .../sql/execute-queries/superset.md | 6 +- .../reference/client-libraries/v2/go.md | 2 +- .../client-libraries/v2/javascript/_index.md | 4 +- .../client-libraries/v2/javascript/browser.md | 4 +- .../v2/javascript/nodejs/_index.md | 10 +- .../v2/javascript/nodejs/install.md | 10 +- .../reference/client-libraries/v2/python.md | 2 +- .../reference/client-libraries/v3/python.md | 2 +- 47 files changed, 717 insertions(+), 126 deletions(-) create mode 100644 content/influxdb/cloud-dedicated/process-data/summarize.md rename content/influxdb/cloud-dedicated/{query-data => process-data}/tools/_index.md (74%) create mode 100644 content/influxdb/cloud-dedicated/process-data/tools/grafana.md rename content/influxdb/cloud-dedicated/{query-data => process-data}/tools/pandas.md (94%) rename content/influxdb/cloud-dedicated/{query-data => process-data}/tools/pyarrow.md (96%) rename content/influxdb/cloud-dedicated/{query-data => process-data}/tools/superset.md (93%) create mode 100644 content/influxdb/cloud-dedicated/process-data/tools/tableau.md create mode 100644 content/influxdb/cloud-dedicated/query-data/influxql/execute-queries/grafana.md rename content/influxdb/cloud-dedicated/query-data/{tools => sql/execute-queries}/grafana.md (95%) create mode 100644 content/influxdb/cloud-serverless/process-data/summarize.md rename content/influxdb/cloud-serverless/{query-data => process-data}/tools/_index.md (80%) create mode 100644 content/influxdb/cloud-serverless/process-data/tools/grafana.md rename content/influxdb/cloud-serverless/{query-data => process-data}/tools/pandas.md (89%) rename content/influxdb/cloud-serverless/{query-data => process-data}/tools/pyarrow.md (93%) rename content/influxdb/cloud-serverless/{query-data => process-data}/tools/superset.md (88%) create mode 100644 content/influxdb/cloud-serverless/process-data/tools/tableau.md rename content/influxdb/cloud-serverless/query-data/{tools => sql/execute-queries}/grafana.md (94%) diff --git a/content/influxdb/cloud-dedicated/api-compatibility/v1/_index.md b/content/influxdb/cloud-dedicated/api-compatibility/v1/_index.md index 73e51d40c..77532bcca 100644 --- a/content/influxdb/cloud-dedicated/api-compatibility/v1/_index.md +++ b/content/influxdb/cloud-dedicated/api-compatibility/v1/_index.md @@ -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" >}}/) diff --git a/content/influxdb/cloud-dedicated/api-compatibility/v2/_index.md b/content/influxdb/cloud-dedicated/api-compatibility/v2/_index.md index 8b37e80ce..3d7311caa 100644 --- a/content/influxdb/cloud-dedicated/api-compatibility/v2/_index.md +++ b/content/influxdb/cloud-dedicated/api-compatibility/v2/_index.md @@ -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" >}}/) diff --git a/content/influxdb/cloud-dedicated/get-started/query.md b/content/influxdb/cloud-dedicated/get-started/query.md index 09c3af7c6..855e2c8a4 100644 --- a/content/influxdb/cloud-dedicated/get-started/query.md +++ b/content/influxdb/cloud-dedicated/get-started/query.md @@ -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" >}}/) diff --git a/content/influxdb/cloud-dedicated/process-data/_index.md b/content/influxdb/cloud-dedicated/process-data/_index.md index 4ae6e0124..be5e7e0d6 100644 --- a/content/influxdb/cloud-dedicated/process-data/_index.md +++ b/content/influxdb/cloud-dedicated/process-data/_index.md @@ -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 >}} \ No newline at end of file diff --git a/content/influxdb/cloud-dedicated/process-data/summarize.md b/content/influxdb/cloud-dedicated/process-data/summarize.md new file mode 100644 index 000000000..a5b2a8bac --- /dev/null +++ b/content/influxdb/cloud-dedicated/process-data/summarize.md @@ -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 %}} +{{% 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 + + 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 + ``` diff --git a/content/influxdb/cloud-dedicated/query-data/tools/_index.md b/content/influxdb/cloud-dedicated/process-data/tools/_index.md similarity index 74% rename from content/influxdb/cloud-dedicated/query-data/tools/_index.md rename to content/influxdb/cloud-dedicated/process-data/tools/_index.md index 6d4d82461..cb0bdf629 100644 --- a/content/influxdb/cloud-dedicated/query-data/tools/_index.md +++ b/content/influxdb/cloud-dedicated/process-data/tools/_index.md @@ -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/ diff --git a/content/influxdb/cloud-dedicated/process-data/tools/grafana.md b/content/influxdb/cloud-dedicated/process-data/tools/grafana.md new file mode 100644 index 000000000..ef8de2839 --- /dev/null +++ b/content/influxdb/cloud-dedicated/process-data/tools/grafana.md @@ -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/). diff --git a/content/influxdb/cloud-dedicated/query-data/tools/pandas.md b/content/influxdb/cloud-dedicated/process-data/tools/pandas.md similarity index 94% rename from content/influxdb/cloud-dedicated/query-data/tools/pandas.md rename to content/influxdb/cloud-dedicated/process-data/tools/pandas.md index a7109b91a..c1e2a953f 100644 --- a/content/influxdb/cloud-dedicated/query-data/tools/pandas.md +++ b/content/influxdb/cloud-dedicated/process-data/tools/pandas.md @@ -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()) ``` diff --git a/content/influxdb/cloud-dedicated/query-data/tools/pyarrow.md b/content/influxdb/cloud-dedicated/process-data/tools/pyarrow.md similarity index 96% rename from content/influxdb/cloud-dedicated/query-data/tools/pyarrow.md rename to content/influxdb/cloud-dedicated/process-data/tools/pyarrow.md index bc779fa06..456dc273e 100644 --- a/content/influxdb/cloud-dedicated/query-data/tools/pyarrow.md +++ b/content/influxdb/cloud-dedicated/process-data/tools/pyarrow.md @@ -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 ... diff --git a/content/influxdb/cloud-dedicated/query-data/tools/superset.md b/content/influxdb/cloud-dedicated/process-data/tools/superset.md similarity index 93% rename from content/influxdb/cloud-dedicated/query-data/tools/superset.md rename to content/influxdb/cloud-dedicated/process-data/tools/superset.md index 62cbe3765..ee706ac8c 100644 --- a/content/influxdb/cloud-dedicated/query-data/tools/superset.md +++ b/content/influxdb/cloud-dedicated/process-data/tools/superset.md @@ -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 diff --git a/content/influxdb/cloud-dedicated/process-data/tools/tableau.md b/content/influxdb/cloud-dedicated/process-data/tools/tableau.md new file mode 100644 index 000000000..bee155ba5 --- /dev/null +++ b/content/influxdb/cloud-dedicated/process-data/tools/tableau.md @@ -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. diff --git a/content/influxdb/cloud-dedicated/query-data/influxql/execute-queries/grafana.md b/content/influxdb/cloud-dedicated/query-data/influxql/execute-queries/grafana.md new file mode 100644 index 000000000..61f728a8f --- /dev/null +++ b/content/influxdb/cloud-dedicated/query-data/influxql/execute-queries/grafana.md @@ -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 %}} + + + +- [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) + + + +## 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 %}} + + +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**. + + +{{% /tab-content %}} +{{% tab-content %}} + + +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. + + +{{% /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 %}} + + +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. + + +{{% /tab-content %}} +{{% tab-content %}} + + +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" />}} + + + +{{% /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 %}} + + +{{% 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. + + +{{% /tab-content %}} +{{% tab-content %}} + + +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. + + +{{% /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/). diff --git a/content/influxdb/cloud-dedicated/query-data/influxql/execute-queries/python.md b/content/influxdb/cloud-dedicated/query-data/influxql/execute-queries/python.md index 989da072a..5dd6f2e5b 100644 --- a/content/influxdb/cloud-dedicated/query-data/influxql/execute-queries/python.md +++ b/content/influxdb/cloud-dedicated/query-data/influxql/execute-queries/python.md @@ -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/) diff --git a/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/_index.md b/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/_index.md index c9c7404ec..ece5ee048 100644 --- a/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/_index.md +++ b/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/_index.md @@ -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/) diff --git a/content/influxdb/cloud-dedicated/query-data/tools/grafana.md b/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana.md similarity index 95% rename from content/influxdb/cloud-dedicated/query-data/tools/grafana.md rename to content/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana.md index 253fb1713..3e4a1dbfc 100644 --- a/content/influxdb/cloud-dedicated/query-data/tools/grafana.md +++ b/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/grafana.md @@ -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/) diff --git a/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/python.md b/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/python.md index dfd774761..b40b181ea 100644 --- a/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/python.md +++ b/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/python.md @@ -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/) diff --git a/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset.md b/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset.md index 1573a1cd9..3857b2f67 100644 --- a/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset.md +++ b/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/superset.md @@ -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/ --- diff --git a/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/tableau.md b/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/tableau.md index 88b574261..3a0f1cf49 100644 --- a/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/tableau.md +++ b/content/influxdb/cloud-dedicated/query-data/sql/execute-queries/tableau.md @@ -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 diff --git a/content/influxdb/cloud-dedicated/reference/client-libraries/v2/_index.md b/content/influxdb/cloud-dedicated/reference/client-libraries/v2/_index.md index 04ae24cb2..c4d7a8a75 100644 --- a/content/influxdb/cloud-dedicated/reference/client-libraries/v2/_index.md +++ b/content/influxdb/cloud-dedicated/reference/client-libraries/v2/_index.md @@ -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" >}}/) diff --git a/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/_index.md b/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/_index.md index c27c81deb..e157a9f91 100644 --- a/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/_index.md +++ b/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/_index.md @@ -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" >}}/) diff --git a/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/browser.md b/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/browser.md index 2c6543064..59cab504c 100644 --- a/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/browser.md +++ b/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/browser.md @@ -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" >}}/) diff --git a/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/nodejs/_index.md b/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/nodejs/_index.md index 575629106..37a1ab360 100644 --- a/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/nodejs/_index.md +++ b/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/nodejs/_index.md @@ -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" >}}/) diff --git a/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/nodejs/install.md b/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/nodejs/install.md index a07b084ab..e212a4dc2 100644 --- a/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/nodejs/install.md +++ b/content/influxdb/cloud-dedicated/reference/client-libraries/v2/javascript/nodejs/install.md @@ -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 >}} diff --git a/content/influxdb/cloud-dedicated/reference/influxql/math-operators.md b/content/influxdb/cloud-dedicated/reference/influxql/math-operators.md index 7d1cab8d0..441c88cea 100644 --- a/content/influxdb/cloud-dedicated/reference/influxql/math-operators.md +++ b/content/influxdb/cloud-dedicated/reference/influxql/math-operators.md @@ -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: diff --git a/content/influxdb/cloud-serverless/api-compatibility/v1/_index.md b/content/influxdb/cloud-serverless/api-compatibility/v1/_index.md index 02de696df..aaf43da80 100644 --- a/content/influxdb/cloud-serverless/api-compatibility/v1/_index.md +++ b/content/influxdb/cloud-serverless/api-compatibility/v1/_index.md @@ -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" >}}/) diff --git a/content/influxdb/cloud-serverless/api-compatibility/v2/_index.md b/content/influxdb/cloud-serverless/api-compatibility/v2/_index.md index c897bddb2..f16b051e5 100644 --- a/content/influxdb/cloud-serverless/api-compatibility/v2/_index.md +++ b/content/influxdb/cloud-serverless/api-compatibility/v2/_index.md @@ -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" >}}/) diff --git a/content/influxdb/cloud-serverless/get-started/query.md b/content/influxdb/cloud-serverless/get-started/query.md index ea9ed9139..ec589363e 100644 --- a/content/influxdb/cloud-serverless/get-started/query.md +++ b/content/influxdb/cloud-serverless/get-started/query.md @@ -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 "\* " >}} diff --git a/content/influxdb/cloud-serverless/process-data/summarize.md b/content/influxdb/cloud-serverless/process-data/summarize.md new file mode 100644 index 000000000..32876b209 --- /dev/null +++ b/content/influxdb/cloud-serverless/process-data/summarize.md @@ -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 %}} +{{% 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 + + 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 + ``` diff --git a/content/influxdb/cloud-serverless/query-data/tools/_index.md b/content/influxdb/cloud-serverless/process-data/tools/_index.md similarity index 80% rename from content/influxdb/cloud-serverless/query-data/tools/_index.md rename to content/influxdb/cloud-serverless/process-data/tools/_index.md index 589809461..63fc13862 100644 --- a/content/influxdb/cloud-serverless/query-data/tools/_index.md +++ b/content/influxdb/cloud-serverless/process-data/tools/_index.md @@ -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 >}} diff --git a/content/influxdb/cloud-serverless/process-data/tools/grafana.md b/content/influxdb/cloud-serverless/process-data/tools/grafana.md new file mode 100644 index 000000000..fc9b53956 --- /dev/null +++ b/content/influxdb/cloud-serverless/process-data/tools/grafana.md @@ -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/). diff --git a/content/influxdb/cloud-serverless/query-data/tools/pandas.md b/content/influxdb/cloud-serverless/process-data/tools/pandas.md similarity index 89% rename from content/influxdb/cloud-serverless/query-data/tools/pandas.md rename to content/influxdb/cloud-serverless/process-data/tools/pandas.md index e8f2508c8..588c997c7 100644 --- a/content/influxdb/cloud-serverless/query-data/tools/pandas.md +++ b/content/influxdb/cloud-serverless/process-data/tools/pandas.md @@ -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()) ``` diff --git a/content/influxdb/cloud-serverless/query-data/tools/pyarrow.md b/content/influxdb/cloud-serverless/process-data/tools/pyarrow.md similarity index 93% rename from content/influxdb/cloud-serverless/query-data/tools/pyarrow.md rename to content/influxdb/cloud-serverless/process-data/tools/pyarrow.md index 5e0069f31..f489b5d20 100644 --- a/content/influxdb/cloud-serverless/query-data/tools/pyarrow.md +++ b/content/influxdb/cloud-serverless/process-data/tools/pyarrow.md @@ -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. diff --git a/content/influxdb/cloud-serverless/query-data/tools/superset.md b/content/influxdb/cloud-serverless/process-data/tools/superset.md similarity index 88% rename from content/influxdb/cloud-serverless/query-data/tools/superset.md rename to content/influxdb/cloud-serverless/process-data/tools/superset.md index d4625651e..945c9a517 100644 --- a/content/influxdb/cloud-serverless/query-data/tools/superset.md +++ b/content/influxdb/cloud-serverless/process-data/tools/superset.md @@ -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. diff --git a/content/influxdb/cloud-serverless/process-data/tools/tableau.md b/content/influxdb/cloud-serverless/process-data/tools/tableau.md new file mode 100644 index 000000000..e43ea8f47 --- /dev/null +++ b/content/influxdb/cloud-serverless/process-data/tools/tableau.md @@ -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. diff --git a/content/influxdb/cloud-serverless/query-data/influxql/execute-queries/python.md b/content/influxdb/cloud-serverless/query-data/influxql/execute-queries/python.md index 34e3dc571..6ad17a217 100644 --- a/content/influxdb/cloud-serverless/query-data/influxql/execute-queries/python.md +++ b/content/influxdb/cloud-serverless/query-data/influxql/execute-queries/python.md @@ -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/) diff --git a/content/influxdb/cloud-serverless/query-data/sql/execute-queries/_index.md b/content/influxdb/cloud-serverless/query-data/sql/execute-queries/_index.md index c7d0214e9..3dc177dd2 100644 --- a/content/influxdb/cloud-serverless/query-data/sql/execute-queries/_index.md +++ b/content/influxdb/cloud-serverless/query-data/sql/execute-queries/_index.md @@ -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/) diff --git a/content/influxdb/cloud-serverless/query-data/tools/grafana.md b/content/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana.md similarity index 94% rename from content/influxdb/cloud-serverless/query-data/tools/grafana.md rename to content/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana.md index f26dac900..780a3f4af 100644 --- a/content/influxdb/cloud-serverless/query-data/tools/grafana.md +++ b/content/influxdb/cloud-serverless/query-data/sql/execute-queries/grafana.md @@ -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 diff --git a/content/influxdb/cloud-serverless/query-data/sql/execute-queries/java.md b/content/influxdb/cloud-serverless/query-data/sql/execute-queries/java.md index 3d4e3821e..e7058283f 100644 --- a/content/influxdb/cloud-serverless/query-data/sql/execute-queries/java.md +++ b/content/influxdb/cloud-serverless/query-data/sql/execute-queries/java.md @@ -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 { diff --git a/content/influxdb/cloud-serverless/query-data/sql/execute-queries/python.md b/content/influxdb/cloud-serverless/query-data/sql/execute-queries/python.md index eeb17c799..eb8e60d2c 100644 --- a/content/influxdb/cloud-serverless/query-data/sql/execute-queries/python.md +++ b/content/influxdb/cloud-serverless/query-data/sql/execute-queries/python.md @@ -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/) diff --git a/content/influxdb/cloud-serverless/query-data/sql/execute-queries/superset.md b/content/influxdb/cloud-serverless/query-data/sql/execute-queries/superset.md index fc408a13c..bba658c22 100644 --- a/content/influxdb/cloud-serverless/query-data/sql/execute-queries/superset.md +++ b/content/influxdb/cloud-serverless/query-data/sql/execute-queries/superset.md @@ -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. - [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) diff --git a/content/influxdb/cloud-serverless/reference/client-libraries/v2/go.md b/content/influxdb/cloud-serverless/reference/client-libraries/v2/go.md index b8ffdaf79..c9001dfda 100644 --- a/content/influxdb/cloud-serverless/reference/client-libraries/v2/go.md +++ b/content/influxdb/cloud-serverless/reference/client-libraries/v2/go.md @@ -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 %}} diff --git a/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/_index.md b/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/_index.md index d0c27420f..1d8ce893a 100644 --- a/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/_index.md +++ b/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/_index.md @@ -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" >}}/) diff --git a/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/browser.md b/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/browser.md index be34dbb49..9b41adbd6 100644 --- a/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/browser.md +++ b/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/browser.md @@ -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" >}}/) diff --git a/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/nodejs/_index.md b/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/nodejs/_index.md index 74ca1d6bb..b93c2ae2c 100644 --- a/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/nodejs/_index.md +++ b/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/nodejs/_index.md @@ -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 %}} diff --git a/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/nodejs/install.md b/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/nodejs/install.md index 9d0753d88..7e2f9dc46 100644 --- a/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/nodejs/install.md +++ b/content/influxdb/cloud-serverless/reference/client-libraries/v2/javascript/nodejs/install.md @@ -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 %}} diff --git a/content/influxdb/cloud-serverless/reference/client-libraries/v2/python.md b/content/influxdb/cloud-serverless/reference/client-libraries/v2/python.md index e583faf27..2cb7225d9 100644 --- a/content/influxdb/cloud-serverless/reference/client-libraries/v2/python.md +++ b/content/influxdb/cloud-serverless/reference/client-libraries/v2/python.md @@ -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/). diff --git a/content/influxdb/cloud-serverless/reference/client-libraries/v3/python.md b/content/influxdb/cloud-serverless/reference/client-libraries/v3/python.md index 632ddcc74..e1a67ec6e 100644 --- a/content/influxdb/cloud-serverless/reference/client-libraries/v3/python.md +++ b/content/influxdb/cloud-serverless/reference/client-libraries/v3/python.md @@ -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.