Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tabel

Tabel adalah struktur data utama di Amazon Keyspaces. Data dalam tabel diatur ke dalam baris dan kolom. Subset kolom tersebut digunakan untuk menentukan partisi (dan akhirnya penempatan data) melalui spesifikasi kunci partisi.

Kumpulan kolom lain dapat didefinisikan menjadi kolom pengelompokan, yang berarti bahwa mereka dapat berpartisipasi sebagai predikat dalam eksekusi kueri.

Secara default, tabel baru dibuat dengan kapasitas throughput sesuai permintaan. Anda dapat mengubah mode kapasitas untuk tabel baru dan yang sudah ada. Untuk informasi selengkapnya tentang mode throughput read/write kapasitas, lihatKonfigurasikan mode read/write kapasitas di Amazon Keyspaces.

Untuk tabel dalam mode disediakan, Anda dapat mengonfigurasi opsionalAUTOSCALING_SETTINGS. Untuk informasi selengkapnya tentang penskalaan otomatis Amazon Keyspaces dan opsi yang tersedia, lihatKonfigurasikan penskalaan otomatis pada tabel yang ada.

Untuk informasi tentang batas kuota dan batasan untuk tabel Amazon Keyspaces, lihatKuota untuk Amazon Keyspaces (untuk Apache Cassandra).

CREATE TABLE

Gunakan CREATE TABLE pernyataan untuk membuat tabel baru.

Sintaksis

create_table_statement ::=  CREATE TABLE [ IF NOT EXISTS ] table_name
    '('
        column_definition 
        ( ',' column_definition )*
        [ ',' PRIMARY KEY '(' primary_key ')' ]
    ')' [ WITH table_options ]

column_definition      ::=  column_name cql_type [ FROZEN ][ STATIC ][ PRIMARY KEY]

primary_key            ::=  partition_key [ ',' clustering_columns ]

partition_key          ::=  column_name
                              | '(' column_name ( ',' column_name )* ')'

clustering_columns     ::=  column_name ( ',' column_name )*

table_options          ::=  [table_options]
                              | CLUSTERING ORDER BY '(' clustering_order ')' [ AND table_options ]
                              | cdc
                              | CUSTOM_PROPERTIES
                              | AUTOSCALING_SETTINGS
                              | default_time_to_live
                              | TAGS

clustering_order       ::=  column_name (ASC | DESC) ( ',' column_name (ASC | DESC) )*

Di mana:

Contoh

CREATE TABLE IF NOT EXISTS my_keyspace.my_table (
                                            id text,
                                            name text,
                                            region text,
                                            division text,
                                            project text,
                                            role text,
                                            pay_scale int,
                                            vacation_hrs float,
                                            manager_id text,
                                            PRIMARY KEY (id,division))
                                            WITH CUSTOM_PROPERTIES={
                                                'capacity_mode':{
                                                        'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20
                                                    },
                                                'point_in_time_recovery':{'status': 'enabled'},
                                                'encryption_specification':{
                                                        'encryption_type': 'CUSTOMER_MANAGED_KMS_KEY', 
                                                        'kms_key_identifier':'arn:aws:kms:eu-west-1:5555555555555:key/11111111-1111-111-1111-111111111111'
                                                    }
                                            }
                                            AND CLUSTERING ORDER BY (division ASC) 
                                            AND TAGS={'key1':'val1', 'key2':'val2'}
                                            AND default_time_to_live = 3024000;

Dalam tabel yang menggunakan kolom pengelompokan, kolom non-clustering dapat dinyatakan sebagai statis dalam definisi tabel. Untuk informasi selengkapnya tentang kolom statis, lihatPerkirakan konsumsi kapasitas untuk kolom statis di Amazon Keyspaces.

Contoh

CREATE TABLE my_keyspace.my_table (
                                            id int,
                                            name text,
                                            region text,
                                            division text,
                                            project text STATIC,
                                            PRIMARY KEY (id,division));

