Tablestore：Operasi tabel

Catatan

• Satu instans dapat memiliki maksimal 64 tabel data.

• Tabel data yang baru dibuat tidak langsung tersedia untuk operasi baca dan tulis. Biasanya, Anda dapat membaca dari dan menulis ke tabel tersebut sekitar satu menit setelah pembuatan.

• Kolom kunci utama auto-increment dan fitur transaksi lokal tidak dapat digunakan secara bersamaan. Jika Anda mengonfigurasi kolom kunci utama auto-increment saat membuat tabel data, transaksi lokal tidak akan berlaku meskipun diaktifkan.

Fitur

• Buat Tabel Data

  Saat membuat tabel data, Anda harus menentukan skema dan konfigurasinya.

  • Skema tabel mencakup nama tabel, definisi kunci primer, dan konfigurasi kolom pradefinisi.

  • Tabel berikut menjelaskan item konfigurasi yang dapat Anda atur untuk tabel tersebut.

    Item Konfigurasi	Deskripsi
    Konfigurasikan kolom primary key auto-increment	Saat membuat tabel data, Anda dapat mengatur kolom kunci primer non-partisi sebagai kolom auto-increment. Selama penulisan data, Anda tidak perlu menentukan nilai untuk kolom auto-increment tersebut. Tablestore secara otomatis menghasilkan nilainya.
    Data versions and lifecycle	Gunakan versi data dan time to live (TTL) untuk mengelola data secara efisien. Hal ini mengurangi penyimpanan data dan menekan biaya penyimpanan.
    Allow updates	Secara default, data dapat ditulis ke tabel data menggunakan pembaruan UpdateRow. Anda juga dapat mengubah status allow updates tabel setelah tabel dibuat. Penting Jika Anda berencana menggunakan siklus hidup indeks pencarian, Anda harus melarang penulisan data menggunakan pembaruan UpdateRow.
    Reserved read/write throughput	Untuk instans kinerja tinggi dalam , Anda dapat mengonfigurasi reserved read/write throughput untuk tabel data sesuai kebutuhan.
    Indeks sekunder	Tablestore menyediakan indeks sekunder lokal dan global untuk memenuhi berbagai kebutuhan kueri dengan persyaratan konsistensi baca yang berbeda. Anda dapat membuat satu atau beberapa indeks sekunder saat membuat tabel data. Catatan Untuk menggunakan indeks sekunder, pradefinisikan kolom non-kunci primer beserta tipe datanya saat membuat tabel data. Gunakan kolom-kolom tersebut sebagai kolom indeks atau kolom atribut untuk tabel indeks. Anda juga dapat menambahkan atau menghapus kolom pradefinisi setelah tabel dibuat.
    Enkripsi data	Tablestore menyediakan enkripsi saat diam (encryption at rest) untuk memastikan keamanan data. Anda dapat mengonfigurasi enkripsi data saat membuat tabel data.
    Local transaction	Setelah Anda mengaktifkan transaksi lokal untuk tabel data, Anda dapat membuat transaksi lokal dalam satu nilai kunci partisi tunggal dan melakukan operasi baca-tulis pada data dalam transaksi tersebut. Penting Aktifkan transaksi lokal untuk tabel data di Konsol Tablestore atau menggunakan Tablestore SDK untuk Java 5.11.0 atau yang lebih baru. Jika Anda membuat tabel data tanpa mengaktifkan fitur transaksi lokal tetapi kemudian memerlukan fitur ini, silakan submit a ticket untuk mengajukan permintaan.

• Perbarui konfigurasi tabel

  Anda dapat memperbarui TTL, jumlah versi maksimum, offset versi maksimum, dan konfigurasi stream tabel data. Anda juga dapat memperbarui reserved read/write throughput tabel data dalam instans komputasi-teroptimalkan.

• Daftar nama tabel

  Anda dapat mengambil nama semua tabel data yang dibuat dalam instans saat ini.

• Deskripsi tabel kueri

  Anda dapat mengkueri informasi tentang tabel data tertentu, seperti skemanya dan detail reserved read/write throughput-nya.

• Hapus tabel data

  Anda dapat menghapus tabel data tertentu.

Buat tabel data

Untuk membuat tabel data di konsol Tablestore, ikuti langkah-langkah berikut:

1. Buka halaman Instance Management.

   1. Masuk ke konsol Tablestore.

   2. Di bilah navigasi atas, pilih grup sumber daya dan wilayah.

   3. Di halaman Overview, klik alias instans atau klik Instance Management di kolom Actions.

2. Di tab Instance Details, klik Create Table.

