全部产品
Search
文档中心

Time Series Database:Eksplorasi Skema

更新时间:Jun 28, 2025

InfluxQL adalah bahasa serupa SQL yang digunakan untuk melakukan operasi pada data yang disimpan di TSDB untuk InfluxDB®. Bagian berikut menjelaskan sintaksis InfluxQL yang dapat digunakan untuk menanyakan skema Anda.

SHOW DATABASES

SHOW RETENTION POLICIES

SHOW SERIES

SHOW MEASUREMENTS

SHOW TAG KEYS

SHOW TAG VALUES

SHOW FIELD KEYS

-

-

Catatan

Untuk mengunduh data sampel yang digunakan dalam topik ini, lihat Data Sampel.

Data Sampel

Sebelum memulai penjelasan skema, masuk ke CLI Influx.

$ influx -precision rfc3339
Connected to http://localhost:8086 version 1.7.x
InfluxDB shell 1.7.x
>

Penting

Disarankan menggunakan Konsol Time Series Database (TSDB) untuk menanyakan informasi database dan melakukan operasi terkait database.

SHOW DATABASES

Mengembalikan semua database yang akun Anda memiliki izin untuk ditanyakan.

SHOW DATABASES

Contoh

Jalankan kueri SHOW DATABASES

> SHOW DATABASES

name: databases
name
----
NOAA_water_database
_internal

Kueri sebelumnya mengembalikan nama database dalam format tabel. Akun tersebut memiliki izin untuk menanyakan database NOAA_water_database dan database _internal.

SHOW RETENTION POLICIES

Mengembalikan kebijakan retensi data dari database yang ditentukan.

SHOW RETENTION POLICIES [ON <database_name>]

Deskripsi Sintaksis

Klausa ON <database_name> bersifat opsional. Jika kueri Anda tidak mengandung ON <database_name>, Anda harus menjalankan pernyataan USE <database_name> di CLI Influx atau menetapkan parameter db dalam permintaan API HTTP Anda untuk menentukan database yang ingin Anda tanyakan.

Contoh

Contoh 1: Jalankan kueri SHOW RETENTION POLICIES yang mengandung klausa ON <database_name>

> SHOW RETENTION POLICIES ON NOAA_water_database

name      duration   shardGroupDuration   replicaN   default
----      --------   ------------------   --------   -------
autogen   0s         168h0m0s             1          true

Kueri sebelumnya mengembalikan kebijakan retensi dari database NOAA_water_database dalam format tabel. Respons kueri menunjukkan bahwa database tersebut hanya memiliki satu kebijakan retensi bernama autogen. autogen adalah kebijakan retensi DEFAULT dari database. Kebijakan retensi ini memiliki durasi tak terbatas, durasi grup shard tujuh hari, dan faktor replikasi satu.

Contoh 2: Jalankan kueri SHOW RETENTION POLICIES yang tidak mengandung klausa ON <database_name>

Jalankan pernyataan USE <database_name> untuk menentukan database yang ingin Anda tanyakan

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW RETENTION POLICIES

name      duration   shardGroupDuration   replicaN   default
----      --------   ------------------   --------   -------
autogen   0s         168h0m0s             1          true

Tetapkan parameter db untuk menentukan database yang ingin Anda tanyakan

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode "q=SHOW RETENTION POLICIES"

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "columns": [
                        "name",
                        "duration",
                        "shardGroupDuration",
                        "replicaN",
                        "default"
                    ],
                    "values": [
                        [
                            "autogen",
                            "0s",
                            "168h0m0s",
                            1,
                            true
                        ]
                    ]
                }
            ]
        }
    ]
}

SHOW SERIES

Mengembalikan seri dari database yang ditentukan.

Sintaksis

SHOW SERIES [ON <database_name>] [FROM_clause] [WHERE <tag_key> <operator> [ '<tag_value>' | <regular_expression>]] [LIMIT_clause] [OFFSET_clause]

Deskripsi Sintaksis

Klausa ON <database_name> bersifat opsional. Jika kueri Anda tidak mengandung ON <database_name>, Anda harus menjalankan pernyataan USE <database_name> di CLI Influx atau menetapkan parameter db dalam permintaan API HTTP Anda untuk menentukan database yang ingin Anda tanyakan.

Klausa FROM, WHERE, LIMIT, dan OFFSET juga bersifat opsional. Perbandingan bidang tidak didukung dalam kueri SHOW SERIES. Dalam klausa WHERE, Anda dapat menggunakan operator yang dijelaskan dalam tabel berikut untuk membandingkan tag.

