Baca dan tulis data dengan Tablestore CLI - Tablestore - Alibaba Cloud Documentation Center

Sisipkan, baca, perbarui, hapus, pindai, serta impor atau ekspor data dalam tabel data menggunakan Tablestore CLI.

Prasyarat

Tablestore CLI telah diinstal dan kredensial akses telah dikonfigurasi. Untuk informasi selengkapnya, lihat Tablestore CLI.
Tabel data telah dibuat. Untuk informasi selengkapnya, lihat Operasi tabel data.

Sebelum menjalankan operasi data, jalankan perintah berikut untuk memilih tabel data target:

use -t <tableName>

Sisipkan data

Sisipkan satu baris data ke dalam tabel data.

put --pk '<pk_values>' --attr '<attr_json>'

Parameter	Wajib	Deskripsi
-k, --pk	Ya	Nilai kunci primer dari tabel data, direpresentasikan sebagai array JSON. Penting Jumlah dan tipe kolom kunci primer harus sesuai dengan tabel data. Jika kolom kunci primer merupakan kolom auto-increment, atur nilainya ke placeholder null.
-a, --attr	Ya	Kolom atribut, direpresentasikan sebagai array JSON. Setiap kolom atribut berisi bidang-bidang berikut: c (wajib): Nama kolom atribut. v (wajib): Nilai kolom atribut. t (opsional): Tipe kolom atribut. Nilai yang valid: integer, string (string terenkripsi UTF-8), binary, Boolean, dan double. Bidang ini wajib jika tipe kolom atribut adalah binary. ts (opsional): Timestamp, yaitu versi data. Jika parameter ini tidak diatur, Tablestore akan menghasilkan timestamp.
--condition	Tidak	Kondisi keberadaan baris. Pembaruan bersyarat didukung. Nilai yang valid: ignore (default): Menyisipkan data tanpa mempertimbangkan apakah baris tersebut sudah ada. Baris yang sudah ada akan ditimpa. exist: Menyisipkan data hanya jika baris tersebut sudah ada. Data yang ada akan ditimpa. not_exist: Menyisipkan data hanya jika baris tersebut belum ada.
-i, --input	Tidak	Menyisipkan data dari file konfigurasi JSON. Saat menggunakan file konfigurasi, Anda tidak perlu menentukan --pk dan --attr.

Untuk menyisipkan data dari file konfigurasi, jalankan perintah berikut:

Windows

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

Linux dan macOS

put -i /localpath/filename.json

Contoh file konfigurasi:

{
    "PK":{
        "Values":["86", 6771]
    },
    "Attr":{
        "Values":[
            {"C":"age", "V":32, "TS":1626860801604, "IsInt":true}
        ]
    }
}

Contoh

Sisipkan satu baris. Nilai kolom kunci primer pertama adalah "86" dan nilai kolom kunci primer kedua adalah 6771. Baris tersebut memiliki dua kolom atribut: name dan country.
```
put --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]'
```

Sisipkan data hanya jika baris tersebut belum ada.

put --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]' --condition not_exist

Baca data

Baca satu baris data berdasarkan kunci primer.

Catatan

Jika baris yang ditentukan tidak ada, hasil kosong akan dikembalikan.

get --pk '<pk_values>'

Parameter	Wajib	Deskripsi
-k, --pk	Ya	Nilai kunci primer dari tabel data, direpresentasikan sebagai array JSON. Jumlah dan tipe kolom kunci primer harus sesuai dengan tabel data.
-c, --columns	Tidak	Kolom yang akan dibaca. Tentukan kolom kunci primer atau kolom atribut, dipisahkan dengan koma. Jika parameter ini tidak diatur, semua kolom akan dikembalikan.
--max_version	Tidak	Jumlah maksimum versi data yang akan dibaca.
--time_range_start	Tidak	Membaca data dalam rentang nomor versi yang ditentukan. time_range_start dan time_range_end masing-masing menentukan timestamp awal dan akhir. Rentang tersebut merupakan interval setengah terbuka [awal, akhir).
--time_range_end	Tidak
--time_range_specific	Tidak	Membaca data dari nomor versi tertentu.
-o, --output	Tidak	Menyimpan hasil kueri ke file lokal.

Contoh

Baca baris dengan nilai kolom kunci primer pertama "86" dan nilai kolom kunci primer kedua 6771.

get --pk '["86", 6771]'

Perbarui data

Perbarui kolom atribut suatu baris dalam tabel data.

update --pk '<pk_values>' --attr '<attr_json>'

Parameter	Wajib	Deskripsi
-k, --pk	Ya	Nilai kunci primer dari tabel data, direpresentasikan sebagai array JSON. Jumlah dan tipe kolom kunci primer harus sesuai dengan tabel data.
--attr	Ya	Kolom atribut, direpresentasikan sebagai array JSON. Setiap kolom atribut berisi bidang-bidang berikut: c (wajib): Nama kolom atribut. v (wajib): Nilai kolom atribut. t (opsional): Tipe kolom atribut. Nilai yang valid: integer, string (string terenkripsi UTF-8), binary, Boolean, dan double. Bidang ini wajib jika tipe kolom atribut adalah binary. ts (opsional): Timestamp, yaitu versi data. Jika parameter ini tidak diatur, Tablestore akan menghasilkan timestamp.
--delete	Tidak	Nama kolom atribut yang akan dihapus. Gunakan parameter ini bersama `--attr '[]'` untuk menghapus kolom atribut yang ditentukan tanpa memperbarui kolom lain. Kedua parameter --delete dan --attr wajib digunakan saat menghapus kolom atribut.
--condition	Tidak	Kondisi keberadaan baris. Pembaruan bersyarat didukung. Nilai yang valid: ignore (default): Memperbarui data tanpa mempertimbangkan apakah baris tersebut sudah ada. exist: Memperbarui data hanya jika baris tersebut sudah ada. not_exist: Menyisipkan data hanya jika baris tersebut belum ada.
-i, --input	Tidak	Memperbarui data dari file konfigurasi JSON. Saat menggunakan file konfigurasi, Anda tidak perlu menentukan --pk dan --attr.

