Time Series Database:CLI de TSDB for InfluxDB®

$ ./influx -ssl -username "myname" -password "mypassword" -host ts-xxxxxx.influxdata.rds.aliyuncs.com -port 3242
Connected to https://<Endpoint>:3242 version 1.8.x
InfluxDB shell version: 1.8.x

Descripción de parámetros

• -ssl: se conecta al servidor de InfluxDB mediante HTTPS.

• -username: el nombre de usuario de la cuenta que creó.

• -password: la contraseña de la cuenta.

• -host: el endpoint de la instancia. Reemplace ts-xxxxxx con su ID de instancia.

• -port: el puerto de red. Utilice 8086 para conexiones VPC y 3242 para conexiones a Internet.

Ahora puede introducir consultas InfluxQL y algunos comandos de la CLI directamente en su terminal. Para introducir consultas Flux, establezca la opción -type en flux. Puede ejecutar help en cualquier momento para listar los comandos disponibles. Para interrumpir una consulta InfluxQL de larga duración, presione Ctrl+C.

Variables de entorno

Las siguientes variables de entorno permiten configurar los ajustes del cliente influx. Puede especificarlas en minúsculas o mayúsculas. Las mayúsculas tienen prioridad.

HTTP_PROXY

Define el servidor proxy que utiliza HTTP.

