Tablestore:Operasi tabel data

Catatan penggunaan

• Anda dapat membuat maksimal 64 tabel data dalam satu instans.

• Tabel data tidak langsung tersedia untuk operasi baca dan tulis setelah dibuat. Dalam kebanyakan kasus, Anda dapat mengakses tabel baru sekitar satu menit kemudian.

• Fitur 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, fitur transaksi lokal tidak akan berlaku meskipun diaktifkan.

Fitur

• Buat tabel data

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

  • Informasi skema tabel data mencakup nama tabel, definisi kunci primer, dan konfigurasi kolom pradefinisi.

  • Anda dapat mengonfigurasi tabel data sesuai kebutuhan bisnis. Tabel berikut menjelaskan parameter konfigurasi tersebut.

    Parameter	Deskripsi
    Kolom kunci utama auto-increment	Saat membuat tabel data, Anda dapat menetapkan kolom kunci primer yang bukan kunci partisi sebagai kolom kunci utama auto-increment. Saat menulis data ke tabel, Anda tidak perlu menentukan nilai untuk kolom ini; Tablestore akan menghasilkannya secara otomatis.
    Versi data dan TTL	Anda dapat menggunakan versi data dan fitur time to live (TTL) untuk mengelola data secara efisien, yang membantu mengurangi penggunaan penyimpanan dan menekan biaya penyimpanan.
    Allow updates	Secara default, Anda dapat menulis data ke tabel data dengan memanggil operasi API UpdateRow. Anda dapat mengubah pengaturan ini setelah tabel dibuat. Penting Jika Anda berencana menggunakan fitur time to live (TTL) untuk indeks pencarian, Anda harus melarang penulisan yang menggunakan operasi API UpdateRow.
    Throughput baca/tulis yang dicadangkan	Untuk instans High-performance yang menggunakan , Anda dapat mengonfigurasi throughput baca/tulis yang dicadangkan untuk tabel data sesuai kebutuhan.
    Indeks sekunder	Tablestore menyediakan indeks sekunder lokal dan global untuk memenuhi kebutuhan kueri dengan jaminan konsistensi baca yang berbeda. Anda dapat membuat satu atau beberapa indeks sekunder saat membuat tabel data. Catatan Untuk menggunakan indeks sekunder, Anda harus menetapkan terlebih dahulu satu atau beberapa kolom non-kunci primer beserta tipe datanya dalam tabel data. Kolom-kolom ini dapat digunakan sebagai kolom indeks atau kolom termasuk dalam indeks. Anda dapat menambah atau menghapus kolom pradefinisi setelah tabel dibuat.
    Enkripsi data	Tablestore menyediakan enkripsi data saat diam (data at rest) untuk menjamin keamanan data. Anda dapat mengonfigurasi enkripsi data saat membuat tabel data.
    Transaksi lokal	Setelah mengaktifkan transaksi lokal untuk tabel data, Anda dapat membuat transaksi lokal dalam satu nilai kunci partisi dan melakukan operasi baca/tulis pada data dalam transaksi tersebut. Penting Anda dapat mengaktifkan transaksi lokal untuk tabel data melalui Konsol Tablestore atau Tablestore SDK untuk Java versi 5.11.0 atau lebih baru. Jika Anda tidak mengaktifkan transaksi lokal saat membuat tabel tetapi memerlukannya nanti, kirim tiket untuk mengaktifkannya.

• Perbarui konfigurasi tabel

  Memodifikasi konfigurasi tertentu dari tabel data, seperti time to live (TTL), jumlah versi maksimum, offset versi maksimum, dan pengaturan Stream. Anda juga dapat menyesuaikan throughput baca/tulis yang dicadangkan untuk tabel data dalam instans High-performance yang menggunakan .

• Daftar nama tabel

  Mengambil nama semua tabel data dalam instans saat ini.

• Kueri deskripsi tabel

  Mengkueri informasi tentang tabel data tertentu, seperti skemanya dan detail throughput baca/tulis yang dicadangkan.

• Hapus tabel data

  Menghapus tabel data tertentu.

Buat tabel data

Lakukan langkah-langkah berikut untuk membuat tabel data di Konsol Tablestore.

1. Buka halaman Instance Management.

   1. Login ke Konsol Tablestore.

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

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

