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 Specifiche REST APIs per Apache Iceberg
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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 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 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 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 i dati negli oggetti gestiti di Lake Formation, devi impostare autorizzazioni specifiche per il ruolo o l'utente IAM.
+ CREATE\$1CATALOG: necessario per creare cataloghi
+ CREATE\$1DATABASE: necessario per creare database
+ CREATE\$1TABLE: necessario per creare tabelle
+ DELETE: necessario per eliminare i dati da una tabella
+ DESCRIBE: necessario per leggere i metadati
+ DROP: obbligatorio 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
Per ulteriori informazioni, consulta il [riferimento alle autorizzazioni di Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/lf-permissions-reference.html) nella Guida per gli AWS Lake Formation sviluppatori.
# GetConfig
**Informazioni generali**
| | |
| --- |--- |
| 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 \$1L67 |
****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 attuale viene utilizzato per restituire la risposta. Per ulteriori informazioni, consulta [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
# GetCatalog
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | GetCatalog |
| Tipo | AWS Glue API di estensione |
| Percorso REST | GET/extensions/v1/catalogs/\$1catalogo\$1 |
| 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 \$1L40 |
****Considerazioni e limitazioni****
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
# ListNamespaces
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | ListNamespaces |
| Tipo | API del catalogo REST Iceberg |
| Percorso REST | GET/iceberg/v1/catalogs/\$1catalog\$1/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 \$1L205 |
****Considerazioni e limitazioni****
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ 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.
# CreateNamespace
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | CreateNamespace |
| Tipo | API del catalogo REST Iceberg |
| Percorso REST | POST/iceberg/v1/catalogs/\$1catalog\$1/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 \$1L256 |
****Considerazioni e limitazioni****
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È 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.
# StartCreateNamespaceTransaction
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | StartCreateNamespaceTransaction |
| Tipo | AWS Glue estensioni API |
| Percorso REST | POST/extensions/v1/catalogs/\$1catalog\$1/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 \$1L256 |
****Considerazioni e limitazioni****
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È 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 `GetCatalog` contiene il parametro `use-extensions=true` nella risposta.
## LoadNamespaceMetadata
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | LoadNamespaceMetadata |
| Tipo | API del catalogo REST Iceberg |
| Percorso REST | GET/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1 |
| 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 \$1L302 |
****Considerazioni e limitazioni****
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
## UpdateNamespaceProperties
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | UpdateNamespaceProperties |
| Tipo | API del catalogo REST Iceberg |
| Percorso REST | POSTA/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/properties |
| 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 \$1L400 |
****Considerazioni e limitazioni****
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
# DeleteNamespace
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | DeleteNamespace |
| Tipo | API del catalogo REST Iceberg |
| Percorso REST | DELETE/iceberg/v1/catalogs/\$1catalog\$1/namespces/\$1ns\$1 |
| 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 \$1L365 |
****Considerazioni e limitazioni****
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ 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 `GetCatalog` indica una risposta `use-extensions=true`.
# StartDeleteNamespaceTransaction
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | StartDeleteNamespaceTransaction |
| Tipo | AWS Glue estensioni API |
| Percorso REST | ELIMINA/extensions/v1/catalogs/\$1catalog\$1/namespces/\$1ns\$1 |
| 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 \$1L85 |
****Considerazioni e limitazioni****
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ 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 `GetCatalog` indica una risposta `use-extensions=true`.
# ListTables
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | ListTables |
| Tipo | API del catalogo REST Iceberg |
| Percorso REST | OTTIENI/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/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 \$1L463 |
****Considerazioni e limitazioni****
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ 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`.
# CreateTable
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | CreateTable |
| Tipo | API del catalogo REST Iceberg |
| Percorso REST | OTTIENI/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables |
| Operazione IAM | colla: CreateTable |
| Autorizzazioni Lake Formation | ALL, CREATE\$1TABLE |
| 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 \$1L497 |
****Considerazioni e limitazioni****
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ `CreateTable` con gestione temporanea non è supportato. Se viene specificato il parametro di query `stageCreate`, l'operazione avrà esito negativo. Ciò significa che un'operazione come `CREATE TABLE AS SELECT` non è supportata e che devi utilizzare una combinazione di `CREATE TABLE` e `INSERT INTO` per risolvere il problema.
+ L'operazione API `CreateTable` non supporta l'opzione `state-create = TRUE`.
# StartCreateTableTransaction
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | CreateTable |
| Tipo | AWS Glue estensioni API |
| Percorso REST | POST/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables |
| Operazione IAM | colla: CreateTable |
| Autorizzazioni Lake Formation | ALL, CREATE\$1TABLE |
| CloudTrail Evento . | colla: CreateTable |
| Definizione Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml \$1L107 |
****Considerazioni e limitazioni****
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ `CreateTable` con gestione temporanea non è supportato. Se viene specificato il parametro di query `stageCreate`, l'operazione avrà esito negativo. Ciò significa che un'operazione come `CREATE TABLE AS SELECT` non è supportata e che l'utente deve utilizzare una combinazione di `CREATE TABLE` e `INSERT 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 API `GetCatalog` indica una risposta `use-extensions=true`.
# LoadTable
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | LoadTable |
| Tipo | API del catalogo REST Iceberg |
| Percorso REST | GETiceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabella\$1 |
| 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 \$1L616 |
**Considerazioni**
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ `CreateTable` con gestione temporanea non è supportato. Se viene specificato il parametro di query `stageCreate`, l'operazione avrà esito negativo. Ciò significa che un'operazione come `CREATE TABLE AS SELECT` non è supportata e che l'utente deve utilizzare una combinazione di `CREATE TABLE` e `INSERT 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 API `GetCatalog` indica una risposta `use-extensions=true`.
# ExtendedLoadTable
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | LoadTable |
| Tipo | AWS Glue estensioni API |
| Percorso REST | GET/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1 |
| 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 \$1L134 |
**Considerazioni**
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ È supportata solo la modalità `all` per il parametro delle query degli snapshot.
+ Rispetto all'API `LoadTable`, l'API `ExtendedLoadTable` 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**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/extended-load-table.html)
# PreplanTable
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | PreplanTable |
| Tipo | AWS Glue estensioni API |
| Percorso REST | POSTA/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1/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 \$1L211 |
**Considerazioni**
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ 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 `ExtendedLoadTable` contiene `aws.server-side-capabilities.scan-planning=true`.
# PlanTable
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | PlanTable |
| Tipo | AWS Glue estensioni API |
| Percorso REST | POSTA/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1/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 \$1L243 |
**Considerazioni**
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ 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 `ExtendedLoadTable` contiene `aws.server-side-capabilities.scan-planning=true`.
# TableExists
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | TableExists |
| Tipo | API del catalogo REST Iceberg |
| Percorso REST | HEAD/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabella\$1 |
| 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 \$1L833 |
**Considerazioni**
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
# UpdateTable
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | UpdateTable |
| Tipo | API del catalogo REST Iceberg |
| Percorso REST | POSTiceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabella\$1 |
| 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 \$1L677 |
**Considerazioni**
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
# StartUpdateTableTransaction
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | StartUpdateTableTransaction |
| Tipo | AWS Glue API di estensione |
| Percorso REST | POST/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabella\$1 |
| 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 \$1L154 |
**Considerazioni**
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ L'API è asincrona e restituisce un ID di transazione che è possibile utilizzare per il tracciamento tramite la chiamata API `CheckTransactionStatus`.
+ Un'operazione `RenamTable` può essere eseguita anche tramite questa API. Quando ciò accade, il chiamante deve disporre anche dell'autorizzazione glue: CreateTable o LakeFormation CREATE\$1TABLE per rinominare la tabella.
+ È possibile utilizzare questa API solo se la risposta dell'API `ExtendedLoadTable` contiene `aws.server-side-capabilities.scan-planning=true`.
# DeleteTable
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | DeleteTable |
| Tipo | API del catalogo REST Iceberg |
| Percorso REST | DELETE/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabella\$1 |
| 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 \$1L793 |
**Considerazioni**
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consulta la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ L'operazione API `DeleteTable` supporta un'opzione di eliminazione definitiva. Quando l'opzione di eliminazione è impostata su `true`, 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 e `purge = TRUE,`.
Per le tabelle archiviate nello storage gestito Amazon Redshift, l'operazione eliminerà i dati della tabella, in modo simile al comportamento `DROP TABLE` in Amazon Redshift. L'operazione non va a buon fine quando la tabella è archiviata in Amazon Redshift e `purge = FALSE`.
+ `purgeRequest=true` non è supportato.
# StartDeleteTableTransaction
**Informazioni generali**
| | |
| --- |--- |
| Nome operazione | StartDeleteTableTransaction |
| Tipo | AWS Glue estensioni API |
| Percorso REST | ELIMINA/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabella\$1 |
| 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 \$1L793 |
**Considerazioni**
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ È possibile specificare solo un namespace a livello singolo nel parametro del percorso REST. Per ulteriori informazioni, consultare la sezione [Parametro del percorso namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ `purgeRequest=false` non è supportato.
+ L'API è asincrona e restituisce un ID di transazione che può essere tracciato tramite `CheckTransactionStatus`.
# CheckTransactionStatus
**Informazioni generali**
| | |
| --- |--- |
| 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 \$1L273 |
**Considerazioni**
+ Il parametro del percorso del catalogo deve seguire lo stile descritto nella sezione [Parametri del percorso del catalogo e del prefisso](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).