Untuk memperbarui data dari file konfigurasi, jalankan perintah berikut:

Windows

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

Linux dan macOS

update -i /localpath/filename.json

Format file konfigurasi sama seperti saat menyisipkan data.

Contoh

Perbarui baris dengan nilai kolom kunci primer pertama "86" dan nilai kolom kunci primer kedua 6771.

update --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]' --condition ignore

Hapus kolom atribut aaa dari baris dengan nilai kunci primer "abc".
```
update --pk '["abc"]' --delete aaa --attr '[]'
```

Hapus data

Hapus satu baris data berdasarkan kunci primer.

delete --pk '<pk_values>'

Parameter	Wajib	Deskripsi
-k, --pk	Ya	Nilai kunci primer dari tabel data, direpresentasikan sebagai array JSON. Jumlah dan tipe kolom kunci primer harus sesuai dengan tabel data.

Contoh

Hapus baris dengan nilai kolom kunci primer pertama "86" dan nilai kolom kunci primer kedua 6771.

delete --pk '["86", 6771]'

Pindai data

Pindai dan ambil semua data atau jumlah baris tertentu dari tabel data.

scan --limit <n>

Parameter	Wajib	Deskripsi
--limit	Tidak	Jumlah maksimum baris yang dikembalikan. Jika parameter ini tidak diatur, semua baris dalam tabel akan dipindai.

Contoh

Pindai dan ambil hingga 10 baris dari tabel data.

scan --limit 10

Ekspor data

Ekspor data dari tabel data ke file JSON lokal.

scan -o /localpath/filename.json

Parameter	Wajib	Deskripsi
-o, --output	Ya	Jalur file lokal tempat data diekspor.
-c, --columns	Tidak	Kolom yang akan diekspor. Tentukan kolom kunci primer atau kolom atribut, dipisahkan dengan koma. Jika parameter ini tidak diatur, semua kolom akan diekspor.
--max_version	Tidak	Jumlah maksimum versi data yang diekspor.
--time_range_start	Tidak	Mengekspor data dalam rentang nomor versi yang ditentukan. time_range_start dan time_range_end masing-masing menentukan timestamp awal dan akhir. Rentang tersebut merupakan interval setengah terbuka [awal, akhir).
--time_range_end	Tidak
--time_range_specific	Tidak	Mengekspor data dari nomor versi tertentu.
--backward	Tidak	Mengekspor data dalam urutan menurun berdasarkan kunci primer.
-l, --limit	Tidak	Jumlah maksimum baris yang diekspor.
-b, --begin	Tidak	Titik awal dan akhir rentang ekspor. Rentang kunci primer merupakan interval setengah terbuka [awal, akhir). Catatan Jika --begin diatur ke [null,null], titik awal adalah [INF_MIN,INF_MIN], yang berarti dimulai dari nilai minimum setiap kolom kunci primer. Jika --end diatur ke [null,null], titik akhir adalah [INF_MAX,INF_MAX], yang berarti berakhir pada nilai maksimum setiap kolom kunci primer.
-e, --end	Tidak

Contoh

Ekspor semua data dari tabel saat ini ke file lokal bernama mydata.json.
```
scan -o /tmp/mydata.json
```
Ekspor hanya kolom uid dan name.
```
scan -o /tmp/mydata.json -c uid,name
```

Ekspor data dalam rentang kunci primer tertentu.

scan -o /tmp/mydata.json -b '["86", 6771]' -e '["86", 6775]'

Impor data

Impor data dari file JSON lokal ke dalam tabel data.

Penting

Jika jalur file berisi karakter Tionghoa, proses impor akan gagal.

import -i /localpath/filename.json

Parameter	Wajib	Deskripsi
-a, --action	Tidak	Mode impor. Nilai yang valid: put (default): Jika baris sudah ada, data baris asli (semua kolom dan semua versi) dihapus terlebih dahulu, lalu data baris baru ditulis. update: Jika baris sudah ada, Anda dapat menambah atau menghapus kolom atribut, menghapus data versi tertentu, atau memperbarui nilai kolom atribut. Jika baris belum ada, baris baru akan disisipkan.
-i, --input	Ya	Jalur ke file data JSON lokal. Penting Jumlah dan tipe kolom kunci primer harus sesuai dengan tabel data. Jika kolom kunci primer merupakan kolom auto-increment, atur nilainya ke placeholder null.
--ignore_version	Tidak	Mengabaikan pengecekan timestamp dan menggunakan waktu saat ini sebagai timestamp.

Format file data (satu catatan JSON per baris):

{"PK":{"Values":["redchen",0]},"Attr":{"Values":[{"C":"country","V":"china0"},{"C":"name","V":"redchen0"}]}}
{"PK":{"Values":["redchen",1]},"Attr":{"Values":[{"C":"country","V":"china1"},{"C":"name","V":"redchen1"}]}}

Contoh

Impor data dari file mydata.json ke tabel saat ini.
```
import -i /tmp/mydata.json
```
Impor data dan gunakan waktu saat ini sebagai timestamp.
```
import -i /tmp/mydata.json --ignore_version
```