From 4001d0e8d9ea4e345e6826d27caa70988676e435 Mon Sep 17 00:00:00 2001 From: Kelly Date: Tue, 19 May 2020 17:56:43 -0700 Subject: [PATCH 1/4] rename table structure > data schema; upd content --- .../reference/key-concepts/data-schema.md | 61 +++++++++++++++++++ .../reference/key-concepts/table-structure.md | 24 -------- 2 files changed, 61 insertions(+), 24 deletions(-) create mode 100644 content/v2.0/reference/key-concepts/data-schema.md delete mode 100644 content/v2.0/reference/key-concepts/table-structure.md diff --git a/content/v2.0/reference/key-concepts/data-schema.md b/content/v2.0/reference/key-concepts/data-schema.md new file mode 100644 index 000000000..40b8d3cb7 --- /dev/null +++ b/content/v2.0/reference/key-concepts/data-schema.md @@ -0,0 +1,61 @@ +--- +title: InfluxDB data schema +description: > + InfluxDB uses a tabular data schema for displaying raw data in Data Explorer and for returning query results in annotative CSV syntax. +weight: 103 +menu: + v2_0_ref: + parent: Key concepts + name: Data schema +v2.0/tags: [key concepts] +--- + +InfluxDB [data elements](/v2.0/reference/key-concepts/data-elements/) are stored in [time-structured merge tree (TSM)](/v2.0/reference/internals/storage-engine/#time-structured-merge-tree-tsm) and [time series index (TSI)](/v2.0/reference/internals/storage-engine/#time-series-index-tsi) files to efficiently compact and store data. + +InfluxDB also provides a **tabular data schema** that includes the following: + +- [Annotation rows](#annotation-rows) +- [Header row](#header-row) +- [Data rows](#data-row) +- [Data columns](#data-columns) +- [Group keys](#group-keys) + +The **tabular data schema is used for the following**: + +- To [view raw data](/v2.0/visualize-data/explore-metrics/#view-raw-data) when [exploring metrics with InfluxDB](/v2.0/visualize-data/explore-metrics) +- To return query results in [annotated CSV syntax](/v2.0/reference/syntax/annotated-csv/) + +## Annotation rows + +Annotation rows describe column properties, for example: + +- `#group` +- `#datatype` +- `#default` + +## Header row + +The header row defines column labels that describe data in each column, for example: + +- `table` +- `_time` +- `_value` +- `_field` +- `_measurement` +- tag key names (without underscore prefix): `tag-1`, `tag-2` + +## Data rows + +Each data row contains the data specified in the header row for one [point](/v2.0/reference/glossary/#point). + +## Other columns + +In addition to the columns in each data row (specified in the header row), the following columns are optional: + +- `annotation` +- `result` +- `table` + +## Group keys + +Determine the contents of output tables in Flux by grouping records that share common values in specified columns. Learn more about [grouping your data with Flux](/v2.0/query-data/flux/group-data/). diff --git a/content/v2.0/reference/key-concepts/table-structure.md b/content/v2.0/reference/key-concepts/table-structure.md deleted file mode 100644 index 71011c1bb..000000000 --- a/content/v2.0/reference/key-concepts/table-structure.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: InfluxDB table structure -description: > - InfluxDB uses a columnar system to structure tables. -weight: 103 -menu: - v2_0_ref: - parent: Key concepts - name: Table structure -v2.0/tags: [key concepts] ---- - -InfluxDB 2.0 uses the following columnar table structure to store data: - -- **Annotation rows:** include the following rows: #group, #datatype, and #default. -- **Header row:** describes the data labels for each column in a row. -- **Data columns:** include the following columns: annotation, result, and table. -- **Data rows:** all rows that contain time series data. For details about the type of data stored in InfluxDB, see [InfluxDB data elements](/v2.0/reference/key-concepts/data-elements/). -- **Group keys** determine the contents of output tables in Flux by grouping records that share common values in specified columns. Learn more about [grouping your data with Flux](/v2.0/query-data/flux/group-data/). - -For specifications on the InfluxDB 2.0 table structure, see [Tables](/v2.0/reference/syntax/annotated-csv/#tables). - -**_Tip:_** To visualize your table structure in the InfluxDB user interface, click the **Data Explorer** icon -in the sidebar, create a query, click **Submit**, and then select **View Raw Data**. From 93f6f3b4270408c1b225625aca5b95dd1381a8f5 Mon Sep 17 00:00:00 2001 From: kelseiv <47797004+kelseiv@users.noreply.github.com> Date: Tue, 19 May 2020 18:04:46 -0700 Subject: [PATCH 2/4] update typo in description --- content/v2.0/reference/key-concepts/data-schema.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/v2.0/reference/key-concepts/data-schema.md b/content/v2.0/reference/key-concepts/data-schema.md index 40b8d3cb7..06666e5fb 100644 --- a/content/v2.0/reference/key-concepts/data-schema.md +++ b/content/v2.0/reference/key-concepts/data-schema.md @@ -1,7 +1,7 @@ --- title: InfluxDB data schema description: > - InfluxDB uses a tabular data schema for displaying raw data in Data Explorer and for returning query results in annotative CSV syntax. + InfluxDB uses a tabular data schema for displaying raw data in Data Explorer and for returning query results in annotated CSV syntax. weight: 103 menu: v2_0_ref: From e96a4da02d764cfa4786273444fbbc6f0943e86c Mon Sep 17 00:00:00 2001 From: kelseiv <47797004+kelseiv@users.noreply.github.com> Date: Tue, 19 May 2020 18:05:49 -0700 Subject: [PATCH 3/4] edit --- content/v2.0/reference/key-concepts/data-schema.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/v2.0/reference/key-concepts/data-schema.md b/content/v2.0/reference/key-concepts/data-schema.md index 06666e5fb..21729e20b 100644 --- a/content/v2.0/reference/key-concepts/data-schema.md +++ b/content/v2.0/reference/key-concepts/data-schema.md @@ -10,7 +10,7 @@ menu: v2.0/tags: [key concepts] --- -InfluxDB [data elements](/v2.0/reference/key-concepts/data-elements/) are stored in [time-structured merge tree (TSM)](/v2.0/reference/internals/storage-engine/#time-structured-merge-tree-tsm) and [time series index (TSI)](/v2.0/reference/internals/storage-engine/#time-series-index-tsi) files to efficiently compact and store data. +InfluxDB [data elements](/v2.0/reference/key-concepts/data-elements/) are stored in [time-structured merge tree (TSM)](/v2.0/reference/internals/storage-engine/#time-structured-merge-tree-tsm) and [time series index (TSI)](/v2.0/reference/internals/storage-engine/#time-series-index-tsi) files to efficiently compact stored data. InfluxDB also provides a **tabular data schema** that includes the following: From e4cf0f17d246efb8490ff4e752ef0f2d1e231160 Mon Sep 17 00:00:00 2001 From: Kelly Date: Wed, 20 May 2020 08:32:07 -0700 Subject: [PATCH 4/4] add alias --- content/v2.0/reference/key-concepts/data-schema.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/v2.0/reference/key-concepts/data-schema.md b/content/v2.0/reference/key-concepts/data-schema.md index 21729e20b..cc01a54f0 100644 --- a/content/v2.0/reference/key-concepts/data-schema.md +++ b/content/v2.0/reference/key-concepts/data-schema.md @@ -2,6 +2,8 @@ title: InfluxDB data schema description: > InfluxDB uses a tabular data schema for displaying raw data in Data Explorer and for returning query results in annotated CSV syntax. +aliases: + - /v2.0/reference/key-concepts/table-structure weight: 103 menu: v2_0_ref: