View a markdown version of this page

Semantica delle transazioni - Amazon Redshift

Amazon Redshift non supporterà più l'uso delle UDF Python dopo il 30 giugno 2026. Inizieremo ad applicarlo gradualmente. Per ulteriori informazioni sui dettagli della fine del ciclo di vita e sulle opzioni di migrazione di Python, consulta la post sul blog che è stato pubblicato il 30 giugno 2025.

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

Semantica delle transazioni

Le query di scrittura di Amazon Redshift Iceberg supportano le transazioni ACID. Le transazioni di scrittura sono atomiche: quando una query o una transazione fallisce, Amazon Redshift non pubblica un aggiornamento parziale della tabella.

Per impostazione predefinita, ogni query di scrittura Iceberg viene eseguita come transazione di commit automatico e Amazon Redshift pubblica le modifiche come un'istantanea di Iceberg al termine della query. Puoi anche raggruppare più istruzioni DML (Data Manipulation Language) che scrivono su una tabella Iceberg in una transazione con più istruzioni. Amazon Redshift pubblica quindi tutte le modifiche della transazione come un'istantanea Iceberg al momento del commit della transazione.

L'esempio seguente crea una tabella con una singola dichiarazione di commit automatico:

CREATE TABLE sales_schema.orders ( order_id int, customer_id int, order_date date, total_amount decimal(10,2) ) USING ICEBERG LOCATION 's3://my-data-lake/sales/orders/';

Multi-statement transazioni

È possibile eseguire una transazione con più dichiarazioni in uno dei seguenti modi:

  • Un blocco di transazione esplicito che inizia con BEGIN o START TRANSACTION e termina con COMMIT o END. Per annullare le modifiche alla transazione, termina il blocco con ROLLBACK o ABORT.

  • Una singola stringa di interrogazione che contiene più istruzioni separate da punto e virgola.

  • Una connessione JDBC con autoCommit impostato su false. L'autista avvia una transazione prima della prima dichiarazione e la transazione termina quando l'applicazione chiama commit() o rollback().

L'esempio seguente applica un batch notturno di modifiche al punto vendita (POS) a un sales tabella. La MERGE la dichiarazione aggiunge nuove vendite e corregge quelle esistenti a partire da pos_sales Tavolo da palco Iceberg. Il DELETE la dichiarazione rimuove le vendite annullate elencate nel pos_voids Tavolo da palco Iceberg. Il SELECT l'estratto conto controlla il totale del giorno prima del completamento della transazione.

BEGIN; -- Add new sales and correct existing ones MERGE INTO iceberg_schema.sales USING iceberg_schema.pos_sales p ON sales.sale_id = p.sale_id WHEN MATCHED THEN UPDATE SET amount = p.amount WHEN NOT MATCHED THEN INSERT VALUES (p.sale_id, p.store_id, p.sale_date, p.amount); -- Remove voided sales DELETE FROM iceberg_schema.sales WHERE sale_id IN (SELECT sale_id FROM iceberg_schema.pos_voids); -- Check the day's total, which includes both changes SELECT sum(amount) FROM iceberg_schema.sales WHERE sale_date = '2026-10-06'; -- COMMIT if the total is correct; otherwise ROLLBACK COMMIT;

Il SELECT la dichiarazione vede le modifiche rispetto al MERGE e DELETE dichiarazioni, perché le letture della tabella scritta da una transazione includono le modifiche non salvate della transazione. Le altre sessioni e gli altri motori non vedono alcuna modifica fino a COMMIT. Vedono la tabella com'era prima o dopo il lotto, ma mai nel mezzo.

Se una delle dichiarazioni della transazione non va a buon fine o se si termina la transazione con ROLLBACK, Amazon Redshift non pubblica alcuna modifica della transazione. L'esempio seguente inserisce un ordine, lo aggiorna e quindi annulla entrambe le modifiche:

BEGIN; INSERT INTO "analytics-bucket@s3tablescatalog".sales_db.orders VALUES (12346, 5432, '2026-10-06', 150.75); UPDATE "analytics-bucket@s3tablescatalog".sales_db.orders SET total_amount = 160.75 WHERE order_id = 12346; ROLLBACK; -- discards both the INSERT and the UPDATE

Dichiarazioni consentite in una transazione con più dichiarazioni

Una transazione che scrive su una tabella Iceberg può leggere da qualsiasi tabella, ma può scrivere solo su quella tabella Iceberg. La tabella seguente mostra quali istruzioni è possibile eseguire in una transazione che contiene una scrittura Iceberg.

Dichiarazione Comportamento
SELECT da qualsiasi tabella, incluse le tabelle Iceberg, le tabelle RMS (Redshift managed storage) e altre tabelle esterne, in qualsiasi database Consentito
INSERT, UPDATE, DELETE, e MERGE su un tavolo Iceberg Consentito Pubblicato come istantanea su COMMIT.
REFRESH MATERIALIZED VIEW su una visione materializzata di Iceberg Consentito. La vista materializzata è l'obiettivo di scrittura della transazione.
Una scrittura su una seconda tabella Iceberg Non consentito
Qualsiasi altra scrittura, prima o dopo la scrittura di Iceberg, come DML su una tabella RMS o una tabella temporanea, COPY, UNLOAD, GRANT, REVOKE, ANALYZE, o DDL Non consentito
Iceberg DDL: CREATE TABLE, CREATE TABLE AS, ALTER TABLE, CREATE MATERIALIZED VIEW, DROP TABLE, e DROP MATERIALIZED VIEW Non consentito

