Gunakan CLI Tablestore untuk melakukan operasi pada tabel data - Tablestore

Model Wide Column menggunakan tabel data untuk menyimpan informasi. Bagian ini menjelaskan cara menggunakan CLI Tablestore untuk melakukan berbagai operasi pada tabel data, termasuk pembuatan, penggunaan, pembaruan, dan penghapusan tabel. Anda juga dapat mencantumkan nama tabel serta menanyakan informasi terkait tabel.

Buat tabel

Buat tabel data dengan konfigurasi seperti kolom kunci utama dan waktu hidup (TTL) yang ditentukan. Anda juga dapat mengimpor file konfigurasi dalam format JSON untuk membuat tabel data.

Sintaks perintah

create -t tableName --pk '[{"c":"<primaryKeyName>", "t":"<primaryKeyType>"},{"c":"<primaryKeyName>", "t":"<primaryKeyType>","opt":"<options>"}]' --ttl <timeToLive> --version <maxVersion>

Parameter

Parameter	Diperlukan	Contoh	Deskripsi
-m, --mode	Tidak	widecolumn	Jenis tabel yang ingin Anda buat. Nilai default: widecolumn. Nilai valid: widecolumn: tabel data. timeseries: tabel seri waktu.
-t, --table	Ya	mytable	Nama tabel data.
-k, --pk	Ya	[{"c":"uid","t":"string"},{"c":"pid","t":"integer"}]	Kolom kunci utama dari tabel data. Nilai parameter ini adalah array JSON. Parameter ini terdiri dari bidang berikut: c: wajib. Nama kolom kunci utama. t: wajib. Jenis kolom kunci utama. Nilai valid: string, integer, dan binary. opt: opsional. Item konfigurasi opsional. Nilai valid: none dan auto. Nilai default: none. Jika Anda mengatur opt ke auto, kolom kunci utama adalah kolom kunci utama auto-increment. Untuk informasi lebih lanjut tentang kolom kunci utama auto-increment, lihat Konfigurasikan kolom kunci utama auto-increment. Catatan Anda tidak perlu menentukan skema kolom atribut saat membuat tabel data. Kolom atribut di setiap baris bisa berbeda. Anda harus menentukan nama kolom atribut saat menulis data. Anda dapat menentukan satu hingga empat kolom kunci utama. Kolom kunci utama pertama adalah kunci partisi. Setelah Anda membuat tabel data, Anda tidak dapat mengubah konfigurasi atau urutan kolom kunci utama.
--ttl	Tidak	864.000	Periode retensi data dalam tabel data. Unit: detik. Nilai default adalah -1, yang menentukan bahwa data tidak pernah kedaluwarsa. Catatan TTL harus minimal 86.400 detik (satu hari) atau -1. Nilai -1 menentukan bahwa data dalam tabel data tidak pernah kedaluwarsa.
--version	Tidak	1	Jumlah maksimum versi yang dapat disimpan untuk data dalam kolom atribut. Nilai default: 1. Nilai 1 menentukan bahwa hanya versi terbaru data yang disimpan untuk setiap kolom atribut. Nilai parameter ini harus bilangan bulat positif. Penting Tablestore tidak memberlakukan batasan pada jumlah maksimum versi yang dapat disimpan untuk data dalam kolom atribut. Namun, untuk performa optimal dan kemudahan penggunaan, kami sarankan Anda mengatur parameter ini ke nilai yang tidak melebihi 500.
--read_cu	Tidak	0	Throughput baca dan tulis yang dicadangkan. Unit: unit kapasitas (CU). Nilai default 0 menentukan bahwa Anda dikenakan biaya untuk semua throughput berdasarkan model pay-as-you-go. Catatan Anda dapat menentukan throughput baca dan tulis yang dicadangkan hanya untuk tabel data dalam instance berperforma tinggi. Jika Anda mengatur throughput baca atau tulis yang dicadangkan ke nilai selain 0, Anda akan dikenakan biaya terlepas dari apakah Anda memulai permintaan baca atau tulis.
--write_cu	Tidak	0
-d, --defined	Tidak	[{"c":"name","t":"string"},{"c":"age","t":"integer"}]	Nama dan jenis kolom yang telah ditentukan sebelumnya. Nilai parameter ini adalah array JSON. Parameter ini terdiri dari bidang berikut: c: wajib. Nama kolom yang telah ditentukan sebelumnya. t: wajib. Jenis kolom yang telah ditentukan sebelumnya. Nilai valid: string, integer, binary, double, dan bool. Catatan Secara default, Anda dapat menentukan hingga 32 kolom yang telah ditentukan sebelumnya untuk tabel data.
-i, --input	Tidak	/tmp/create_table_meta.json	Path file konfigurasi yang digunakan untuk membuat tabel data. File konfigurasi harus dalam format JSON.