Anda dapat membuat tabel dengan kolom yang menggunakan tipe yang ditentukan pengguna (UDT). Pernyataan pertama dalam contoh membuat tipe, pernyataan kedua membuat tabel dengan kolom yang menggunakan tipe.

Contoh

CREATE TYPE my_keyspace."udt""N@ME" (my_field int);
CREATE TABLE my_keyspace.my_table (my_col1 int pri key, my_col2 "udt""N@ME");

ALTER TABLE

Gunakan ALTER TABLE pernyataan untuk menambahkan kolom baru, menambahkan tag, atau mengubah properti kustom tabel.

Sintaksis

alter_table_statement ::=  ALTER TABLE table_name    
 
        [ ADD ( column_definition | column_definition_list)  ] 
        [[ADD | DROP] TAGS {'key1':'val1', 'key2':'val2'}]            
        [ WITH table_options [ , ... ] ] ;
        
column_definition      ::=  column_name cql_type
                    
                

Di mana:

Contoh

Pernyataan berikut menunjukkan cara menambahkan kolom ke tabel yang ada.

ALTER TABLE mykeyspace.mytable ADD (ID int);

Pernyataan ini menunjukkan cara menambahkan dua kolom koleksi ke tabel yang ada:

ALTER TABLE my_Table ADD(col_frozen_list FROZEN<LIST<FROZEN<SET<TEXT>>>>, col_map MAP<INT, FROZEN<SET<INT>>>);

Contoh berikut menunjukkan cara menambahkan kolom yang menggunakan tipe yang ditentukan pengguna (UDT) ke tabel.

ALTER TABLE my_keyspace.my_table ADD (my_column, my_udt;);

Untuk mengubah mode kapasitas tabel dan menentukan unit kapasitas baca dan tulis, Anda dapat menggunakan pernyataan berikut.

ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={'capacity_mode':{'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20}};

Pernyataan berikut menentukan kunci KMS yang dikelola pelanggan untuk tabel.

ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={     
              'encryption_specification':{ 
                      'encryption_type': 'CUSTOMER_MANAGED_KMS_KEY', 
                      'kms_key_identifier':'arn:aws:kms:eu-west-1:5555555555555:key/11111111-1111-111-1111-111111111111'     
                  } 
         };

Untuk mengaktifkan pemulihan point-in-time untuk tabel, Anda dapat menggunakan pernyataan berikut.

ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={'point_in_time_recovery': {'status': 'enabled'}};

Untuk mengatur nilai Time to Live default dalam detik untuk tabel, Anda dapat menggunakan pernyataan berikut.

ALTER TABLE my_table WITH default_time_to_live = 2592000;

Pernyataan ini mengaktifkan pengaturan Time to Live kustom untuk tabel.

ALTER TABLE mytable WITH CUSTOM_PROPERTIES={'ttl':{'status': 'enabled'}};

MENGEMBALIKAN TABEL

Gunakan RESTORE TABLE pernyataan untuk mengembalikan tabel ke suatu titik waktu. Pernyataan ini memerlukan pemulihan point-in-time untuk diaktifkan pada tabel. Untuk informasi selengkapnya, lihat Cadangkan dan pulihkan data dengan pemulihan point-in-time untuk Amazon Keyspaces.

Sintaksis

restore_table_statement ::=  
    RESTORE TABLE restored_table_name FROM TABLE source_table_name 
                    [ WITH table_options [ , ... ] ];

Di mana:

Contoh

RESTORE TABLE mykeyspace.mytable_restored from table mykeyspace.my_table 
WITH restore_timestamp = '2020-06-30T04:05:00+0000'
AND custom_properties = {'point_in_time_recovery':{'status':'disabled'}, 'capacity_mode':{'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20}}
AND TAGS={'key1':'val1', 'key2':'val2'};

MEJA DROP

Gunakan DROP TABLE pernyataan untuk menghapus tabel dari ruang tombol.

Sintaksis

drop_table_statement ::=  
    DROP TABLE [ IF EXISTS ] table_name

Di mana:

Contoh

DROP TABLE my_keyspace.my_table;