View a markdown version of this page

Sémantique des transactions - Amazon Redshift

Amazon Redshift ne prendra plus en charge l'utilisation des UDF Python après le 30 juin 2026. Nous allons commencer à l'appliquer par étapes. Pour plus d'informations sur les détails de la fin de vie et des options de migration de Python, consultez le billet de blog qui a été publié le 30 juin 2025.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Sémantique des transactions

Les requêtes d'écriture Amazon Redshift Iceberg prennent en charge les transactions ACID. Les transactions d'écriture sont atomiques : lorsqu'une requête ou une transaction échoue, Amazon Redshift ne publie pas de mise à jour partielle de la table.

Par défaut, chaque requête d'écriture Iceberg s'exécute comme sa propre transaction de validation automatique, et Amazon Redshift publie ses modifications sous la forme d'un instantané Iceberg une fois la requête terminée. Vous pouvez également regrouper plusieurs instructions en langage de manipulation de données (DML) qui écrivent dans une table Iceberg dans une transaction à instructions multiples. Amazon Redshift publie ensuite toutes les modifications apportées à la transaction sous la forme d'un instantané Iceberg une fois la transaction validée.

L'exemple suivant crée une table avec une seule instruction de validation automatique :

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 transactions

Vous pouvez exécuter une transaction à relevés multiples de l'une des manières suivantes :

  • Un bloc de transaction explicite qui commence par BEGIN ou START TRANSACTION et se termine par COMMIT ou END. Pour annuler les modifications apportées à la transaction, terminez le bloc avec ROLLBACK ou ABORT.

  • Chaîne de requête unique contenant plusieurs instructions séparées par des points-virgules.

  • Une connexion JDBC avec autoCommit réglé sur false. Le chauffeur commence une transaction avant votre premier relevé, et la transaction se termine lorsque votre application appelle commit() ou rollback().

L'exemple suivant applique un lot nocturne de modifications au point de vente (POS) à un sales table. Le MERGE la déclaration ajoute de nouvelles ventes et corrige celles qui existent déjà depuis le pos_sales Table de scène Iceberg. Le DELETE la déclaration supprime les ventes annulées répertoriées dans pos_voids Table de scène Iceberg. Le SELECT Un relevé vérifie le total de la journée avant la validation de la transaction.

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;

Le SELECT la déclaration voit les modifications par rapport à MERGE et DELETE instructions, car les lectures de la table écrite par une transaction incluent les modifications non validées de la transaction. Les autres sessions et les autres moteurs ne voient aucune modification avant COMMIT. Ils voient le tableau tel qu'il était avant ou après le lot, mais jamais entre les deux.

Si l'un des relevés de la transaction échoue, ou si vous terminez la transaction avec ROLLBACK, Amazon Redshift ne publie aucune des modifications apportées à la transaction. L'exemple suivant insère une commande, la met à jour, puis annule les deux modifications :

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

Relevés autorisés dans le cadre d'une transaction comportant plusieurs relevés

Une transaction qui écrit dans une table Iceberg peut lire à partir de n'importe quelle table, mais elle ne peut écrire que dans cette table Iceberg. Le tableau suivant indique les instructions que vous pouvez exécuter dans une transaction contenant une écriture Iceberg.

Instruction Comportement
SELECT à partir de n'importe quelle table, y compris les tables Iceberg, les tables de stockage géré Redshift (RMS) et d'autres tables externes, dans n'importe quelle base de données Autorisé
INSERT, UPDATE, DELETE, et MERGE sur une table Iceberg Autorisé. Publié en un clin d'œil sur COMMIT.
REFRESH MATERIALIZED VIEW sur une vue matérialisée d'Iceberg Autorisé. La vue matérialisée est la cible d'écriture de la transaction.
Une écriture sur une deuxième table Iceberg Non autorisée
Toute autre écriture, avant ou après l'écriture Iceberg, telle que DML sur une table RMS ou une table temporaire, COPY, UNLOAD, GRANT, REVOKE, ANALYZE, ou DDL Non autorisée
Iceberg DDL : CREATE TABLE, CREATE TABLE AS, ALTER TABLE, CREATE MATERIALIZED VIEW, DROP TABLE, et DROP MATERIALIZED VIEW Non autorisée

Lorsque vous exécutez une instruction qui n'est pas autorisée, l'instruction échoue et Amazon Redshift interrompt la transaction. Aucune des modifications apportées plus tôt dans la transaction n'est publiée. Dans l'exemple suivant, le deuxième DELETE L'instruction échoue car elle écrit dans une deuxième table 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