Tabel berikut menjelaskan operator yang dapat digunakan dalam klausa WHERE.

=

Sama dengan

<>

Tidak sama dengan

!=

Tidak sama dengan

=~

Cocok

!~

Tidak cocok

Untuk informasi lebih lanjut tentang ekspresi reguler dan klausa FROM, LIMIT, dan OFFSET, lihat bab Eksplorasi Data.

Contoh

Contoh 1: Jalankan kueri SHOW SERIES yang mengandung klausa ON <database_name>

> SHOW SERIES ON NOAA_water_database

key
---
average_temperature,location=coyote_creek
average_temperature,location=santa_monica
h2o_feet,location=coyote_creek
h2o_feet,location=santa_monica
h2o_pH,location=coyote_creek
h2o_pH,location=santa_monica
h2o_quality,location=coyote_creek,randtag=1
h2o_quality,location=coyote_creek,randtag=2
h2o_quality,location=coyote_creek,randtag=3
h2o_quality,location=santa_monica,randtag=1
h2o_quality,location=santa_monica,randtag=2
h2o_quality,location=santa_monica,randtag=3
h2o_temperature,location=coyote_creek
h2o_temperature,location=santa_monica

Kueri sebelumnya mengembalikan hasil dalam format yang mirip dengan format protokol baris. Elemen sebelum koma pertama (,) di setiap baris adalah nama pengukuran. Elemen yang mengikuti koma pertama (,) di setiap baris adalah kunci tag atau nilai tag. Respons kueri menunjukkan bahwa database NOAA_water_database memiliki 5 pengukuran berbeda dan 14 seri berbeda.

Contoh 2: Jalankan kueri SHOW SERIES yang tidak mengandung klausa ON <database_name>

Jalankan pernyataan USE <database_name> untuk menentukan database yang ingin Anda tanyakan

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW SERIES

key
---
average_temperature,location=coyote_creek
average_temperature,location=santa_monica
h2o_feet,location=coyote_creek
h2o_feet,location=santa_monica
h2o_pH,location=coyote_creek
h2o_pH,location=santa_monica
h2o_quality,location=coyote_creek,randtag=1
h2o_quality,location=coyote_creek,randtag=2
h2o_quality,location=coyote_creek,randtag=3
h2o_quality,location=santa_monica,randtag=1
h2o_quality,location=santa_monica,randtag=2
h2o_quality,location=santa_monica,randtag=3
h2o_temperature,location=coyote_creek
h2o_temperature,location=santa_monica

Tetapkan parameter db untuk menentukan database yang ingin Anda tanyakan

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode "q=SHOW SERIES"

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "columns": [
                        "key"
                    ],
                    "values": [
                        [
                            "average_temperature,location=coyote_creek"
                        ],
                        [
                            "average_temperature,location=santa_monica"
                        ],
                        [
                            "h2o_feet,location=coyote_creek"
                        ],
                        [
                            "h2o_feet,location=santa_monica"
                        ],
                        [
                            "h2o_pH,location=coyote_creek"
                        ],
                        [
                            "h2o_pH,location=santa_monica"
                        ],
                        [
                            "h2o_quality,location=coyote_creek,randtag=1"
                        ],
                        [
                            "h2o_quality,location=coyote_creek,randtag=2"
                        ],
                        [
                            "h2o_quality,location=coyote_creek,randtag=3"
                        ],
                        [
                            "h2o_quality,location=santa_monica,randtag=1"
                        ],
                        [
                            "h2o_quality,location=santa_monica,randtag=2"
                        ],
                        [
                            "h2o_quality,location=santa_monica,randtag=3"
                        ],
                        [
                            "h2o_temperature,location=coyote_creek"
                        ],
                        [
                            "h2o_temperature,location=santa_monica"
                        ]
                    ]
                }
            ]
        }
    ]
}

Contoh 3: Jalankan kueri SHOW SERIES yang mengandung beberapa klausa

> SHOW SERIES ON NOAA_water_database FROM "h2o_quality" WHERE "location" = 'coyote_creek' LIMIT 2

key
---
h2o_quality,location=coyote_creek,randtag=1
h2o_quality,location=coyote_creek,randtag=2

