Bekerja dengan keyspaces di Amazon Keyspaces

Bagian ini memberikan rincian tentang bekerja dengan keyspaces di Amazon Keyspaces (untuk Apache Cassandra).

Bekerja dengan ruang kunci sistem di Amazon Keyspaces

Amazon Keyspaces menggunakan empat ruang kunci sistem:

• system

• system_schema

• system_schema_mcs

• system_multiregion_info

Bagian berikut memberikan rincian tentang ruang kunci sistem dan tabel sistem yang didukung di Amazon Keyspaces.

system

Ini adalah ruang kunci Cassandra. Amazon Keyspaces menggunakan tabel berikut.

Nama tabel	Nama kolom	Komentar
local	key, bootstrapped, broadcast_address, cluster_name, cql_version, data_center, gossip_generation, host_id, listen_address, native_protocol_version, partitioner, rack, release_version, rpc_address, schema_version, thrift_version, tokens, truncated_at	Informasi tentang keyspace lokal.
peers	peer, data_center, host_id, preferred_ip, rack, release_version, rpc_address, schema_version, tokens	Kueri tabel ini untuk melihat titik akhir yang tersedia. Misalnya, jika Anda terhubung melalui titik akhir publik, Anda melihat daftar sembilan alamat IP yang tersedia. Jika Anda terhubung melalui titik akhir FIPS, Anda melihat daftar tiga alamat IP. Jika Anda terhubung melalui titik akhir AWS PrivateLink VPC, Anda melihat daftar alamat IP yang telah Anda konfigurasi. Untuk informasi selengkapnya, lihat Mengisi entri system.peers tabel dengan informasi titik akhir VPC antarmuka.
size_estimates	keyspace_name, table_name, range_start, range_end, mean_partition_size, partitions_count	Tabel ini mendefinisikan ukuran total dan jumlah partisi untuk setiap rentang token untuk setiap tabel. Ini diperlukan untuk Apache Cassandra Spark Connector, yang menggunakan perkiraan ukuran partisi untuk mendistribusikan pekerjaan.
prepared_statements	prepared_id, logged_keyspace, query_string	Tabel ini berisi informasi tentang kueri yang disimpan.

system_schema

Ini adalah ruang kunci Cassandra. Amazon Keyspaces menggunakan tabel berikut.

Nama tabel	Nama kolom	Komentar
keyspaces	keyspace_name, durable_writes, replication	Informasi tentang keyspace tertentu.
tables	keyspace_name, table_name, bloom_filter_fp_chance, caching, comment, compaction, compression, crc_check_chance, dclocal_read_repair_chance, default_time_to_live, extensions, flags, gc_grace_seconds, id, max_index_interval, memtable_flush_period_in_ms, min_index_interval, read_repair_chance, speculative_retry	Informasi tentang tabel tertentu.
columns	keyspace_name, table_name, column_name, clustering_order, column_name_bytes, kind, position, type	Informasi tentang kolom tertentu.

system_schema_mcs

Ini adalah ruang kunci Amazon Keyspaces yang menyimpan informasi tentang atau AWS setelan khusus Amazon Keyspaces.