2. Di tab Instance Details, klik Create Table.

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

   Parameter	Deskripsi
   Table name	Nama tabel data, yang harus unik dalam satu instans. Nama harus terdiri dari 1 hingga 255 byte dan dapat berisi huruf kapital, huruf kecil, angka, serta garis bawah (_). Nama harus dimulai dengan huruf atau garis bawah (_).
   Primary key	Satu atau beberapa kolom yang secara unik mengidentifikasi baris dalam tabel. Masukkan nama kunci primer, pilih tipe data, lalu klik Add Primary Key Column untuk menambahkan kolom kunci primer lainnya. Anda dapat menentukan hingga empat kolom kunci primer untuk satu tabel. Kolom kunci primer pertama adalah kunci partisi. Anda tidak dapat mengubah konfigurasi atau urutan kolom kunci primer setelah tabel dibuat. Penting Tablestore memungkinkan Anda menetapkan satu kolom kunci primer sebagai kolom kunci utama auto-increment. Satu tabel hanya dapat memiliki satu kolom kunci utama auto-increment, dan kunci partisi tidak boleh menjadi kolom auto-increment. Jika kolom kunci primer ditetapkan sebagai auto-increment, Anda tidak perlu menentukan nilainya saat menulis baris; Tablestore akan menghasilkan nilai unik dan meningkat secara ketat dalam kunci partisi tersebut. Nama kunci primer harus terdiri dari 1 hingga 255 byte dan dapat berisi huruf kapital, huruf kecil, angka, serta garis bawah (_). Nama harus dimulai dengan huruf atau garis bawah (_). Tipe data kunci primer dapat berupa STRING, INTEGER, atau BINARY.
   Allow updates	Menentukan apakah data boleh ditulis dengan memanggil operasi API UpdateRow. Jika parameter ini tidak diatur atau diatur ke Yes, data dapat ditulis dengan memanggil UpdateRow. Untuk menggunakan fitur time to live (TTL) dari indeks pencarian, Anda harus mengatur parameter ini ke No. Hal ini melarang penulisan yang menggunakan operasi API UpdateRow.
   Encryption	Menentukan apakah enkripsi data saat diam diaktifkan. Secara default, fitur ini dinonaktifkan. Untuk mengaktifkannya, nyalakan sakelar Encryption. Penting Enkripsi data saat diam tidak dapat dinonaktifkan setelah diaktifkan. Lakukan dengan hati-hati.
   Encryption type	Jenis enkripsi data. Parameter ini wajib diisi hanya jika Anda menyalakan sakelar Encryption. Nilai yang valid: CMK of KMS: Tablestore BYOK-based Key: Tablestore Penting Sebelum menggunakan opsi BYOK, Anda harus membuat kunci perangkat lunak di Konsol KMS, lalu membuat role kustom dan mengonfigurasi izinnya. Untuk informasi selengkapnya, lihat Enkripsi data.
   Key ID	ID kunci. Parameter ini wajib diisi hanya jika Encryption Type diatur ke BYOK-based Key.
   Role ARN	Nama Sumber Daya Alibaba Cloud (ARN) dari role tersebut. Parameter ini wajib diisi hanya jika Encryption Type diatur ke BYOK-based Key.

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

   Lakukan langkah ini jika Anda perlu mengonfigurasi pengaturan lanjutan untuk tabel data, seperti time to live (TTL), atau membuat indeks sekunder.

   Parameter lanjutan

   Untuk mengelola periode retensi data dalam tabel, tentukan time to live (TTL). Untuk menyimpan beberapa versi data untuk kunci primer yang sama, tentukan jumlah maksimum versi. Untuk informasi selengkapnya, lihat Versi data dan TTL.

   Untuk instans High-performance dalam Mode CU, Anda dapat menentukan throughput baca atau tulis yang dicadangkan untuk tabel data guna mengurangi biaya. Untuk informasi selengkapnya, lihat Throughput baca/tulis yang dicadangkan.

   1. Nyalakan sakelar Advanced Settings.

   2. Konfigurasikan parameter lanjutan seperti yang dijelaskan dalam tabel berikut.

      Parameter	Deskripsi
      Time to live	Periode retensi data, dalam detik. Ketika data melebihi periode ini, sistem secara otomatis menghapus data yang kedaluwarsa. Nilainya harus berupa bilangan bulat yang lebih besar dari atau sama dengan 86400 (satu hari), atau -1. Nilai -1 berarti data tidak pernah kedaluwarsa.
      Max versions	Jumlah maksimum versi yang dapat disimpan untuk setiap kolom atribut. Jika jumlah versi data dalam kolom atribut melebihi nilai ini, sistem secara otomatis menghapus versi lama. Nilainya harus berupa bilangan bulat bukan nol.
      Max version offset	Penyimpangan maksimum yang diizinkan antara versi data yang ditentukan dan waktu sistem saat ini, dalam detik. Nilai ini harus berupa bilangan bulat positif. Operasi tulis berhasil hanya jika versi yang ditentukan untuk setiap kolom berada dalam offset yang diizinkan dari waktu penulisan. Rentang versi yang valid untuk kolom atribut adalah [max{WriteTime - MaxVersionOffset, WriteTime - TTL}, WriteTime + MaxVersionOffset).
      Reserved read throughput	Parameter ini hanya didukung untuk instans High-performance yang menggunakan . Throughput baca atau tulis yang dicadangkan untuk tabel data. Nilainya harus berupa bilangan bulat dari 0 hingga 100.000. Satuannya adalah capacity unit (CU). Jika Anda mengatur Reserved Read Throughput atau Reserved Write Throughput ke nilai lebih dari 0, Tablestore akan mengalokasikan dan mencadangkan sumber daya yang sesuai untuk tabel data. Setelah tabel dibuat, penagihan untuk throughput yang dicadangkan langsung dimulai. Jika Anda mengatur Reserved Read Throughput atau Reserved Write Throughput ke 0, Tablestore tidak akan mengalokasikan atau mencadangkan sumber daya untuk tabel data.
      Reserved write throughput
      Enable local transaction	Fitur transaksi lokal dinonaktifkan secara default. Untuk melakukan operasi baca/tulis atomik pada satu atau beberapa baris dalam partisi yang sama, nyalakan sakelar Enable Local Transaction.
      Enable row version support	Dukungan versi baris dinonaktifkan secara default. Untuk menggunakan global table, Anda harus menyalakan sakelar Enable Row Versioning. Anda tidak dapat menonaktifkan pengaturan ini setelah diaktifkan. Batasan berikut berlaku saat dukungan versi baris diaktifkan: Satu baris dapat memiliki maksimal 256 kolom. Anda tidak dapat menentukan nomor versi secara manual saat menulis data. Nomor versi dihasilkan secara otomatis oleh sistem. Saat melakukan operasi pembaruan, sistem harus terlebih dahulu membaca versi baris saat ini, yang menimbulkan sedikit beban baca tambahan.
      Quick set for global table	Saat menggunakan global table, nyalakan sakelar Quick Set Global Table Dependency. Sistem secara otomatis memodifikasi konfigurasi terkait untuk global table. Perubahan konfigurasi adalah sebagai berikut: Time To Live: -1 Max Versions: 1 Max Version Offset: 2147483647 Enable Row Version Support: Diaktifkan

   Konfigurasikan indeks sekunder

   Saat aplikasi perlu mengkueri data berdasarkan atribut berbeda, Anda dapat menggunakan atribut tersebut sebagai kolom kunci primer indeks sekunder untuk memungkinkan kueri cepat. Untuk informasi selengkapnya, lihat indeks sekunder.

   1. Nyalakan sakelar Create a secondary index.

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

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

      Tipe data untuk kolom pradefinisi dapat berupa STRING, INTEGER, BINARY, FLOAT, atau BOOLEAN.

   3. Klik Add Secondary Index, masukkan nama indeks, pilih kunci primer indeks, dan opsional pilih kolom pradefinisi serta tipe indeks.

      Penting

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

      Nama indeks harus terdiri dari 1 hingga 255 byte dan dapat berisi huruf kapital, huruf kecil, angka, serta garis bawah (_). Nama harus dimulai dengan huruf atau garis bawah (_).

      • Primary Key dapat terdiri dari kolom kunci primer tabel data dan kolom pradefinisi. Anda dapat memilih beberapa kolom. Pre-defined Column hanya dapat dipilih dari kolom pradefinisi tabel data. Anda dapat memilih beberapa kolom, tetapi tidak boleh sama dengan kolom kunci primer indeks mana pun.

      • Index Type dapat berupa Global atau Local.

        Penting

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

        Indeks sekunder global melakukan sinkronisasi asinkron data dari kolom yang diindeks dan kolom kunci primer tabel data ke tabel indeks. Latensi sinkronisasi biasanya dalam kisaran milidetik. Indeks sekunder lokal melakukan sinkronisasi sinkron data dari kolom yang diindeks dan kolom kunci primer tabel data ke tabel indeks. Setelah data ditulis ke tabel data, data tersebut langsung tersedia untuk dikueri dari tabel indeks.

5. Klik Create.

Kelola tabel data

Lakukan operasi berikut untuk mengelola tabel data sesuai kebutuhan.

Pengembangan dan integrasi

Anda dapat menggunakan SDK berikut atau Tablestore CLI untuk melakukan operasi tabel data.