Contoh

Kode sampel berikut menunjukkan cara membuat tabel data bernama mytable. Dalam contoh ini, tabel data memiliki kolom kunci utama uid dan pid. Data dalam tabel tidak akan kedaluwarsa.
```
create -t mytable --pk '[{"c":"uid", "t":"string"}, {"c":"pid", "t":"integer"}]'
```
Kode sampel berikut menunjukkan cara membuat tabel data bernama mytable. Dalam contoh ini, tabel data memiliki kolom kunci utama uid dan pid. Kolom kunci utama pid diatur sebagai kolom auto-increment.

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

Kode sampel berikut menunjukkan cara membuat tabel data bernama mytable. Dalam contoh ini, tabel data memiliki kolom kunci utama uid dan pid. TTL diatur ke 864.000 detik (10 hari), dan hanya versi terbaru data yang disimpan untuk setiap kolom atribut.
```
create -t mytable --pk '[{"C":"uid","t":"string"}, {"c":"pid","t":"integer"}]' --ttl 864000 --version 1
```

Kode sampel berikut menunjukkan cara menggunakan file konfigurasi untuk membuat tabel data bernama mytable. Dalam contoh ini, tabel data memiliki kolom kunci utama uid dan pid. TTL diatur ke 864.000 detik (10 hari), throughput baca dan tulis dicadangkan ke 0, dan hingga tiga versi data disimpan untuk setiap kolom atribut.

Windows

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

Linux dan macOS

create -i /localpath/filename.json

File konfigurasi berisi informasi berikut:

{
    "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
    }
}

Gunakan tabel

Pilih tabel tempat Anda ingin melakukan operasi tabel atau operasi data.

Sintaks perintah

use --wc -t <tableName>

Parameter

Parameter	Diperlukan	Contoh	Deskripsi
--wc	Tidak	N/A	Menentukan bahwa tabel tempat Anda ingin melakukan operasi adalah tabel data atau tabel indeks.
-t, --table	Ya	mytable	Nama tabel.

Contoh

Kode sampel berikut menunjukkan cara memilih tabel mytable:

use -t mytable

Cantumkan nama tabel

Cantumkan nama semua tabel, tabel data, atau tabel seri waktu dalam instance.

Sintaks perintah

list

Parameter

Parameter	Diperlukan	Contoh	Deskripsi
-a, --all	Tidak	N/A	Mencantumkan nama semua tabel.
-d, --detail	Tidak	N/A	Mencantumkan detail tabel.
-w, --wc	Tidak	N/A	Mencantumkan nama semua tabel data.
-t, --ts	Tidak	N/A	Mencantumkan nama semua tabel seri waktu.

Contoh

Cantumkan nama semua tabel dengan tipe yang sama dengan tabel saat ini.
```
list
```
Cantumkan nama semua tabel.
```
list -a
```
Cantumkan nama semua tabel data.
```
list -w
```
Cantumkan nama semua tabel seri waktu.
```
list -t
```

Perbarui tabel

Perbarui informasi tentang tabel data, seperti TTL dan jumlah versi maksimal.

Sintaks perintah

alter -t <tableName> --ttl <timeToLive> --version <maxVersion> --read_cu <readCU> --write_cu <writeCU>

