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à.

Usa le istruzioni batch in Amazon Keyspaces

Puoi combinare più INSERT DELETE operazioni e in un'UPDATEunica dichiarazione. BATCH LOGGEDi batch sono l'impostazione predefinita.

batch_statement ::=     BEGIN [ UNLOGGED ] BATCH
                        [ USING update_parameter( AND update_parameter)* ]
                        modification_statement ( ';' modification_statement )*
                        APPLY BATCH
modification_statement ::= insert_statement | update_statement | delete_statement

Quando si esegue un'istruzione batch, il driver combina tutte le istruzioni del batch in un'unica operazione batch.

Per decidere quale tipo di operazione batch utilizzare, è possibile prendere in considerazione le seguenti linee guida.

Per informazioni sulle quote delle dichiarazioni in batch, vedere. Quote per Amazon Keyspaces (per Apache Cassandra)

Batch non registrati

Con i batch non registrati, Amazon Keyspaces elabora più operazioni come un'unica richiesta senza mantenere un registro batch. Con un'operazione batch non registrata, è possibile che alcune azioni abbiano successo mentre altre falliscano. I batch non registrati sono utili quando si desidera:

La sintassi per un batch non registrato è simile a quella di un batch registrato, con l'aggiunta della parola chiave. UNLOGGED

BEGIN UNLOGGED BATCH
    INSERT INTO users (id, firstname, lastname) VALUES (1, 'John', 'Doe');
    INSERT INTO users (id, firstname, lastname) VALUES (2, 'Jane', 'Smith');
APPLY BATCH;

Batch registrati

Un batch registrato combina più azioni di scrittura in un'unica operazione atomica. Quando si esegue un batch registrato:

I batch registrati possono avere latenze leggermente superiori. Per applicazioni ad alto rendimento, prendi in considerazione l'utilizzo di batch non registrati.

Non sono previsti costi aggiuntivi per l'utilizzo di batch registrati in Amazon Keyspaces. Paghi solo per le scritture che fanno parte delle tue operazioni in batch. Amazon Keyspaces esegue due scritture sottostanti per ogni riga del batch: una per preparare la riga per il batch e una per eseguire il commit del batch. Quando pianifichi la capacità per le tabelle che utilizzano batch registrati, ricorda che ogni riga di un batch richiede una capacità doppia rispetto a un'operazione di scrittura standard. Ad esempio, se l'applicazione esegue un batch registrato al secondo con tre righe da 1 KB, è necessario fornire sei unità di capacità di scrittura (WCUs) rispetto alle sole tre WCUs per singole scritture o batch non registrati.

Per informazioni sui prezzi, consulta i prezzi di Amazon Keyspaces (per Apache Cassandra).

Le migliori pratiche per le operazioni in batch

Prendi in considerazione le seguenti pratiche consigliate per l'utilizzo di operazioni batch di Amazon Keyspaces.

Coerenza e concorrenza

Amazon Keyspaces applica le seguenti regole di coerenza e concorrenza per i batch registrati:

Operatori e condizioni supportati

Condizioni di errore delle istruzioni batch registrate

Un'operazione batch registrata può fallire in uno dei seguenti casi:

Istruzioni Batch e replica in più regioni

Nelle distribuzioni in più regioni:

Monitora le operazioni in batch

Puoi monitorare le operazioni in batch utilizzando i CloudWatch parametri di Amazon per tenere traccia di prestazioni, errori e modelli di utilizzo. Amazon Keyspaces fornisce i seguenti CloudWatch parametri per il monitoraggio delle operazioni batch per tabella:

Per ulteriori informazioni, consulta Parametri di Amazon Keyspaces.

Oltre ai CloudWatch parametri, puoi utilizzarli AWS CloudTrail per registrare tutte le azioni dell'API Amazon Keyspaces. Ogni azione API nel batch viene registrata, CloudTrail semplificando il monitoraggio e la verifica delle operazioni batch nelle tabelle Amazon Keyspaces.

Esempi di operazioni in batch

Di seguito è riportato un esempio di istruzione batch di base registrata.

BEGIN BATCH
    INSERT INTO users (id, firstname, lastname) VALUES (1, 'John', 'Doe');
    INSERT INTO users (id, firstname, lastname) VALUES (2, 'Jane', 'Smith');
APPLY BATCH;

Questo è un esempio di batch che include DELETE istruzioni INSERTUPDATE, e.

BEGIN BATCH
    INSERT INTO users (id, firstname, lastname) VALUES (1, 'John', 'Doe');
    UPDATE users SET firstname = 'Johnny' WHERE id = 2;
    DELETE FROM users WHERE id = 3;
APPLY BATCH;

Questo è un esempio di batch che utilizza timestamp lato client.

BEGIN BATCH
    INSERT INTO users (id, firstname, lastname) VALUES (1, 'John', 'Stiles') USING TIMESTAMP 1669069624;
    INSERT INTO users (id, firstname, lastname) VALUES (2, 'Jane', 'Doe') USING TIMESTAMP 1669069624;
APPLY BATCH;

BEGIN BATCH
    UPDATE users USING TIMESTAMP 1669069624 SET firstname = 'Carlos' WHERE id = 1;
    UPDATE users USING TIMESTAMP 1669069624 SET firstname = 'Diego' WHERE id = 2;
APPLY BATCH;

Questo è un esempio di batch condizionale.

BEGIN BATCH
    INSERT INTO users (id, firstname, lastname) VALUES (1, 'Jane', 'Doe') IF NOT EXISTS;
    INSERT INTO users (id, firstname, lastname) VALUES (2, 'John', 'Doe') IF NOT EXISTS;
APPLY BATCH;


BEGIN BATCH
    UPDATE users SET lastname = 'Stiles' WHERE id = 1 IF lastname = 'Doe';
    UPDATE users SET lastname = 'Stiles' WHERE id = 2 IF lastname = 'Doe';
APPLY BATCH;

Questo è un esempio di batch che utilizza Time to Live (TTL).

BEGIN BATCH
    INSERT INTO users (id, firstname, lastname) VALUES (1, 'John', 'Doe') USING TTL 3600;
    INSERT INTO users (id, firstname, lastname) VALUES (2, 'Jane', 'Smith') USING TTL 7200;
APPLY BATCH;

Questo è un esempio di istruzione batch che aggiorna più tabelle.

BEGIN BATCH
    INSERT INTO users (id, firstname) VALUES (1, 'John');
    INSERT INTO user_emails (user_id, email) VALUES (1, 'john@example.com');
APPLY BATCH;

Questo è un esempio di operazione batch che utilizza tipi definiti dall'utente (UDTs). L'esempio presuppone che l'addressUDT esista.

BEGIN BATCH
    INSERT INTO users (id, firstname, address)
    VALUES (1, 'John', {street: '123 Main St', city: 'NYC', zip: '10001'});
    INSERT INTO users (id, firstname, address)
    VALUES (2, 'Jane', {street: '456 Oak Ave', city: 'LA', zip: '90210'});
APPLY BATCH;

BEGIN BATCH
    UPDATE users SET address.zip = '10002' WHERE id = 1;
    UPDATE users SET address.city = 'Boston' WHERE id = 2;
APPLY BATCH;