Schema exploration - Time Series Database - Centre de documentation Alibaba Cloud

InfluxQL fournit des instructions SHOW pour inspecter la structure des bases de données dans TSDB for InfluxDB®. Utilisez ces instructions pour lister les bases de données, les politiques de rétention, les séries, les mesures, les clés de tag, les valeurs de tag et les clés de champ.

SHOW DATABASES	SHOW RETENTION POLICIES	SHOW SERIES
SHOW MEASUREMENTS	SHOW TAG KEYS	SHOW TAG VALUES
SHOW FIELD KEYS

Téléchargez les exemples de données utilisés dans cette rubrique depuis la page des données d'exemple InfluxDB .

Données d'exemple

Pour suivre les exemples de cette rubrique, connectez-vous à l'interface CLI Influx :

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

Important

Utilisez la console Time Series Database (TSDB) pour interroger les informations sur la base de données et effectuer des opérations sur les bases de données.

SHOW DATABASES

Renvoie toutes les bases de données que le compte est autorisé à interroger.

Syntaxe

SHOW DATABASES

Exemple

> SHOW DATABASES

name: databases
name
----
NOAA_water_database
_internal

Les résultats listent chaque base de données au format tabulaire. Le compte est autorisé à interroger NOAA_water_database et _internal.

SHOW RETENTION POLICIES

Renvoie les politiques de rétention pour une base de données spécifiée.

Syntaxe

SHOW RETENTION POLICIES [ON <database_name>]

Le paramètre ON <database_name> est facultatif. Sans celui-ci, exécutez d'abord USE <database_name> dans l'interface CLI Influx ou définissez le paramètre db dans votre requête HTTP API.

Exemples

Avec la clause ON

> SHOW RETENTION POLICIES ON NOAA_water_database

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

La base de données NOAA_water_database dispose d'une politique de rétention : autogen. Il s'agit de la politique par défaut (DEFAULT), avec une durée illimitée (0s), une durée de groupe de shards de sept jours (168h0m0s) et un facteur de réplication de 1.

Sans la clause ON — utilisation de l'interface CLI

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW RETENTION POLICIES

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

Sans la clause ON — utilisation de l'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

Renvoie les séries d'une base de données spécifiée.

Syntaxe

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

Toutes les clauses sont facultatives. La comparaison de champs n'est pas prise en charge ; la clause WHERE accepte uniquement les comparaisons de tags. Pour plus de détails sur FROM, LIMIT et OFFSET, consultez la documentation sur l'exploration des données.

Opérateurs pris en charge dans la clause WHERE

Opérateur	Signification
`=`	Égal à
`<>`	Différent de
`!=`	Différent de
`=~`	Correspondance
`!~`	Pas de correspondance

Exemples

Avec la clause 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

Les résultats suivent le format du protocole de ligne : l'élément précédant la première virgule est le nom de la mesure et les éléments suivants sont des paires clé-valeur de tag. La base de données NOAA_water_database contient 5 mesures et 14 séries.

Sans la clause ON — utilisation de l'interface 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

Sans la clause ON — utilisation de l'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"]
                    ]
                }
            ]
        }
    ]
}

Avec plusieurs clauses

> 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

Renvoie toutes les séries de NOAA_water_database qui incluent la mesure h2o_quality et le tag location=coyote_creek. L'instruction LIMIT 2 limite les résultats à deux séries.

SHOW MEASUREMENTS

Renvoie les mesures d'une base de données spécifiée.

Syntaxe

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

Toutes les clauses sont facultatives. La comparaison de champs n'est pas prise en charge ; la clause WHERE accepte uniquement les comparaisons de tags. Pour plus de détails sur LIMIT et OFFSET, consultez la documentation sur l'exploration des données.

Opérateurs pris en charge dans la clause WHERE

Opérateur	Signification
`=`	Égal à
`<>`	Différent de
`!=`	Différent de
`=~`	Correspondance
`!~`	Pas de correspondance

Exemples

Avec la clause ON

> SHOW MEASUREMENTS ON NOAA_water_database

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

La base de données NOAA_water_database contient cinq mesures : average_temperature, h2o_feet, h2o_pH, h2o_quality et h2o_temperature.

Sans la clause ON — utilisation de l'interface 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

Sans la clause ON — utilisation de l'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"]
                    ]
                }
            ]
        }
    ]
}

Avec une expression régulière et LIMIT/OFFSET

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

name: measurements
name
----
h2o_pH
h2o_quality

