Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
AWS Glue API REST per le specifiche di Apache Iceberg
Questa sezione contiene le specifiche relative a AWS Glue Catalogo Iceberg REST e AWS Glue API di estensione e considerazioni sull'utilizzo di queste API.
Le AWS Glue Data Catalog gli endpoint supportano due metodi di autenticazione. Scegli il metodo che corrisponde al modo in cui il tuo motore di analisi o l'integrazione si connette al catalogo.
-
AWS Signature versione 4 (SIGv4) — L'impostazione predefinita per AWS SDK e AWS motori di analisi nativi. Vedi AWS Signature Version 4 per le richieste API.
-
Token al portatore OAuth 2.0 — Per partner di integrazione esterni e motori di query di terze parti che si autenticano con un token di accesso OAuth ottenuto da AWS Sign-In. Vedi le informazioni di autenticazione in Connessione al catalogo dati tramite AWS Glue Endpoint REST Iceberge Configurare l'accesso OAuth a AWS Glue Catalogo REST Iceberg nel AWS Sign-In Guida per l'utente.
Quando si accede a AWS Glue endpoint del servizio e AWS Glue metadati, l'applicazione assume un ruolo IAM che richiede glue:GetCatalog Azione IAM. Questo vale per entrambi i metodi di autenticazione: con SIGv4, viene utilizzata l'identità IAM propria del chiamante; con un token portatore OAuth, l'identità è il ruolo IAM assunto durante lo scambio di token.
L'accesso al Data Catalog e ai suoi oggetti può essere gestito tramite IAM, AWS Lake Formation, o autorizzazioni in modalità ibrida di Lake Formation. Indipendentemente dal metodo di autenticazione, le stesse azioni IAM e le stesse autorizzazioni Lake Formation documentate per ciascuna operazione vengono applicate a ogni richiesta.
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 usare IAM, AWS Lake Formation, o autorizzazioni in modalità ibrida di Lake Formation per gestire l'accesso al catalogo dati predefinito e ai suoi 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 — Richiesto per drop/delete 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
Nota
Quando un motore di interrogazione si autentica con un token portante OAuth, le autorizzazioni di Lake Formation descritte in questa sezione vengono applicate al ruolo IAM che il cliente ha configurato per l'integrazione. Concedi a quel ruolo solo le autorizzazioni che gli utenti del partner dovrebbero avere, ad esempio SELECT e DESCRIBE su tabelle specifiche. Vedi Fase 3: concedere a Lake Formation le autorizzazioni per il ruolo nel AWS Sign-In Guida per l'utente.
Per ulteriori informazioni, vedere Riferimento alle autorizzazioni di Lake Formation nel AWS Lake Formation Guida per gli sviluppatori.
| Nome operazione | GetConfig |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
OTTIENI/iceberg/v1/config |
| Operazione IAM |
colla: GetCatalog |
| Autorizzazioni Lake Formation | Non applicabile |
| CloudTrail Evento . |
colla: 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 di
warehouseinterrogazione deve essere impostato sull'ID del AWS Glue catalogo. 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 |
AWS Glue API di estensione |
| Percorso REST |
GET/extensions/v1/catalogs/{catalogo} |
| Operazione IAM |
colla: GetCatalog |
| Autorizzazioni Lake Formation | DESCRIBE |
| CloudTrail Evento . |
colla: 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 |
colla: GetDatabase |
| Autorizzazioni Lake Formation | ALL, DESCRIBE, SELECT |
| CloudTrail Evento . |
colla: 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 |
colla: CreateDatabase |
| Autorizzazioni Lake Formation | ALL, DESCRIBE, SELECT |
| CloudTrail Evento . |
colla: 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 |
AWS Glue estensioni API |
| Percorso REST |
POST/extensions/v1/catalogs/{catalog}/namespaces |
| Operazione IAM |
colla: CreateDatabase |
| Autorizzazioni Lake Formation | ALL, DESCRIBE, SELECT |
| CloudTrail Evento . |
colla: 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 |
colla:GetDatabase |
| Autorizzazioni Lake Formation | ALL, DESCRIBE, SELECT |
| CloudTrail Evento . |
colla: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, consultare la sezione Parametro del percorso namespace.
| Nome operazione | UpdateNamespaceProperties |
| Tipo |
API del catalogo REST Iceberg |
| Percorso REST |
MESSAGGIO/iceberg/v1/catalogs/ {catalog} /namespaces/ {ns} /proprietà |
| Operazione IAM |
colla:UpdateDatabase |
| Autorizzazioni Lake Formation | ALL, ALTER |
| CloudTrail Evento . |
colla: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, consultare 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 |
colla: DeleteDatabase |
| Autorizzazioni Lake Formation | ALL, DROP |
| CloudTrail Evento . |
colla: 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 |
AWS Glue estensioni API |
| Percorso REST |
ELIMINA/extensions/v1/catalogs/{catalog}/namespces/{ns} |
| Operazione IAM |
colla: DeleteDatabase |
| Autorizzazioni Lake Formation | ALL, DROP |
| CloudTrail Evento . |
colla: 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 |
OTTIENI/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Operazione IAM |
colla: GetTables |
| Autorizzazioni Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail Evento . |
colla: 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 |
OTTIENI/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Operazione IAM |
colla: CreateTable |
| Autorizzazioni Lake Formation | ALL, CREATE_TABLE |
| CloudTrail Evento . |
colla: 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, 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 devi utilizzare una combinazione diCREATE TABLEeINSERT INTOper risolvere il problema. -
L'operazione API
CreateTablenon supporta l'opzionestate-create = TRUE.
| Nome operazione | CreateTable |
| Tipo |
AWS Glue estensioni API |
| Percorso REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Operazione IAM |
colla: CreateTable |
| Autorizzazioni Lake Formation | ALL, CREATE_TABLE |
| CloudTrail Evento . |
colla: 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 |
GETiceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabella} |
| Azione IAM |
colla: GetTable |
| Autorizzazioni Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail evento |
colla: 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 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 |
AWS Glue estensioni API |
| Percorso REST |
GET/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Azione IAM |
colla: GetTable |
| Autorizzazioni Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail evento |
colla: 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 Description leggi. server-side-capabilities.pianificazione della scansione
Indica se la tabella può essere scansionata utilizzando la tabella e. PreparePlan PlanTable APIs leggi. server-side-capabilities.data-commit
Indica se è possibile eseguire il commit della 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 AWS credenziali 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, parte delle AWS credenziali 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, fa parte delle AWS credenziali 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 |
AWS Glue estensioni API |
| Percorso REST |
POSTA/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/preplan |
| Azione IAM |
colla: GetTable |
| Autorizzazioni Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail evento |
colla: 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 |
AWS Glue estensioni API |
| Percorso REST |
POSTA/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/plan |
| Azione IAM |
colla: GetTable |
| Autorizzazioni Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail evento |
colla: 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/{tabella} |
| Azione IAM |
colla: GetTable |
| Autorizzazioni Lake Formation | ALL, SELECT, DESCRIBE |
| CloudTrail evento |
colla: GetTable |
| Definizione Open API | 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 |
POSTiceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabella} |
| Azione IAM |
colla: UpdateTable |
| Autorizzazioni Lake Formation | ALL, ALTER |
| CloudTrail evento |
colla: 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 | AWS Glue API di estensione |
| Percorso REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabella} |
| Azione IAM |
colla: UpdateTable |
| Autorizzazioni Lake Formation |
ALL, ALTER |
| CloudTrail evento |
colla: 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/{tabella} |
| Azione IAM |
colla: DeleteTable |
| Autorizzazioni Lake Formation | ALL, DROP |
| CloudTrail evento |
colla: 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 |
AWS Glue estensioni API |
| Percorso REST |
ELIMINA/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabella} |
| Azione IAM |
colla: DeleteTable |
| Autorizzazioni Lake Formation | ALL, DROP |
| CloudTrail evento |
colla: 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 |
AWS Glue estensioni API |
| Percorso REST |
POST/extensions/v1/transactions/status |
| Azione 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.