Pour écrire dans une autre table, exécutez cette écriture dans sa propre transaction, avant ou après la transaction Iceberg. Exécutez des instructions Iceberg DDL, telles que CREATE TABLE et ALTER TABLE, sous forme d'instructions autonomes en dehors d'un bloc de transactions. Si votre client désactive la validation automatique, activez-la avant d'exécuter des instructions Iceberg DDL.

Référencement du tableau dans une transaction

Amazon Redshift identifie une table Iceberg dans une transaction par le nom que vous utilisez pour la référencer. Utilisez le même nom pour la table tout au long de la transaction. Si vous faites référence à une table par deux noms, par exemple via deux schémas externes, ou via un schéma externe et que awsdatacatalog catalogue, Amazon Redshift traite les deux noms comme deux tableaux différents. L'écriture du second nom échoue et la lecture du second nom n'inclut pas les modifications non validées de la transaction. Pour plus d'informations, voir Référencement de tables Iceberg dans Amazon Redshift.

Garanties d'isolation

Une transaction sur les tables Iceberg vous donne les garanties suivantes :

  • Publication atomique: les autres sessions et moteurs ne voient aucune modification d'une transaction avant COMMIT, puis visualisez-les tous en un seul cliché.

  • Lisez vos propres écrits: les lectures de la table Iceberg qu'une transaction écrit incluent les modifications non validées de la transaction, à condition que la transaction utilise le même nom pour la table.

  • Lectures répétables: La première instruction qui lit ou écrit une table Iceberg dans une transaction fixe la version de cette table pour le reste de la transaction. Les lectures ultérieures de la table dans la même transaction ne permettent pas de voir les modifications que les autres sessions ont validées entre-temps.

Amazon Redshift corrige la version de chaque table Iceberg lorsque la transaction lit ou écrit cette table pour la première fois, et non au début de la transaction. Si une transaction accède pour la première fois à une table Iceberg plus tard dans la transaction, cette lecture peut inclure des modifications que d'autres sessions ont validées après le début de la transaction.

Les lectures de tables RMS dans une même transaction utilisent l'instantané de transaction Amazon Redshift, de sorte qu'elles peuvent ne pas refléter le même moment que les lectures de tables Iceberg. Pour plus d'informations, voir Niveaux d'isolation dans Amazon Redshift.

Fichiers provenant de transactions qui ne sont pas validées

Lors de l'exécution de chaque instruction d'une transaction comportant plusieurs déclarations, Amazon Redshift écrit des fichiers de données et des fichiers de métadonnées intermédiaires à l'emplacement de la table. Si la transaction n'est pas validée, aucun instantané ne fait référence à ces fichiers et ceux-ci deviennent des fichiers orphelins. Pour les supprimer, configurez la suppression des fichiers orphelins pour la table. Pour plus d’informations, consultez Bonnes pratiques.

Résolution des problèmes liés aux transactions à relevés multiples

Si une instruction d'une transaction comportant plusieurs relevés échoue, Amazon Redshift interrompt la transaction et ne publie aucune de ses modifications. Voici les erreurs courantes et les moyens de les résoudre :

  • Only a single Iceberg table can be written to in a multi-statement transaction involving Iceberg writes ou Cannot write to a different database after an Iceberg write to a data lake catalog in the same transaction. — La transaction écrit dans plusieurs tables. Exécutez chaque écriture dans une autre table dans sa propre transaction. Si vous faites référence à la même table Iceberg par deux noms, tels que deux schémas externes, utilisez un seul nom tout au long de la transaction.

  • Iceberg DDL is not allowed in multi-statement transaction — Exécutez les instructions DDL Iceberg en tant qu'instructions autonomes en dehors d'un bloc de transactions.

  • current transaction is aborted, commands ignored until end of transaction block — Une instruction précédente de la transaction a échoué, la transaction ne peut donc pas être validée. Courez ROLLBACK pour mettre fin à la transaction.

Résolution des conflits d'écriture simultanés

Plusieurs sessions et moteurs peuvent écrire simultanément dans la même table Iceberg. Si un autre rédacteur effectue une validation dans la table pendant que votre écriture est en cours d'exécution et que les deux ensembles de modifications ne se chevauchent pas, Amazon Redshift peut rebaser vos modifications sur la dernière version de la table et les valider sans exécuter à nouveau l'écriture. Si Amazon Redshift ne parvient pas à rebaser vos modifications, par exemple parce que les deux écritures ont modifié les mêmes données, la validation échoue. Dans ce cas, lancez à nouveau l'écriture. Pour plus d'informations, voir Résolution des conflits d'écriture simultanés pour les tables Apache Iceberg dans Amazon Redshift.

Note

Les instructions d'écriture Iceberg ne peuvent pas être exécutées dans une procédure stockée.