Kueri sebelumnya mengembalikan semua seri yang mencakup pengukuran h2o_quality dan pasangan nilai-tag location = coyote_creek dari database NOAA_water_database. Klausa LIMIT membatasi jumlah seri yang dikembalikan menjadi dua.

SHOW MEASUREMENTS

Mengembalikan pengukuran dalam database yang ditentukan.

Sintaksis

SHOW MEASUREMENTS [ON <database_name>] [WITH MEASUREMENT <regular_expression>] [WHERE <tag_key> <operator> ['<tag_value>' | <regular_expression>]] [LIMIT_clause] [OFFSET_clause]

Deskripsi Sintaksis

Klausa ON <database_name> bersifat opsional. Jika kueri Anda tidak mengandung ON <database_name>, Anda harus menjalankan pernyataan USE <database_name> di CLI Influx atau menetapkan parameter db dalam permintaan API HTTP Anda untuk menentukan database yang ingin Anda tanyakan.

Klausa WITH, WHERE, LIMIT, dan OFFSET bersifat opsional. Perbandingan bidang tidak didukung dalam kueri SHOW MEASUREMENTS. Dalam klausa WHERE, Anda dapat menggunakan operator yang dijelaskan dalam tabel berikut untuk membandingkan tag.

Tabel berikut menjelaskan operator yang dapat digunakan dalam klausa WHERE.

=

Sama dengan

<>

Tidak sama dengan

!=

Tidak sama dengan

=~

Cocok

!~

Tidak cocok

Untuk informasi lebih lanjut tentang ekspresi reguler dan klausa LIMIT dan OFFSET, lihat bab Eksplorasi Data.

Contoh

Contoh 1: Jalankan kueri SHOW MEASUREMENTS yang mengandung klausa ON <database_name>

> SHOW MEASUREMENTS ON NOAA_water_database

name: measurements
name
----
average_temperature
h2o_feet
h2o_pH
h2o_quality
h2o_temperature

Kueri sebelumnya mengembalikan pengukuran dalam database NOAA_water_database. Database NOAA_water_database memiliki pengukuran berikut: average_temperature, h2o_feet, h2o_pH, h2o_quality, dan h2o_temperature.

Contoh 2: Jalankan kueri SHOW MEASUREMENTS yang tidak mengandung klausa ON <database_name>

Jalankan pernyataan USE <database_name> untuk menentukan database yang ingin Anda tanyakan

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW MEASUREMENTS
name: measurements
name
----
average_temperature
h2o_feet
h2o_pH
h2o_quality
h2o_temperature

Tetapkan parameter db untuk menentukan database yang ingin Anda tanyakan

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode "q=SHOW MEASUREMENTS"

