Todos los productos
Search
Centro de documentos

Tablestore:CLI de Tablestore

Última actualización: Sep 03, 2026

Use el CLI de Tablestore para gestionar datos de columnas anchas y series temporales en tareas de desarrollo, depuración y operaciones.

Introducción

Descargue la herramienta CLI y configure las credenciales de acceso para comenzar a gestionar los recursos de Tablestore.

Descargar la herramienta CLI

La herramienta CLI es compatible con Windows, Linux y macOS.

Plataforma

Enlace de descarga

Windows

aliyun-tablestore-cli-windows-amd64-2026-08-04-a0a4086.zip

Linux

macOS

Iniciar la herramienta CLI y configurar credenciales

Extraiga el paquete e inicie la herramienta CLI desde el directorio extraído.

Windows

Haga doble clic en el archivo ts.exe.

Linux y macOS

Ejecute el comando ./ts.

Nota
  • Si el archivo no tiene permiso de ejecución en Linux o macOS, ejecute chmod 755 ts para otorgar el permiso antes de iniciar la herramienta.

  • Si macOS muestra el mensaje "ts" cannot be opened because Apple cannot check it for malicious software, vaya a la configuración de Privacy & Security para permitir que se ejecute ts.

Una vez iniciada la herramienta CLI, ejecute el comando config para configurar las credenciales de acceso:

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

Parámetro

Descripción

--endpoint

URL del endpoint de la instancia.

--instance

Nombre de la instancia.

--id

AccessKey ID. Para más información, consulte Create an AccessKey.

--key

AccessKey Secret.

--token

(Opcional) Token STS. Especifique este parámetro para acceder a Tablestore con credenciales de acceso temporal.

Para acceder a Tablestore mediante acceso temporal STS, agregue el parámetro --token al comando config:

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

Si aún no ha activado Tablestore ni creado una instancia, consulte Activate Tablestore y Instance operations. También puede activar el servicio y crear una instancia mediante la herramienta CLI.

Operaciones básicas

Compruebe la conexión al ejecutar operaciones básicas de datos.

Columnas anchas

Cree una tabla de datos, escriba datos y léalos para comprobar las operaciones básicas de columnas anchas.

  1. Cree una tabla de datos.

    create -t order --pk '[{"c":"id","t":"string"}]'
  2. Cambie a la tabla de datos.

    use --wc -t order
  3. Escriba una fila de datos.

    put --pk '["id001"]' --attr '[{"c":"name","v":"test"},{"c":"age","v":20}]'
  4. Lea la fila.

    get --pk '["id001"]'

Para más operaciones de columnas anchas, consulte Wide Column model.

Series temporales

Cree una tabla de series temporales para el monitoreo de servidores y consulte los datos para verificar las operaciones básicas de series temporales.

A continuación se registran métricas de CPU (measurement: cpu) para un host. El origen de datos identifica el host y las etiquetas registran la región y el sistema operativo.

  1. Cree una tabla de series temporales.

    create -t mytable --ttl -1 -m timeseries
  2. Cambie a la tabla de series temporales.

    use --ts -t mytable
  3. Escriba datos de series temporales.

    putts --k '["cpu","host001",["region=hangzhou","os=linux"]]' --field '[{"c":"cpu_usage","v":0.65},{"c":"load","v":2.1}]'
  4. Consulte los datos de series temporales.

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

Para más operaciones de series temporales, consulte TimeSeries model.

Consultar comandos disponibles

Ejecute el comando help para ver todos los comandos disponibles. Para consultar las opciones de un comando específico, ejecute <command> help. Por ejemplo, ejecute alter help.