---
title: Explore your data schema with Flux
description: Flux provides functions that let you explore the structure and schema of your data stored in InfluxDB.
url: https://docs.influxdata.com/influxdb/cloud/query-data/flux/explore-schema/
estimated_tokens: 1939
product: InfluxDB Cloud (TSM)
version: cloud
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/cloud/query-data/flux/explore-schema/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---

Flux provides functions that let you explore the structure and schema of your
data stored in InfluxDB.

* [List buckets](#list-buckets)
* [List measurements](#list-measurements)
* [List field keys](#list-field-keys)
* [List tag keys](#list-tag-keys)
* [List tag values](#list-tag-values)

Functions in the `schema` package are not supported in the [Flux REPL](/influxdb/cloud/tools/repl/).

## List buckets

Use [`buckets()`](/flux/v0/stdlib/universe/buckets/)to list **buckets in your organization**.

```js
buckets()
```

[](#view-example-buckets-output)

View example `buckets()` output

`buckets()` returns a single table with the following columns:

* **organizationID**: Organization ID
* **name**: Bucket name
* **id**: Bucket ID
* **retentionPolicy**: Retention policy associated with the bucket
* **retentionPeriod**: Retention period in nanoseconds

|organizationID|      name      |  id   |retentionPolicy|retentionPeriod|
|--------------|----------------|-------|---------------|---------------|
|   XooX0x0    |  \_monitoring  |XooX0x1|               |604800000000000|
|   XooX0x0    |    \_tasks     |XooX0x2|               |259200000000000|
|   XooX0x0    |example-bucket-1|XooX0x3|               |       0       |
|   XooX0x0    |example-bucket-2|XooX0x4|               |       0       |
|   XooX0x0    |example-bucket-3|XooX0x5|               |172800000000000|

## List measurements

Use [`schema.measurements()`](/flux/v0/stdlib/influxdata/influxdb/schema/measurements)to list **measurements in a bucket**.*By default, this function returns results from the last 30 days.*

```js
import "influxdata/influxdb/schema"

schema.measurements(bucket: "example-bucket")
```

[](#view-example-schemameasurements-output)

View example `schema.measurements()` output

`schema.measurements()` returns a single table with a `_value` column.
Each row contains the name of a measurement.

|\_value|
|-------|
|  m1   |
|  m2   |
|  m3   |
|  m4   |
|  m5   |

## List field keys

Use [`schema.fieldKeys`](/flux/v0/stdlib/influxdata/influxdb/schema/fieldkeys)to list **field keys in a bucket**.*By default, this function returns results from the last 30 days.*

```js
import "influxdata/influxdb/schema"

schema.fieldKeys(bucket: "example-bucket")
```

[](#view-example-schemafieldkeys-output)

View example `schema.fieldKeys()` output

`schema.fieldKeys()` returns a single table with a `_value` column.
Each row contains a unique field key from the specified bucket.

|\_value|
|-------|
|field1 |
|field2 |
|field3 |
|field4 |
|field5 |

### List fields in a measurement

Use [`schema.measurementFieldKeys`](/flux/v0/stdlib/influxdata/influxdb/schema/measurementfieldkeys)to list **field keys in a measurement**.*By default, this function returns results from the last 30 days.*

```js
import "influxdata/influxdb/schema"

schema.measurementFieldKeys(
    bucket: "example-bucket",
    measurement: "example-measurement",
)
```

[](#view-example-schemameasurementfieldkeys-output)

View example `schema.measurementFieldKeys()` output

`schema.measurementFieldKeys()` returns a single table with a `_value` column.
Each row contains the name of a unique field key in the specified bucket and measurement.

|\_value|
|-------|
|field1 |
|field2 |
|field3 |
|field4 |
|field5 |

## List tag keys

Use [`schema.tagKeys()`](/flux/v0/stdlib/influxdata/influxdb/schema/tagkeys)to list **tag keys in a bucket**.*By default, this function returns results from the last 30 days.*

```js
import "influxdata/influxdb/schema"

schema.tagKeys(bucket: "example-bucket")
```

[](#view-example-schematagkeys-output)

View example `schema.tagKeys()` output

`schema.tagKeys()` returns a single table with a `_value` column.
Each row contains the a unique tag key from the specified bucket.

|\_value|
|-------|
| tag1  |
| tag2  |
| tag3  |
| tag4  |
| tag5  |

### List tag keys in a measurement

Use [`schema.measurementTagKeys`](/flux/v0/stdlib/influxdata/influxdb/schema/measurementtagkeys)to list **tag keys in a measurement**.*By default, this function returns results from the last 30 days.*

```js
import "influxdata/influxdb/schema"

schema.measurementTagKeys(
    bucket: "example-bucket",
    measurement: "example-measurement",
)
```

[](#view-example-schemameasurementtagkeys-output)

View example `schema.measurementTagKeys()` output

`schema.measurementTagKeys()` returns a single table with a `_value` column.
Each row contains a unique tag key from the specified bucket and measurement.

|\_value|
|-------|
| tag1  |
| tag2  |
| tag3  |
| tag4  |
| tag5  |

## List tag values

Use [`schema.tagValues()`](/flux/v0/stdlib/influxdata/influxdb/schema/tagvalues)to list **tag values for a given tag in a bucket**.*By default, this function returns results from the last 30 days.*

```js
import "influxdata/influxdb/schema"

schema.tagValues(bucket: "example-bucket", tag: "example-tag")
```

[](#view-example-schematagvalues-output)

View example `schema.tagValues()` output

`schema.tagValues()` returns a single table with a `_value` column.
Each row contains a unique tag value from the specified bucket and tag key.

| \_value |
|---------|
|tagValue1|
|tagValue2|
|tagValue3|
|tagValue4|
|tagValue5|

### List tag values in a measurement

Use [`schema.measurementTagValues`](/flux/v0/stdlib/influxdata/influxdb/schema/measurementtagvalues)to list **tag values for a given tag in a measurement**.*By default, this function returns results from the last 30 days.*

```js
import "influxdata/influxdb/schema"

schema.measurementTagValues(
    bucket: "example-bucket",
    tag: "example-tag",
    measurement: "example-measurement",
)
```

[](#view-example-schemameasurementtagvalues-output)

View example `schema.measurementTagValues()` output

`schema.measurementTagValues()` returns a single table with a `_value` column.
Each row contains a unique tag value from the specified bucket, measurement,
and tag key.

| \_value |
|---------|
|tagValue1|
|tagValue2|
|tagValue3|
|tagValue4|
|tagValue5|

#### Related

* [schema.measurements() function](/flux/v0/stdlib/influxdata/influxdb/schema/measurements/)
* [schema.fieldKeys() function](/flux/v0/stdlib/influxdata/influxdb/schema/fieldkeys/)
* [schema.measurementFieldKeys() function](/flux/v0/stdlib/influxdata/influxdb/schema/measurementfieldkeys/)
* [schema.tagKeys() function](/flux/v0/stdlib/influxdata/influxdb/schema/tagkeys/)
* [schema.measurementTagKeys() function](/flux/v0/stdlib/influxdata/influxdb/schema/measurementtagkeys/)
* [schema.tagValues() function](/flux/v0/stdlib/influxdata/influxdb/schema/tagvalues/)
* [schema.measurementTagValues() function](/flux/v0/stdlib/influxdata/influxdb/schema/measurementtagvalues/)

[schema](/influxdb/cloud/tags/schema/)
| organizationID | name | id | retentionPolicy | retentionPeriod |
| --- | --- | --- | --- | --- |
| organizationID | name | id | retentionPolicy | retentionPeriod |
| XooX0x0 | _monitoring | XooX0x1 |  | 604800000000000 |
| XooX0x0 | _tasks | XooX0x2 |  | 259200000000000 |
| XooX0x0 | example-bucket-1 | XooX0x3 |  | 0 |
| XooX0x0 | example-bucket-2 | XooX0x4 |  | 0 |
| XooX0x0 | example-bucket-3 | XooX0x5 |  | 172800000000000 |

| _value |
| --- |
| _value |
| m1 |
| m2 |
| m3 |
| m4 |
| m5 |

| _value |
| --- |
| _value |
| field1 |
| field2 |
| field3 |
| field4 |
| field5 |

| _value |
| --- |
| _value |
| field1 |
| field2 |
| field3 |
| field4 |
| field5 |

| _value |
| --- |
| _value |
| tag1 |
| tag2 |
| tag3 |
| tag4 |
| tag5 |

| _value |
| --- |
| _value |
| tag1 |
| tag2 |
| tag3 |
| tag4 |
| tag5 |

| _value |
| --- |
| _value |
| tagValue1 |
| tagValue2 |
| tagValue3 |
| tagValue4 |
| tagValue5 |

| _value |
| --- |
| _value |
| tagValue1 |
| tagValue2 |
| tagValue3 |
| tagValue4 |
| tagValue5 |