{
  {
      "results": [
          {
              "statement_id": 0,
              "series": [
                  {
                      "name": "measurements",
                      "columns": [
                          "name"
                      ],
                      "values": [
                          [
                              "average_temperature"
                          ],
                          [
                              "h2o_feet"
                          ],
                          [
                              "h2o_pH"
                          ],
                          [
                              "h2o_quality"
                          ],
                          [
                              "h2o_temperature"
                          ]
                      ]
                  }
              ]
          }
      ]
  }

Contoh 3: Jalankan kueri SHOW MEASUREMENTS yang mengandung beberapa klausa (i)

> SHOW MEASUREMENTS ON NOAA_water_database WITH MEASUREMENT =~ /h2o.*/ LIMIT 2 OFFSET 1

name: measurements
name
----
h2o_pH
h2o_quality

Kueri sebelumnya mengembalikan pengukuran yang namanya dimulai dengan h2o dalam database NOAA_water_database. Klausa LIMIT membatasi jumlah pengukuran yang dikembalikan menjadi dua. Klausa OFFSET melewati h2o_feet. Kueri mengembalikan dua pengukuran pertama yang muncul setelah h2o_feet.

Contoh 4: Jalankan kueri SHOW MEASUREMENTS yang mengandung beberapa klausa (ii)

> SHOW MEASUREMENTS ON NOAA_water_database WITH MEASUREMENT =~ /h2o.*/ WHERE "randtag"  =~ /\d/

name: measurements
name
----
h2o_quality

Kueri sebelumnya mengembalikan pengukuran yang memenuhi persyaratan tertentu dalam database NOAA_water_database. Salah satu persyaratannya adalah nama pengukuran harus dimulai dengan h2o. Persyaratan lainnya adalah nilai tag randtag harus mencakup setidaknya satu bilangan bulat.

SHOW TAG KEYS

Mengembalikan kunci tag dalam database yang ditentukan.

Sintaksis

SHOW TAG KEYS [ON <database_name>] [FROM_clause] [WHERE <tag_key> <operator> ['<tag_value>' | <regular_expression>]] [LIMIT_clause] [OFFSET_clause]

Deskripsi Sintaksis

Klausa ON <database_name> bersifat opsional. Jika kueri Anda tidak mengandung ON <database_name>, Anda harus menjalankan pernyataan USE <database_name> di CLI Influx atau menetapkan parameter db dalam permintaan API HTTP Anda untuk menentukan database yang ingin Anda tanyakan.

Klausa FROM dan WHERE bersifat opsional. Perbandingan bidang tidak didukung dalam kueri SHOW TAG KEYS. Dalam klausa WHERE, Anda dapat menggunakan operator yang dijelaskan dalam tabel berikut untuk membandingkan tag.

Tabel berikut menjelaskan operator yang dapat digunakan dalam klausa WHERE.

=

Sama dengan

<>

Tidak sama dengan

!=

Tidak sama dengan

=~

Cocok

!~

Tidak cocok

Untuk informasi lebih lanjut tentang ekspresi reguler dan klausa FROM, LIMIT, dan OFFSET, lihat bab Eksplorasi Data.

Contoh

Contoh 1: Jalankan kueri SHOW TAG KEYS yang mengandung klausa ON <database_name>

> SHOW TAG KEYS ON "NOAA_water_database"

name: average_temperature
tagKey
------
location

name: h2o_feet
tagKey
------
location

name: h2o_pH
tagKey
------
location

name: h2o_quality
tagKey
------
location
randtag

name: h2o_temperature
tagKey
------
location

Kueri sebelumnya mengembalikan kunci tag dalam database NOAA_water_database. Hasil dikelompokkan berdasarkan nama pengukuran. Hasil menunjukkan bahwa setiap pengukuran memiliki kunci tag location. Pengukuran h2o_quality memiliki dua kunci tag: randtag dan location.

Contoh 2: Jalankan kueri SHOW TAG KEYS yang tidak mengandung klausa ON <database_name>

Jalankan pernyataan USE <database_name> untuk menentukan database yang ingin Anda tanyakan

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW TAG KEYS

name: average_temperature
tagKey
------
location

name: h2o_feet
tagKey
------
location

name: h2o_pH
tagKey
------
location

name: h2o_quality
tagKey
------
location
randtag

name: h2o_temperature
tagKey
------
location

Tetapkan parameter db untuk menentukan database yang ingin Anda tanyakan

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode "q=SHOW TAG KEYS"

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "name": "average_temperature",
                    "columns": [
                        "tagKey"
                    ],
                    "values": [
                        [
                            "location"
                        ]
                    ]
                },
                {
                    "name": "h2o_feet",
                    "columns": [
                        "tagKey"
                    ],
                    "values": [
                        [
                            "location"
                        ]
                    ]
                },
                {
                    "name": "h2o_pH",
                    "columns": [
                        "tagKey"
                    ],
                    "values": [
                        [
                            "location"
                        ]
                    ]
                },
                {
                    "name": "h2o_quality",
                    "columns": [
                        "tagKey"
                    ],
                    "values": [
                        [
                            "location"
                        ],
                        [
                            "randtag"
                        ]
                    ]
                },
                {
                    "name": "h2o_temperature",
                    "columns": [
                        "tagKey"
                    ],
                    "values": [
                        [
                            "location"
                        ]
                    ]
                }
            ]
        }
    ]
}

Contoh 3: Jalankan kueri SHOW TAG KEYS yang mengandung beberapa klausa

> SHOW TAG KEYS ON "NOAA_water_database" FROM "h2o_quality" LIMIT 1 OFFSET 1

name: h2o_quality
tagKey
------
randtag

Kueri sebelumnya mengembalikan kunci tag dari pengukuran h2o_quality dalam database NOAA_water_database. Klausa LIMIT membatasi jumlah kunci tag yang dikembalikan menjadi satu. Klausa OFFSET melewati pengukuran pertama.

SHOW TAG VALUES

Mengembalikan nilai tag dari kunci tag yang ditentukan dalam database yang ingin Anda tanyakan.

Sintaksis

