All Products
Search
Document Center

Tablestore:Tablestore CLI

Last Updated:Jun 04, 2026

Gunakan Tablestore CLI untuk mengelola data model kolom lebar dan time-series selama pengembangan, debugging, serta operasi.

Quick start

Unduh tool CLI dan konfigurasikan kredensial akses untuk mulai mengelola sumber daya Tablestore.

Download the CLI tool

Tool CLI mendukung Windows, Linux, dan macOS.

Platform

Download link

Windows

Linux

macOS

Start the CLI tool and configure credentials

Ekstrak paket tersebut, lalu jalankan tool CLI dari direktori hasil ekstraksi.

Windows

Klik ganda file ts.exe.

Linux and macOS

Jalankan perintah ./ts.

Catatan
  • Jika file tidak memiliki izin eksekusi di Linux atau macOS, jalankan chmod 755 ts untuk memberikan izin tersebut sebelum menjalankan tool.

  • Jika macOS menampilkan pesan "ts" cannot be opened because Apple cannot check it for malicious software, buka pengaturan Privacy & Security untuk mengizinkan ts berjalan.

Setelah tool CLI dimulai, jalankan perintah config untuk mengonfigurasi kredensial akses:

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

Parameter

Description

--endpoint

URL endpoint instans.

--instance

Nama instans.

--id

ID AccessKey. Untuk informasi selengkapnya, lihat Create an AccessKey.

--key

AccessKey Secret.

--token

(Opsional) Token STS. Tentukan parameter ini untuk mengakses Tablestore dengan kredensial akses temporary.

Untuk mengakses Tablestore dengan kredensial akses temporary STS, tambahkan parameter --token ke perintah config:

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

Jika Anda belum mengaktifkan Tablestore atau membuat instans, lihat Activate Tablestore dan Instance operations. Anda juga dapat mengaktifkan layanan dan membuat instans menggunakan tool CLI.

Basic operations

Verifikasi koneksi dengan menjalankan operasi data dasar.

Wide-column

Buat tabel data, tulis data, dan baca data untuk memverifikasi operasi dasar model kolom lebar.

  1. Buat tabel data.

    create -t order --pk '[{"c":"id","t":"string"}]'
  2. Beralih ke tabel data.

    use --wc -t order
  3. Tulis satu baris data.

    put --pk '["id001"]' --attr '[{"c":"name","v":"test"},{"c":"age","v":20}]'
  4. Baca baris tersebut.

    get --pk '["id001"]'

Untuk operasi model kolom lebar lainnya, lihat Wide Column model.

Time-series

Buat tabel time-series untuk pemantauan server dan kueri data guna memverifikasi operasi time-series dasar.

Langkah-langkah berikut mencatat metrik CPU (measurement: cpu) untuk sebuah host. Sumber data mengidentifikasi host tersebut, dan tag mencatat wilayah serta sistem operasi.

  1. Buat tabel time-series.

    create --ts -t mytable --ttl -1
  2. Beralih ke tabel time-series.

    use --ts -t mytable
  3. Tulis data time-series.

    putts --mn cpu --ds host=host001 --tags region=hangzhou,os=linux --fields cpu_usage=0.65,load=2.1
  4. Kueri data time-series.

    getts --mn cpu --ds host=host001

Untuk operasi time-series lainnya, lihat TimeSeries model.

View available commands

Jalankan perintah help untuk melihat semua perintah yang tersedia. Untuk melihat opsi suatu perintah tertentu, jalankan <command> help. Contohnya, jalankan alter help.