O InfluxQL é uma linguagem de consulta semelhante ao SQL para interagir com dados no TSDB For InfluxDB®. Este documento descreve a instrução SELECT do InfluxQL e sintaxes de consulta úteis.
|
Conceitos básicos |
Configuração dos resultados da consulta |
Dicas de sintaxe de consulta |
|
Instrução SELECT |
ORDER BY time DESC |
Sintaxe de tempo |
|
Cláusula WHERE |
Cláusulas LIMIT e SLIMIT |
Expressões regulares |
|
Cláusula GROUP BY |
Cláusulas OFFSET e SOFFSET |
Tipos de dados e conversão |
|
Cláusula INTO |
Cláusula de fuso horário |
Mesclagem |
|
- |
- |
Múltiplas instruções |
|
- |
- |
Subconsultas |
Dados de exemplo
Os exemplos deste documento utilizam dados públicos do National Oceanic and Atmospheric Administration (NOAA) Center for Operational Oceanographic Products and Services. As etapas a seguir mostram como executar consultas nesses dados.
Primeiro, faça login na interface de linha de comando (CLI) do InfluxDB:
$ influx -ssl -username <username> -password <password> -host <network_address> -port 3242 -precision rfc3339 -database NOAA_water_database
Connected to https://<network_address>:3242 version 1.7.x
InfluxDB shell 1.7.x
>Em seguida, revise os dados de exemplo da measurement h2o_feet.
name: h2o_feet
|
time |
level description |
location |
water_level |
|
2015-08-18T00:00:00Z |
between 6 and 9 feet |
coyote_creek |
8.12 |
|
2015-08-18T00:00:00Z |
below 3 feet |
santa_monica |
2.064 |
|
2015-08-18T00:06:00Z |
between 6 and 9 feet |
coyote_creek |
8.005 |
|
2015-08-18T00:06:00Z |
below 3 feet |
santa_monica |
2.116 |
|
2015-08-18T00:12:00Z |
between 6 and 9 feet |
coyote_creek |
7.887 |
|
2015-08-18T00:12:00Z |
below 3 feet |
santa_monica |
2.028 |
Os dados em h2o_feet são registrados em intervalos de seis minutos. Essa measurement possui uma tag key location com dois valores de tag: coyote_creek e santa_monica. Além disso, h2o_feet contém dois fields. O field level description armazena valores do tipo string, enquanto o field water_level armazena valores de ponto flutuante. Todos esses dados residem no banco de dados NOAA_water_database.
O field level description não faz parte dos dados originais da NOAA. Adicionamos esse field para fornecer valores que contêm caracteres especiais e strings.