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.
# AWS Glue Spécifications REST APIs pour Apache Iceberg
Cette section contient les spécifications relatives au catalogue et à l' AWS Glue extension AWS Glue Iceberg REST APIs, ainsi que les considérations relatives à leur utilisation. APIs
Les demandes d'API adressées aux AWS Glue Data Catalog points de terminaison sont authentifiées à l'aide de AWS Signature Version 4 (SigV4). Consultez [AWS la section Signature version 4 pour les demandes d'API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) pour en savoir plus sur AWS SigV4.
Lors de l'accès au point de terminaison du AWS Glue service et aux AWS Glue métadonnées, l'application assume un rôle IAM qui nécessite une action `glue:getCatalog` IAM.
L’accès au catalogue de données et à ses objets peut être géré à l’aide des autorisations IAM, Lake Formation ou du mode hybride Lake Formation.
Les catalogues fédérés dans le catalogue de données contiennent des emplacements de données enregistrés pour Lake Formation. Lake Formation utilise le catalogue de données pour fournir des autorisations de type base de données afin de gérer l’accès des utilisateurs aux objets du catalogue de données.
Vous pouvez utiliser les autorisations du mode hybride IAM ou Lake Formation pour gérer l'accès au catalogue de données par défaut et à ses objets. AWS Lake Formation
Pour créer, insérer ou supprimer des données dans les objets gérés Lake Formation, vous devez configurer des autorisations spécifiques pour l’utilisateur ou le rôle IAM.
+ CREATE\$1CATALOG : nécessaire pour créer des catalogues
+ CREATE\$1DATABASE : nécessaire pour créer des bases de données
+ CREATE\$1TABLE : nécessaire pour créer des tables
+ DELETE : nécessaire pour supprimer des données d’une table
+ DESCRIBE : nécessaire pour lire les métadonnées
+ DROP — Obligatoire pour drop/delete une table ou une base de données
+ INSERT : nécessaire lorsque le principal doit insérer des données dans une table
+ SELECT : nécessaire lorsque le principal doit sélectionner des données d’une table
Pour plus d'informations, consultez la [référence sur les autorisations de Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/lf-permissions-reference.html) dans le Guide du AWS Lake Formation développeur.
# GetConfig
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | GetConfig |
| Type | API de catalogue REST Iceberg |
| Chemin REST | OBTENEZ/iceberg/v1/config |
| Action IAM | colle : GetCatalog |
| Autorisations Lake Formation | Non applicable |
| CloudTrail event | colle : GetCatalog |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L67 |
****Considérations et restrictions****
+ Le paramètre de `warehouse` requête doit être défini sur l'ID du AWS Glue catalogue. S’il n’est pas défini, le catalogue racine du compte courant est utilisé pour renvoyer la réponse. Pour de plus amples informations, veuillez consulter [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
# GetCatalog
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | GetCatalog |
| Type | AWS Glue API d'extension |
| Chemin REST | GET/extensions/v1/catalogs/\$1catalogue\$1 |
| Action IAM | colle : GetCatalog |
| Autorisations Lake Formation | DESCRIBE |
| CloudTrail event | colle : GetCatalog |
| Définition Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml \$1L40 |
****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
# ListNamespaces
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | ListNamespaces |
| Type | API de catalogue REST Iceberg |
| Chemin REST | GET/iceberg/v1/catalogs/\$1catalog\$1/namespaces |
| Action IAM | colle : GetDatabase |
| Autorisations Lake Formation | ALL, DESCRIBE, SELECT |
| CloudTrail event | colle : GetDatabase |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L205 |
****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Seuls les espaces de noms du niveau suivant sont affichés. Pour répertorier les espaces de noms à des niveaux plus profonds, spécifiez l’ID de catalogue imbriqué dans le paramètre de chemin d’accès au catalogue.
# CreateNamespace
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | CreateNamespace |
| Type | API de catalogue REST Iceberg |
| Chemin REST | POST/iceberg/v1/catalogs/\$1catalog\$1/namespaces |
| Action IAM | colle : CreateDatabase |
| Autorisations Lake Formation | ALL, DESCRIBE, SELECT |
| CloudTrail event | colle : CreateDatabase |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L256 |
****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Seul un espace de noms à niveau unique peut être créé. Pour créer un espace de noms à plusieurs niveaux, vous devez créer chaque niveau de manière itérative et vous connecter au niveau à l’aide du paramètre de chemin du catalogue.
# StartCreateNamespaceTransaction
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | StartCreateNamespaceTransaction |
| Type | AWS Glue API d'extensions |
| Chemin REST | POST/extensions/v1/catalogs/\$1catalog\$1/namespaces |
| Action IAM | colle : CreateDatabase |
| Autorisations Lake Formation | ALL, DESCRIBE, SELECT |
| CloudTrail event | colle : CreateDatabase |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L256 |
****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez créer qu’un espace de noms à niveau unique. Pour créer un espace de noms à plusieurs niveaux, vous devez créer chaque niveau de manière itérative et vous connecter au niveau à l’aide du paramètre de chemin du catalogue.
+ L’API est asynchrone et renvoie un ID de transaction que vous pouvez utiliser pour le suivi à l’aide de l’appel d’API `CheckTransactionStatus`.
+ Vous pouvez appeler cette API uniquement si l’appel d’API `GetCatalog` contient le paramètre `use-extensions=true` dans la réponse.
## LoadNamespaceMetadata
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | LoadNamespaceMetadata |
| Type | API de catalogue REST Iceberg |
| Chemin REST | GET/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1 |
| Action IAM | colle : GetDatabase |
| Autorisations Lake Formation | ALL, DESCRIBE, SELECT |
| CloudTrail event | colle : GetDatabase |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L302 |
****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
## UpdateNamespaceProperties
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | UpdateNamespaceProperties |
| Type | API de catalogue REST Iceberg |
| Chemin REST | POSTER/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/properties |
| Action IAM | colle : UpdateDatabase |
| Autorisations Lake Formation | ALL, ALTER |
| CloudTrail event | colle : UpdateDatabase |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L400 |
****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
# DeleteNamespace
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | DeleteNamespace |
| Type | API de catalogue REST Iceberg |
| Chemin REST | DELETE/iceberg/v1/catalogs/\$1catalog\$1/namespces/\$1ns\$1 |
| Action IAM | colle : DeleteDatabase |
| Autorisations Lake Formation | ALL, DROP |
| CloudTrail event | colle : DeleteDatabase |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L365 |
****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ Si la base de données contient des objets, l’opération échouera.
+ L’API est asynchrone et renvoie un ID de transaction que vous pouvez utiliser pour le suivi à l’aide de l’appel d’API `CheckTransactionStatus`.
+ L’API ne peut être utilisée que si l’appel d’API `GetCatalog` indique `use-extensions=true` dans la réponse.
# StartDeleteNamespaceTransaction
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | StartDeleteNamespaceTransaction |
| Type | AWS Glue API d'extensions |
| Chemin REST | SUPPRIMER/extensions/v1/catalogs/\$1catalog\$1/namespces/\$1ns\$1 |
| Action IAM | colle : DeleteDatabase |
| Autorisations Lake Formation | ALL, DROP |
| CloudTrail event | colle : DeleteDatabase |
| Définition Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml \$1L85 |
****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ Si la base de données contient des objets, l’opération échouera.
+ L’API est asynchrone et renvoie un ID de transaction que vous pouvez utiliser pour le suivi à l’aide de l’appel d’API `CheckTransactionStatus`.
+ L’API ne peut être utilisée que si l’appel d’API `GetCatalog` indique `use-extensions=true` dans la réponse.
# ListTables
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | ListTables |
| Type | API de catalogue REST Iceberg |
| Chemin REST | OBTENEZ/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables |
| Action IAM | colle : GetTables |
| Autorisations Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail event | colle : GetTables |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L463 |
****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ Toutes les tables, y compris les tables non Iceberg, seront répertoriées. Pour déterminer si une table peut être chargée en tant que table Iceberg ou non, appelez l’opération `LoadTable`.
# CreateTable
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | CreateTable |
| Type | API de catalogue REST Iceberg |
| Chemin REST | OBTENEZ/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables |
| Action IAM | colle : CreateTable |
| Autorisations Lake Formation | ALL, CREATE\$1TABLE |
| CloudTrail event | colle : CreateTable |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L497 |
****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ `CreateTable` avec copie intermédiaire n’est pas prise en charge. Si le paramètre de requête `stageCreate` est spécifié, l’opération échouera. Cela signifie que les opérations comme `CREATE TABLE AS SELECT` ne sont pas prises en charge et que vous pouvez utiliser une combinaison de `CREATE TABLE` et de `INSERT INTO` comme solution de contournement.
+ L’opération d’API `CreateTable` ne prend pas en charge l’option `state-create = TRUE`.
# StartCreateTableTransaction
**Informations générales**
| | |
| --- |--- |
| Nom de l'opération | CreateTable |
| Type | AWS Glue API d'extensions |
| Chemin REST | POST/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables |
| Action IAM | colle : CreateTable |
| Autorisations Lake Formation | ALL, CREATE\$1TABLE |
| CloudTrail event | colle : CreateTable |
| Définition Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml \$1L107 |
****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ `CreateTable` avec copie intermédiaire n’est pas prise en charge. Si le paramètre de requête `stageCreate` est spécifié, l’opération échouera. Cela signifie que les opérations comme `CREATE TABLE AS SELECT` ne sont pas prises en charge et que l’utilisateur doit utiliser une combinaison de `CREATE TABLE` et de `INSERT INTO` comme solution de contournement.
+ L’API est asynchrone et renvoie un ID de transaction que vous pouvez utiliser pour le suivi à l’aide de l’appel d’API `CheckTransactionStatus`.
+ L’API ne peut être utilisée que si l’appel d’API `GetCatalog` indique `use-extensions=true` dans la réponse.
# LoadTable
**Informations générales**
| | |
| --- |--- |
| Nom de l’opération | LoadTable |
| Type | API de catalogue REST Iceberg |
| Chemin REST | OBTENIR/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1 |
| Action IAM | colle : GetTable |
| Autorisations Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail événement | colle : GetTable |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L616 |
**Considérations**
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ `CreateTable` avec copie intermédiaire n’est pas prise en charge. Si le paramètre de requête `stageCreate` est spécifié, l’opération échouera. Cela signifie que les opérations comme `CREATE TABLE AS SELECT` ne sont pas prises en charge et que l’utilisateur doit utiliser une combinaison de `CREATE TABLE` et de `INSERT INTO` comme solution de contournement.
+ L’API est asynchrone et renvoie un ID de transaction que vous pouvez utiliser pour le suivi à l’aide de l’appel d’API `CheckTransactionStatus`.
+ L’API ne peut être utilisée que si l’appel d’API `GetCatalog` indique `use-extensions=true` dans la réponse.
# ExtendedLoadTable
**Informations générales**
| | |
| --- |--- |
| Nom de l’opération | LoadTable |
| Type | AWS Glue API d'extensions |
| Chemin REST | OBTENIR/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1 |
| Action IAM | colle : GetTable |
| Autorisations Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail événement | colle : GetTable |
| Définition Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml \$1L134 |
**Considérations**
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ Seul le mode `all` est pris en charge pour le paramètre de requête des instantanés.
+ Par rapport à l’API `LoadTable`, l’API `ExtendedLoadTable` se distingue des manières suivantes :
+ Elle n’impose pas strictement que tous les champs soient disponibles.
+ Elle fournit les paramètres supplémentaires suivants dans le champ de configuration de la réponse :
**Paramètres supplémentaires**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/extended-load-table.html)
# PreplanTable
**Informations générales**
| | |
| --- |--- |
| Nom de l’opération | PreplanTable |
| Type | AWS Glue API d'extensions |
| Chemin REST | POSTER/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1/preplan |
| Action IAM | colle : GetTable |
| Autorisations Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail événement | colle : GetTable |
| Définition Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml \$1L211 |
**Considérations**
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ L’appelant de cette API doit toujours déterminer s’il reste des résultats à récupérer en fonction du jeton de page. Une réponse avec un élément de page vide, mais un jeton de pagination, est possible si le côté serveur est toujours en cours de traitement, mais n’est pas en mesure de produire un résultat dans le temps de réponse donné.
+ Vous ne pouvez utiliser cette API que si la réponse de l’API `ExtendedLoadTable` contient `aws.server-side-capabilities.scan-planning=true`.
# PlanTable
**Informations générales**
| | |
| --- |--- |
| Nom de l’opération | PlanTable |
| Type | AWS Glue API d'extensions |
| Chemin REST | POSTER/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1/plan |
| Action IAM | colle : GetTable |
| Autorisations Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail événement | colle : GetTable |
| Définition Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml \$1L243 |
**Considérations**
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ L’appelant de cette API doit toujours déterminer s’il reste des résultats à récupérer en fonction du jeton de page. Une réponse avec un élément de page vide, mais un jeton de pagination, est possible si le côté serveur est toujours en cours de traitement, mais n’est pas en mesure de produire un résultat dans le temps de réponse donné.
+ Vous ne pouvez utiliser cette API que si la réponse de l’API `ExtendedLoadTable` contient `aws.server-side-capabilities.scan-planning=true`.
# TableExists
**Informations générales**
| | |
| --- |--- |
| Nom de l’opération | TableExists |
| Type | API de catalogue REST Iceberg |
| Chemin REST | HEAD/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tableau\$1 |
| Action IAM | colle : GetTable |
| Autorisations Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail événement | colle : GetTable |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L833 |
**Considérations**
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
# UpdateTable
**Informations générales**
| | |
| --- |--- |
| Nom de l’opération | UpdateTable |
| Type | API de catalogue REST Iceberg |
| Chemin REST | POST/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tableau\$1 |
| Action IAM | colle : UpdateTable |
| Autorisations Lake Formation | ALL, ALTER |
| CloudTrail événement | colle : UpdateTable |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L677 |
**Considérations**
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
# StartUpdateTableTransaction
**Informations générales**
| | |
| --- |--- |
| Nom de l’opération | StartUpdateTableTransaction |
| Type | AWS Glue API d'extension |
| Chemin REST | POST/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tableau\$1 |
| Action IAM | colle : UpdateTable |
| Autorisations Lake Formation | ALL, ALTER |
| CloudTrail événement | colle : UpdateTable |
| Définition Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml \$1L154 |
**Considérations**
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ L’API est asynchrone et renvoie un ID de transaction que vous pouvez utiliser pour le suivi à l’aide de l’appel d’API `CheckTransactionStatus`.
+ Une opération `RenamTable` peut également être effectuée par le biais de cette API. Dans ce cas, l'appelant doit également disposer de l'autorisation glue : CreateTable ou LakeFormation CREATE\$1TABLE pour renommer la table.
+ Vous ne pouvez utiliser cette API que si la réponse de l’API `ExtendedLoadTable` contient `aws.server-side-capabilities.scan-planning=true`.
# DeleteTable
**Informations générales**
| | |
| --- |--- |
| Nom de l’opération | DeleteTable |
| Type | API de catalogue REST Iceberg |
| Chemin REST | DELETE/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tableau\$1 |
| Action IAM | colle : DeleteTable |
| Autorisations Lake Formation | ALL, DROP |
| CloudTrail événement | colle : DeleteTable |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L793 |
**Considérations**
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ Le fonctionnement de l’API `DeleteTable` prend en charge une option de purge. Lorsque la purge est définie sur `true`, les données de la table sont supprimées ; dans le cas contraire, elles ne le sont pas. Pour les tables dans Amazon S3, l’opération ne supprime pas les données des tables. L’opération échoue lorsque la table est stockée dans Amazon S3 et `purge = TRUE,`.
Pour les tables stockées dans le stockage géré par Amazon Redshift, l’opération supprimera les données des tables, de la même manière que le comportement `DROP TABLE` dans Amazon Redshift. L’opération échoue lorsque la table est stockée dans Amazon Redshift et `purge = FALSE`.
+ `purgeRequest=true` n’est pas pris en charge.
# StartDeleteTableTransaction
**Informations générales**
| | |
| --- |--- |
| Nom de l’opération | StartDeleteTableTransaction |
| Type | AWS Glue API d'extensions |
| Chemin REST | SUPPRIMER/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1 |
| Action IAM | colle : DeleteTable |
| Autorisations Lake Formation | ALL, DROP |
| CloudTrail événement | colle : DeleteTable |
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L793 |
**Considérations**
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).
+ `purgeRequest=false` n’est pas pris en charge.
+ L’API est asynchrone et renvoie un identifiant de transaction qui peut être suivi via `CheckTransactionStatus`.
# CheckTransactionStatus
**Informations générales**
| | |
| --- |--- |
| Nom de l’opération | CheckTransactionStatus |
| Type | AWS Glue API d'extensions |
| Chemin REST | POST/extensions/v1/transactions/status |
| Action IAM | La même autorisation que l’action qui initie la transaction |
| Autorisations Lake Formation | La même autorisation que l’action qui initie la transaction |
| Définition Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml \$1L273 |
**Considérations**
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).