Add InfluxQL schema exploration docs (#5189)
* add influxql explore schema task-based doc * port influxql explore schema guide to clustered and serverlesspull/5191/head
Scott Anderson
GitHub
parent
8223d6e3f0
commit
5d3328b7c6
|
|
@ -0,0 +1,341 @@
|
|||
---
|
||||
title: Explore your schema with InfluxQL
|
||||
description: >
|
||||
Use InfluxQL `SHOW` statements to return information about your data schema.
|
||||
menu:
|
||||
influxdb_cloud_dedicated:
|
||||
name: Explore your schema
|
||||
parent: Query with InfluxQL
|
||||
identifier: query-influxql-schema
|
||||
weight: 201
|
||||
influxdb/cloud-dedicated/tags: [query, influxql]
|
||||
related:
|
||||
- /influxdb/cloud-dedicated/reference/influxql/show/
|
||||
list_code_example: |
|
||||
##### List measurements
|
||||
```sql
|
||||
SHOW MEASUREMENTS
|
||||
```
|
||||
|
||||
##### List field keys in a measurement
|
||||
```sql
|
||||
SHOW FIELD KEYS FROM "measurement"
|
||||
```
|
||||
|
||||
##### List tag keys in a measurement
|
||||
```sql
|
||||
SHOW TAG KEYS FROM "measurement"
|
||||
```
|
||||
|
||||
##### List tag values for a specific tag key
|
||||
```sql
|
||||
SHOW TAG VALUES FROM "measurement" WITH KEY = "tag-key"
|
||||
```
|
||||
---
|
||||
|
||||
Use InfluxQL `SHOW` statements to return information about your data schema.
|
||||
|
||||
{{% note %}}
|
||||
#### Sample data
|
||||
|
||||
The following examples use data provided in [sample data sets](/influxdb/cloud-dedicated/reference/sample-data/).
|
||||
To run the example queries and return identical results, follow the instructions
|
||||
provided for each sample data set to write the data to your {{% product-name %}}
|
||||
database.
|
||||
{{% /note %}}
|
||||
|
||||
- [List measurements in a database](#list-measurements-in-a-database)
|
||||
- [List measurements that contain specific tag key-value pairs](#list-measurements-that-contain-specific-tag-key-value-pairs)
|
||||
- [List measurements that match a regular expression](#list-measurements-that-match-a-regular-expression)
|
||||
- [List field keys in a measurement](#list-field-keys-in-a-measurement)
|
||||
- [List tag keys in a measurement](#list-tag-keys-in-a-measurement)
|
||||
- [List tag keys in measurements that contain a specific tag key-value pair](#list-tag-keys-in-measurements-that-contain-a-specific-tag-key-value-pair)
|
||||
- [List tag values for a specific tag key](#list-tag-values-for-a-specific-tag-key)
|
||||
- [List tag values for multiple tags](#list-tag-values-for-multiple-tags)
|
||||
- [List tag values for tags that match a regular expression](#list-tag-values-for-tags-that-match-a-regular-expression)
|
||||
- [List tag values associated with a specific tag key-value pair](#list-tag-values-associated-with-a-specific-tag-key-value-pair)
|
||||
|
||||
|
||||
## List measurements in a database
|
||||
|
||||
Use [`SHOW MEASUREMENTS`](/influxdb/cloud-dedicated/reference/influxql/show/#show-measurements)
|
||||
to list measurements in your InfluxDB database.
|
||||
|
||||
```sql
|
||||
SHOW MEASUREMENTS
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: measurements
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| name |
|
||||
| :----------- |
|
||||
| bitcoin |
|
||||
| home |
|
||||
| home_actions |
|
||||
| numbers |
|
||||
| weather |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List measurements that contain specific tag key-value pairs
|
||||
|
||||
To return only measurements with specific tag key-value pairs, include a `WHERE`
|
||||
clause with tag key-value pairs to query for.
|
||||
|
||||
```sql
|
||||
SHOW MEASUREMENTS WHERE room = 'Kitchen'
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "1" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: measurements
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| name |
|
||||
| :----------- |
|
||||
| home |
|
||||
| home_actions |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List measurements that match a regular expression
|
||||
|
||||
To return only measurements with names that match a
|
||||
[regular expression](/influxdb/cloud-dedicated/reference/influxql/regular-expressions/),
|
||||
include a `WITH` clause that compares the `MEASUREMENT` to a regular expression.
|
||||
|
||||
```sql
|
||||
SHOW MEASUREMENTS WITH MEASUREMENT =~ /^home/
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "2" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: measurements
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| name |
|
||||
| :----------- |
|
||||
| home |
|
||||
| home_actions |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
## List field keys in a measurement
|
||||
|
||||
Use [`SHOW FIELD KEYS`](/influxdb/cloud-dedicated/reference/influxql/show/#show-field-keys)
|
||||
to return all field keys in a measurement.
|
||||
Include a `FROM` clause to specify the measurement.
|
||||
If no measurement is specified, the query returns all field keys in the database.
|
||||
|
||||
```sql
|
||||
SHOW FIELD KEYS FROM home
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "3" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| fieldKey | fieldType |
|
||||
| :------- | :-------- |
|
||||
| co | integer |
|
||||
| hum | float |
|
||||
| temp | float |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
## List tag keys in a measurement
|
||||
|
||||
Use [`SHOW TAG KEYS`](/influxdb/cloud-dedicated/reference/influxql/show/#show-field-keys)
|
||||
to return all tag keys in a measurement.
|
||||
Include a `FROM` clause to specify the measurement.
|
||||
If no measurement is specified, the query returns all tag keys in the database.
|
||||
|
||||
```sql
|
||||
SHOW TAG KEYS FROM home_actions
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "4" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| tagKey |
|
||||
| :----- |
|
||||
| action |
|
||||
| level |
|
||||
| room |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag keys in measurements that contain a specific tag key-value pair
|
||||
|
||||
To return all tag keys measurements that contain specific tag key-value pairs,
|
||||
include a `WHERE` clause with the tag key-value pairs to query for.
|
||||
|
||||
```sql
|
||||
SHOW TAG KEYS WHERE room = 'Kitchen'
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "5" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| tagKey |
|
||||
| :----- |
|
||||
| room |
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| tagKey |
|
||||
| :----- |
|
||||
| action |
|
||||
| level |
|
||||
| room |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
## List tag values for a specific tag key
|
||||
|
||||
Use [`SHOW TAG VALUES`](/influxdb/cloud-dedicated/reference/influxql/show/#show-field-values)
|
||||
to return all values for specific tags in a measurement.
|
||||
|
||||
- Include a `FROM` clause to specify the measurement.
|
||||
If no measurement is specified, the query returns all tag values from the
|
||||
specified tag keys in the database.
|
||||
- Use the `WITH` clause to compare `KEY` to tag keys to list the values of.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES FROM weather WITH KEY = location
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "5" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: weather
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :------- | :------------ |
|
||||
| location | Concord |
|
||||
| location | Hayward |
|
||||
| location | San Francisco |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag values for multiple tags
|
||||
|
||||
To return tag values for multiple specific tag keys, use the `IN` operator in
|
||||
the `WITH` clause to compare `KEY` to a list of tag keys.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES FROM home_actions WITH KEY IN ("level", "action")
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "6" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :----- | :---- |
|
||||
| action | alert |
|
||||
| action | cool |
|
||||
| level | ok |
|
||||
| level | warn |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag values for tags that match a regular expression
|
||||
|
||||
To return only tag values from tags keys that match a regular expression, use
|
||||
regular expression comparison operators in your `WITH` clause to compare `KEY`
|
||||
to the regular expression.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES WITH KEY =~ /oo/
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "7" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :--- | :---------- |
|
||||
| room | Kitchen |
|
||||
| room | Living Room |
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :--- | :---------- |
|
||||
| room | Kitchen |
|
||||
| room | Living Room |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag values associated with a specific tag key-value pair
|
||||
|
||||
To list tag values for tags associated with a specific tag key-value pair:
|
||||
|
||||
- Use the `WITH` clause to identify what tag keys to return values for.
|
||||
- Include a `WHERE` clause that identifies the tag key-value pair to query for.
|
||||
|
||||
The following example returns tag values for the `action` and `level` tags for
|
||||
points where the `room` tag value is `Kitchen`.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES WITH KEY IN ("action", "level") WHERE room = 'Kitchen'
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "8" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :----- | :---- |
|
||||
| action | alert |
|
||||
| action | cool |
|
||||
| level | ok |
|
||||
| level | warn |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
|
@ -12,6 +12,8 @@ list_code_example: |
|
|||
```sql
|
||||
SHOW [MEASUREMENTS | FIELD KEYS | TAG KEYS | TAG VALUES]
|
||||
```
|
||||
related:
|
||||
- /influxdb/cloud-dedicated/query-data/influxql/explore-schema/
|
||||
---
|
||||
|
||||
Use InfluxQL `SHOW` statements to query schema information from a database.
|
||||
|
|
|
|||
|
|
@ -0,0 +1,341 @@
|
|||
---
|
||||
title: Explore your schema with InfluxQL
|
||||
description: >
|
||||
Use InfluxQL `SHOW` statements to return information about your data schema.
|
||||
menu:
|
||||
influxdb_cloud_serverless:
|
||||
name: Explore your schema
|
||||
parent: Query with InfluxQL
|
||||
identifier: query-influxql-schema
|
||||
weight: 201
|
||||
influxdb/cloud-serverless/tags: [query, influxql]
|
||||
related:
|
||||
- /influxdb/cloud-serverless/reference/influxql/show/
|
||||
list_code_example: |
|
||||
##### List measurements
|
||||
```sql
|
||||
SHOW MEASUREMENTS
|
||||
```
|
||||
|
||||
##### List field keys in a measurement
|
||||
```sql
|
||||
SHOW FIELD KEYS FROM "measurement"
|
||||
```
|
||||
|
||||
##### List tag keys in a measurement
|
||||
```sql
|
||||
SHOW TAG KEYS FROM "measurement"
|
||||
```
|
||||
|
||||
##### List tag values for a specific tag key
|
||||
```sql
|
||||
SHOW TAG VALUES FROM "measurement" WITH KEY = "tag-key"
|
||||
```
|
||||
---
|
||||
|
||||
Use InfluxQL `SHOW` statements to return information about your data schema.
|
||||
|
||||
{{% note %}}
|
||||
#### Sample data
|
||||
|
||||
The following examples use data provided in [sample data sets](/influxdb/cloud-serverless/reference/sample-data/).
|
||||
To run the example queries and return identical results, follow the instructions
|
||||
provided for each sample data set to write the data to your {{% product-name %}}
|
||||
bucket.
|
||||
{{% /note %}}
|
||||
|
||||
- [List measurements in a bucket](#list-measurements-in-a-bucket)
|
||||
- [List measurements that contain specific tag key-value pairs](#list-measurements-that-contain-specific-tag-key-value-pairs)
|
||||
- [List measurements that match a regular expression](#list-measurements-that-match-a-regular-expression)
|
||||
- [List field keys in a measurement](#list-field-keys-in-a-measurement)
|
||||
- [List tag keys in a measurement](#list-tag-keys-in-a-measurement)
|
||||
- [List tag keys in measurements that contain a specific tag key-value pair](#list-tag-keys-in-measurements-that-contain-a-specific-tag-key-value-pair)
|
||||
- [List tag values for a specific tag key](#list-tag-values-for-a-specific-tag-key)
|
||||
- [List tag values for multiple tags](#list-tag-values-for-multiple-tags)
|
||||
- [List tag values for tags that match a regular expression](#list-tag-values-for-tags-that-match-a-regular-expression)
|
||||
- [List tag values associated with a specific tag key-value pair](#list-tag-values-associated-with-a-specific-tag-key-value-pair)
|
||||
|
||||
|
||||
## List measurements in a bucket
|
||||
|
||||
Use [`SHOW MEASUREMENTS`](/influxdb/cloud-serverless/reference/influxql/show/#show-measurements)
|
||||
to list measurements in your InfluxDB bucket.
|
||||
|
||||
```sql
|
||||
SHOW MEASUREMENTS
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: measurements
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| name |
|
||||
| :----------- |
|
||||
| bitcoin |
|
||||
| home |
|
||||
| home_actions |
|
||||
| numbers |
|
||||
| weather |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List measurements that contain specific tag key-value pairs
|
||||
|
||||
To return only measurements with specific tag key-value pairs, include a `WHERE`
|
||||
clause with tag key-value pairs to query for.
|
||||
|
||||
```sql
|
||||
SHOW MEASUREMENTS WHERE room = 'Kitchen'
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "1" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: measurements
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| name |
|
||||
| :----------- |
|
||||
| home |
|
||||
| home_actions |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List measurements that match a regular expression
|
||||
|
||||
To return only measurements with names that match a
|
||||
[regular expression](/influxdb/cloud-serverless/reference/influxql/regular-expressions/),
|
||||
include a `WITH` clause that compares the `MEASUREMENT` to a regular expression.
|
||||
|
||||
```sql
|
||||
SHOW MEASUREMENTS WITH MEASUREMENT =~ /^home/
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "2" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: measurements
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| name |
|
||||
| :----------- |
|
||||
| home |
|
||||
| home_actions |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
## List field keys in a measurement
|
||||
|
||||
Use [`SHOW FIELD KEYS`](/influxdb/cloud-serverless/reference/influxql/show/#show-field-keys)
|
||||
to return all field keys in a measurement.
|
||||
Include a `FROM` clause to specify the measurement.
|
||||
If no measurement is specified, the query returns all field keys in the bucket.
|
||||
|
||||
```sql
|
||||
SHOW FIELD KEYS FROM home
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "3" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| fieldKey | fieldType |
|
||||
| :------- | :-------- |
|
||||
| co | integer |
|
||||
| hum | float |
|
||||
| temp | float |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
## List tag keys in a measurement
|
||||
|
||||
Use [`SHOW TAG KEYS`](/influxdb/cloud-serverless/reference/influxql/show/#show-field-keys)
|
||||
to return all tag keys in a measurement.
|
||||
Include a `FROM` clause to specify the measurement.
|
||||
If no measurement is specified, the query returns all tag keys in the bucket.
|
||||
|
||||
```sql
|
||||
SHOW TAG KEYS FROM home_actions
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "4" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| tagKey |
|
||||
| :----- |
|
||||
| action |
|
||||
| level |
|
||||
| room |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag keys in measurements that contain a specific tag key-value pair
|
||||
|
||||
To return all tag keys measurements that contain specific tag key-value pairs,
|
||||
include a `WHERE` clause with the tag key-value pairs to query for.
|
||||
|
||||
```sql
|
||||
SHOW TAG KEYS WHERE room = 'Kitchen'
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "5" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| tagKey |
|
||||
| :----- |
|
||||
| room |
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| tagKey |
|
||||
| :----- |
|
||||
| action |
|
||||
| level |
|
||||
| room |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
## List tag values for a specific tag key
|
||||
|
||||
Use [`SHOW TAG VALUES`](/influxdb/cloud-serverless/reference/influxql/show/#show-field-values)
|
||||
to return all values for specific tags in a measurement.
|
||||
|
||||
- Include a `FROM` clause to specify the measurement.
|
||||
If no measurement is specified, the query returns all tag values from the
|
||||
specified tag keys in the bucket.
|
||||
- Use the `WITH` clause to compare `KEY` to tag keys to list the values of.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES FROM weather WITH KEY = location
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "5" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: weather
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :------- | :------------ |
|
||||
| location | Concord |
|
||||
| location | Hayward |
|
||||
| location | San Francisco |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag values for multiple tags
|
||||
|
||||
To return tag values for multiple specific tag keys, use the `IN` operator in
|
||||
the `WITH` clause to compare `KEY` to a list of tag keys.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES FROM home_actions WITH KEY IN ("level", "action")
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "6" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :----- | :---- |
|
||||
| action | alert |
|
||||
| action | cool |
|
||||
| level | ok |
|
||||
| level | warn |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag values for tags that match a regular expression
|
||||
|
||||
To return only tag values from tags keys that match a regular expression, use
|
||||
regular expression comparison operators in your `WITH` clause to compare `KEY`
|
||||
to the regular expression.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES WITH KEY =~ /oo/
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "7" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :--- | :---------- |
|
||||
| room | Kitchen |
|
||||
| room | Living Room |
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :--- | :---------- |
|
||||
| room | Kitchen |
|
||||
| room | Living Room |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag values associated with a specific tag key-value pair
|
||||
|
||||
To list tag values for tags associated with a specific tag key-value pair:
|
||||
|
||||
- Use the `WITH` clause to identify what tag keys to return values for.
|
||||
- Include a `WHERE` clause that identifies the tag key-value pair to query for.
|
||||
|
||||
The following example returns tag values for the `action` and `level` tags for
|
||||
points where the `room` tag value is `Kitchen`.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES WITH KEY IN ("action", "level") WHERE room = 'Kitchen'
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "8" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :----- | :---- |
|
||||
| action | alert |
|
||||
| action | cool |
|
||||
| level | ok |
|
||||
| level | warn |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
|
@ -12,6 +12,8 @@ list_code_example: |
|
|||
```sql
|
||||
SHOW [MEASUREMENTS | FIELD KEYS | TAG KEYS | TAG VALUES]
|
||||
```
|
||||
related:
|
||||
- /influxdb/cloud-serverless/query-data/influxql/explore-schema/
|
||||
---
|
||||
|
||||
Use InfluxQL `SHOW` statements to query schema information from a bucket.
|
||||
|
|
|
|||
|
|
@ -0,0 +1,341 @@
|
|||
---
|
||||
title: Explore your schema with InfluxQL
|
||||
description: >
|
||||
Use InfluxQL `SHOW` statements to return information about your data schema.
|
||||
menu:
|
||||
influxdb_cloud_clustered:
|
||||
name: Explore your schema
|
||||
parent: Query with InfluxQL
|
||||
identifier: query-influxql-schema
|
||||
weight: 201
|
||||
influxdb/clustered/tags: [query, influxql]
|
||||
related:
|
||||
- /influxdb/clustered/reference/influxql/show/
|
||||
list_code_example: |
|
||||
##### List measurements
|
||||
```sql
|
||||
SHOW MEASUREMENTS
|
||||
```
|
||||
|
||||
##### List field keys in a measurement
|
||||
```sql
|
||||
SHOW FIELD KEYS FROM "measurement"
|
||||
```
|
||||
|
||||
##### List tag keys in a measurement
|
||||
```sql
|
||||
SHOW TAG KEYS FROM "measurement"
|
||||
```
|
||||
|
||||
##### List tag values for a specific tag key
|
||||
```sql
|
||||
SHOW TAG VALUES FROM "measurement" WITH KEY = "tag-key"
|
||||
```
|
||||
---
|
||||
|
||||
Use InfluxQL `SHOW` statements to return information about your data schema.
|
||||
|
||||
{{% note %}}
|
||||
#### Sample data
|
||||
|
||||
The following examples use data provided in [sample data sets](/influxdb/clustered/reference/sample-data/).
|
||||
To run the example queries and return identical results, follow the instructions
|
||||
provided for each sample data set to write the data to your {{% product-name %}}
|
||||
bucket.
|
||||
{{% /note %}}
|
||||
|
||||
- [List measurements in a bucket](#list-measurements-in-a-bucket)
|
||||
- [List measurements that contain specific tag key-value pairs](#list-measurements-that-contain-specific-tag-key-value-pairs)
|
||||
- [List measurements that match a regular expression](#list-measurements-that-match-a-regular-expression)
|
||||
- [List field keys in a measurement](#list-field-keys-in-a-measurement)
|
||||
- [List tag keys in a measurement](#list-tag-keys-in-a-measurement)
|
||||
- [List tag keys in measurements that contain a specific tag key-value pair](#list-tag-keys-in-measurements-that-contain-a-specific-tag-key-value-pair)
|
||||
- [List tag values for a specific tag key](#list-tag-values-for-a-specific-tag-key)
|
||||
- [List tag values for multiple tags](#list-tag-values-for-multiple-tags)
|
||||
- [List tag values for tags that match a regular expression](#list-tag-values-for-tags-that-match-a-regular-expression)
|
||||
- [List tag values associated with a specific tag key-value pair](#list-tag-values-associated-with-a-specific-tag-key-value-pair)
|
||||
|
||||
|
||||
## List measurements in a bucket
|
||||
|
||||
Use [`SHOW MEASUREMENTS`](/influxdb/clustered/reference/influxql/show/#show-measurements)
|
||||
to list measurements in your InfluxDB bucket.
|
||||
|
||||
```sql
|
||||
SHOW MEASUREMENTS
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: measurements
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| name |
|
||||
| :----------- |
|
||||
| bitcoin |
|
||||
| home |
|
||||
| home_actions |
|
||||
| numbers |
|
||||
| weather |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List measurements that contain specific tag key-value pairs
|
||||
|
||||
To return only measurements with specific tag key-value pairs, include a `WHERE`
|
||||
clause with tag key-value pairs to query for.
|
||||
|
||||
```sql
|
||||
SHOW MEASUREMENTS WHERE room = 'Kitchen'
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "1" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: measurements
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| name |
|
||||
| :----------- |
|
||||
| home |
|
||||
| home_actions |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List measurements that match a regular expression
|
||||
|
||||
To return only measurements with names that match a
|
||||
[regular expression](/influxdb/clustered/reference/influxql/regular-expressions/),
|
||||
include a `WITH` clause that compares the `MEASUREMENT` to a regular expression.
|
||||
|
||||
```sql
|
||||
SHOW MEASUREMENTS WITH MEASUREMENT =~ /^home/
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "2" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: measurements
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| name |
|
||||
| :----------- |
|
||||
| home |
|
||||
| home_actions |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
## List field keys in a measurement
|
||||
|
||||
Use [`SHOW FIELD KEYS`](/influxdb/clustered/reference/influxql/show/#show-field-keys)
|
||||
to return all field keys in a measurement.
|
||||
Include a `FROM` clause to specify the measurement.
|
||||
If no measurement is specified, the query returns all field keys in the bucket.
|
||||
|
||||
```sql
|
||||
SHOW FIELD KEYS FROM home
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "3" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| fieldKey | fieldType |
|
||||
| :------- | :-------- |
|
||||
| co | integer |
|
||||
| hum | float |
|
||||
| temp | float |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
## List tag keys in a measurement
|
||||
|
||||
Use [`SHOW TAG KEYS`](/influxdb/clustered/reference/influxql/show/#show-field-keys)
|
||||
to return all tag keys in a measurement.
|
||||
Include a `FROM` clause to specify the measurement.
|
||||
If no measurement is specified, the query returns all tag keys in the bucket.
|
||||
|
||||
```sql
|
||||
SHOW TAG KEYS FROM home_actions
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "4" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| tagKey |
|
||||
| :----- |
|
||||
| action |
|
||||
| level |
|
||||
| room |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag keys in measurements that contain a specific tag key-value pair
|
||||
|
||||
To return all tag keys measurements that contain specific tag key-value pairs,
|
||||
include a `WHERE` clause with the tag key-value pairs to query for.
|
||||
|
||||
```sql
|
||||
SHOW TAG KEYS WHERE room = 'Kitchen'
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "5" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| tagKey |
|
||||
| :----- |
|
||||
| room |
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| tagKey |
|
||||
| :----- |
|
||||
| action |
|
||||
| level |
|
||||
| room |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
## List tag values for a specific tag key
|
||||
|
||||
Use [`SHOW TAG VALUES`](/influxdb/clustered/reference/influxql/show/#show-field-values)
|
||||
to return all values for specific tags in a measurement.
|
||||
|
||||
- Include a `FROM` clause to specify the measurement.
|
||||
If no measurement is specified, the query returns all tag values from the
|
||||
specified tag keys in the bucket.
|
||||
- Use the `WITH` clause to compare `KEY` to tag keys to list the values of.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES FROM weather WITH KEY = location
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "5" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: weather
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :------- | :------------ |
|
||||
| location | Concord |
|
||||
| location | Hayward |
|
||||
| location | San Francisco |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag values for multiple tags
|
||||
|
||||
To return tag values for multiple specific tag keys, use the `IN` operator in
|
||||
the `WITH` clause to compare `KEY` to a list of tag keys.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES FROM home_actions WITH KEY IN ("level", "action")
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "6" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :----- | :---- |
|
||||
| action | alert |
|
||||
| action | cool |
|
||||
| level | ok |
|
||||
| level | warn |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag values for tags that match a regular expression
|
||||
|
||||
To return only tag values from tags keys that match a regular expression, use
|
||||
regular expression comparison operators in your `WITH` clause to compare `KEY`
|
||||
to the regular expression.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES WITH KEY =~ /oo/
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "7" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :--- | :---------- |
|
||||
| room | Kitchen |
|
||||
| room | Living Room |
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :--- | :---------- |
|
||||
| room | Kitchen |
|
||||
| room | Living Room |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
||||
#### List tag values associated with a specific tag key-value pair
|
||||
|
||||
To list tag values for tags associated with a specific tag key-value pair:
|
||||
|
||||
- Use the `WITH` clause to identify what tag keys to return values for.
|
||||
- Include a `WHERE` clause that identifies the tag key-value pair to query for.
|
||||
|
||||
The following example returns tag values for the `action` and `level` tags for
|
||||
points where the `room` tag value is `Kitchen`.
|
||||
|
||||
```sql
|
||||
SHOW TAG VALUES WITH KEY IN ("action", "level") WHERE room = 'Kitchen'
|
||||
```
|
||||
|
||||
{{< expand-wrapper >}}
|
||||
{{% expand "View example output" "8" %}}
|
||||
|
||||
{{% influxql/table-meta %}}
|
||||
name: home_actions
|
||||
{{% /influxql/table-meta %}}
|
||||
|
||||
| key | value |
|
||||
| :----- | :---- |
|
||||
| action | alert |
|
||||
| action | cool |
|
||||
| level | ok |
|
||||
| level | warn |
|
||||
|
||||
{{% /expand %}}
|
||||
{{< /expand-wrapper >}}
|
||||
|
|
@ -12,6 +12,8 @@ list_code_example: |
|
|||
```sql
|
||||
SHOW [MEASUREMENTS | FIELD KEYS | TAG KEYS | TAG VALUES]
|
||||
```
|
||||
related:
|
||||
- /influxdb/clustered/query-data/influxql/explore-schema/
|
||||
---
|
||||
|
||||
Use InfluxQL `SHOW` statements to query schema information from a database.
|
||||
|
|
|
|||
Loading…
Reference in New Issue