All Products
Search

This Product

    Tablestore:Tablestore CLI

    Document Center

    Tablestore:Tablestore CLI

    Last Updated:Jul 10, 2026

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

    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 dan 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 dijalankan.

    Setelah tool CLI berjalan, 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 dasar time-series.

    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 -t mytable --ttl -1 -m timeseries

    2. Beralih ke tabel time-series.

      use --ts -t mytable

    3. Tulis data time-series.

      putts --k '["cpu","host001",["region=hangzhou","os=linux"]]' --field '[{"c":"cpu_usage","v":0.65},{"c":"load","v":2.1}]'

    4. Kueri data time-series.

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

    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. Misalnya, jalankan alter help.