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à.
Questa sezione contiene le specifiche sul catalogo e sull' AWS Glue estensione AWS Glue APIs Iceberg REST e le considerazioni relative al loro utilizzo. APIs
Le richieste API agli AWS Glue Data Catalog endpoint vengono autenticate utilizzando AWS Signature Version 4 (SigV4). Consulta AWS la sezione Signature Version 4 per le richieste API per saperne di più su SigV4. AWS
Quando accede all'endpoint del AWS Glue servizio e ai AWS Glue metadati, l'applicazione assume un ruolo IAM che richiede l'intervento di IAM. glue:getCatalog
L'accesso al Data Catalog e ai relativi oggetti può essere gestito utilizzando le autorizzazioni in modalità ibrida IAM, Lake Formation o Lake Formation.
I cataloghi federati nel Data Catalog hanno posizioni di dati registrate da Lake Formation. Lake Formation collabora con Data Catalog per fornire autorizzazioni in stile database per gestire l'accesso degli utenti agli oggetti del Data Catalog.
Puoi utilizzare le autorizzazioni in modalità ibrida IAM o Lake Formation per gestire l'accesso al Data Catalog predefinito e ai relativi oggetti. AWS Lake Formation
Per creare, inserire o eliminare dati negli oggetti gestiti di Lake Formation, devi impostare autorizzazioni specifiche per l'utente o il ruolo 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/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 il riferimento alle autorizzazioni di Lake Formation nella Guida per gli AWS Lake Formation sviluppatori.
Nome dell'operazione | GetConfig |
Tipo |
API del catalogo REST di Iceberg |
Percorso REST |
GET /iceberg/v1/config |
Operazione IAM |
colla: GetCatalog |
Autorizzazioni Lake Formation | Non applicabile |
CloudTrail Evento . |
colla: GetCatalog |
Definizione dell'API aperta | 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
warehouse
interrogazione deve essere impostato sull'ID del AWS Glue catalogo. Se non è impostato, il catalogo principale dell'account corrente viene utilizzato per restituire la risposta. Per ulteriori informazioni, consulta Parametri del prefisso e del percorso del catalogo.
Nome dell'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 dell'API aperta | 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 prefisso e del percorso del catalogo
Nome dell'operazione | ListNamespaces |
Tipo |
API del catalogo REST di Iceberg |
Percorso REST |
GET/iceberg/v1/catalogs/{catalog}/namespaces |
Operazione IAM |
colla: GetDatabase |
Autorizzazioni Lake Formation | TUTTO, DESCRIVI, SELEZIONA |
CloudTrail Evento . |
colla: GetDatabase |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
-
Vengono visualizzati solo i namespace del livello successivo. Per elencare i namespace a livelli più profondi, specificate l'ID del catalogo annidato nel parametro del percorso del catalogo.
Nome dell'operazione | CreateNamespace |
Tipo |
API del catalogo REST di Iceberg |
Percorso REST |
POST/iceberg/v1/catalogs/{catalog}/namespaces |
Operazione IAM |
colla: CreateDatabase |
Autorizzazioni Lake Formation | TUTTO, DESCRIVI, SELEZIONA |
CloudTrail Evento . |
colla: CreateDatabase |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
-
È possibile creare solo uno spazio dei nomi a livello singolo. Per creare uno spazio dei nomi a più livelli, è necessario creare in modo iterativo ogni livello e connettersi al livello utilizzando il parametro del percorso del catalogo.
Nome dell'operazione | StartCreateNamespaceTransaction |
Tipo |
AWS Glue estensioni API |
percorso REST |
POST/extensions/v1/catalogs/{catalog}/namespaces |
Operazione IAM |
colla: CreateDatabase |
Autorizzazioni Lake Formation | TUTTO, DESCRIVI, SELEZIONA |
CloudTrail Evento . |
colla: CreateDatabase |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
-
È possibile creare solo uno spazio dei nomi a livello singolo. Per creare uno spazio dei nomi 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 puoi utilizzare per il tracciamento utilizzando la chiamata API.
CheckTransactionStatus
-
È possibile chiamare questa API solo se la chiamata
GetCatalog
API contiene il parametrouse-extensions=true
nella risposta.
Nome dell'operazione | LoadNamespaceMetadata |
Tipo |
API del catalogo REST di Iceberg |
Percorso REST |
GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns} |
Operazione IAM |
colla: GetDatabase |
Autorizzazioni Lake Formation | TUTTO, DESCRIVI, SELEZIONA |
CloudTrail Evento . |
colla: GetDatabase |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
Nome dell'operazione | UpdateNamespaceProperties |
Tipo |
API del catalogo REST di Iceberg |
Percorso REST |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties |
Operazione IAM |
colla: UpdateDatabase |
Autorizzazioni Lake Formation | CHIAMA, ALTERA |
CloudTrail Evento . |
colla: UpdateDatabase |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
Nome dell'operazione | DeleteNamespace |
Tipo |
API del catalogo REST di Iceberg |
Percorso REST |
DELETE/iceberg/v1/catalogs/{catalog}/namespces/{ns} |
Operazione IAM |
colla: DeleteDatabase |
Autorizzazioni Lake Formation | TUTTI, BUTTATI |
CloudTrail Evento . |
colla: DeleteDatabase |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
-
Se nel database sono presenti oggetti, l'operazione avrà esito negativo.
-
L'API è asincrona e restituisce un ID di transazione che è possibile utilizzare per il tracciamento tramite la
CheckTransactionStatus
chiamata API. -
L'API può essere utilizzata solo se la chiamata
GetCatalog
API indicause-extensions=true
una risposta.
Nome dell'operazione | StartDeleteNamespaceTransaction |
Tipo |
AWS Glue estensioni API |
percorso REST |
DELETE /extensions/v1/catalogs/{catalog}/namespces/{ns} |
Operazione IAM |
colla: DeleteDatabase |
Autorizzazioni Lake Formation | TUTTI, LASCIA CADERE |
CloudTrail Evento . |
colla: DeleteDatabase |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare un solo spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
-
Se nel database sono presenti oggetti, l'operazione avrà esito negativo.
-
L'API è asincrona e restituisce un ID di transazione che è possibile utilizzare per il tracciamento tramite la
CheckTransactionStatus
chiamata API. -
L'API può essere utilizzata solo se la chiamata
GetCatalog
API indicause-extensions=true
una risposta.
Nome dell'operazione | ListTables |
Tipo |
API del catalogo REST di Iceberg |
Percorso REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
Operazione IAM |
colla: GetTables |
Autorizzazioni Lake Formation | CHIAMA, SELEZIONA, DESCRIVI |
CloudTrail Evento . |
colla: GetTables |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
-
Verranno elencate tutte le tabelle, incluse le tabelle non Iceberg. Per determinare se una tabella può essere caricata o meno come tabella Iceberg, chiamate operation.
LoadTable
Nome dell'operazione | CreateTable |
Tipo |
API del catalogo REST di Iceberg |
Percorso REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
Operazione IAM |
colla: CreateTable |
Autorizzazioni Lake Formation | TUTTI, CREATE_TABLE |
CloudTrail Evento . |
colla: CreateTable |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
-
CreateTable
con staging non è supportato. Se viene specificato il parametro distageCreate
query, l'operazione avrà esito negativo. Ciò significa che l'operazione like nonCREATE TABLE AS SELECT
è supportata ed è possibile utilizzare una combinazione diCREATE TABLE
eINSERT INTO
come soluzione alternativa. -
L'operazione
CreateTable
API non supporta l'opzione.state-create = TRUE
Nome dell'operazione | CreateTable |
Tipo |
AWS Glue estensioni API |
percorso REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables |
Operazione IAM |
colla: CreateTable |
Autorizzazioni Lake Formation | TUTTI, CREATE_TABLE |
CloudTrail Evento . |
colla: CreateTable |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
-
CreateTable
con staging non è supportato. Se viene specificato il parametro distageCreate
query, l'operazione avrà esito negativo. Ciò significa che l'operazione like nonCREATE TABLE AS SELECT
è supportata e l'utente deve utilizzare una combinazione diCREATE TABLE
eINSERT INTO
per 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
GetCatalog
API indicause-extensions=true
una risposta.
Nome operazione | LoadTable |
Tipo |
AWS Glue estensioni API |
percorso REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabella} |
Operazione IAM |
colla: GE TTable |
Autorizzazioni Lake Formation | CHIAMA, SELEZIONA, DESCRIVI |
CloudTrail evento |
colla: GetTable |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la Parametro del percorso del namespace sezione.
-
CreateTable
con staging non è supportato. Se viene specificato il parametro distageCreate
query, l'operazione avrà esito negativo. Ciò significa che l'operazione like nonCREATE TABLE AS SELECT
è supportata e l'utente deve utilizzare una combinazione diCREATE TABLE
eINSERT INTO
per 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
GetCatalog
API indicause-extensions=true
una risposta.
Nome operazione | LoadTable |
Tipo |
AWS Glue estensioni API |
percorso REST |
GET /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabella} |
Operazione IAM |
colla: GetTable |
Autorizzazioni Lake Formation | CHIAMA, SELEZIONA, DESCRIVI |
CloudTrail evento |
colla: GetTable |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
-
È supportata solo la
all
modalità per il parametro di interrogazione delle istantanee. -
Rispetto all'
LoadTable
API, l'ExtendedLoadTable
API si 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 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 credenziali temporanee per accedere alla posizione temporanea gestita dal servizio. AWS
aws.glue.staging.expiration-ms
Utilizzato per la pianificazione della scansione lato server o il data commit, ora di scadenza delle credenziali per accedere allo staging gestito dal servizio. location.
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 temporanea gestita dal servizio.
Nome operazione | PreplanTable |
Tipo |
AWS Glue estensioni API |
percorso REST |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/preplan |
Operazione IAM |
colla: GetTable |
Autorizzazioni Lake Formation | CHIAMA, SELEZIONA, DESCRIVI |
CloudTrail evento |
colla: GetTable |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del 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'
ExtendedLoadTable
API contieneaws.server-side-capabilities.scan-planning=true
.
Nome operazione | PlanTable |
Tipo |
AWS Glue estensioni API |
percorso REST |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/plan |
Operazione IAM |
colla: GetTable |
Autorizzazioni Lake Formation | CHIAMA, SELEZIONA, DESCRIVI |
CloudTrail evento |
colla: GetTable |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del 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'
ExtendedLoadTable
API contieneaws.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} |
Operazione IAM |
colla: GetTable |
Autorizzazioni Lake Formation | CHIAMA, SELEZIONA, DESCRIVI |
CloudTrail evento |
colla: GetTable |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
Nome operazione | UpdateTable |
Tipo |
API del catalogo REST Iceberg |
Percorso REST |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabella} |
Operazione IAM |
colla: UpdateTable |
Autorizzazioni Lake Formation | CHIAMA, ALTERA |
CloudTrail evento |
colla: UpdateTable |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
Nome operazione | StartUpdateTableTransaction |
Tipo | AWS Glue API di estensione |
percorso REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabella} |
Operazione IAM |
colla: UpdateTable |
Autorizzazioni Lake Formation |
CHIAMA, ALTERA |
CloudTrail evento |
colla: UpdateTable |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
-
L'API è asincrona e restituisce un ID di transazione che puoi utilizzare per il tracciamento utilizzando la
CheckTransactionStatus
chiamata API. -
Un'
RenamTable
operazione può 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 contiene.
ExtendedLoadTable
aws.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} |
Operazione IAM |
colla: DeleteTable |
Autorizzazioni Lake Formation | TUTTI, BUTTATI |
CloudTrail evento |
colla: DeleteTable |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
-
DeleteTable
Il funzionamento dell'API supporta un'opzione di eliminazione. Quando l'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 delle tabelle. L'operazione ha esito negativo quando la tabella viene archiviata in Amazon S3 e.purge = TRUE,
Per le tabelle archiviate nello storage gestito di Amazon Redshift, l'operazione eliminerà i dati delle tabelle, analogamente al
DROP TABLE
comportamento di Amazon Redshift. L'operazione ha esito negativo quando la tabella viene archiviata in Amazon Redshift e.purge = FALSE
-
purgeRequest=true
non è supportato.
Nome operazione | StartDeleteTableTransaction |
Tipo |
AWS Glue estensioni API |
percorso REST |
DELETE /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabella} |
Operazione IAM |
colla: DeleteTable |
Autorizzazioni Lake Formation | TUTTI, LASCIA CADERE |
CloudTrail evento |
colla: DeleteTable |
Definizione dell'API aperta | 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 prefisso e del percorso del catalogo
È possibile specificare solo uno spazio dei nomi a livello singolo nel parametro REST Path. Per ulteriori informazioni, consulta la sezione. Parametro del percorso del namespace
-
purgeRequest=false
non è supportato. -
L'API è asincrona e restituisce un ID di transazione che può essere tracciato.
CheckTransactionStatus
Nome operazione | CheckTransactionStatus |
Tipo |
AWS Glue estensioni API |
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 dell'API aperta | 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 prefisso e del percorso del catalogo