Executar operações de dados em tabelas de séries temporais pela interface de linha de comando - Tablestore: Central de Documentação do Alibaba Cloud

Pré-requisitos

CLI com credenciais de acesso configuradas. Para mais informações, consulte Tablestore CLI.
Uma tabela de séries temporais. Para mais informações, consulte Operações de tabela de séries temporais.

Antes de escrever, importar ou consultar dados, selecione a tabela de séries temporais de destino:

use --ts -t <tableName>

Escrever dados de séries temporais

Escreva uma linha de dados de séries temporais em uma timeline especificada.

putts --k '<timeseriesKey>' --field '<fields_json>' --time <timestamp>

Parâmetro	Obrigatório	Descrição
--k	Sim	Identificador da timeline, representado como um array JSON no formato `["measurement","dataSource",["tag1=value1","tag2=value2"]]`. O array inclui: Primeiro elemento: nome da medição. Segundo elemento: identificador da source de dados. Terceiro elemento: array de tags. Cada tag segue o formato tagKey=tagValue.
--field	Sim	Campos de dados, representados como um array json. Cada elemento contém as seguintes propriedades: c (obrigatório): nome da coluna. v (obrigatório): valor da coluna. Tipos suportados: string, Boolean, integer e número de ponto flutuante. isint (opcional): defina como `true` para tratar o valor como inteiro. O padrão é `false` (número de ponto flutuante).
--time	Sim	Timestamp da linha de dados, em microssegundos (μs).

Exemplo

Escreva métricas de CPU para um host monitorado na região de Hangzhou:

putts --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --field '[{"c":"usage_user","v":58,"isint":true},{"c":"usage_idle","v":24,"isint":true}]' --time 1635162859000000

Importar dados de séries temporais

Importe dados de séries temporais de um arquivo local para uma tabela de séries temporais.

Windows

import_timeseries --input D:\\localpath\\filename.txt

Linux and macOS

import_timeseries --input /localpath/filename.txt

Parâmetro	Obrigatório	Descrição
-i, --input	Sim	Caminho do arquivo de dados local.

Cada linha do arquivo de dados representa uma linha de dados de séries temporais no formato measurement_name,tags fields timestamp.

Campo	Obrigatório	Descrição
measurement_name	Sim	Nome da medição.
tags	Sim	Cada tag segue o formato tagKey=tagValue. O tagValue da primeira tag serve como identificador da source de dados.
fields	Sim	Campos de dados no formato fieldKey=fieldValue. Acrescente `i` a um valor numérico para indicar um inteiro. Valores sem `i` são tratados como ponto flutuante por padrão.
timestamp	Sim	Timestamp em nanossegundos (ns). A conversão para microssegundos ocorre automaticamente após a importação.

Exemplo de arquivo de dados:

cpu,hostname=host_0,region=cn-hangzhou usage_user=58i,usage_system=2i,usage_idle=24i 1609459200000000000
cpu,hostname=host_1,region=cn-hangzhou usage_user=58i,usage_system=2i,usage_idle=24i 1609459200000000000

Exemplo

Importe dados de séries temporais de um arquivo local:

import_timeseries --input /tmp/import_timeseries.txt

Consultar dados de séries temporais

Consulte dados de séries temporais de uma timeline especificada dentro de um intervalo de tempo.

getts --k '<timeseriesKey>' --time_start <start> --time_end <end> --limit <n>

Parâmetro	Obrigatório	Descrição
--k	Sim	Identificador da timeline, no mesmo formato de `--k` na seção Escrever dados de séries temporais.
--time_start	Sim	Horário inicial da consulta, como timestamp em microssegundos.
--time_end	Sim	Horário final da consulta, como timestamp em microssegundos.
--limit	Não	Número máximo de linhas a retornar. Valores válidos: 1 a 5000.

Exemplo

getts --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --time_start 0 --time_end 1667638230000000 --limit 100

Pesquisar timelines

Pesquise timelines que correspondam a condições especificadas. A forma abreviada deste comando é qtm.

query_ts_meta --measurement <measurement> --datasource <dataSource> --limit <n>

Parâmetro	Obrigatório	Descrição
--measurement	Não	Nome da medição.
--datasource	Não	Identificador da source de dados.
--limit	Não	Número máximo de linhas a retornar. Valores válidos: 1 a 1000. O servidor pode retornar menos linhas que o limite especificado.
-e, --edit	Não	Defina filtros de pesquisa complexos no formato json. Tipos de filtro suportados: COMPOSITE, MEASUREMENT, SOURCE e TAG.

Exemplo

Pesquise timelines em que o nome da medição é cpu e o identificador da source de dados é localhost.

query_ts_meta --measurement cpu --datasource localhost --limit 10

Para definir filtros de pesquisa complexos, use qtm -e. Exemplo de filtro:

{
    "Type":"COMPOSITE",
    "QueryCondition":{
        "Operator":"AND",
        "SubConditions":[
            {
                "Type":"MEASUREMENT",
                "QueryCondition":{
                    "Operator":"EQUAL",
                    "Value":"CPU"
                }
            },
            {
                "Type":"SOURCE",
                "QueryCondition":{
                    "Operator":"EQUAL",
                    "Value":"127.0.0.1"
                }
            },
            {
                "Type":"TAG",
                "QueryCondition":{
                    "Operator":"GREATER_EQUAL",
                    "TagName":"Region",
                    "Value":"Jiangning"
                }
            }
        ]
    }
}

Varredura de timelines

Recupere todas as timelines ou um número limitado delas de uma tabela de séries temporais. A forma abreviada deste comando é qtm.

query_ts_meta --limit <n>

Parâmetro	Obrigatório	Descrição
--limit	Não	Número máximo de linhas a retornar. Se não especificado, a varredura abrange todas as timelines.

Exemplo

query_ts_meta --limit 10

Atualizar timelines

Atualize os atributos de uma timeline. Caso a timeline de destino não exista, o comando a cria. A forma abreviada deste comando é utm.

update_ts_meta --k '<timeseriesKey>' --attrs '<attributes>'

Parâmetro	Obrigatório	Descrição
--k	Sim	Identificador da timeline, no mesmo formato de `--k` na seção Escrever dados de séries temporais.
--attrs	Não	Atributos da timeline, representados como um array json. Cada atributo segue o formato chave=valor.

Exemplo

Defina os atributos de cidade e região para um host monitorado:

update_ts_meta --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --attrs '["city=nanjing","region=jiangning"]'