Renvoie les mesures dont les noms correspondent à h2o.* dans NOAA_water_database. L'instruction LIMIT 2 limite les résultats à deux. L'instruction OFFSET 1 ignore la première correspondance (h2o_feet), de sorte que les résultats commencent à partir de h2o_pH.

Avec une expression régulière et un filtre de tag

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

name: measurements
name
----
h2o_quality

Renvoie les mesures de NOAA_water_database dont les noms correspondent à h2o.* et qui possèdent au moins une valeur numérique pour le tag randtag.

SHOW TAG KEYS

Renvoie les clés de tag d'une base de données spécifiée.

Syntaxe

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

Les paramètres ON, FROM et WHERE sont facultatifs. La comparaison de champs n'est pas prise en charge. Pour plus de détails sur FROM, LIMIT et OFFSET, consultez la documentation sur l'exploration des données.

Opérateurs pris en charge dans la clause WHERE

Opérateur	Signification
`=`	Égal à
`<>`	Différent de
`!=`	Différent de
`=~`	Correspondance
`!~`	Pas de correspondance

Exemples

Avec la clause 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

Les résultats sont regroupés par mesure. Chaque mesure possède la clé de tag location. La mesure h2o_quality comporte deux clés de tag : location et randtag.

Sans la clause ON — utilisation de l'interface 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

Sans la clause ON — utilisation de l'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"]]
                }
            ]
        }
    ]
}

Avec plusieurs clauses

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

name: h2o_quality
tagKey
------
randtag

Renvoie les clés de tag de la mesure h2o_quality dans NOAA_water_database. L'instruction LIMIT 1 limite les résultats à une seule clé de tag. L'instruction OFFSET 1 ignore location, de sorte que le résultat commence à partir de randtag.

SHOW TAG VALUES

Renvoie les valeurs de tag pour les clés de tag spécifiées dans une base de données.

Syntaxe

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]

Les paramètres ON, FROM, WHERE, LIMIT et OFFSET sont facultatifs. La clause WITH KEY est obligatoire ; spécifiez une ou plusieurs clés de tag ou une expression régulière. La comparaison de champs n'est pas prise en charge. Pour plus de détails sur FROM, LIMIT et OFFSET, consultez la documentation sur l'exploration des données.

Opérateurs pris en charge dans les clauses WITH et WHERE

Opérateur	Signification
`=`	Égal à
`<>`	Différent de
`!=`	Différent de
`=~`	Correspondance
`!~`	Pas de correspondance

Exemples

Avec la clause ON

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

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

Renvoie toutes les valeurs de la clé de tag randtag dans NOAA_water_database. Les résultats sont regroupés par mesure.

Sans la clause ON — utilisation de l'interface 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

Sans la clause ON — utilisation de l'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"]
                    ]
                }
            ]
        }
    ]
}

Avec plusieurs clauses

> 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

Renvoie jusqu'à trois valeurs de tag issues des mesures de NOAA_water_database lorsque la clé de tag est location ou randtag et que la valeur de randtag n'est pas nulle.

SHOW FIELD KEYS

Renvoie les clés de champ et les types de données de leurs valeurs de champ.

Syntaxe

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

Ces deux clauses sont facultatives. Pour plus de détails sur FROM, consultez la documentation sur l'exploration des données.

Les types de données des valeurs de champ peuvent différer selon les shards. Lorsque plusieurs types de données existent pour la même clé de champ, SHOW FIELD KEYS les renvoie dans l'ordre suivant : float, integer, string, boolean.

Exemples

Avec la clause 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

Renvoie toutes les clés de champ et leurs types de données pour chaque mesure de NOAA_water_database.

Sans la clause ON — utilisation de l'interface 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

Sans la clause ON — utilisation de l'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"]]
                }
            ]
        }
    ]
}

Pour une seule mesure

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

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

Renvoie uniquement les clés de champ et les types de données pour la mesure h2o_feet.

FAQ sur SHOW FIELD KEYS

Pourquoi SHOW FIELD KEYS affiche-t-il plusieurs types de données pour la même clé de champ ?

Les types de données des valeurs de champ doivent être cohérents au sein d'un shard, mais peuvent différer d'un shard à l'autre. SHOW FIELD KEYS signale le type de données associé à chaque clé de champ dans chaque shard.

Par exemple, si le champ all_the_types a été écrit avec différents types de données dans plusieurs shards :

> SHOW FIELD KEYS

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

Important

SHOW FIELD KEYS gère les différences de type entre les shards différemment de l'instruction SELECT. Consultez la rubrique FAQ pour plus de détails.

InfluxDB® est une marque déposée par InfluxData, qui n'est ni affiliée à, ni ne cautionne TSDB for InfluxDB®.