3. Di kotak dialog Create Table, konfigurasikan parameter seperti dijelaskan dalam tabel berikut.

   Parameter	Deskripsi
   Nama Tabel	Nama tabel data. Nama harus unik dalam instans tersebut. Nama harus terdiri dari 1 hingga 255 byte, berupa huruf besar atau kecil, angka, atau garis bawah (_), serta dimulai dengan huruf atau garis bawah (_).
   Primary Key	Satu atau beberapa kolom yang secara unik mengidentifikasi suatu record dalam tabel. Masukkan nama kunci primer, pilih tipe data, lalu klik Add Primary Key untuk menambahkan kunci primer baru. Satu tabel dapat memiliki hingga empat kunci primer. Kunci primer pertama secara default merupakan kunci partisi. Konfigurasi dan urutan kunci primer tidak dapat diubah setelah ditetapkan. Penting Tablestore memungkinkan Anda mengatur kolom kunci primer sebagai kolom auto-increment. Setiap tabel hanya dapat memiliki satu kolom kunci primer auto-increment, dan kunci partisi tidak dapat diatur sebagai kolom auto-increment. Setelah kolom kunci primer diatur sebagai auto-increment, Anda tidak perlu menentukan nilai untuk kolom ini saat menulis satu baris data. Tablestore secara otomatis menghasilkan nilainya. Nilai yang dihasilkan secara otomatis bersifat inkremental ketat dan unik dalam kunci partisi yang sama. Nama kunci primer harus terdiri dari 1 hingga 255 byte, berupa huruf besar atau kecil, angka, atau garis bawah (_), serta dimulai dengan huruf atau garis bawah (_). Tipe data kunci primer dapat berupa String, Integer, atau Binary.
   Izinkan Pembaruan	Menentukan apakah data boleh diperbarui menggunakan UpdateRow. Jika Anda tidak mengatur parameter ini atau mengaturnya ke Yes, data dapat diperbarui menggunakan UpdateRow. Jika Anda ingin menggunakan fitur lifecycle management untuk indeks pencarian, Anda harus mengatur parameter ini ke No. Pengaturan ini melarang pembaruan data menggunakan UpdateRow.
   Enkripsi	Menentukan apakah enkripsi saat diam diaktifkan. Secara default, fitur ini dinonaktifkan. Aktifkan sakelar Encryption untuk mengaktifkannya. Penting Setelah enkripsi saat diam diaktifkan, fitur tersebut tidak dapat dinonaktifkan. Harap berhati-hati.
   Tipe Enkripsi	Tipe enkripsi. Parameter ini wajib diisi hanya jika Anda mengaktifkan sakelar Encryption. Nilai yang valid: KMS Service Master Key: Tablestore secara otomatis membuat kunci master layanan KMS untuk mengenkripsi dan mendekripsi data. BYOK Custom Key: Tablestore mengenkripsi dan mendekripsi data berdasarkan kunci kustom Anda. Penting Sebelum menggunakan tipe enkripsi BYOK custom key, Anda harus membuat kunci yang dilindungi perangkat lunak di Konsol KMS, lalu membuat role kustom dan mengonfigurasi izin. Untuk informasi selengkapnya, lihat Data encryption.
   ID Kunci	ID kunci. Parameter ini wajib diisi hanya jika Anda mengatur Encryption Type ke BYOK Custom Key.
   ARN	ARN role tersebut. Parameter ini wajib diisi hanya jika Anda mengatur Encryption Type ke BYOK Custom Key.

