Todos os produtos
Search
Central de documentação

Tablestore:Operações de tabela de séries temporais

Última atualização: Jul 03, 2026

Crie, liste, selecione, descreva, atualize e exclua o modelo TimeSeries pela CLI.

Pré-requisitos

  • CLI instalada e credenciais de acesso configuradas. Para mais informações, consulte Tablestore CLI.

  • Instância do Tablestore criada. Para mais informações, consulte Operações de instância.

Criar uma tabela de séries temporais

Crie uma tabela de séries temporais com configuração opcional de tempo de vida (TTL).

create -m timeseries -t <tableName> --ttl <timeToLive>

Parâmetro

Obrigatório

Descrição

-m, --model

Sim

Tipo da tabela. Defina como timeseries para criar uma tabela de séries temporais.

-t, --table

Sim

Nome da tabela de séries temporais.

--ttl

Não

TTL dos dados na tabela de séries temporais, em segundos. Valor padrão: -1 (dados nunca expiram). Valores válidos: inteiro maior ou igual a 86400 (um dia) ou -1.

Importante

A expiração dos dados é calculada com base na coluna de timestamp especificada, não no momento da gravação.

Exemplo

Crie uma tabela de séries temporais chamada mytable em que os dados nunca expirem.

create -m timeseries -t mytable --ttl -1

Listar tabelas de séries temporais

Liste todas as tabelas de séries temporais da instância atual.

list_table --ts

Selecionar uma tabela de séries temporais

Selecione uma tabela de séries temporais para realizar operações de dados subsequentes.

use --ts -t <tableName>

Parâmetro

Obrigatório

Descrição

--ts

Sim

Indica operação em tabela de séries temporais.

-t, --table

Sim

Nome da tabela de séries temporais.

Exemplo

use --ts -t mytable

Descrever uma tabela de séries temporais

Visualize a configuração de uma tabela de séries temporais.

desc --ts -t <tableName>

Parâmetro

Obrigatório

Descrição

--ts

Não

Indica operação em tabela de séries temporais. Opcional se você já tiver selecionado uma tabela desse tipo com use --ts.

-t, --table

Não

Nome da tabela de séries temporais. Opcional se você já tiver selecionado uma tabela com use.

-f, --print_format

Não

Formato de saída. Valores válidos: json (padrão) e table.

-o, --output

Não

Salva as informações da tabela em um arquivo JSON local.

Exemplo

desc --ts -t mytable

Atualizar uma tabela de séries temporais

Atualize o TTL de uma tabela de séries temporais.

alter --ttl <timeToLive> --ts

Parâmetro

Obrigatório

Descrição

--ts

Sim

Indica operação em tabela de séries temporais.

--ttl

Sim

TTL dos dados na tabela de séries temporais, em segundos. Valores válidos: inteiro maior ou igual a 86400 (um dia) ou -1 (dados nunca expiram).

Importante

A expiração dos dados é calculada com base na coluna de timestamp especificada, não no momento da gravação.

Exemplo

Defina o TTL da tabela de séries temporais atual como 86400 segundos (um dia).

alter --ttl 86400 --ts

Excluir uma tabela de séries temporais

Exclua uma tabela de séries temporais e todos os respectivos dados.

drop -t <tableName> --ts -y

Parâmetro

Obrigatório

Descrição

-t, --table

Sim

Nome da tabela de séries temporais.

--ts

Sim

Indica operação em tabela de séries temporais.

-y, --yes

Sim

Ignora o prompt de confirmação de exclusão.

Exemplo

Exclua a tabela de séries temporais mytable.

drop -t mytable --ts -y