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.

# Commande DELETE dans Amazon QLDB
<a name="ql-reference.delete"></a>

**Important**  
Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez [Migrer un registre Amazon QLDB vers Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Dans Amazon QLDB, utilisez `DELETE` la commande pour marquer un document actif comme supprimé dans un tableau en créant une nouvelle mais dernière révision du document. Cette dernière révision indique que le document est supprimé. Cette opération met fin au cycle de vie d'un document, ce qui signifie qu'aucune autre révision de document portant le même identifiant de document ne peut être créée.

Cette opération est irréversible. Vous pouvez toujours consulter l'historique des révisions d'un document supprimé à l'aide du[Fonction d'historique](working.history.md#working.history.function).

**Note**  
Pour savoir comment contrôler l'accès afin d'exécuter cette commande partiQL sur des tables spécifiques, consultez. [Commencer à utiliser le mode d'autorisation standard dans Amazon QLDB](getting-started-standard-mode.md)

**Topics**
+ [Syntaxe](#ql-reference.delete.syntax)
+ [Paramètres](#ql-reference.delete.parameters)
+ [Valeur renvoyée](#ql-reference.delete.return)
+ [Exemples](#ql-reference.delete.examples)
+ [Exécution par programmation à l'aide du pilote](#ql-reference.delete.driver)

## Syntaxe
<a name="ql-reference.delete.syntax"></a>

```
DELETE FROM table_name [ AS table_alias ] [ BY id_alias ]
[ WHERE condition ]
```

## Paramètres
<a name="ql-reference.delete.parameters"></a>

***table\$1name***  
Nom de la table utilisateur contenant les données à supprimer. Les instructions DML ne sont prises en charge que dans la [vue utilisateur](working.userdata.md) par défaut. Chaque instruction ne peut être exécutée que sur une seule table.

**EN TANT QUE *table\$1alias***  
(Facultatif) Alias défini par l'utilisateur qui s'étend au-dessus d'une table à supprimer. Le `AS` mot clé est facultatif.

**PAR *id\$1alias***  
(Facultatif) Alias défini par l'utilisateur qui est lié au champ de `id` métadonnées de chaque document du jeu de résultats. L'alias doit être déclaré dans la `FROM` clause à l'aide du `BY` mot clé. Cela est utile lorsque vous souhaitez filtrer sur l'[ID du document](working.metadata.md) lorsque vous recherchez l'affichage utilisateur par défaut. Pour de plus amples informations, veuillez consulter [Utilisation de la clause BY pour demander l'ID du document](working.metadata.by-clause.md).

**OÙ *condition***  
Les critères de sélection des documents à supprimer.

**Note**  
Si vous omettez la `WHERE` clause, tous les documents du tableau sont supprimés.

## Valeur renvoyée
<a name="ql-reference.delete.return"></a>

`documentId`— L'identifiant unique de chaque document que vous avez supprimé.

## Exemples
<a name="ql-reference.delete.examples"></a>

```
DELETE FROM VehicleRegistration AS r
WHERE r.VIN = '1HVBBAANXWH544237'
```

## Exécution par programmation à l'aide du pilote
<a name="ql-reference.delete.driver"></a>

*Pour savoir comment exécuter cette instruction par programmation à l'aide du pilote QLDB, consultez les didacticiels suivants dans Getting started with the driver :*
+ Java : [Tutoriel de démarrage rapide](driver-quickstart-java.md) \$1 [Référence de livre de cuisine](driver-cookbook-java.md)
+ .NET : [Tutoriel de démarrage rapide](driver-quickstart-dotnet.md) \$1 [Référence de livre de cuisine](driver-cookbook-dotnet.md)
+ Allez : [Tutoriel de démarrage rapide](driver-quickstart-golang.md) \$1 [Référence de livre de cuisine](driver-cookbook-golang.md)
+ Node.js : [Tutoriel de démarrage rapide](driver-quickstart-nodejs.md) \$1 [Référence de livre de cuisine](driver-cookbook-nodejs.md)
+ Python : [Tutoriel de démarrage rapide](driver-quickstart-python.md) \$1 [Référence de livre de cuisine](driver-cookbook-python.md)