Kelola tabel data menggunakan antarmuka baris perintah - Tablestore

Buat, pilih, tampilkan, perbarui, dan hapus tabel data menggunakan Tablestore command line interface (CLI).

Prasyarat

Instal Tablestore CLI dengan kredensial akses yang telah dikonfigurasi. Untuk informasi selengkapnya, lihat Tablestore CLI.
Memiliki instans Tablestore. Untuk informasi selengkapnya, lihat Operasi Instans.

Buat tabel

Untuk membuat tabel data, tentukan kolom kunci primer dan, secara opsional, konfigurasikan TTL data serta batas jumlah versi. Alternatifnya, Anda dapat membuat tabel dari file konfigurasi JSON.

create -t tableName --pk '[{"c":"col1","t":"string"},{"c":"col2","t":"integer"}]' [--ttl seconds] [--version max]

Parameter	Wajib	Deskripsi
`-t, --table`	Ya	Nama tabel data.
`-k, --pk`	Ya	Definisi kolom kunci primer dalam format array JSON. Setiap elemen berisi bidang-bidang berikut: `c` (wajib): Nama kolom kunci primer. `t` (wajib): Tipe kolom kunci primer. Nilai yang valid: `string`, `integer`, `binary`. `opt` (opsional): Nilai default: `none`. Atur ke `auto` untuk menggunakan kolom sebagai kolom kunci utama auto-increment. Untuk informasi selengkapnya tentang kolom kunci utama auto-increment, lihat Auto-increment primary key column. Catatan Kolom atribut tidak perlu didefinisikan saat membuat tabel data. Setiap baris di Tablestore dapat memiliki kolom atribut yang berbeda. Nama kolom atribut ditentukan saat Anda menulis data. Tabel data mendukung hingga 4 kolom kunci primer. Kolom kunci primer pertama adalah kunci partisi secara default. Konfigurasi kunci primer tidak dapat diubah setelah tabel dibuat.
`-m, --model`	Tidak	Jenis tabel. Nilai default: `widecolumn` (tabel data). Untuk membuat tabel deret waktu, lihat TimeSeries model.
`--ttl`	Tidak	Waktu hidup (TTL) data, dalam detik. Nilai default: `-1` (data tidak pernah kedaluwarsa). Nilainya harus lebih besar atau sama dengan 86400 (satu hari) atau sama dengan -1.
`--version`	Tidak	Jumlah maksimum versi. Nilai default: `1`. Nilainya harus berupa bilangan bulat bukan nol. Penting Tablestore tidak menerapkan batas keras pada jumlah maksimum versi. Namun, demi kinerja dan kegunaan optimal, pertahankan nilai ini pada 500 atau kurang.
`--read_cu`	Tidak	Throughput baca atau tulis yang dicadangkan, dalam unit kapasitas (CUs). Nilai default: `0` (pay-as-you-go). Catatan Konfigurasi ini hanya didukung untuk tabel data dalam instans kinerja tinggi. Jika throughput baca atau tulis yang dicadangkan diatur ke nilai bukan nol, Anda akan dikenai biaya terlepas dari apakah permintaan baca atau tulis dikirim atau tidak.
`--write_cu`	Tidak
`-d, --defined`	Tidak	Kolom pradefinisi dalam format array JSON. Diperlukan untuk indeks sekunder. Setiap elemen berisi bidang-bidang berikut: `c` (wajib): Nama kolom pradefinisi. `t` (wajib): Tipe kolom pradefinisi. Nilai yang valid: `string`, `integer`, `binary`, `double`, `bool`. Catatan Tabel data mendukung hingga 32 kolom pradefinisi secara default.
`--stream_enable`	Tidak	Menentukan apakah Stream diaktifkan. Nilai default: `false`.
`--stream_expire`	Tidak	Periode kedaluwarsa data Stream, dalam jam. Nilai default: `24`.
`-i, --input`	Tidak	Jalur ke file konfigurasi JSON untuk membuat tabel.

Buat tabel data dasar:

create -t mytable --pk '[{"c":"uid","t":"string"},{"c":"pid","t":"integer"}]'