4. (Opsional) Di kotak dialog Create Table, konfigurasikan pengaturan lanjutan atau buat indeks sekunder.

   Langkah ini memungkinkan Anda mengatur konfigurasi lanjutan, seperti siklus hidup data, atau membuat indeks sekunder untuk tabel data.

   Konfigurasikan parameter lanjutan

   Untuk mengelola periode retensi data dalam tabel, Anda dapat menentukan time to live (TTL). Untuk menyimpan beberapa versi data dengan kunci primer yang sama, Anda dapat menentukan jumlah versi maksimum. Untuk informasi selengkapnya, lihat Data versions and lifecycle.

   Untuk instans kinerja tinggi dalam mode bayar sesuai penggunaan, Anda dapat menentukan reserved read atau write throughput untuk tabel data guna menghemat biaya. Untuk informasi selengkapnya, lihat Reserved read/write throughput.

   1. Aktifkan sakelar Advanced Settings.

   2. Konfigurasikan parameter lanjutan seperti dijelaskan dalam tabel berikut.

      Parameter	Deskripsi
      Data Lifecycle	Periode retensi data dalam tabel data. Saat periode retensi data melebihi TTL yang ditentukan, sistem secara otomatis membersihkan data yang kedaluwarsa. Satuan: detik. Nilainya harus lebih besar dari atau sama dengan 86400 (satu hari) atau -1 (data tidak pernah kedaluwarsa).
      Max versions	Jumlah maksimum versi yang dapat disimpan untuk setiap kolom atribut dalam tabel data. Saat jumlah versi untuk kolom atribut melebihi nilai ini, sistem secara otomatis menghapus versi lama. Nilainya harus berupa bilangan bulat bukan nol.
      Max version offset	Selisih maksimum yang diizinkan antara nomor versi data yang ditentukan dan waktu sistem saat ini, dalam satuan detik. Max version offset adalah bilangan bulat positif yang dapat lebih besar dari jumlah detik sejak 00:00:00 UTC pada 1 Januari 1970 hingga waktu saat ini. Data hanya dapat ditulis berhasil jika selisih antara nomor versi semua kolom dan waktu penulisan berada dalam batas max version offset. Rentang versi yang valid untuk kolom atribut adalah [max{Data write time - Max version offset, Data write time - Time to live}, Data write time + Max version offset).
      Reserved read throughput	Hanya instans kinerja tinggi dalam yang mendukung parameter ini. Reserved read atau write throughput untuk tabel data. Nilainya harus berupa bilangan bulat dari 0 hingga 100.000. Satuan: CU. Jika Reserved read throughput atau Reserved write throughput lebih besar dari 0, Tablestore mengalokasikan dan mencadangkan sumber daya yang sesuai untuk tabel data. Setelah tabel data dibuat, penagihan untuk reserved throughput langsung dimulai. Jika Reserved read throughput atau Reserved write throughput bernilai 0, Tablestore tidak mengalokasikan atau mencadangkan sumber daya untuk tabel data.
      Reserved write throughput
      Enable Local Transaction	Transaksi lokal dinonaktifkan secara default. Untuk melakukan operasi baca-tulis atomik pada satu atau beberapa baris, aktifkan sakelar Enable Local Transaction.
      Support Row Versioning	Pengendalian versi baris dinonaktifkan secara default untuk tabel. Untuk menggunakan global tables, aktifkan sakelar Support Row Versioning. Setelah pengendalian versi baris diaktifkan, fitur tersebut tidak dapat dinonaktifkan. Batasan berikut berlaku setelah Anda mengaktifkan pengendalian versi baris: Satu baris dapat memiliki maksimal 256 kolom. Anda tidak dapat menentukan nomor versi secara manual saat menulis data. Sistem secara otomatis menghasilkannya. Saat melakukan operasi Update, sistem harus terlebih dahulu membaca versi baris saat ini, yang menyebabkan sedikit beban baca tambahan.
      Quickly Set Global Table Dependencies	Saat menggunakan global tables, aktifkan sakelar Quickly Set Global Table Dependencies. Sistem secara otomatis memodifikasi konfigurasi untuk global tables. Konfigurasi yang dimodifikasi sebagai berikut: Time to live: -1 Max versions: 1 Max version offset: 2147483647 Support Row Versioning: Diaktifkan

   Konfigurasikan indeks sekunder

   Jika aplikasi perlu menggunakan atribut berbeda sebagai kondisi kueri, Anda dapat menentukan atribut tersebut sebagai kolom kunci primer indeks sekunder untuk mempercepat kueri data. Untuk informasi selengkapnya, lihat Secondary index.

   1. Aktifkan sakelar Create Secondary Index.

   2. Klik Add Predefined Column, masukkan nama untuk kolom pradefinisi, lalu pilih tipe data.

      Nama kolom pradefinisi harus terdiri dari 1 hingga 255 byte, berupa huruf besar, huruf kecil, angka, atau garis bawah (_), serta dimulai dengan huruf atau garis bawah (_).

      Tipe data kolom pradefinisi dapat berupa String, Integer, Binary, Floating-point number, atau Boolean value.

   3. Klik Add Secondary Index, masukkan nama indeks, pilih kunci primer indeks, lalu pilih kolom pradefinisi indeks dan tipe indeks sesuai kebutuhan.

      Penting

      Nama indeks tidak boleh sama dengan nama tabel data. Baik nama indeks maupun nama tabel data harus unik dalam instans tersebut.

      Nama indeks harus terdiri dari 1 hingga 255 byte, berupa huruf besar, huruf kecil, angka, atau garis bawah (_), serta dimulai dengan huruf atau garis bawah (_).

      • Index primary key dapat terdiri dari kunci primer dan kolom pradefinisi tabel data. Anda dapat memilih beberapa kolom. Index predefined columns hanya dapat dipilih dari kolom pradefinisi tabel data. Anda dapat memilih beberapa kolom. Namun, kolom yang Anda pilih sebagai index predefined columns tidak boleh sama dengan kolom yang Anda pilih sebagai index primary keys.

      • Untuk Index type, Anda dapat memilih Global atau Local.

        Penting

        Kolom kunci primer pertama dari indeks sekunder global dapat berupa kolom kunci primer atau kolom pradefinisi apa pun dari tabel data. Kolom kunci primer pertama dari indeks sekunder lokal harus sama dengan kolom kunci primer pertama tabel data.

        Untuk indeks sekunder global, data dari kolom yang diindeks dan kolom kunci primer tabel data disinkronkan secara asinkron ke tabel indeks. Dalam kondisi normal, latensi sinkronisasi berada dalam rentang milidetik. Untuk indeks sekunder lokal, data dari kolom yang diindeks dan kolom kunci primer tabel data disinkronkan secara sinkron ke tabel indeks. Setelah data ditulis ke tabel data, Anda dapat langsung mengkuerinya dari tabel indeks.

5. Klik Create.

Kelola tabel data

Anda dapat melakukan operasi berikut untuk mengelola tabel data.

Integrasi pengembang

Anda dapat menggunakan antarmuka baris perintah (CLI) atau kit pengembangan perangkat lunak (SDK) untuk melakukan operasi tabel.