From 9c14bddb3acb51c680b5076b36fcf7d07928d834 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Fri, 11 Jul 2025 08:24:46 -0500 Subject: [PATCH] fix(influxdb3): add tag priority guidance --- content/shared/influxdb3-admin/tables/create.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/content/shared/influxdb3-admin/tables/create.md b/content/shared/influxdb3-admin/tables/create.md index 4d8298e27..a79c44a85 100644 --- a/content/shared/influxdb3-admin/tables/create.md +++ b/content/shared/influxdb3-admin/tables/create.md @@ -18,7 +18,7 @@ However, you can manually create tables to define a custom schema or apply custo - _Required_: The name of the database to create the table in - _Required_: The name of the table to create (see [Table naming restrictions](#table-naming-restrictions)) - - _Required_: Tag columns to include in the table + - _Required_: Tag columns to include in the table (must have at least one tag column) - _Optional_: Field columns and their data types to include in the table {{% show-in "enterprise" %}} - _Optional_: A retention period for the table @@ -27,6 +27,14 @@ However, you can manually create tables to define a custom schema or apply custo > [!Note] > Tables must include at least one tag column. > Field columns are optional and can be added later when you write data. + + > [!Important] + > #### Tag order affects query performance + > When considering your schema and creating your table, order your tags by query priority. + > Place the most commonly queried tags first. + > Columns that appear earlier are typically faster to filter and access during query execution. + > + > For more information, see [Optimize writes](/influxdb3/version/write-data/best-practices/optimize-writes/#sort-tags-by-query-priority). {{% code-placeholders "DATABASE_NAME|TABLE_NAME|AUTH_TOKEN" %}} ```bash