Todos os produtos
Search
Central de documentação

Tablestore:Tablestore CLI

Última atualização: Jul 09, 2026

Use o Tablestore CLI para gerenciar dados de colunas largas e séries temporais durante o desenvolvimento, a depuração e as operações.

Introdução

Baixe a ferramenta CLI e configure as credenciais de acesso para começar a gerenciar recursos do Tablestore.

Baixar a ferramenta CLI

A ferramenta CLI é compatível com Windows, Linux e macOS.

Plataforma

Link para download

Windows

Linux

macOS

Iniciar a ferramenta CLI e configurar credenciais

Extraia o pacote e inicie a ferramenta CLI no diretório extraído.

Windows

Clique em duas vezes no arquivo ts.exe.

Linux e macOS

Execute o comando ./ts.

Nota
  • Se o arquivo não tiver permissão de execução no Linux ou macOS, execute chmod 755 ts para conceder essa permissão antes de iniciar a ferramenta.

  • Caso o macOS exiba a mensagem "ts" cannot be opened because Apple cannot check it for malicious software, acesse as configurações de Privacidade e Segurança para permitir a execução do ts.

Após iniciar a ferramenta CLI, execute o comando config para configurar as credenciais de acesso:

config --endpoint https://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance --id LTAI******************** --key 7NR2****************************************

Parâmetro

Descrição

--endpoint

URL do endpoint da instância.

--instance

Nome da instância.

--id

AccessKey ID. Para mais informações, consulte Criar um AccessKey.

--key

AccessKey Secret.

--token

(Opcional) Token STS. Especifique este parâmetro para acessar o Tablestore com credenciais de acesso temporárias.

Para acessar o Tablestore com credenciais temporárias STS, adicione o parâmetro --token ao comando config:

config --endpoint https://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance --id STS.LTAI******************** --key 7NR2**************************************** --token STS.6MC2****************************************
Nota

Se você ainda não ativou o Tablestore ou criou uma instância, consulte Ativar o Tablestore e Operações de instância. Também é possível ativar o serviço e criar uma instância pela ferramenta CLI.

Operações básicas

Verifique a conexão executando operações básicas de dados.

Colunas largas

Crie uma tabela de dados, grave e leia dados para validar as operações básicas do modelo de colunas largas.

  1. Crie uma tabela de dados.

    create -t order --pk '[{"c":"id","t":"string"}]'
  2. Mude para a tabela de dados.

    use --wc -t order
  3. Grave uma linha de dados.

    put --pk '["id001"]' --attr '[{"c":"name","v":"test"},{"c":"age","v":20}]'
  4. Leia a linha.

    get --pk '["id001"]'

Para mais operações com colunas largas, consulte Modelo Wide Column.

Séries temporais

Crie uma tabela de séries temporais para monitoramento de servidores e consulte os dados para validar as operações básicas desse modelo.

Os passos a seguir registram métricas de CPU (measurement: cpu) de um host. A fonte de dados identifica o host, enquanto as tags registram a região e o sistema operacional.

  1. Crie uma tabela de séries temporais.

    create -t mytable --ttl -1 -m timeseries
  2. Mude para a tabela de séries temporais.

    use --ts -t mytable
  3. Grave dados de séries temporais.

    putts --k '["cpu","host001",["region=hangzhou","os=linux"]]' --field '[{"c":"cpu_usage","v":0.65},{"c":"load","v":2.1}]'
  4. Consulte os dados de séries temporais.

    getts --k '["cpu","host001",["region=hangzhou","os=linux"]]'

Para mais operações com séries temporais, consulte Modelo TimeSeries.

Visualizar comandos disponíveis

Execute o comando help para visualizar todos os comandos disponíveis. Para ver as opções de um comando específico, execute <command> help. Por exemplo, execute alter help.