Documentation

InfluxDB Cloud Serverless

Execute queries

Use tools and libraries to query data stored in an InfluxDB Cloud Serverless bucket.

InfluxDB v3 supports the following APIs and languages for querying data:

  • Flight+RPC with SQL or InfluxQL. Use InfluxDB client libraries and Flight+RPC clients to query with SQL or InfluxQL and retrieve data in Arrow in-memory format.
  • Flight SQL with SQL or InfluxQL. Use Flight SQL clients to query with SQL or InfluxQL and retrieve data in Arrow in-memory format.
  • HTTP /query endpoint for InfluxDB v1 compatibility when you bring workloads and code from v1.x to v3. Use the /query endpoint with InfluxQL and tools such as Telegraf, HTTP clients, and InfluxDB v1 client libraries to query and retrieve data in JSON or CSV format.

/api/v2/query endpoint can’t query InfluxDB v3

InfluxDB Cloud Serverless doesn’t support the InfluxDB v2 HTTP /api/v2/query endpoint and isn’t optimized for the Flux query language. Use SQL or InfluxQL to query data stored in InfluxDB v3.

Learn how to connect to InfluxDB and query your data using the following tools:

Use client libraries

Use the InfluxDB v3 client libraries with SQL or InfluxQL to query data stored in InfluxDB. InfluxDB v3 client libraries are language-specific packages that integrate with your application. Execute queries and retrieve data and metadata over the Flight+gRPC protocol, and then process data using tools in the language of your choice.

Use the InfluxDB Data Explorer to query data

Query your data in the InfluxDB user interface (UI) Data Explorer.

Use the v1 query API and InfluxQL

Use the InfluxDB v1 HTTP query API to query data in InfluxDB Cloud Serverless with InfluxQL.

curl https://cloud2.influxdata.com/query \
  --header "Authorization: Token API_TOKEN" \
  --data-urlencode "db=BUCKET_NAME" \
  --data-urlencode "q=SELECT * FROM home"

Read more

Use visualization tools

Use visualization tools and SQL or InfluxQL to query data stored in InfluxDB.

query sql influxql

Was this page helpful?

Thank you for your feedback!

© 2024 InfluxData, Inc.

Select your InfluxDB Cloud Serverless region

Select your InfluxDB Cloud Serverless region and we’ll customize code examples for you.

AWS

For more information, see InfluxDB Cloud Serverless regions.

Thank you for your feedback!

Let us know what we can do better:

Thank you!

No thanks

The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Flux is going into maintenance mode and will not be supported in InfluxDB 3.0. This was a decision based on the broad demand for SQL and the continued growth and adoption of InfluxQL. We are continuing to support Flux for users in 1.x and 2.x so you can continue using it with no changes to your code. If you are interested in transitioning to InfluxDB 3.0 and want to future-proof your code, we suggest using InfluxQL.

For information about the future of Flux, see the following:

InfluxDB Cloud Serverless

You are currently viewing documentation specific to InfluxDB Cloud Serverless powered by the v3 storage engine, which offers different functionality than InfluxDB Cloud powered by the TSM storage engine.

Are you using InfluxDB Cloud Serverless? How to find out?

Visit your organization's homepage and find the following at the bottom of the right column:

InfluxDB Cloud Serverless Storage Engine Version 3
Yes – I'm using InfluxDB Cloud Serverless No – I'm using InfluxDB Cloud (TSM)