Nama tabel	Nama kolom	Komentar
keyspaces	keyspace_name, durable_writes, replication	Kueri tabel ini untuk mengetahui secara terprogram apakah ruang kunci telah dibuat. Untuk informasi selengkapnya, lihat Membuat ruang kunci di Amazon Keyspaces.
tables	keyspace_name, creation_time, speculative_retry, cdc, gc_grace_seconds, crc_check_chance, min_index_interval, bloom_filter_fp_chance, flags, custom_properties, dclocal_read_repair_chance, table_name, caching, default_time_to_live, read_repair_chance, max_index_interval, extensions, compaction, comment, id, compression, memtable_flush_period_in_ms, status	Kueri tabel ini untuk mengetahui status tabel tertentu. Untuk informasi selengkapnya, lihat Membuat tabel di Amazon Keyspaces. Anda juga dapat menanyakan tabel ini untuk mencantumkan pengaturan yang khusus untuk Amazon Keyspaces dan disimpan sebagai. custom_properties Sebagai contoh: capacity_mode client_side_timestamps encryption_specification point_in_time_recovery ttl
tables_history	keyspace_name, table_name, event_time, creation_time, custom_properties, event	Kueri tabel ini untuk mempelajari tentang perubahan skema untuk tabel tertentu.
columns	keyspace_name, table_name, column_name, clustering_order, column_name_bytes, kind, position, type	Tabel ini identik dengan tabel Cassandra di keyspace. system_schema
tags	resource_id, keyspace_name, resource_name, resource_type, tags	Kueri tabel ini untuk mengetahui apakah ruang kunci memiliki tag. Untuk informasi selengkapnya, lihat Menambahkan tag ke ruang dan tabel baru atau yang sudah ada menggunakan CQL.
autoscaling	keyspace_name, table_name, provisioned_read_capacity_autoscaling_update, provisioned_write_capacity_autoscaling_update	Kueri tabel ini untuk mendapatkan pengaturan penskalaan otomatis dari tabel yang disediakan. Perhatikan bahwa pengaturan ini tidak akan tersedia sampai tabel aktif. Untuk menanyakan tabel ini, Anda harus menentukan keyspace_name dan table_name dalam WHERE klausa. Untuk informasi selengkapnya, lihat Mengelola penskalaan otomatis Amazon Keyspaces dengan Cassandra Query Language (CQL).

system_multiregion_info

Ini adalah ruang kunci Amazon Keyspaces yang menyimpan informasi tentang Replikasi Multi-Wilayah.

Nama tabel	Nama kolom	Komentar
tables	keyspace_name, table_name, region, status	Tabel ini berisi informasi tentang tabel Multi-wilayah—misalnya, tabel Wilayah AWS yang direplikasi dan status tabel. Anda juga dapat menanyakan tabel ini untuk mencantumkan pengaturan yang khusus untuk Amazon Keyspaces yang disimpan sebagai. custom_properties Sebagai contoh: capacity_mode Untuk menanyakan tabel ini, Anda harus menentukan keyspace_name dan table_name dalam WHERE klausa. Untuk informasi selengkapnya, lihat Membuat ruang kunci Multi-wilayah (CQL).
autoscaling	keyspace_name, table_name, provisioned_read_capacity_autoscaling_update, provisioned_write_capacity_autoscaling_update, region	Kueri tabel ini untuk mendapatkan pengaturan penskalaan otomatis dari tabel yang disediakan Multi-wilayah. Perhatikan bahwa pengaturan ini tidak akan tersedia sampai tabel aktif. Untuk menanyakan tabel ini, Anda harus menentukan keyspace_name dan table_name dalam WHERE klausa. Untuk informasi selengkapnya, lihat Menggunakan CQL untuk membuat dan mengelola tabel Multi-region.

Membuat ruang kunci di Amazon Keyspaces

Amazon Keyspaces melakukan operasi data definition language (DDL), seperti membuat dan menghapus keyspaces, secara asinkron.

Anda dapat memantau status pembuatan ruang kunci baru di AWS Management Console, yang menunjukkan kapan ruang kunci tertunda atau aktif. Anda juga dapat memantau status pembuatan keyspace baru secara terprogram dengan menggunakan keyspace. system_schema_mcs Sebuah keyspace menjadi terlihat dalam system_schema_mcs keyspaces tabel ketika sudah siap untuk digunakan.

Pola desain yang disarankan untuk memeriksa kapan ruang kunci baru siap digunakan adalah dengan melakukan polling tabel Amazon system_schema_mcs keyspaces Keyspaces (system_schema_mcs.*). Untuk daftar pernyataan DDL untuk ruang kunci, lihat Keyspaces bagian dalam referensi bahasa CQL.

Kueri berikut menunjukkan apakah keyspace telah berhasil dibuat.

SELECT * FROM system_schema_mcs.keyspaces WHERE keyspace_name = 'mykeyspace';

Untuk keyspace yang telah berhasil dibuat, output dari query terlihat seperti berikut.

keyspace_name | durable_writes  | replication
--------------+-----------------+--------------
   mykeyspace | true            |{...} 1 item