Todos os produtos
Search

Este produto

    Time Series Database:Exploração de schema

    Central de documentação

    Time Series Database:Exploração de schema

    Última atualização: Jun 27, 2026

    O InfluxQL oferece instruções SHOW para inspecionar a estrutura dos bancos de dados no TSDB for InfluxDB®. Use essas instruções para listar bancos de dados, políticas de retenção, séries, medições, chaves de tag, valores de tag e chaves de campo.

    **SHOW DATABASES**

    **SHOW RETENTION POLICIES**

    **SHOW SERIES**

    SHOW MEASUREMENTS

    SHOW TAG KEYS

    SHOW TAG VALUES

    SHOW FIELD KEYS

    Baixe os dados de exemplo usados nesta página na página de dados de exemplo do InfluxDB .

    Dados de exemplo

    Para acompanhar os exemplos deste tópico, conecte-se à CLI do Influx:

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

    Use o console do Time Series Database (TSDB) para consultar informações do banco de dados e executar operações.

    SHOW DATABASES

    Retorna todos os bancos de dados que a conta tem permissão para consultar.

    Sintaxe

    SHOW DATABASES

    Exemplo

    > SHOW DATABASES

name: databases
name
----
NOAA_water_database
_internal

    Os resultados listam cada banco de dados em formato tabular. A conta tem permissão para consultar NOAA_water_database e _internal.

    SHOW RETENTION POLICIES

    Retorna as políticas de retenção de um banco de dados especificado.

    Sintaxe

    SHOW RETENTION POLICIES [ON <database_name>]

    A cláusula ON <database_name> é opcional. Sem ela, execute primeiro USE <database_name> na CLI do Influx ou defina o parâmetro db na requisição da API HTTP.

    Exemplos

    Com a cláusula ON

    > SHOW RETENTION POLICIES ON NOAA_water_database

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

    O banco de dados NOAA_water_database tem uma política de retenção: autogen. Esta é a política DEFAULT, com duração infinita (0s), duração de grupo de shards de sete dias (168h0m0s) e fator de replicação igual a 1.

    Sem a cláusula ON — usando a CLI

    > USE NOAA_water_database
Using database NOAA_water_database

> SHOW RETENTION POLICIES

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

    Sem a cláusula ON — usando a API HTTP

    ~# 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

    Retorna as séries em um banco de dados especificado.

    Sintaxe

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

    Todas as cláusulas são opcionais. Não há suporte para comparação de campos; a cláusula WHERE aceita apenas comparações de tags. Para obter detalhes sobre FROM, LIMIT e OFFSET, consulte a documentação de exploração de dados.

    Operadores suportados na cláusula WHERE

    Operador

    Significado

    =

    Igual

    <>

    Diferente

    !=

    Diferente

    =~

    Correspondência

    !~

    Sem correspondência

    Exemplos

    Com a cláusula ON

    > 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

    Os resultados seguem o formato de protocolo de linha: o elemento antes da primeira vírgula é o nome da medição, e os elementos subsequentes são pares chave-valor de tag. O banco de dados NOAA_water_database tem 5 medições e 14 séries.

    Sem a cláusula ON — usando a CLI

    > 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

    Sem a cláusula ON — usando a API HTTP

    ~# 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"]
                    ]
                }
            ]
        }
    ]
}

    Com múltiplas cláusulas

    > 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

    Retorna todas as séries em NOAA_water_database que incluem a medição h2o_quality e a tag location=coyote_creek. A instrução LIMIT 2 restringe os resultados a duas séries.

    SHOW MEASUREMENTS

    Retorna as medições em um banco de dados especificado.

    Sintaxe

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

    Todas as cláusulas são opcionais. Não há suporte para comparação de campos; a cláusula WHERE aceita apenas comparações de tags. Para obter detalhes sobre LIMIT e OFFSET, consulte a documentação de exploração de dados.

    Operadores suportados na cláusula WHERE

    Operador

    Significado

    =

    Igual

    <>

    Diferente

    !=

    Diferente

    =~

    Correspondência

    !~

    Sem correspondência

    Exemplos

    Com a cláusula ON

    > SHOW MEASUREMENTS ON NOAA_water_database

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

    O banco de dados NOAA_water_database tem cinco medições: average_temperature, h2o_feet, h2o_pH, h2o_quality e h2o_temperature.

    Sem a cláusula ON — usando a CLI

    > USE NOAA_water_database
Using database NOAA_water_database

> SHOW MEASUREMENTS

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

    Sem a cláusula ON — usando a API HTTP

    ~# 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"]
                    ]
                }
            ]
        }
    ]
}

    Com regex e LIMIT/OFFSET

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