Formato de valor: [protocol://][:puerto]

HTTP_PROXY=http://localhost:1234

HTTPS_PROXY

Define el servidor proxy que utiliza HTTPS. Si tanto HTTP_PROXY como HTTPS_PROXY están configurados, HTTPS_PROXY tiene prioridad.

Formato de valor: [protocol://][:puerto]

HTTPS_PROXY=https://localhost:1443

NO_PROXY

Una lista de nombres de host que no pasan por ningún proxy. Si esta variable se establece únicamente con un asterisco (*), coincide con todos los hosts.

Formato de valor: separe varios hosts con comas.

NO_PROXY=123.45.67.89,123.45.67.90

Opciones de influx

Puede pasar opciones a influx cuando inicie influx. Ejecute $ influx --help para listar las opciones disponibles. La siguiente lista describe brevemente cada opción. Las opciones -execute, -format y -import se describen en detalle más adelante en esta sección.

-compressed

Establezca esta opción en true si el archivo de importación está comprimido. -compressed debe utilizarse junto con -import.

Establece el nivel de consistencia de escritura.

-database 'database name'

La base de datos a la que se conecta influx.

-execute '<command>'

Ejecuta un comando InfluxQL y sale.

-format 'json|csv|column'

Especifica el formato de las respuestas del servidor.

-host '<hostname>'

El host al que se conecta influx.

-import

Importa nuevos datos desde un archivo, o importa una base de datos que se exportó previamente a un archivo.

-password '<password>'

La contraseña que utiliza influx para conectarse al servidor. Si deja esta opción vacía (-password ''), influx le solicitará la contraseña. También puede usar la variable de entorno INFLUX_PASSWORD para establecer la contraseña de la CLI.

-path

La ruta al archivo de importación. -path debe utilizarse junto con -import.

-port 'port #'

El puerto al que se conecta influx. De forma predeterminada, TSDB for InfluxDB® se ejecuta en el puerto 3242.

-pps

El número de puntos de datos por segundo que permite la importación. De forma predeterminada, pps se establece en 0 y influx no limita la tasa de importación. -pps debe utilizarse junto con -import.

-precision 'rfc3339|h|m|s|ms|u|ns'

Especifica el formato y la precisión de las marcas de tiempo para consultas y escrituras: rfc3339 (YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ), h (horas), m (minutos), s (segundos), ms (milisegundos), u (microsegundos) o ns (nanosegundos). La precisión predeterminada es nanosegundos.

-pretty

Formatea la salida JSON para mejorar su legibilidad.

-ssl

Utiliza HTTPS para las solicitudes.

-type

Determina qué shell interactiva utilizar. El valor predeterminado es influxql. Para usar la shell REPL de Flux, establezca -type en flux.

-username 'username'

El nombre de usuario que utiliza influx para conectarse al servidor. También puede usar la variable de entorno INFLUX_USERNAME para establecer el nombre de usuario de la CLI.

-version

Muestra la versión de TSDB for InfluxDB® y sale.

Use -execute para ejecutar un comando InfluxQL y salir

Ejecute una consulta que no requiere una base de datos:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -execute 'SHOW DATABASES'
name: databases
---------------
name
NOAA_water_database
_internal
telegraf
pirates

Ejecute una consulta que requiere una base de datos y cambie la precisión de la marca de tiempo:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -execute 'SELECT * FROM "h2o_feet" LIMIT 3' -database="NOAA_water_database" -precision=rfc3339
name: h2o_feet
--------------
time                     level description     location      water_level
2015-08-18T00:00:00Z     below 3 feet          santa_monica  2.064
2015-08-18T00:00:00Z     between 6 and 9 feet  coyote_creek  8.12
2015-08-18T00:06:00Z     between 6 and 9 feet  coyote_creek  8.005

Use -format para especificar el formato de las respuestas del servidor

El formato predeterminado es column:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -format=column
[...]
> SHOW DATABASES
name: databases
---------------
name
NOAA_water_database
_internal
telegraf
pirates

Cambie el formato a csv:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -format=csv
[...]
> SHOW DATABASES
name,name
databases,NOAA_water_database
databases,_internal
databases,telegraf
databases,pirates

Cambie el formato a json:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -format=json
[...]
> SHOW DATABASES
{"results":[{"series":[{"name":"databases","columns":["name"],"values":[["NOAA_water_database"],["_internal"],["telegraf"],["pirates"]]}]}]}

Cambie el formato a JSON y habilite la salida formateada:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -format=json -pretty
[...]
> SHOW DATABASES
{
    "results": [  
        {
            "series": [
                {
                    "name": "databases",
                    "columns": [
                        "name"
                    ],
                    "values": [
                        [
                            "NOAA_water_database"                       
                        ],
                        [
                            "_internal"
                        ],
                        [
                            "telegraf"
                        ],
                        [
                            "pirates"
                        ]
                    ]
                }
            ]
        }
    ]
}

Use -import para importar datos desde un archivo

El archivo de importación consta de dos partes:

Ejemplo:

Suponga que ya se crearon una base de datos llamada pirates y una política de retención llamada oneday.

Archivo (datarrr.txt):

# DML
# CONTEXT-DATABASE: pirates
# CONTEXT-RETENTION-POLICY: oneday
treasures,captain_id=dread_pirate_roberts value=801 1439856000
treasures,captain_id=flint value=29 1439856000
treasures,captain_id=sparrow value=38 1439856000
treasures,captain_id=tetra value=47 1439856000
treasures,captain_id=crunch value=109 1439858880

Comando:

$influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -import -path=datarrr.txt -precision=s

Resultado:

2015/12/22 12:25:06 Processed 0 commands
2015/12/22 12:25:06 Processed 5 inserts
2015/12/22 12:25:06 Failed 0 inserts

Nota

Tenga en cuenta los siguientes puntos sobre -import:

• Utilice

  -pps

  para establecer el número de puntos de datos por segundo que permite la importación cuando los puntos de datos se escriben en la base de datos. De forma predeterminada, pps se establece en 0 y

  influx

  no limita la tasa de importación.

• Puede importar archivos .gz. Solo necesita agregar

  -compressed

  al comando.

• Proporcione marcas de tiempo para los puntos de datos en el archivo. TSDB for InfluxDB® asigna la misma marca de tiempo a los puntos de datos que no tienen marcas de tiempo, lo cual puede causar sobrescrituras inesperadas de datos.

• Si su archivo de datos contiene más de 5,000 puntos de datos, es posible que deba dividir el archivo en varios archivos para que los datos puedan escribirse en TSDB for InfluxDB® por lotes. Escriba datos en TSDB for InfluxDB® en lotes de 5,000 o 10,000 puntos de datos. Los lotes más pequeños generan más solicitudes HTTP, lo que impide un rendimiento óptimo. De forma predeterminada, las solicitudes HTTP expiran después de cinco segundos. TSDB for InfluxDB® aún intenta escribir los puntos de datos después de un tiempo de espera, pero no hay garantía de que los puntos de datos se escriban.

Comandos de influx

auth

chunked

chunk size <size>

clear [ database | db | retention policy | rp ]

connect <host:port>

consistency <level>

Ctrl+C

format <format>

history

insert

precision <format>

pretty

settings

use [ "<database_name>" | "<database_name>"."<retention policy_name>" ]

> INSERT treasures,captain_id=pirate_king value=2
>

> INSERT INTO oneday treasures,captain_id=pirate_king value=2
Using retention policy oneday
>