Quando esegui un'istruzione non consentita, l'istruzione ha esito negativo e Amazon Redshift interrompe la transazione. Nessuna delle modifiche apportate in precedenza nella transazione viene pubblicata. Nel seguente esempio, il secondo DELETE l'istruzione ha esito negativo perché scrive su una seconda tabella Iceberg:

BEGIN; DELETE FROM iceberg_schema.sales WHERE sale_id IN (SELECT sale_id FROM iceberg_schema.pos_voids); DELETE FROM iceberg_schema.pos_voids; -- fails: a second Iceberg table COMMIT; -- rolls back

Per scrivere su un'altra tabella, esegui quella scrittura nella relativa transazione, prima o dopo la transazione Iceberg. Esegui le istruzioni DDL di Iceberg, ad esempio CREATE TABLE e ALTER TABLE, come dichiarazioni autonome esterne a un blocco di transazioni. Se il client disattiva l'autocommit, attivalo prima di eseguire le dichiarazioni DDL di Iceberg.

Fare riferimento alla tabella in una transazione

Amazon Redshift identifica una tabella Iceberg in una transazione con il nome utilizzato per farvi riferimento. Usa lo stesso nome per la tabella per tutta la transazione. Se si fa riferimento a una tabella tramite due nomi, ad esempio tramite due schemi esterni, o tramite uno schema esterno e awsdatacatalog catalogo, Amazon Redshift considera i due nomi come due tabelle diverse. La scrittura del secondo nome ha esito negativo e la lettura del secondo nome non include le modifiche non salvate della transazione. Per ulteriori informazioni, vedere Riferimento alle tabelle Iceberg in Amazon Redshift.

Garanzie di isolamento

Una transazione sui tavoli Iceberg offre le seguenti garanzie:

  • Pubblicazione atomica: Le altre sessioni e i motori non vedono alcuna modifica di una transazione fino a COMMIT, per poi visualizzarle tutte in un'unica istantanea.

  • Leggi i tuoi scritti: le letture della tabella Iceberg scritte da una transazione includono le modifiche non salvate della transazione, a condizione che la transazione utilizzi lo stesso nome per la tabella.

  • Letture ripetibili: la prima istruzione che legge o scrive una tabella Iceberg in una transazione corregge la versione di quella tabella per il resto della transazione. Le letture successive della tabella nella stessa transazione non vedono le modifiche apportate nel frattempo da altre sessioni.

Amazon Redshift corregge la versione di ogni tabella Iceberg quando la transazione legge o scrive quella tabella per la prima volta, non quando inizia la transazione. Se una transazione accede per la prima volta a una tabella Iceberg più avanti nella transazione, tale lettura può includere modifiche apportate da altre sessioni dopo l'inizio della transazione.

Le letture delle tabelle RMS nella stessa transazione utilizzano lo snapshot della transazione Amazon Redshift, quindi potrebbero non riflettere lo stesso momento in cui sono state lette le tabelle Iceberg. Per ulteriori informazioni, consulta Livelli di isolamento in Amazon Redshift.

File provenienti da transazioni che non vengono salvate

Durante l'esecuzione di ogni istruzione in una transazione con più istruzioni, Amazon Redshift scrive i file di dati e i file di metadati intermedi nella posizione della tabella. Se la transazione non viene completata, nessuna istantanea fa riferimento a questi file e questi diventano file orfani. Per rimuoverli, imposta la rimozione dei file orfani per la tabella. Per ulteriori informazioni, consulta Best practice.

Risoluzione dei problemi relativi alle transazioni con più dichiarazioni

Se una dichiarazione in una transazione con più dichiarazioni fallisce, Amazon Redshift interrompe la transazione e non pubblica nessuna delle modifiche. Di seguito sono riportati gli errori più comuni e come risolverli:

  • Only a single Iceberg table can be written to in a multi-statement transaction involving Iceberg writes o Cannot write to a different database after an Iceberg write to a data lake catalog in the same transaction. — La transazione scrive su più di una tabella. Esegue ogni scrittura su un'altra tabella nella relativa transazione. Se fai riferimento alla stessa tabella Iceberg tramite due nomi, ad esempio due schemi esterni, utilizza un nome in tutta la transazione.

  • Iceberg DDL is not allowed in multi-statement transaction — Esegui le istruzioni DDL di Iceberg come istruzioni autonome all'esterno di un blocco di transazioni.

  • current transaction is aborted, commands ignored until end of transaction block — Un'istruzione precedente nella transazione non è riuscita, quindi la transazione non può essere confermata. Esegui ROLLBACK per terminare la transazione.

Risoluzione di conflitti di scrittura simultanei

Più sessioni e motori possono scrivere contemporaneamente sulla stessa tabella Iceberg. Se un altro autore esegue il commit sulla tabella mentre la scrittura è in corso e i due set di modifiche non si sovrappongono, Amazon Redshift può ribasare le modifiche sulla versione più recente della tabella e confermarle senza eseguire nuovamente la scrittura. Se Amazon Redshift non è in grado di ribasare le modifiche, ad esempio perché entrambe le scritture hanno modificato gli stessi dati, il commit ha esito negativo. Quando ciò accade, esegui nuovamente la scrittura. Per ulteriori informazioni, vedere Risoluzione dei conflitti di scrittura simultanei per le tabelle Apache Iceberg in Amazon Redshift.

Nota

Le istruzioni di scrittura Iceberg non possono essere eseguite all'interno di una stored procedure.