Buat tabel data dengan kolom auto-increment dan TTL:

create -t mytable --pk '[{"c":"uid","t":"string"},{"c":"pid","t":"integer","opt":"auto"}]' --ttl 864000 --version 1

Buat tabel data dengan kolom pradefinisi untuk indeks sekunder:

create -t mytable --pk '[{"c":"uid","t":"string"},{"c":"pid","t":"integer"}]' --defined '[{"c":"name","t":"string"},{"c":"age","t":"integer"}]'

Buat tabel data dari file konfigurasi:

Windows

create -i D:\\localpath\\filename.json

Linux dan macOS

create -i /localpath/filename.json

Contoh file konfigurasi:

{
    "Name": "mytable",
    "Meta": {
        "Pk": [
            {"C": "uid", "T": "string", "Opt": "none"},
            {"C": "pid", "T": "integer", "Opt": "none"}
        ]
    },
    "Option": {
        "TTL": 864000,
        "Version": 3
    },
    "CU": {
        "Read": 0,
        "Write": 0
    }
}

Pilih tabel

Pilih tabel data untuk operasi berikutnya.

use --wc -t tableName

Parameter	Wajib	Deskripsi
`--wc`	Tidak	Memilih tabel data kolom lebar.
`-t, --table`	Ya	Nama tabel.

Contoh:

use --wc -t mytable

Daftar nama tabel

Tampilkan daftar nama tabel dalam instans saat ini. Hasil dapat difilter berdasarkan jenis tabel sesuai kebutuhan.

list [--wc | --all] [--detail]

Parameter	Wajib	Deskripsi
`-w, --wc`	Tidak	Hanya menampilkan tabel data.
`-a, --all`	Tidak	Menampilkan semua jenis tabel.
`-d, --detail`	Tidak	Menampilkan informasi detail tabel.

Contoh:

list --wc

Lihat detail tabel

Tampilkan detail konfigurasi tabel data atau tabel indeks.

desc [-t tableName] [-f json|table] [-o outputFile]

Parameter	Wajib	Deskripsi
`-t, --table`	Tidak	Nama tabel data atau tabel indeks. Jika dihilangkan, menggunakan tabel yang dipilih oleh `use`.
`-f, --print_format`	Tidak	Format output. Nilai yang valid: `json` (default) dan `table`.
`-o, --output`	Tidak	Menyimpan output ke file lokal.

Contoh:

desc -t mytable

Perbarui tabel

Perbarui konfigurasi tabel data, seperti TTL data, jumlah maksimum versi, dan throughput yang dicadangkan.

alter -t tableName [--ttl seconds] [--version max] [--read_cu n] [--write_cu n]

Parameter	Wajib	Deskripsi
`-t, --table`	Ya	Nama tabel. Jika tabel telah dipilih dengan `use`, parameter ini bersifat opsional.
`--ttl`	Tidak	Waktu hidup (TTL) data, dalam detik. Nilainya harus lebih besar atau sama dengan 86400 (satu hari) atau sama dengan -1 (data tidak pernah kedaluwarsa).
`--version`	Tidak	Jumlah maksimum versi. Nilainya harus berupa bilangan bulat bukan nol.
`--read_cu`	Tidak	Throughput baca atau tulis yang dicadangkan, dalam unit kapasitas (CUs). Konfigurasi ini hanya didukung untuk instans kinerja tinggi.
`--write_cu`	Tidak
`--stream_enable`	Tidak	Menentukan apakah Stream diaktifkan.
`--stream_expire`	Tidak	Periode kedaluwarsa data Stream, dalam jam.
`--disallow_update`	Tidak	Menentukan apakah operasi pembaruan dinonaktifkan.

Atur TTL menjadi satu hari dan jumlah maksimum versi menjadi 1:

alter -t mytable --ttl 86400 --version 1

Hapus tabel

Hapus tabel data yang ditentukan.

drop -t tableName [-y]

Parameter	Wajib	Deskripsi
`-t, --table`	Ya	Nama tabel.
`-y, --yes`	Tidak	Mengabaikan prompt konfirmasi dan langsung menghapus tabel.

Contoh:

drop -t mytable -y