From 06069023809c18923258f38f034ec9bc15f02279 Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Wed, 30 Aug 2023 14:58:29 -0600 Subject: [PATCH] New Guides section, Serverless as an evaluation and prototyping platform (#5118) * added new guides section to serverless and dedicated, fixed bug, closes #4978 * added serverless prototyping and evaluation document * Apply suggestions from code review Co-authored-by: Jason Stirnaman * remove dbrp relevance statement --------- Co-authored-by: Jason Stirnaman --- .../influxdb/cloud-dedicated/guides/_index.md | 15 ++ .../{ => guides}/api-compatibility/_index.md | 4 +- .../api-compatibility/v1/_index.md | 1 + .../api-compatibility/v2/_index.md | 1 + .../migrate-data/_index.md | 4 +- .../migrate-1x-to-cloud-dedicated.md | 1 + .../cloud-serverless/guides/_index.md | 15 ++ .../{ => guides}/api-compatibility/_index.md | 3 + .../api-compatibility/v1/_index.md | 1 + .../api-compatibility/v2/_index.md | 1 + .../migrate-data/_index.md | 3 +- .../migrate-data/migrate-1x-to-iox.md | 2 + .../migrate-data/migrate-tsm-to-iox.md | 4 +- .../guides/prototype-evalutation.md | 234 ++++++++++++++++++ .../execute-queries/influxdb-v1-api.md | 2 +- .../query-data/influxql/dbrp.md | 2 +- 16 files changed, 287 insertions(+), 6 deletions(-) create mode 100644 content/influxdb/cloud-dedicated/guides/_index.md rename content/influxdb/cloud-dedicated/{ => guides}/api-compatibility/_index.md (89%) rename content/influxdb/cloud-dedicated/{ => guides}/api-compatibility/v1/_index.md (99%) rename content/influxdb/cloud-dedicated/{ => guides}/api-compatibility/v2/_index.md (99%) rename content/influxdb/cloud-dedicated/{write-data => guides}/migrate-data/_index.md (97%) rename content/influxdb/cloud-dedicated/{write-data => guides}/migrate-data/migrate-1x-to-cloud-dedicated.md (99%) create mode 100644 content/influxdb/cloud-serverless/guides/_index.md rename content/influxdb/cloud-serverless/{ => guides}/api-compatibility/_index.md (84%) rename content/influxdb/cloud-serverless/{ => guides}/api-compatibility/v1/_index.md (99%) rename content/influxdb/cloud-serverless/{ => guides}/api-compatibility/v2/_index.md (99%) rename content/influxdb/cloud-serverless/{write-data => guides}/migrate-data/_index.md (97%) rename content/influxdb/cloud-serverless/{write-data => guides}/migrate-data/migrate-1x-to-iox.md (99%) rename content/influxdb/cloud-serverless/{write-data => guides}/migrate-data/migrate-tsm-to-iox.md (99%) create mode 100644 content/influxdb/cloud-serverless/guides/prototype-evalutation.md diff --git a/content/influxdb/cloud-dedicated/guides/_index.md b/content/influxdb/cloud-dedicated/guides/_index.md new file mode 100644 index 000000000..69ee46585 --- /dev/null +++ b/content/influxdb/cloud-dedicated/guides/_index.md @@ -0,0 +1,15 @@ +--- +title: InfluxDB guides +description: > + Learn how to integrate with and perform specific operations on data stored in + InfluxDB Cloud Dedicated. +menu: + influxdb_cloud_dedicated: + name: Guides +weight: 10 +--- + +Learn how to integrate with and perform specific operations on data stored in +{{< cloud-name >}}. + +{{< children >}} \ No newline at end of file diff --git a/content/influxdb/cloud-dedicated/api-compatibility/_index.md b/content/influxdb/cloud-dedicated/guides/api-compatibility/_index.md similarity index 89% rename from content/influxdb/cloud-dedicated/api-compatibility/_index.md rename to content/influxdb/cloud-dedicated/guides/api-compatibility/_index.md index d01be0662..7c891a16a 100644 --- a/content/influxdb/cloud-dedicated/api-compatibility/_index.md +++ b/content/influxdb/cloud-dedicated/guides/api-compatibility/_index.md @@ -4,14 +4,16 @@ seo_title: Learn to use APIs for your data workloads in InfluxDB Cloud Dedicated description: > Choose the API and tools that fit your workload. Learn how to authenticate, write, and query using Telegraf, client libraries, and HTTP clients. -weight: 19 +weight: 101 menu: influxdb_cloud_dedicated: name: API compatibility + parent: Guides influxdb/cloud-dedicated/tags: [api] aliases: - /influxdb/cloud-dedicated/primers/ - /influxdb/cloud-dedicated/primers/api/ + - /influxdb/cloud-dedicated/api-compatibility/ related: - /influxdb/cloud-dedicated/query-data/sql/ - /influxdb/cloud-dedicated/query-data/influxql/ diff --git a/content/influxdb/cloud-dedicated/api-compatibility/v1/_index.md b/content/influxdb/cloud-dedicated/guides/api-compatibility/v1/_index.md similarity index 99% rename from content/influxdb/cloud-dedicated/api-compatibility/v1/_index.md rename to content/influxdb/cloud-dedicated/guides/api-compatibility/v1/_index.md index 72f2ef18b..3a16fe6e9 100644 --- a/content/influxdb/cloud-dedicated/api-compatibility/v1/_index.md +++ b/content/influxdb/cloud-dedicated/guides/api-compatibility/v1/_index.md @@ -9,6 +9,7 @@ menu: name: v1 API aliases: - /influxdb/cloud-dedicated/primers/api/v1/ + - /influxdb/cloud-dedicated/api-compatibility/v1/ influxdb/cloud-dedicated/tags: [write, line protocol] related: - /influxdb/cloud-dedicated/query-data/sql/ diff --git a/content/influxdb/cloud-dedicated/api-compatibility/v2/_index.md b/content/influxdb/cloud-dedicated/guides/api-compatibility/v2/_index.md similarity index 99% rename from content/influxdb/cloud-dedicated/api-compatibility/v2/_index.md rename to content/influxdb/cloud-dedicated/guides/api-compatibility/v2/_index.md index e159643d8..77efa13de 100644 --- a/content/influxdb/cloud-dedicated/api-compatibility/v2/_index.md +++ b/content/influxdb/cloud-dedicated/guides/api-compatibility/v2/_index.md @@ -12,6 +12,7 @@ menu: influxdb/cloud-dedicated/tags: [write, line protocol] aliases: - /influxdb/cloud-dedicated/primers/api/v2/ + - /influxdb/cloud-dedicated/api-compatibility/v2/ related: - /influxdb/cloud-dedicated/query-data/sql/ - /influxdb/cloud-dedicated/query-data/influxql/ diff --git a/content/influxdb/cloud-dedicated/write-data/migrate-data/_index.md b/content/influxdb/cloud-dedicated/guides/migrate-data/_index.md similarity index 97% rename from content/influxdb/cloud-dedicated/write-data/migrate-data/_index.md rename to content/influxdb/cloud-dedicated/guides/migrate-data/_index.md index 0203c4c6a..ba29886c3 100644 --- a/content/influxdb/cloud-dedicated/write-data/migrate-data/_index.md +++ b/content/influxdb/cloud-dedicated/guides/migrate-data/_index.md @@ -6,8 +6,10 @@ description: > menu: influxdb_cloud_dedicated: name: Migrate data - parent: Write data + parent: Guides weight: 104 +aliases: + - /influxdb/cloud-dedicated/write-data/migrate-data/ alt_engine: /influxdb/cloud/migrate-data/ --- diff --git a/content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md b/content/influxdb/cloud-dedicated/guides/migrate-data/migrate-1x-to-cloud-dedicated.md similarity index 99% rename from content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md rename to content/influxdb/cloud-dedicated/guides/migrate-data/migrate-1x-to-cloud-dedicated.md index 0d4803381..3bb958b79 100644 --- a/content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md +++ b/content/influxdb/cloud-dedicated/guides/migrate-data/migrate-1x-to-cloud-dedicated.md @@ -11,6 +11,7 @@ menu: weight: 103 aliases: - /influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-iox/ + - /influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated/ related: - /influxdb/cloud-dedicated/admin/databases/ - /influxdb/cloud-dedicated/admin/tokens/ diff --git a/content/influxdb/cloud-serverless/guides/_index.md b/content/influxdb/cloud-serverless/guides/_index.md new file mode 100644 index 000000000..110de37b8 --- /dev/null +++ b/content/influxdb/cloud-serverless/guides/_index.md @@ -0,0 +1,15 @@ +--- +title: InfluxDB guides +description: > + Learn how to integrate with and perform specific operations on data stored in + InfluxDB Cloud Serverless. +menu: + influxdb_cloud_serverless: + name: Guides +weight: 10 +--- + +Learn how to integrate with and perform specific operations on data stored in +{{< cloud-name >}}. + +{{< children >}} \ No newline at end of file diff --git a/content/influxdb/cloud-serverless/api-compatibility/_index.md b/content/influxdb/cloud-serverless/guides/api-compatibility/_index.md similarity index 84% rename from content/influxdb/cloud-serverless/api-compatibility/_index.md rename to content/influxdb/cloud-serverless/guides/api-compatibility/_index.md index c78be76c1..30e747952 100644 --- a/content/influxdb/cloud-serverless/api-compatibility/_index.md +++ b/content/influxdb/cloud-serverless/guides/api-compatibility/_index.md @@ -8,7 +8,10 @@ weight: 10 menu: influxdb_cloud_serverless: name: API compatibility + parent: Guides influxdb/cloud-serverless/tags: [api] +aliases: + - /influxdb/cloud-serverless/api-compatibility/ related: - /influxdb/cloud-serverless/reference/api/ --- diff --git a/content/influxdb/cloud-serverless/api-compatibility/v1/_index.md b/content/influxdb/cloud-serverless/guides/api-compatibility/v1/_index.md similarity index 99% rename from content/influxdb/cloud-serverless/api-compatibility/v1/_index.md rename to content/influxdb/cloud-serverless/guides/api-compatibility/v1/_index.md index 9a0fb0e75..3002b6621 100644 --- a/content/influxdb/cloud-serverless/api-compatibility/v1/_index.md +++ b/content/influxdb/cloud-serverless/guides/api-compatibility/v1/_index.md @@ -9,6 +9,7 @@ menu: name: v1 API aliases: - /influxdb/cloud-serverless/primers/api/v1/ + - /influxdb/cloud-serverless/api-compatibility/v1/ influxdb/cloud-serverless/tags: [write, line protocol] related: - /influxdb/cloud-serverless/query-data/sql/ diff --git a/content/influxdb/cloud-serverless/api-compatibility/v2/_index.md b/content/influxdb/cloud-serverless/guides/api-compatibility/v2/_index.md similarity index 99% rename from content/influxdb/cloud-serverless/api-compatibility/v2/_index.md rename to content/influxdb/cloud-serverless/guides/api-compatibility/v2/_index.md index 2961736df..2505a2958 100644 --- a/content/influxdb/cloud-serverless/api-compatibility/v2/_index.md +++ b/content/influxdb/cloud-serverless/guides/api-compatibility/v2/_index.md @@ -12,6 +12,7 @@ menu: influxdb/cloud-serverless/tags: [write, line protocol] aliases: - /influxdb/cloud-serverless/primers/api/v2/ + - /influxdb/cloud-serverless/api-compatibility/v2/ related: - /influxdb/cloud-serverless/query-data/sql/ - /influxdb/cloud-serverless/query-data/influxql/ diff --git a/content/influxdb/cloud-serverless/write-data/migrate-data/_index.md b/content/influxdb/cloud-serverless/guides/migrate-data/_index.md similarity index 97% rename from content/influxdb/cloud-serverless/write-data/migrate-data/_index.md rename to content/influxdb/cloud-serverless/guides/migrate-data/_index.md index 845c98807..7c1bf14b1 100644 --- a/content/influxdb/cloud-serverless/write-data/migrate-data/_index.md +++ b/content/influxdb/cloud-serverless/guides/migrate-data/_index.md @@ -6,10 +6,11 @@ description: > menu: influxdb_cloud_serverless: name: Migrate data - parent: Write data + parent: Guides weight: 104 alt_engine: /influxdb/cloud/migrate-data/ aliases: + - /influxdb/cloud-serverless/write-data/migrate-data/ - /influxdb/cloud-serverless/reference/flux/ - /influxdb/cloud-serverless/query-data/sql/execute-queries/flux-sql/ --- diff --git a/content/influxdb/cloud-serverless/write-data/migrate-data/migrate-1x-to-iox.md b/content/influxdb/cloud-serverless/guides/migrate-data/migrate-1x-to-iox.md similarity index 99% rename from content/influxdb/cloud-serverless/write-data/migrate-data/migrate-1x-to-iox.md rename to content/influxdb/cloud-serverless/guides/migrate-data/migrate-1x-to-iox.md index dad405dc3..9fd54101a 100644 --- a/content/influxdb/cloud-serverless/write-data/migrate-data/migrate-1x-to-iox.md +++ b/content/influxdb/cloud-serverless/guides/migrate-data/migrate-1x-to-iox.md @@ -9,6 +9,8 @@ menu: name: Migrate from 1.x to Serverless parent: Migrate data weight: 103 +aliases: + - /influxdb/cloud-serverless/write-data/migrate-data/migrate-1x-to-iox --- To migrate data from an InfluxDB 1.x OSS or Enterprise instance to InfluxDB Cloud diff --git a/content/influxdb/cloud-serverless/write-data/migrate-data/migrate-tsm-to-iox.md b/content/influxdb/cloud-serverless/guides/migrate-data/migrate-tsm-to-iox.md similarity index 99% rename from content/influxdb/cloud-serverless/write-data/migrate-data/migrate-tsm-to-iox.md rename to content/influxdb/cloud-serverless/guides/migrate-data/migrate-tsm-to-iox.md index 01ab758c1..cbd89aeb0 100644 --- a/content/influxdb/cloud-serverless/write-data/migrate-data/migrate-tsm-to-iox.md +++ b/content/influxdb/cloud-serverless/guides/migrate-data/migrate-tsm-to-iox.md @@ -10,6 +10,8 @@ menu: name: Migrate from TSM to Serverless parent: Migrate data weight: 102 +aliases: + - /influxdb/cloud-serverless/write-data/migrate-data/migrate-tsm-to-iox alt_engine: /influxdb/cloud/migrate-data/migrate-cloud-to-cloud/ --- @@ -211,7 +213,7 @@ metadata = () => { ) * 100.0, }), ) - |> group(columns: ["_measurement", "srcOrg", "srcBucket", "dstBucket"]) + |> group(columns: ["_measurement", "dstOrg", "srcBucket", "dstBucket"]) } // Write the queried data to the specified InfluxDB OSS bucket. diff --git a/content/influxdb/cloud-serverless/guides/prototype-evalutation.md b/content/influxdb/cloud-serverless/guides/prototype-evalutation.md new file mode 100644 index 000000000..f328e65bd --- /dev/null +++ b/content/influxdb/cloud-serverless/guides/prototype-evalutation.md @@ -0,0 +1,234 @@ +--- +title: Prototype your app on InfluxDB Cloud Serverless +description: > + Utilize InfluxDB Cloud Serverless to prototype your production application and + then move it to InfluxDB Cloud Dedicated. + Learn about important differences between Cloud Serverless and Cloud Dedicated and + best practices for building an application prototype on Cloud Serverless. +menu: + influxdb_cloud_serverless: + name: Prototype your app + parent: Guides +weight: 104 +--- + +Utilize InfluxDB Cloud Serverless to prototype your production application and +then move it to InfluxDB Cloud Dedicated. +Learn about important differences between Cloud Serverless and Cloud Dedicated and +best practices for building an application prototype on Cloud Serverless. + + + +- [Key differences between InfluxDB Cloud Serverless and Cloud Dedicated](#key-differences-between-influxdb-cloud-serverless-and-cloud-dedicated) + - [User interface differences](#user-interface-differences) + - [Terminology differences](#terminology-differences) + - [InfluxQL data retention policy mapping differences](#influxql-data-retention-policy-mapping-differences) + - [Query Language Differences](#query-language-differences) + - [API and client library differences](#api-and-client-library-differences) + - [Tasks and alerts differences](#tasks-and-alerts-differences) + - [Token management and authorization differences](#token-management-and-authorization-differences) + - [Performance differences](#performance-differences) + - [Schema differences](#schema-differences) + - [Organization management differences](#organization-management-differences) +- [Best practices](#best-practices) + - [Use the v3 lightweight client libraries](#use-the-v3-lightweight-client-libraries) + - [Avoid features that are not included with InfluxDB Cloud Dedicated](#avoid-features-that-are-not-included-with-influxdb-cloud-dedicated) + - [Use SQL or InfluxQL as your Query Language](#use-sql-or-influxql-as-your-query-language) + - [Stay within the schema limits of InfluxDB Cloud Serverless](#stay-within-the-schema-limits-of-influxdb-cloud-serverless) + - [Keep test and production data separate](#keep-test-and-production-data-separate) + + + +## Key differences between InfluxDB Cloud Serverless and Cloud Dedicated + +### User interface differences + +The user interfaces between InfluxDB Cloud Serverless and InfluxDB Cloud +Dedicated are completely different. +InfluxDB Cloud Serverless is designed for individual developers, data scientists, +and general hobbyists, as well as business-to-business (B2B) customers. +The Cloud Serverless graphical user interface (GUI) provides basic features for database administration (add/delete databases, generate tokens, etc.), query, visualization, and dashboarding. + +Unlike Cloud Serverless, Cloud Dedicated does not come with a GUI. +Cloud Dedicated customers use an administrative command line tool (`influxctl`) +for managing databases and tokens. The `influxctl` utility is not available for +InfluxDB Cloud Serverless. Because the platforms use different administrative tools, +if you're using Cloud Serverless as an evaluation platform for Cloud Dedicated, +you won’t be able to evaluate the Cloud Dedicated administrative features directly. + +### Terminology differences + +InfluxDB Cloud Serverless was an upgrade that introduced the InfluxDB 3.0 storage +engine to InfluxData’s original InfluxDB Cloud (TSM) multi-tenant solution. +InfluxDB Cloud utilizes the Time-Structured Merge Tree (TSM) storage engine in +which databases were referred to as "buckets". +Cloud Serverless still uses this term. + +InfluxDB Cloud Dedicated has only ever used the InfluxDB 3.0 storage engine. +Resource names in Cloud Dedicated are more traditionally aligned with SQL database engines. +Databases are named "databases" and "measurements" are structured as tables. +"Tables" or "measurements" can be used interchangeably. + +| Term | InfluxDB Cloud Serverless | InfluxDB Cloud Dedicated | +| :----------------------------------------- | :------------------------ | :----------------------- | +| Name for a database | Bucket | Database | +| Name for a collection subset of a database | Measurement | Table or measurement | + +These are just terminology differences, not functional differences, and shouldn’t +impact using Cloud Serverless for evaluation, prototyping, or staging. + +### InfluxQL data retention policy mapping differences + +InfluxDB utilizes database and retention policy (DBRP) mappings to support +InfluxQL queries written for InfluxDB 1.x. To query using InfluxQL, InfluxDB +Cloud Serverless requires that customers first create DBRP mappings +(via the CLI or API) for the bucket. +In Cloud Dedicated, DBRP mapping is handled through naming conventions and +doesn’t require customers to configure a mapping for InfluxQL queries. + +### Query Language Differences + +InfluxDB Cloud Serverless and Cloud Dedicated support SQL and InfluxQL. + +| Language | InfluxDB Cloud Serverless | InfluxDB Cloud Dedicated | +| :------- | :------------------------ | :----------------------- | +| SQL | Natively supported | Natively supported | +| InfluxQL | Natively supported | Natively supported | + +The v2 API (which uses the Flux language for querying) is reachable in InfluxDB +Cloud Serverless, but isn't supported. If you plan to use InfluxDB Cloud +Serverless as an evaluation or staging platform for InfluxDB Cloud Dedicated, +use SQL or InfluxQL. + +### API and client library differences + +Because the v2 Query API uses Flux, customers should avoid using the v2 API when +querying InfluxDB Cloud Serverless as an evaluation, staging, or prototyping +platform for InfluxDB Cloud Dedicated. + +For writing data, InfluxDB Cloud Dedicated and InfluxDB Cloud Serverless both +support the v1 API and the v2 write API. + +In addition, [InfluxDB v3 client libraries](/influxdb/reference/client-libraries/v3/) +are available that work the same for both InfluxDB Cloud Serverless and InfluxDB +Cloud Dedicated and help avoid any API differences between the two platforms. +For more detailed information about choosing a client library, see the +_[Choosing a Client Library When Developing with InfluxDB 3.0](https://www.influxdata.com/blog/choosing-client-library-when-developing-with-influxdb-3-0/)_ +blog post. + +### Tasks and alerts differences + +InfluxDB Cloud Serverless had built-in task and alert systems. +These were built on Flux and have not been carried forward to InfluxDB Cloud Dedicated. +If you use InfluxDB Cloud Serverless as an evaluation platform for +InfluxDB Cloud Dedicated, don’t utilize these features as they aren't available +on InfluxDB Cloud Dedicated. + +With InfluxDB Cloud Dedicated, you can build custom task and alerting solutions or use 3rd-party tools like Grafana or Prefect--for example: + +- [Send alerts using data in InfluxDB Cloud Serverless](/influxdb/cloud-serverless/process-data/send-alerts/) +- [Downsample data](/influxdb/cloud-serverless/process-data/downsample/) +- [Summarize data](/influxdb/cloud-serverless/process-data/summarize/) +- [Use data analysis tools](/influxdb/cloud-serverless/process-data/tools/) + +### Token management and authorization differences + +In addition to the token management UI differences mentioned previously +(there is a UI and API for this with Cloud Serverless, with InfluxDB Cloud +Dedicated you use `influxctl`), there are also differences in the granularity +of token permissions---InfluxDB Cloud Dedicated has a few more permission options. + +| Function | InfluxDB Cloud Serverless | InfluxDB Cloud Dedicated | +| :------------------- | :------------------------ | :----------------------- | +| API token generation | Built-in UI or v2 API | `influxctl` CLI | + +### Performance differences + +InfluxDB Cloud Serverless is a multi-tenant solution and has a number of factors +that could affect database performance, including: + +- **Rate limiting**: Limits on reads and writes. +- **Noisy neighbors**: Unexpected high usage from other customers could impact your experience. +- **Generic optimization**: Cloud Serverless is generically optimized to fit the + most common workloads. InfluxDB Cloud Dedicated can be tuned to your + specific data sets and workload with options such as custom partitioning. +- **Tag-specific queries**: Due to generic optimization, queries that select rows with a subset + of tag values may be noticeably slower than in previous versions. +If you are using InfluxDB Cloud Serverless for evaluation purposes, consider +investing in an InfluxDB Cloud Dedicated proof-of-concept (PoC) to get +a more accurate picture of your expected performance. + +### Schema differences + +Schema support in InfluxDB Cloud Serverless and InfluxDB Cloud Dedicated is nearly identical. +However, InfluxDB Cloud Dedicated provides more flexibility, letting you raise +or exceed limits on the number of tables (measurements) and columns +(time, fields, and tags) in a database. +_See [Stay within the schema limits of InfluxDB Cloud Serverless](#stay-within-the-schema-limits-of-influxdb-cloud-serverless)_. + +### Organization management differences + +InfluxDB Cloud Serverless has a feature that lets you create sub-organizations +within your account. InfluxDB Cloud Dedicated does not have this feature. + +Additionally, due to being multi-tenant, Cloud Serverless requires specifying +organization name or ID in some interactions. This isn't required with Cloud Dedicated. + +## Best practices + +Follow these recommended best practices when using InfluxDB Cloud Serverless +as an evaluation or prototyping platform for InfluxDB Cloud Dedicated. + +### Use the v3 lightweight client libraries + +Use the InfluxDB [v3 lightweight client libraries](/influxdb/cloud-serverless/reference/client-libraries/v3/) +to help make your code for writing and querying cross-compatible with InfluxDB Cloud Serverless and Cloud Dedicated. +You'll only need to change your InfluxDB connection credentials +(host, database name, and token). + +### Avoid features that are not included with InfluxDB Cloud Dedicated + +The easiest way to avoid using features in InfluxDB Cloud Serverless that don’t +exist in Cloud Dedicated is to avoid using the Cloud Serverless UI, except when +managing tokens and buckets. +In order to maintain compatibility with Cloud Dedicated, specifically avoid using the following +InfluxDB Cloud Serverless features: + +- The v2 query API and the Flux language +- Administrative APIs +- Tasks and alerts from the Cloud Serverless UI (instead use one of the options +mentioned in _[Tasks and alerts differences](#tasks-and-alerts-differences)_). +- InfluxDB dashboards and visualization tools (use 3rd-party visualization tools) + +### Use SQL or InfluxQL as your Query Language + +SQL and InfluxQL are optimized for InfluxDB v3 and both are excellent +options in Cloud Dedicated and Cloud Serverless. +Avoid Flux since it can’t be used with InfluxDB Cloud Dedicated. + +### Stay within the schema limits of InfluxDB Cloud Serverless + +If you stay within InfluxDB Cloud Serverless limits for tables (measurements) +and columns (time, fields, and tags) within a table, then you won’t have any +problems with limits in InfluxDB Cloud Dedicated. +Cloud Dedicated also provides more flexibility by letting you configure limits. + +| Description | Limit | +| :--------------------------- | ----: | +| Tables (measurements) | 500 | +| Columns (time, fields, tags) | 200 | + +### Keep test and production data separate + +If you are using InfluxDB Cloud Serverless for prototyping or evaluation, use +test data and don’t store production data on the platform. +This has the following benefits: + +- Using test data is less risky. If you make a mistake with your schema, you can delete your data and start over. If you use production + data that you rely on and only have one copy, schema mistakes are harder to + recover from. +- You won't need to migrate data. After you have completed your evaluation, you can delete your test data and start using Cloud Dedicated. + +_You can use live or production data for protoype in InfluxDB Cloud Serverless, and then migrate it to Cloud Dedicated after you complete your evaluation. However, currently this requires +that you write code to query and extract the data, convert it to line protocol +format, and then write it to InfluxDB Cloud Dedicated._ diff --git a/content/influxdb/cloud-serverless/query-data/execute-queries/influxdb-v1-api.md b/content/influxdb/cloud-serverless/query-data/execute-queries/influxdb-v1-api.md index 3f05598f8..0a8520770 100644 --- a/content/influxdb/cloud-serverless/query-data/execute-queries/influxdb-v1-api.md +++ b/content/influxdb/cloud-serverless/query-data/execute-queries/influxdb-v1-api.md @@ -13,7 +13,7 @@ menu: influxdb/cloud-serverless/tags: [query, influxql, python] metadata: [InfluxQL] related: - - /influxdb/cloud-serverless/api-compatibility/v1/ + - /influxdb/cloud-serverless/guides/api-compatibility/v1/ aliases: - /influxdb/cloud-serverless/query-data/influxql/execute-queries/influxdb-v1-api/ list_code_example: | diff --git a/content/influxdb/cloud-serverless/query-data/influxql/dbrp.md b/content/influxdb/cloud-serverless/query-data/influxql/dbrp.md index 99606c4ea..8df28d78b 100644 --- a/content/influxdb/cloud-serverless/query-data/influxql/dbrp.md +++ b/content/influxdb/cloud-serverless/query-data/influxql/dbrp.md @@ -27,7 +27,7 @@ combination to a bucket. {{< cloud-name >}} automatically creates DBRP mappings for you during the following operations: -- Writing to the [`/write` v1 compatibility endpoint](/influxdb/cloud-serverless/api-compatibility/v1/#write-data) +- Writing to the [`/write` v1 compatibility endpoint](/influxdb/cloud-serverless/guides/api-compatibility/v1/#write-data) - [Upgrading from InfluxDB 1.x to InfluxDB Cloud](/influxdb/v2.7/upgrade/v1-to-cloud/) For more information, see [Database and retention policy mapping](/influxdb/cloud-serverless/api/#tag/DBRPs).