Parameter

Parameter	Diperlukan	Contoh	Deskripsi
-t, --table	Ya	mytable	Nama tabel data.
--ttl	Tidak	864.000	Periode retensi data dalam tabel data. Unit: detik. TTL harus minimal 86.400 detik (satu hari) atau -1. Nilai -1 menentukan bahwa data dalam tabel data tidak pernah kedaluwarsa.
--version	Tidak	1	Jumlah maksimum versi yang dapat disimpan untuk data dalam kolom atribut. Nilai default: 1. Nilai 1 menentukan bahwa hanya versi terbaru data yang disimpan untuk setiap kolom atribut. Nilai parameter ini harus bilangan bulat positif. Penting Tablestore tidak memberlakukan batasan pada jumlah maksimum versi yang dapat disimpan untuk data dalam kolom atribut. Namun, untuk performa optimal dan kemudahan penggunaan, kami sarankan Anda mengatur parameter ini ke nilai yang tidak melebihi 500.
--read_cu	Tidak	0	Throughput baca dan tulis yang dicadangkan. Unit: CU. Nilai default 0 menentukan bahwa Anda dikenakan biaya untuk semua throughput berdasarkan model pay-as-you-go. Catatan Anda dapat menentukan throughput baca dan tulis yang dicadangkan hanya untuk tabel data dalam instance berperforma tinggi. Jika Anda mengatur throughput baca atau tulis yang dicadangkan ke nilai selain 0, Anda akan dikenakan biaya terlepas dari apakah Anda memulai permintaan baca atau tulis.
--write_cu	Tidak	0

Contoh

Kode sampel berikut menunjukkan cara mengubah TTL menjadi 86.400 detik, mengatur jumlah versi maksimal ke 1, serta throughput baca dan tulis yang dicadangkan ke 0 untuk tabel data bernama mytable:

alter -t mytable --ttl 86400 --version 1 --read_cu 0 --write_cu 0

Tanyakan informasi tentang tabel

Tanyakan informasi tentang tabel lalu simpan informasi tersebut ke file JSON di komputer lokal Anda.

Sintaks perintah

desc -t <tableName> -o /localpath/filename.json

Parameter

Parameter	Diperlukan	Contoh	Deskripsi
-t, --table	Tidak	mytable	Nama tabel data atau tabel indeks.
-f,--print_format	Tidak	json	Format keluaran informasi tentang tabel. Nilai default: json. Nilai valid: json dan table.
-o,--output	Tidak	/tmp/describe_table_meta.json	Direktori dan nama file JSON tempat informasi tentang tabel disimpan.

Contoh

Kode sampel berikut menunjukkan cara menanyakan informasi tentang tabel saat ini:
```
desc
```
Kode sampel berikut menunjukkan cara menanyakan informasi tentang tabel saat ini dan menyimpan informasi tersebut ke file lokal bernama describe_table_meta.json:
```
desc -o  /tmp/describe_table_meta.json
```

Hapus tabel

Hapus tabel data.

Sintaks perintah

drop -t <tableName> -y

Parameter

Parameter	Diperlukan	Contoh	Deskripsi
-t, --table	Ya	mytable	Nama tabel data.
-y,--yes	Ya	Tidak tersedia	Menentukan bahwa informasi konfirmasi ditampilkan. Parameter ini diperlukan dalam perintah.

Contoh

Kode sampel berikut menunjukkan cara menghapus tabel data bernama mytable:

drop -t mytable -y

Referensi

Model Wide Column mirip dengan model data Bigtable atau HBase, dan cocok untuk berbagai skenario seperti penyimpanan metadata dan data besar. Untuk informasi lebih lanjut, lihat Ikhtisar.
Anda dapat melakukan operasi pada tabel data di konsol Tablestore, atau menggunakan CLI Tablestore atau SDK Tablestore. Untuk informasi lebih lanjut, lihat Gunakan Konsol Tablestore dan Gunakan SDK Tablestore.