SHOW TAG VALUES [ON <database_name>][FROM_clause] WITH KEY [ [<operator> "<tag_key>" | <regular_expression>] | [IN ("<tag_key1>","<tag_key2")]] [WHERE <tag_key> <operator> ['<tag_value>' | <regular_expression>]] [LIMIT_clause] [OFFSET_clause]

Deskripsi Sintaksis

Klausa ON <database_name> bersifat opsional. Jika kueri Anda tidak mengandung ON <database_name>, Anda harus menjalankan pernyataan USE <database_name> di CLI Influx atau menetapkan parameter db dalam permintaan API HTTP Anda untuk menentukan database yang ingin Anda tanyakan.

Klausa WITH wajib. Anda dapat menentukan satu ekspresi reguler atau satu atau lebih kunci tag dalam klausa WITH.

Klausa FROM, WHERE, LIMIT, dan OFFSET bersifat opsional. Perbandingan bidang tidak didukung dalam kueri SHOW TAG VALUES. Dalam klausa WHERE, Anda dapat menggunakan operator yang dijelaskan dalam tabel berikut untuk membandingkan tag.

Tabel berikut menjelaskan operator yang dapat digunakan dalam klausa WITH dan WHERE.

=

Sama dengan

<>

Tidak sama dengan

!=

Tidak sama dengan

=~

Cocok

!~

Tidak cocok

Untuk informasi lebih lanjut tentang ekspresi reguler dan klausa FROM, LIMIT, dan OFFSET, lihat bab Eksplorasi Data.

Contoh

Contoh 1: Jalankan kueri SHOW TAG VALUES yang mengandung klausa ON <database_name>

> SHOW TAG VALUES ON "NOAA_water_database" WITH KEY = "randtag"

name: h2o_quality
key       value
---       -----
randtag   1
randtag   2
randtag   3

Kueri sebelumnya mengembalikan semua nilai tag dari kunci tag randtag dalam database NOAA_water_database. SHOW TAG VALUES mengelompokkan hasil berdasarkan nama pengukuran.

Contoh 2: Jalankan kueri SHOW TAG VALUES yang tidak mengandung klausa ON <database_name>

Jalankan pernyataan USE <database_name> untuk menentukan database yang ingin Anda tanyakan

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW TAG VALUES WITH KEY = "randtag"

name: h2o_quality
key       value
---       -----
randtag   1
randtag   2
randtag   3

Tetapkan parameter db untuk menentukan database yang ingin Anda tanyakan

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode 'q=SHOW TAG VALUES WITH KEY = "randtag"'

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "name": "h2o_quality",
                    "columns": [
                        "key",
                        "value"
                    ],
                    "values": [
                        [
                            "randtag",
                            "1"
                        ],
                        [
                            "randtag",
                            "2"
                        ],
                        [
                            "randtag",
                            "3"
                        ]
                    ]
                }
            ]
        }
    ]
}

Contoh 3: Jalankan kueri SHOW TAG VALUES yang mengandung beberapa klausa

> SHOW TAG VALUES ON "NOAA_water_database" WITH KEY IN ("location","randtag") WHERE "randtag" =~ /./ LIMIT 3

name: h2o_quality
key        value
---        -----
location   coyote_creek
location   santa_monica
randtag    1

Kueri sebelumnya mengembalikan nilai tag yang memenuhi persyaratan tertentu dari pengukuran dalam database NOAA_water_database. Persyaratannya adalah bahwa kunci tag harus location atau randtag, dan nilai dari kunci tag randtag tidak boleh berupa nilai NULL. Klausa LIMIT membatasi jumlah nilai tag yang dikembalikan menjadi tiga.

SHOW FIELD KEYS

Mengembalikan kunci bidang dan tipe data dari nilai bidang.

Sintaksis

SHOW FIELD KEYS [ON <database_name>] [FROM <measurement_name>]

Deskripsi Sintaksis

Klausa ON <database_name> bersifat opsional. Jika kueri Anda tidak mengandung ON <database_name>, Anda harus menjalankan pernyataan USE <database_name> di CLI Influx atau menetapkan parameter db dalam permintaan API HTTP Anda untuk menentukan database yang ingin Anda tanyakan.

Klausa FROM juga bersifat opsional. Untuk informasi lebih lanjut tentang klausa FROM, lihat bab Eksplorasi Data.

Catatan

Catatan: Tipe data dari nilai bidang dapat berbeda di antara shard. Jika beberapa tipe data akan dikembalikan, pernyataan SHOW FIELD KEYS mengembalikan hasil berdasarkan urutan berikut: FLOAT, INTEGER, STRING, BOOLEAN.

