Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Tabelle

Le tabelle sono le principali strutture di dati in Amazon Keyspaces. I dati in una tabella sono organizzati in righe e colonne. Un sottoinsieme di queste colonne viene utilizzato per determinare il partizionamento (e in ultima analisi il posizionamento dei dati) tramite la specifica di una chiave di partizione.

Un altro set di colonne può essere definito in colonne di clustering, il che significa che possono partecipare come predicati all'esecuzione delle query.

Per impostazione predefinita, vengono create nuove tabelle con capacità di throughput su richiesta. È possibile modificare la modalità di capacità per le tabelle nuove ed esistenti. Per ulteriori informazioni sulle modalità di throughput read/write della capacità, vedereConfigura le modalità di read/write capacità in Amazon Keyspaces.

Per le tabelle in modalità provisioned, è possibile configurare una configurazione opzionale. AUTOSCALING_SETTINGS Per ulteriori informazioni sul ridimensionamento automatico di Amazon Keyspaces e sulle opzioni disponibili, consulta. Configura il ridimensionamento automatico su una tabella esistente

Per informazioni sui limiti e i vincoli di quota per le tabelle Amazon Keyspaces, consulta. Quote per Amazon Keyspaces (per Apache Cassandra)

CREATE TABLE

Usa l'CREATE TABLEistruzione per creare una nuova tabella.

Sintassi

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) )*

Dove:

Esempio

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;

In una tabella che utilizza colonne di clustering, le colonne non raggruppate possono essere dichiarate statiche nella definizione della tabella. Per ulteriori informazioni sulle colonne statiche, vedere. Stima del consumo di capacità per le colonne statiche in Amazon Keyspaces

Esempio

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

È possibile creare una tabella con una colonna che utilizza un tipo definito dall'utente (UDT). La prima istruzione negli esempi crea un tipo, la seconda istruzione crea una tabella con una colonna che utilizza il tipo.

Esempio

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

Usa l'ALTER TABLEistruzione per aggiungere nuove colonne, aggiungere tag o modificare le proprietà personalizzate della tabella.

Sintassi

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
                    
                

Dove:

Esempi

L'istruzione seguente mostra come aggiungere una colonna a una tabella esistente.

ALTER TABLE mykeyspace.mytable ADD (ID int);

Questa dichiarazione mostra come aggiungere due colonne di raccolta a una tabella esistente:

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

L'esempio seguente mostra come aggiungere una colonna che utilizza un tipo definito dall'utente (UDT) a una tabella.

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

Per modificare la modalità di capacità di una tabella e specificare le unità di capacità di lettura e scrittura, è possibile utilizzare la seguente dichiarazione.

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

La seguente dichiarazione specifica una chiave KMS gestita dal cliente per la tabella.

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'     
                  } 
         };

Per abilitare il ripristino point-in-time per una tabella, è possibile utilizzare la seguente dichiarazione.

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

Per impostare un valore predefinito di Time to Live in secondi per una tabella, puoi utilizzare la seguente istruzione.

ALTER TABLE my_table WITH default_time_to_live = 2592000;

Questa istruzione abilita impostazioni Time to Live personalizzate per una tabella.

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

RIPRISTINARE LA TABELLA

Usa l'RESTORE TABLEistruzione per ripristinare una tabella in un determinato momento. Questa dichiarazione richiede che il ripristino point-in-time sia abilitato su una tabella. Per ulteriori informazioni, consulta Backup e ripristino dei dati con ripristino point-in-time per Amazon Keyspaces.

Sintassi

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

Dove:

Esempio

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'};

DROP TABLE

Usa l'DROP TABLEistruzione per rimuovere una tabella dal keyspace.

Sintassi

drop_table_statement ::=  
    DROP TABLE [ IF EXISTS ] table_name

Dove:

Esempio

DROP TABLE my_keyspace.my_table;