Gunakan CLI Tablestore untuk mengelola instance - Tablestore

Instance adalah entitas logis dalam Tablestore yang digunakan untuk mengelola tabel. Setiap instance setara dengan sebuah database. Topik ini menjelaskan cara menggunakan CLI Tablestore untuk mengelola instance Tablestore.

Prasyarat

Tablestore harus sudah diaktifkan. Untuk informasi lebih lanjut, lihat Aktifkan Tablestore.

Buat Instance

Buat instance performa tinggi dalam model di wilayah tempat Anda ingin menggunakan Tablestore.

null

Nama instance harus unik di wilayah tersebut. Jika muncul kesalahan yang menunjukkan bahwa nama instance yang Anda tentukan sudah ada, gunakan nama instance baru.
Anda hanya dapat membuat instance performa tinggi dalam model jika menggunakan CLI Tablestore.

Sintaks

create_instance -d deskripsi -n namaInstance -r regionId

Tabel berikut menjelaskan item konfigurasi:

Parameter	Diperlukan	Contoh	Deskripsi
-n	Ya	myinstance	Nama instance. Untuk informasi lebih lanjut, lihat Instance.
-r	Ya	cn-hangzhou	ID wilayah. Untuk informasi lebih lanjut, lihat Wilayah.
-d	Tidak	"Instance pertama dibuat oleh CLI."	Deskripsi instance.

Contoh

Kode sampel berikut menunjukkan cara membuat instance performa tinggi bernama myinstance di wilayah China (Hangzhou):

create_instance -d "Instance pertama dibuat oleh CLI." -n myinstance -r cn-hangzhou

Konfigurasikan Instance

null

Anda hanya dapat mengelola sumber daya di instance setelah mengonfigurasinya.
Konfigurasi instance diperlukan saat mengatur informasi akses jika informasi instance belum dikonfigurasi atau jika Anda ingin mengakses instance lain.

Anda harus menentukan instance yang akan diakses dengan mengonfigurasi titik akhir layanannya. Titik akhir bervariasi tergantung pada jenis jaringan yang digunakan.

Sintaks

config --endpoint endpoint --instance instanceName

Tabel berikut menjelaskan item konfigurasi:

Parameter

Diperlukan

Contoh

Deskripsi

--endpoint

http://myinstance.cn-hangzhou.ots.aliyuncs.com

Titik akhir instance, yang mendukung dua jenis jaringan: Internet dan virtual private cloud (VPC). Tentukan titik akhir instance berdasarkan jenis jaringan Anda. Format titik akhir harus mematuhi aturan berikut:

Publik: http(s)://<nama_instance>.<region_id>.ots.aliyuncs.com
VPC: http(s)://<nama_instance>.<region_id>.vpc.tablestore.aliyuncs.com

--instance

myinstance

Nama instance.

Contoh

Kode sampel berikut menunjukkan cara mengonfigurasi instance myinstance di wilayah China (Hangzhou) untuk diakses melalui titik akhir publik.

config --endpoint http://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance

Output sampel:

{
    "Endpoint": "http://myinstance.cn-hangzhou.ots.aliyuncs.com",
    "AccessKeyId": "NTS**********************",
    "AccessKeySecret": "7NR2****************************************",
    "AccessKeySecretToken": "",
    "Instance": "myinstance"
}

Tabel berikut menjelaskan parameter:

Parameter	Diperlukan	Contoh	Deskripsi
Endpoint	Tidak	https://myinstance.cn-hangzhou.ots.aliyuncs.com	Titik akhir instance. Untuk informasi lebih lanjut, lihat Titik Akhir.
Instance	Tidak	myinstance	Nama instance.
AccessKeyId	Ya	NTS**********************	ID AccessKey dan Rahasia AccessKey dari akun Alibaba Cloud Anda atau pengguna RAM. null Jika Anda menggunakan kredensial akses sementara yang diperoleh dari Security Token Service (STS) untuk mengakses Tablestore, AccessKeyId dan AccessKeySecret yang dikembalikan adalah ID AccessKey dan Rahasia AccessKey yang dikembalikan oleh STS, masing-masing.
AccessKeySecret	Ya	7NR2****************************************
AccessKeySecretToken	Tidak	STS.6MC2****************************************	Token akses sementara. Parameter ini dikembalikan jika Anda mengakses Tablestore menggunakan kredensial akses sementara yang diperoleh dari STS.

Lihat Informasi Instance

Anda dapat memeriksa informasi tentang instance, seperti nama instance, waktu pembuatan, dan ID akun pemilik instance.

Sintaks

describe_instance -r regionId -n instanceName

Tabel berikut menjelaskan item konfigurasi:

Parameter	Diperlukan	Contoh	Deskripsi
-n	Ya	myinstance	Nama instance. Untuk informasi lebih lanjut, lihat Instance.
-r	Ya	cn-hangzhou	ID wilayah. Untuk informasi lebih lanjut, lihat Wilayah.

Contoh

Kode sampel berikut menunjukkan cara memeriksa informasi instance myinstance di wilayah China (Hangzhou):

describe_instance -r cn-hangzhou -n myinstance

Output sampel:

{
    "ClusterType": "ssd",
    "CreateTime": "2024-07-18 09:15:10",
    "Description": "Instance pertama dibuat oleh CLI.",
    "InstanceName": "myinstance",
    "Network": "NORMAL",
    "Quota": {
        "EntityQuota": 64
    },
    "ReadCapacity": 5000,
    "Status": 1,
    "TagInfos": {},
    "UserId": "1379************",
    "WriteCapacity": 5000
}

Query Instance

Anda dapat memeriksa semua instance di wilayah tertentu.

Sintaks

list_instance -r regionId

Tabel berikut menjelaskan item konfigurasi:

Parameter	Diperlukan	Contoh	Deskripsi
-r	Ya	cn-hangzhou	ID wilayah.

Contoh

Kode sampel berikut menunjukkan cara mendapatkan daftar semua instance di wilayah China (Hangzhou):

list_instance -r cn-hangzhou

Output sampel:

null

Jika tidak ada instance yang dibuat di wilayah tertentu, hasil yang dikembalikan akan kosong.

[
    "myinstance"
]

Referensi

Setelah membuat instance dan mengonfigurasi informasi akses instance, Anda dapat menggunakan fitur Tablestore sesuai dengan model penyimpanan data yang dibutuhkan oleh bisnis Anda.

Model data

Proses penggunaan

Model Wide Column

Buat tabel data untuk menyimpan data. Untuk informasi lebih lanjut, lihat Operasi pada tabel data.
Baca data dari dan tulis data ke tabel. Untuk informasi lebih lanjut, lihat Operasi pada tabel data.
Gunakan indeks untuk mempercepat kueri data. Untuk informasi lebih lanjut, lihat Indeks sekunder dan Indeks pencarian.
Gunakan fitur kueri SQL untuk menanyakan data. Untuk informasi lebih lanjut, lihat Kueri SQL.

Jika Anda ingin memigrasikan data atau menggunakan mesin komputasi untuk memproses data, gunakan Layanan Tunnel. Untuk informasi lebih lanjut, lihat Layanan Tunnel.

Model TimeSeries

Buat tabel time series untuk menyimpan data. Untuk informasi lebih lanjut, lihat Operasi pada tabel time series.
Baca data dari dan tulis data ke tabel dan ambil timeline sesuai kebutuhan. Untuk informasi lebih lanjut, lihat Operasi pada tabel time series.
Gunakan fitur kueri SQL untuk menanyakan data. Untuk informasi lebih lanjut, lihat Kueri SQL.