API REST di AWS Glue per le specifiche di Apache Iceberg
Questa sezione contiene le specifiche sul catalogo REST di AWS Glue Iceberg e sulle estensioni API di AWS Glue, nonché considerazioni sull'utilizzo di queste API.
Le richieste API agli endpoint AWS Glue Data Catalog vengono autenticate utilizzando Signature Version 4 (SigV4) di AWS. Consulta la sezione Signature Version 4 di AWS per le richieste API per saperne di più su SigV4 AWS.
Quando accede all'endpoint del servizio AWS Glue e ai metadati AWS Glue, l'applicazione assume un ruolo IAM che richiede l'azione IAM di glue:getCatalog.
L'accesso al Catalogo dati e ai relativi oggetti può essere gestito utilizzando le autorizzazioni IAM, Lake Formation o Lake Formation in modalità ibrida.
I cataloghi federati nel Catalogo dati hanno posizioni di dati registrate da Lake Formation. Lake Formation collabora con Catalogo dati per fornire autorizzazioni in stile database per gestire l'accesso degli utenti agli oggetti del Catalogo dati.
Puoi utilizzare le autorizzazioni IAM, AWS Lake Formation, o Lake Formation in modalità ibrida per gestire l'accesso al Catalogo dati predefinito e ai relativi oggetti.
Per creare, inserire o eliminare i dati negli oggetti gestiti di Lake Formation, devi impostare autorizzazioni specifiche per il ruolo o l'utente IAM.
-
CREATE_CATALOG: necessario per creare cataloghi
-
CREATE_DATABASE: necessario per creare database
-
CREATE_TABLE: necessario per creare tabelle
-
DELETE: necessario per eliminare i dati da una tabella
-
DESCRIBE: necessario per leggere i metadati
-
DROP: necessario per eliminare una tabella o un database
-
INSERT: necessario quando il principale deve inserire dati in una tabella
-
SELECT: necessario quando il principale deve selezionare i dati da una tabella
Per ulteriori informazioni, consulta Documentazione di riferimento sulle autorizzazioni Lake Formation nella Guida per gli sviluppatori di AWS Lake Formation.
| Nome operazione | GetConfig |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
OTTIENI /iceberg/v1/config |
| Operazione IAM |
glue:GetCatalog |
| Autorizzazioni Lake Formation | Non applicabile |
| Evento CloudTrail |
glue:GetCatalog |
| Definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L67 |
Considerazioni e limitazioni
-
Il parametro della query
warehousedeve essere impostato sull'ID del catalogo AWS Glue. Se non è impostato, il catalogo principale dell'account attuale viene utilizzato per restituire la risposta. Per ulteriori informazioni, consulta Parametri del percorso del catalogo e del prefisso.
| Nome operazione | GetCatalog |
| Tipo |
API estensioni AWS Glue |
| Percorso REST |
GET/extensions/v1/catalogs/{catalog} |
| Operazione IAM |
glue:GetCatalog |
| Autorizzazioni Lake Formation | DESCRIBE |
| Evento CloudTrail |
glue:GetCatalog |
| definizione Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L40 |
Considerazioni e limitazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
| Nome operazione | ListNamespaces |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
GET/iceberg/v1/catalogs/{catalog}/namespaces |
| Operazione IAM |
glue:GetDatabase |
| Autorizzazioni Lake Formation | ALL, DESCRIBE, SELECT |
| Evento CloudTrail |
glue:GetDatabase |
| Definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L205 |
Considerazioni e limitazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
-
Vengono visualizzati solo i namespace del livello successivo. Per elencare i namespace dei livelli più avanzati, specifica l'ID del catalogo annidato nel parametro del percorso del catalogo.
| Nome operazione | CreateNamespace |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
POST/iceberg/v1/catalogs/{catalog}/namespaces |
| Operazione IAM |
glue:CreateDatabase |
| Autorizzazioni Lake Formation | TUTTO, DESCRIVI, SELEZIONA |
| Evento CloudTrail |
glue:CreateDatabase |
| definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L256 |
Considerazioni e limitazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
-
È possibile creare solo namespace a livello singolo. Per creare un namespace multilivello, è necessario creare iterativamente ogni livello e connettersi al livello utilizzando il parametro del percorso del catalogo.
| Nome operazione | StartCreateNamespaceTransaction |
| Tipo |
API estensioni AWS Glue |
| Percorso REST |
POST/extensions/v1/catalogs/{catalog}/namespaces |
| Operazione IAM |
glue:CreateDatabase |
| Autorizzazioni Lake Formation | ALL, DESCRIBE, SELECT |
| Evento CloudTrail |
glue:CreateDatabase |
| Definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L256 |
Considerazioni e limitazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
-
È possibile creare un solo namespace a livello singolo. Per creare namespace a più livelli, è necessario creare in modo iterativo ogni livello e connettersi al livello utilizzando il parametro del percorso del catalogo.
-
L'API è asincrona e restituisce un ID di transazione che è possibile utilizzare per il tracciamento tramite la chiamata API
CheckTransactionStatus. -
È possibile chiamare questa API solo se la chiamata API
GetCatalogcontiene il parametrouse-extensions=truenella risposta.
| Nome operazione | LoadNamespaceMetadata |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns} |
| Operazione IAM |
glue:GetDatabase |
| Autorizzazioni Lake Formation | ALL, DESCRIBE, SELECT |
| Evento CloudTrail |
glue:GetDatabase |
| Definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L302 |
Considerazioni e limitazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione Parametro del percorso namespace.
| Nome operazione | UpdateNamespaceProperties |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties |
| Operazione IAM |
glue:UpdateDatabase |
| Autorizzazioni Lake Formation | TUTTO, MODIFICA |
| Evento CloudTrail |
glue:UpdateDatabase |
| Definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L400 |
Considerazioni e limitazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione Parametro del percorso namespace.
| Nome operazione | DeleteNamespace |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
DELETE/iceberg/v1/catalogs/{catalog}/namespces/{ns} |
| Operazione IAM |
glue:DeleteDatabase |
| Autorizzazioni Lake Formation | ALL, DROP |
| Evento CloudTrail |
glue:DeleteDatabase |
| definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L365 |
Considerazioni e limitazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione Parametro del percorso namespace.
-
Se nel database sono presenti oggetti, l'operazione non andrà a buon fine.
-
L'API è asincrona e restituisce un ID di transazione che è possibile utilizzare per il tracciamento tramite la chiamata API
CheckTransactionStatus. -
L'API può essere utilizzata solo se la chiamata API
GetCatalogindica una rispostause-extensions=true.
| Nome operazione | StartDeleteNamespaceTransaction |
| Tipo |
API estensioni AWS Glue |
| Percorso REST |
DELETE /extensions/v1/catalogs/{catalog}/namespces/{ns} |
| Operazione IAM |
glue:DeleteDatabase |
| Autorizzazioni Lake Formation | ALL, DROP |
| Evento CloudTrail |
glue:DeleteDatabase |
| Definizione Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L85 |
Considerazioni e limitazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione Parametro del percorso namespace.
-
Se nel database sono presenti oggetti, l'operazione non andrà a buon fine.
-
L'API è asincrona e restituisce un ID di transazione che è possibile utilizzare per il tracciamento tramite la chiamata API
CheckTransactionStatus. -
L'API può essere utilizzata solo se la chiamata API
GetCatalogindica una rispostause-extensions=true.
| Nome operazione | ListTables |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Operazione IAM |
glue:GetTables |
| Autorizzazioni Lake Formation | ALL, SELECT, DESCRIBE |
| Evento CloudTrail |
glue:GetTables |
| Definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L463 |
Considerazioni e limitazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione Parametro del percorso namespace.
-
Verranno elencate tutte le tabelle, incluse quelle non Iceberg. Per determinare se una tabella può essere caricata o meno come tabella Iceberg, chiama l'operazione
LoadTable.
| Nome operazione | CreateTable |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Operazione IAM |
glue:CreateTable |
| Autorizzazioni Lake Formation | ALL, CREATE_TABLE |
| Evento CloudTrail |
glue:CreateTable |
| definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L497 |
Considerazioni e limitazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione Parametro del percorso namespace.
-
CreateTablecon gestione temporanea non è supportato. Se viene specificato il parametro di querystageCreate, l'operazione avrà esito negativo. Ciò significa che un'operazione comeCREATE TABLE AS SELECTnon è supportata e che devi utilizzare una combinazione diCREATE TABLEeINSERT INTOper risolvere il problema. -
L'operazione API
CreateTablenon supporta l'opzionestate-create = TRUE.
| Nome operazione | CreateTable |
| Tipo |
API estensioni AWS Glue |
| Percorso REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Operazione IAM |
glue:CreateTable |
| Autorizzazioni Lake Formation | ALL, CREATE_TABLE |
| Evento CloudTrail |
glue:CreateTable |
| Definizione Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L107 |
Considerazioni e limitazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione Parametro del percorso namespace.
-
CreateTablecon gestione temporanea non è supportato. Se viene specificato il parametro di querystageCreate, l'operazione avrà esito negativo. Ciò significa che un'operazione comeCREATE TABLE AS SELECTnon è supportata e che l'utente deve utilizzare una combinazione diCREATE TABLEeINSERT INTOper risolvere il problema. -
L'API è asincrona e restituisce un ID di transazione che è possibile utilizzare per il tracciamento tramite la chiamata API
CheckTransactionStatus. -
L'API può essere utilizzata solo se la chiamata API
GetCatalogindica una rispostause-extensions=true.
| Nome operazione | LoadTable |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Operazione IAM |
glue:GeTTable |
| Autorizzazioni Lake Formation | ALL, SELECT, DESCRIBE |
| Evento CloudTrail |
glue:GetTable |
| Definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L616 |
Considerazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione Parametro del percorso namespace.
-
CreateTablecon gestione temporanea non è supportato. Se viene specificato il parametro di querystageCreate, l'operazione avrà esito negativo. Ciò significa che un'operazione come nonCREATE TABLE AS SELECTè supportata e che l'utente deve utilizzare una combinazione diCREATE TABLEeINSERT INTOper risolvere il problema. -
L'API è asincrona e restituisce un ID di transazione che è possibile utilizzare per il tracciamento tramite la chiamata API
CheckTransactionStatus. -
L'API può essere utilizzata solo se la chiamata API
GetCatalogindica una rispostause-extensions=true.
| Nome operazione | LoadTable |
| Tipo |
API estensioni AWS Glue |
| Percorso REST |
GET /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Operazione IAM |
glue:GetTable |
| Autorizzazioni Lake Formation | TUTTO, SELEZIONA, DESCRIVI |
| Evento CloudTrail |
glue:GetTable |
| Definizione Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L134 |
Considerazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione Parametro del percorso namespace.
-
È supportata solo la modalità
allper il parametro delle query degli snapshot. -
Rispetto all'API
LoadTable, l'APIExtendedLoadTablesi differenzia nei seguenti modi:Non impone rigorosamente che tutti i campi siano disponibili.
-
fornisce i seguenti parametri aggiuntivi nel campo di configurazione della risposta:
Parametri aggiuntivi Chiave di configurazione Descrizione aws.server-side-capabilities.scan-planning
Indica se la tabella può essere scansionata utilizzando la tabella PreparePlan e le API PlanTable. aws.server-side-capabilities.data-commit
Indica se è possibile impiegare la tabella utilizzando la transazione StartUpdateTable. aws.glue.staging.location
Utilizzato per la pianificazione della scansione lato server o il data commit, una posizione temporanea gestita dal servizio che può essere utilizzata dal motore per scrivere file di dati temporanei
aws.glue.staging.access-key-id
Utilizzato per la pianificazione della scansione lato server o il data commit, una parte delle credenziali AWS temporanee per accedere alla posizione temporanea gestita dal servizio
aws.glue.staging.secret-access-key
Utilizzato per la pianificazione della scansione lato server o il data commit, una parte delle credenziali AWS temporanee per accedere alla posizione temporanea gestita dal servizio.
aws.glue.staging.session-token
Utilizzato per la pianificazione della scansione lato server o il data commit, una parte delle credenziali AWS temporanee per accedere alla posizione temporanea gestita dal servizio.
aws.glue.staging.expiration-ms
Utilizzato per la pianificazione della scansione lato server o il data commit, il tempo di scadenza delle credenziali per accedere alla posizione temporanea gestita dal servizio.
aws.glue.staging.data-transfer-role-arn
Utilizzato per la pianificazione della scansione lato server o il data commit, un ruolo IAM che può essere assunto per accedere alla posizione di staging gestita dal servizio.
| Nome operazione | PreplanTable |
| Tipo |
Estensioni API AWS Glue |
| Percorso REST |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/preplan |
| Operazione IAM |
glue:GetTable |
| Autorizzazioni Lake Formation | TUTTO, SELEZIONA, DESCRIVI |
| Evento CloudTrail |
glue:GetTable |
| Definizione Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L211 |
Considerazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione Parametro del percorso namespace.
-
Il chiamante di questa API deve sempre determinare se ci sono risultati rimanenti da recuperare in base al token della pagina. Una risposta con un elemento di pagina vuoto ma un token di impaginazione è possibile se il lato server è ancora in fase di elaborazione ma non è in grado di produrre alcun risultato nel tempo di risposta specificato.
-
È possibile utilizzare questa API solo se la risposta dell'API
ExtendedLoadTablecontieneaws.server-side-capabilities.scan-planning=true.
| Nome operazione | PlanTable |
| Tipo |
Estensioni API AWS Glue |
| Percorso REST |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/plan |
| Operazione IAM |
glue:GetTable |
| Autorizzazioni Lake Formation | TUTTO, SELEZIONA, DESCRIVI |
| Evento CloudTrail |
glue:GetTable |
| Definizione Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L243 |
Considerazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione Parametro del percorso namespace.
-
Il chiamante di questa API deve sempre determinare se ci sono risultati rimanenti da recuperare in base al token della pagina. Una risposta con un elemento di pagina vuoto ma un token di impaginazione è possibile se il lato server è ancora in fase di elaborazione ma non è in grado di produrre alcun risultato nel tempo di risposta specificato.
-
È possibile utilizzare questa API solo se la risposta dell'API
ExtendedLoadTablecontieneaws.server-side-capabilities.scan-planning=true.
| Nome operazione | TableExists |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
HEAD/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Operazione IAM |
glue:GetTable |
| Autorizzazioni Lake Formation | ALL, SELECT, DESCRIBE |
| Evento CloudTrail |
glue:GetTable |
| Definizione OpenAPI | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L833 |
Considerazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione Parametro del percorso namespace.
| Nome operazione | UpdateTable |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Operazione IAM |
glue:UpdateTable |
| Autorizzazioni Lake Formation | ALL, ALTER |
| Evento CloudTrail |
glue:UpdateTable |
| Definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L677 |
Considerazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione Parametro del percorso namespace.
| Nome operazione | StartUpdateTableTransaction |
| Tipo | API estensione AWS Glue |
| Percorso REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Operazione IAM |
glue:UpdateTable |
| Autorizzazioni Lake Formation |
ALL, ALTER |
| Evento CloudTrail |
glue:UpdateTable |
| Definizione Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L154 |
Considerazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione Parametro del percorso namespace.
-
L'API è asincrona e restituisce un ID di transazione che è possibile utilizzare per il tracciamento tramite la chiamata API
CheckTransactionStatus. -
Un'operazione
RenamTablepuò essere eseguita anche tramite questa API. Quando ciò accade, il chiamante deve disporre anche dell'autorizzazione glue:CreateTable o LakeFormation CREATE_TABLE per rinominare la tabella. -
È possibile utilizzare questa API solo se la risposta dell'API
ExtendedLoadTablecontieneaws.server-side-capabilities.scan-planning=true.
| Nome operazione | DeleteTable |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
DELETE/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Operazione IAM |
glue:DeleteTable |
| Autorizzazioni Lake Formation | ALL, DROP |
| Evento CloudTrail |
glue:DeleteTable |
| Definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L793 |
Considerazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione Parametro del percorso namespace.
-
L'operazione API
DeleteTablesupporta un'opzione di eliminazione definitiva. Quando l'opzione di eliminazione è impostata sutrue, i dati della tabella vengono eliminati, altrimenti i dati non vengono eliminati. Per le tabelle in Amazon S3, l'operazione non elimina i dati della tabella. L'operazione non va a buon fine quando la tabella è archiviata in Amazon S3 epurge = TRUE,.Per le tabelle archiviate nello storage gestito Amazon Redshift, l'operazione eliminerà i dati della tabella, in modo simile al comportamento
DROP TABLEin Amazon Redshift. L'operazione non va a buon fine quando la tabella è archiviata in Amazon Redshift epurge = FALSE. -
purgeRequest=truenon è supportato.
| Nome operazione | StartDeleteTableTransaction |
| Tipo |
API estensioni AWS Glue |
| Percorso REST |
DELETE /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Operazione IAM |
glue:DeleteTable |
| Autorizzazioni Lake Formation | ALL, DROP |
| Evento CloudTrail |
glue:DeleteTable |
| Definizione Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L793 |
Considerazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.
È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione Parametro del percorso namespace.
-
purgeRequest=falsenon è supportato. -
L'API è asincrona e restituisce un ID di transazione che può essere tracciato tramite
CheckTransactionStatus.
| Nome operazione | CheckTransactionStatus |
| Tipo |
API dell'estensione AWS Glue |
| Percorso REST |
POST/extensions/v1/transactions/status |
| Operazione IAM |
La stessa autorizzazione dell'azione che avvia la transazione |
| Autorizzazioni Lake Formation | La stessa autorizzazione dell'azione che avvia la transazione |
| Definizione Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L273 |
Considerazioni
-
Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione Parametri del percorso del catalogo e del prefisso.