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.
Cette section contient les spécifications relatives au catalogue et à l' AWS Glue extension AWS Glue Iceberg REST APIs, ainsi que les APIs points à prendre en compte lors de leur utilisation.
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 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 du mode hybride IAM, Lake Formation ou Lake Formation.
Les catalogues fédérés du 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 par Lake Formation, vous devez configurer des autorisations spécifiques pour l'utilisateur ou le rôle IAM.
-
CREATE_CATALOG — Nécessaire pour créer des catalogues
-
CREATE_DATABASE — Nécessaire pour créer des bases de données
-
CREATE_TABLE — Nécessaire pour créer des tables
-
DELETE — Obligatoire pour supprimer des données d'une table
-
DESCRIBE — Nécessaire pour lire les métadonnées
-
DROP — Nécessaire pour supprimer/supprimer 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 dans une table
Pour plus d'informations, consultez la référence sur les autorisations de Lake Formation dans le Guide du AWS Lake Formation développeur.
| Nom de l'opération | GetConfig |
| Type |
API du catalogue REST Iceberg |
| chemin REST |
GET /iceberg/v1/config |
| Action IAM |
colle : GetCatalog |
| Permissions de Lake Formation | Ne s’applique pas |
| CloudTrail event |
colle : GetCatalog |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L67 |
Considérations et restrictions
-
Le paramètre de
warehouserequê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 préfixe et du chemin du catalogue.
| Nom de l'opération | GetCatalog |
| Type |
AWS Glue API d'extension |
| chemin REST |
GET/extensions/v1/catalogs/{catalogue} |
| Action IAM |
colle : GetCatalog |
| Permissions de Lake Formation | DESCRIBE |
| CloudTrail event |
colle : GetCatalog |
| Définition de l'API ouverte | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L40 |
Considérations et restrictions
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
| Nom de l'opération | ListNamespaces |
| Type |
API du catalogue REST Iceberg |
| chemin REST |
GET/iceberg/v1/catalogs/{catalog}/namespaces |
| Action IAM |
colle : GetDatabase |
| Permissions de Lake Formation | TOUT, DÉCRIRE, SÉLECTIONNER |
| CloudTrail event |
colle : GetDatabase |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L205 |
Considérations et restrictions
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
-
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 du catalogue.
| Nom de l'opération | CreateNamespace |
| Type |
API du catalogue REST Iceberg |
| chemin REST |
POST/iceberg/v1/catalogs/{catalog}/namespaces |
| Action IAM |
colle : CreateDatabase |
| Permissions de Lake Formation | TOUT, DÉCRIRE, SÉLECTIONNER |
| CloudTrail event |
colle : CreateDatabase |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L256 |
Considérations et restrictions
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
-
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.
| Nom de l'opération | StartCreateNamespaceTransaction |
| Type |
AWS Glue API d'extensions |
| chemin REST |
POST/extensions/v1/catalogs/{catalog}/namespaces |
| Action IAM |
colle : CreateDatabase |
| Permissions de Lake Formation | TOUT, DÉCRIRE, SÉLECTIONNER |
| CloudTrail event |
colle : CreateDatabase |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L256 |
Considérations et restrictions
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
-
Vous ne pouvez créer qu'un espace de noms à un seul niveau. Pour créer des espaces 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 identifiant de transaction que vous pouvez utiliser pour le suivi à l'aide de l'appel d'
CheckTransactionStatusAPI. -
Vous pouvez appeler cette API uniquement si l'appel
GetCatalogd'API contient le paramètreuse-extensions=truedans la réponse.
| Nom de l'opération | LoadNamespaceMetadata |
| Type |
API du catalogue REST Iceberg |
| chemin REST |
GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns} |
| Action IAM |
colle : GetDatabase |
| Permissions de Lake Formation | TOUT, DÉCRIRE, SÉLECTIONNER |
| CloudTrail event |
colle : GetDatabase |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L302 |
Considérations et restrictions
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre de chemin REST. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
| Nom de l'opération | UpdateNamespaceProperties |
| Type |
API du catalogue REST Iceberg |
| chemin REST |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties |
| Action IAM |
colle : UpdateDatabase |
| Permissions de Lake Formation | TOUT, MODIFIER |
| CloudTrail event |
colle : UpdateDatabase |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L400 |
Considérations et restrictions
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre de chemin REST. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
| Nom de l'opération | DeleteNamespace |
| Type |
API du catalogue REST Iceberg |
| chemin REST |
DELETE/iceberg/v1/catalogs/{catalog}/namespces/{ns} |
| Action IAM |
colle : DeleteDatabase |
| Permissions de Lake Formation | TOUT, DÉPOSER |
| CloudTrail event |
colle : DeleteDatabase |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L365 |
Considérations et restrictions
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
Si la base de données contient des objets, l'opération échouera.
-
L'API est asynchrone et renvoie un identifiant de transaction que vous pouvez utiliser pour le suivi à l'aide de l'appel d'
CheckTransactionStatusAPI. -
L'API ne peut être utilisée que si l'appel
GetCatalogd'API l'indiqueuse-extensions=trueen réponse.
| Nom de l'opération | StartDeleteNamespaceTransaction |
| Type |
AWS Glue API d'extensions |
| chemin REST |
DELETE /extensions/v1/catalogs/{catalog}/namespces/{ns} |
| Action IAM |
colle : DeleteDatabase |
| Permissions de Lake Formation | TOUT, DÉPOSER |
| CloudTrail event |
colle : DeleteDatabase |
| Définition de l'API ouverte | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L85 |
Considérations et restrictions
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un seul espace de noms à niveau unique dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
Si la base de données contient des objets, l'opération échouera.
-
L'API est asynchrone et renvoie un identifiant de transaction que vous pouvez utiliser pour le suivi à l'aide de l'appel d'
CheckTransactionStatusAPI. -
L'API ne peut être utilisée que si l'appel
GetCatalogd'API l'indiqueuse-extensions=trueen réponse.
| Nom de l'opération | ListTables |
| Type |
API du catalogue REST Iceberg |
| chemin REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Action IAM |
colle : GetTables |
| Permissions de Lake Formation | TOUT, SÉLECTIONNER, DÉCRIRE |
| CloudTrail event |
colle : GetTables |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L463 |
Considérations et restrictions
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
Toutes les tables, y compris les tables autres que celles d'Iceberg, seront répertoriées. Pour déterminer si une table peut être chargée en tant que table Iceberg ou non, appelez
LoadTableoperation.
| Nom de l'opération | CreateTable |
| Type |
API du catalogue REST Iceberg |
| chemin REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Action IAM |
colle : CreateTable |
| Permissions de Lake Formation | TOUT, CREATE_TABLE |
| CloudTrail event |
colle : CreateTable |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L497 |
Considérations et restrictions
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
CreateTableavec mise en scène n'est pas prise en charge. Si le paramètre destageCreaterequête est spécifié, l'opération échouera. Cela signifie que les opérations similaires neCREATE TABLE AS SELECTsont pas prises en charge et que vous pouvez utiliser une combinaison deCREATE TABLEetINSERT INTOcomme solution de contournement. -
Le fonctionnement de l'
CreateTableAPI ne prend pas en charge cette optionstate-create = TRUE.
| Nom de l'opération | CreateTable |
| Type |
AWS Glue API d'extensions |
| chemin REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Action IAM |
colle : CreateTable |
| Permissions de Lake Formation | TOUT, CREATE_TABLE |
| CloudTrail event |
colle : CreateTable |
| Définition de l'API ouverte | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L107 |
Considérations et restrictions
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre de chemin REST. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
CreateTableavec mise en scène n'est pas prise en charge. Si le paramètre destageCreaterequête est spécifié, l'opération échouera. Cela signifie que les opérations similaires neCREATE TABLE AS SELECTsont pas prises en charge et que l'utilisateur doit utiliser une combinaison deCREATE TABLEetINSERT INTOpour contourner le problème. -
L'API est asynchrone et renvoie un identifiant de transaction que vous pouvez utiliser pour le suivi à l'aide de l'appel d'
CheckTransactionStatusAPI. -
L'API ne peut être utilisée que si l'appel
GetCatalogd'API l'indiqueuse-extensions=trueen réponse.
| Nom de l’opération | LoadTable |
| Type |
AWS Glue API d'extensions |
| chemin REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tableau} |
| Action IAM |
Colle : GE TTable |
| Permissions de Lake Formation | TOUT, SÉLECTIONNER, DÉCRIRE |
| CloudTrail événement |
colle : GetTable |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L616 |
Considérations
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un seul espace de noms de niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
CreateTableavec mise en scène n'est pas prise en charge. Si le paramètre destageCreaterequête est spécifié, l'opération échouera. Cela signifie que les opérations similaires neCREATE TABLE AS SELECTsont pas prises en charge et que l'utilisateur doit utiliser une combinaison deCREATE TABLEetINSERT INTOpour contourner le problème. -
L'API est asynchrone et renvoie un identifiant de transaction que vous pouvez utiliser pour le suivi à l'aide de l'appel d'
CheckTransactionStatusAPI. -
L'API ne peut être utilisée que si l'appel
GetCatalogd'API l'indiqueuse-extensions=trueen réponse.
| Nom de l’opération | LoadTable |
| Type |
AWS Glue API d'extensions |
| chemin REST |
GET /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tableau} |
| Action IAM |
colle : GetTable |
| Permissions de Lake Formation | TOUT, SÉLECTIONNER, DÉCRIRE |
| CloudTrail événement |
colle : GetTable |
| Définition de l'API ouverte | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L134 |
Considérations
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
Seul
allle mode est pris en charge pour le paramètre de requête des instantanés. -
Par rapport à
LoadTablel'API, l'ExtendedLoadTableAPI se distingue des manières suivantes :N'impose pas strictement que tous les champs soient disponibles.
-
fournit les paramètres supplémentaires suivants dans le champ de configuration de la réponse :
Paramètres supplémentaires Clé de configuration Description aws. server-side-capabilities.scan-planning
Indique si le tableau peut être scanné à l'aide du PreparePlan tableau et PlanTable APIs. aws. server-side-capabilities.data-commit
Indique si la table peut être validée à l'aide de la StartUpdateTable transaction. aws.glue.staging.location
Utilisé pour la planification du scan côté serveur ou pour la validation des données, emplacement intermédiaire géré par le service qui peut être utilisé par le moteur pour écrire des fichiers de données temporaires
aws.glue.staging. access-key-id
Utilisé pour la planification du scan côté serveur ou pour la validation des données, il fait partie des informations d' AWS identification temporaires permettant d'accéder à l'emplacement intermédiaire géré par le service
aws.glue.staging. secret-access-key
Utilisé pour la planification du scan côté serveur ou pour la validation des données, il fait partie des informations d' AWS identification temporaires permettant d'accéder à l'emplacement intermédiaire géré par le service.
jeton de session aws.glue.staging.session
Utilisé pour la planification du scan côté serveur ou pour la validation des données, il fait partie des informations d' AWS identification temporaires permettant d'accéder à l'emplacement intermédiaire géré par le service.
aws.glue.staging.expiration-ms
Utilisé pour la planification du scan côté serveur ou pour la validation des données, date d'expiration des informations d'identification pour accéder à l'emplacement intermédiaire géré par le service.
aws.glue.staging. data-transfer-role-arn
Utilisé pour la planification du scan côté serveur ou pour la validation des données, rôle IAM qui peut être assumé pour accéder à l'emplacement intermédiaire géré par le service.
| Nom de l’opération | PreplanTable |
| Type |
AWS Glue API d'extensions |
| chemin REST |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/preplan |
| Action IAM |
colle : GetTable |
| Permissions de Lake Formation | TOUT, SÉLECTIONNER, DÉCRIRE |
| CloudTrail événement |
colle : GetTable |
| Définition de l'API ouverte | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L211 |
Considérations
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
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'
ExtendedLoadTableAPI contientaws.server-side-capabilities.scan-planning=true.
| Nom de l’opération | PlanTable |
| Type |
AWS Glue API d'extensions |
| chemin REST |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/plan |
| Action IAM |
colle : GetTable |
| Permissions de Lake Formation | TOUT, SÉLECTIONNER, DÉCRIRE |
| CloudTrail événement |
colle : GetTable |
| Définition de l'API ouverte | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L243 |
Considérations
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
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'
ExtendedLoadTableAPI contientaws.server-side-capabilities.scan-planning=true.
| Nom de l’opération | TableExists |
| Type |
API du catalogue REST Iceberg |
| chemin REST |
HEAD/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tableau} |
| Action IAM |
colle : GetTable |
| Permissions de Lake Formation | TOUT, SÉLECTIONNER, DÉCRIRE |
| CloudTrail événement |
colle : GetTable |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L833 |
Considérations
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
| Nom de l’opération | UpdateTable |
| Type |
API du catalogue REST Iceberg |
| chemin REST |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tableau} |
| Action IAM |
colle : UpdateTable |
| Permissions de Lake Formation | TOUT, MODIFIER |
| CloudTrail événement |
colle : UpdateTable |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L677 |
Considérations
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
| Nom de l’opération | StartUpdateTableTransaction |
| Type | AWS Glue API d'extension |
| chemin REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tableau} |
| Action IAM |
colle : UpdateTable |
| Permissions de Lake Formation |
TOUT, MODIFIER |
| CloudTrail événement |
colle : UpdateTable |
| Définition de l'API ouverte | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L154 |
Considérations
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
L'API est asynchrone et renvoie un identifiant de transaction que vous pouvez utiliser pour le suivi à l'aide de l'appel d'
CheckTransactionStatusAPI. -
Une
RenamTableopération 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_TABLE pour renommer la table. -
Vous ne pouvez utiliser cette API que si la réponse de l'
ExtendedLoadTableAPI contientaws.server-side-capabilities.scan-planning=true.
| Nom de l’opération | DeleteTable |
| Type |
API du catalogue REST Iceberg |
| chemin REST |
DELETE/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tableau} |
| Action IAM |
colle : DeleteTable |
| Permissions de Lake Formation | TOUT, DÉPOSER |
| CloudTrail événement |
colle : DeleteTable |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L793 |
Considérations
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
DeleteTableLe fonctionnement de l'API prend en charge une option de purge. Lorsque la purge est définie surtrue, les données de la table sont supprimées, sinon les données ne sont pas supprimées. 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, etpurge = TRUE,.Pour les tables stockées dans le stockage géré Amazon Redshift, l'opération supprimera les données des tables, comme dans Amazon
DROP TABLERedshift. L'opération échoue lorsque la table est stockée dans Amazon Redshift et.purge = FALSE -
purgeRequest=truen’est pas pris en charge.
| Nom de l’opération | StartDeleteTableTransaction |
| Type |
AWS Glue API d'extensions |
| chemin REST |
DELETE /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tableau} |
| Action IAM |
colle : DeleteTable |
| Permissions de Lake Formation | TOUT, LAISSE TOMBER |
| CloudTrail événement |
colle : DeleteTable |
| Définition de l'API ouverte | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L793 |
Considérations
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
Vous ne pouvez spécifier qu'un espace de noms à un seul niveau dans le paramètre REST Path. Pour plus d'informations, consultez la Paramètre de chemin d'espace de noms section.
-
purgeRequest=falsen’est pas pris en charge. -
L'API est asynchrone et renvoie un identifiant de transaction qui peut être suivi.
CheckTransactionStatus
| 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 |
| Permissions de Lake Formation | La même autorisation que l'action qui initie la transaction |
| Définition de l'API ouverte | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L273 |
Considérations
-
Le paramètre du chemin du catalogue doit suivre le style décrit dans la Paramètres du préfixe et du chemin du catalogue section.