Contoh

Contoh 1: Jalankan kueri SHOW FIELD KEYS yang mengandung klausa ON <database_name>

> SHOW FIELD KEYS ON "NOAA_water_database"

name: average_temperature
fieldKey            fieldType
--------            ---------
degrees             float

name: h2o_feet
fieldKey            fieldType
--------            ---------
level description   string
water_level         float

name: h2o_pH
fieldKey            fieldType
--------            ---------
pH                  float

name: h2o_quality
fieldKey            fieldType
--------            ---------
index               float

name: h2o_temperature
fieldKey            fieldType
--------            ---------
degrees             float

Kueri sebelumnya mengembalikan kunci bidang dan tipe data dari nilai bidang dari setiap pengukuran dalam database NOAA_water_database.

Contoh 2: Jalankan kueri SHOW FIELD KEYS yang tidak mengandung klausa ON <database_name>

Jalankan pernyataan USE <database_name> untuk menentukan database yang ingin Anda tanyakan

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW FIELD KEYS

name: average_temperature
fieldKey            fieldType
--------            ---------
degrees             float

name: h2o_feet
fieldKey            fieldType
--------            ---------
level description   string
water_level         float

name: h2o_pH
fieldKey            fieldType
--------            ---------
pH                  float

name: h2o_quality
fieldKey            fieldType
--------            ---------
index               float

name: h2o_temperature
fieldKey            fieldType
--------            ---------
degrees             float

Tetapkan parameter db untuk menentukan database yang ingin Anda tanyakan

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode 'q=SHOW FIELD KEYS'

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "name": "average_temperature",
                    "columns": [
                        "fieldKey",
                        "fieldType"
                    ],
                    "values": [
                        [
                            "degrees",
                            "float"
                        ]
                    ]
                },
                {
                    "name": "h2o_feet",
                    "columns": [
                        "fieldKey",
                        "fieldType"
                    ],
                    "values": [
                        [
                            "level description",
                            "string"
                        ],
                        [
                            "water_level",
                            "float"
                        ]
                    ]
                },
                {
                    "name": "h2o_pH",
                    "columns": [
                        "fieldKey",
                        "fieldType"
                    ],
                    "values": [
                        [
                            "pH",
                            "float"
                        ]
                    ]
                },
                {
                    "name": "h2o_quality",
                    "columns": [
                        "fieldKey",
                        "fieldType"
                    ],
                    "values": [
                        [
                            "index",
                            "float"
                        ]
                    ]
                },
                {
                    "name": "h2o_temperature",
                    "columns": [
                        "fieldKey",
                        "fieldType"
                    ],
                    "values": [
                        [
                            "degrees",
                            "float"
                        ]
                    ]
                }
            ]
        }
    ]
}

Contoh 3: Jalankan kueri SHOW FIELD KEYS yang mengandung klausa FROM

> SHOW FIELD KEYS ON "NOAA_water_database" FROM "h2o_feet"

name: h2o_feet
fieldKey            fieldType
--------            ---------
level description   string
water_level         float

Kueri sebelumnya mengembalikan kunci bidang dan tipe data dari nilai bidang dari pengukuran h2o_feet dalam database NOAA_water_database.

FAQ tentang SHOW FIELD KEYS

Pertanyaan 1: SHOW FIELD KEYS dan perbedaan dalam tipe data nilai bidang

Tipe data dari nilai bidang harus sama dalam satu shard. Tipe data dari nilai bidang dapat berbeda di antara shard. Pernyataan SHOW FIELD KEYS mengembalikan tipe data dari nilai bidang yang terkait dengan kunci bidang di setiap shard.

Contoh

Blok kode berikut menunjukkan bahwa bidang all_the_types menyimpan empat tipe data:

> SHOW FIELD KEYS

name: mymeas
fieldKey        fieldType
--------        ---------
all_the_types   integer
all_the_types   float
all_the_types   string
all_the_types   boolean
Penting

Pernyataan SHOW FIELD KEYS menangani perbedaan dalam tipe data nilai bidang dengan cara yang berbeda dari pernyataan SELECT. Untuk informasi lebih lanjut, lihat topik FAQ.

InfluxDB® adalah merek dagang terdaftar oleh InfluxData, yang tidak berafiliasi dengan, dan tidak mendukung, TSDB untuk InfluxDB®.