name: measurements
name
----
h2o_pH
h2o_quality

    Retorna medições cujos nomes correspondem a h2o.* em NOAA_water_database. A instrução LIMIT 2 limita os resultados a dois itens. Já OFFSET 1 ignora a primeira correspondência (h2o_feet), fazendo com que os resultados comecem em h2o_pH.

    Com regex e filtro de tag

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

name: measurements
name
----
h2o_quality

    Retorna medições em NOAA_water_database cujos nomes correspondem a h2o.* e possuem pelo menos um valor numérico para randtag.

    SHOW TAG KEYS

    Retorna as chaves de tag em um banco de dados especificado.

    Sintaxe

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

    As cláusulas ON, FROM e WHERE são opcionais. Não há suporte para comparação de campos. Para obter detalhes sobre FROM, LIMIT e OFFSET, consulte a documentação de exploração de dados.

    Operadores suportados na cláusula WHERE

    Operador

    Significado

    =

    Igual

    <>

    Diferente

    !=

    Diferente

    =~

    Correspondência

    !~

    Sem correspondência

    Exemplos

    Com a cláusula ON

    > 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

    Os resultados são agrupados por medição. Todas as medições possuem a chave de tag location. A medição h2o_quality tem duas chaves de tag: location e randtag.

    Sem a cláusula ON — usando a CLI

    > 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

    Sem a cláusula ON — usando a API HTTP

    ~# 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"]]
                }
            ]
        }
    ]
}

    Com múltiplas cláusulas

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

name: h2o_quality
tagKey
------
randtag

    Retorna chaves de tag da medição h2o_quality em NOAA_water_database. A instrução LIMIT 1 restringe os resultados a uma chave de tag. Como OFFSET 1 ignora location, o resultado começa em randtag.

    SHOW TAG VALUES

    Retorna os valores de tag para chaves de tag especificadas em um banco de dados.

    Sintaxe

    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]

    As cláusulas ON, FROM, WHERE, LIMIT e OFFSET são opcionais. A cláusula WITH KEY é obrigatória: especifique uma ou mais chaves de tag ou uma expressão regular. Não há suporte para comparação de campos. Para obter detalhes sobre FROM, LIMIT e OFFSET, consulte a documentação de exploração de dados.

    Operadores suportados nas cláusulas WITH e WHERE

    Operador

    Significado

    =

    Igual

    <>

    Diferente

    !=

    Diferente

    =~

    Correspondência

    !~

    Sem correspondência

    Exemplos

    Com a cláusula ON

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

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

    Retorna todos os valores da chave de tag randtag em NOAA_water_database. Os resultados são agrupados por medição.

    Sem a cláusula ON — usando a CLI

    > 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

    Sem a cláusula ON — usando a API HTTP

    ~# 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"]
                    ]
                }
            ]
        }
    ]
}

    Com múltiplas cláusulas

    > 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

    Retorna até três valores de tag das medições em NOAA_water_database onde a chave de tag é location ou randtag e o valor de randtag não é nulo.

    SHOW FIELD KEYS

    Retorna chaves de campo e os tipos de dados de seus valores.

    Sintaxe

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

    Ambas as cláusulas são opcionais. Para obter detalhes sobre FROM, consulte a documentação de exploração de dados.

    Os tipos de dados dos valores de campo podem variar entre shards. Quando existem vários tipos de dados para a mesma chave de campo, SHOW FIELD KEYS os retorna nesta ordem: float, integer, string, boolean.

    Exemplos

    Com a cláusula ON

    > 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

    Retorna todas as chaves de campo e seus tipos de dados para cada medição em NOAA_water_database.

    Sem a cláusula ON — usando a CLI

    > 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

    Sem a cláusula ON — usando a API HTTP

    ~# 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"]]
                }
            ]
        }
    ]
}

    Para uma única medição

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

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

    Retorna apenas as chaves de campo e tipos de dados da medição h2o_feet.

    Perguntas frequentes sobre SHOW FIELD KEYS

    Por que SHOW FIELD KEYS exibe vários tipos de dados para a mesma chave de campo?

    Os tipos de dados dos valores de campo devem ser consistentes dentro de um shard, mas podem diferir entre shards. A instrução SHOW FIELD KEYS relata o tipo de dados associado a cada chave de campo em cada shard.

    Por exemplo, se o campo all_the_types foi gravado com diferentes tipos de dados em vários shards:

    > SHOW FIELD KEYS

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

    A instrução SHOW FIELD KEYS trata diferenças de tipo entre shards de forma diferente da instrução SELECT. Consulte o tópico de perguntas frequentes para obter detalhes.

    InfluxDB® é uma marca registrada da InfluxData, que não é afiliada e não endossa o TSDB for InfluxDB®.