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à.
# Accesso al Catalogo dati
Puoi utilizzare AWS Glue Data Catalog (Data Catalog) per scoprire e comprendere i tuoi dati. Il Catalogo dati offre un modo coerente per mantenere le definizioni degli schemi, i tipi di dati, le posizioni e altri metadati. Puoi accedere al Catalogo dati utilizzando i seguenti metodi:
+ AWS Glue console: puoi accedere e gestire il Data Catalog tramite la AWS Glue console, un'interfaccia utente basata sul Web. La console consente di sfogliare e cercare database, tabelle e i relativi metadati associati, nonché creare, aggiornare ed eliminare definizioni di metadati.
+ Crawler di AWS Glue — I crawler sono programmi che scansionano automaticamente le fonti di dati e popolano il Data Catalog con metadati. Puoi creare ed eseguire crawler per scoprire e catalogare dati da varie fonti come Amazon S3, Amazon RDS, Amazon DynamoDB Amazon CloudWatch e database relazionali conformi a JDBC come MySQL e PostgreSQL, oltre a diverse fonti non come Snowflake e Google.AWS BigQuery
+ AWS Glue APIs — È possibile accedere al AWS Glue APIs Data Catalog in modo programmatico utilizzando. Questi APIs consentono di interagire con il Data Catalog in modo programmatico, abilitando l'automazione e l'integrazione con altre applicazioni e servizi.
+ AWS Command Line Interface (AWS CLI) — È possibile utilizzare il AWS CLI per accedere e gestire il Data Catalog dalla riga di comando. L'interfaccia a riga di comando (CLI) fornisce comandi per la creazione, l'aggiornamento e l'eliminazione delle definizioni dei metadati, nonché per l'esecuzione di query e il recupero delle informazioni sui metadati.
+ Integrazione con altri AWS servizi: il Data Catalog si integra con vari altri AWS servizi, consentendo di accedere e utilizzare i metadati archiviati nel catalogo. Ad esempio, puoi utilizzare Amazon Athena per interrogare le fonti di dati utilizzando i metadati nel Catalogo dati e utilizzare AWS Lake Formation per gestire l'accesso e la governance dei dati per le risorse del Catalogo dati.
**Topics**
+ [Connessione al Data Catalog utilizzando l'endpoint REST AWS Glue Iceberg](connect-glu-iceberg-rest.md)
+ [Connessione al Data Catalog utilizzando l'endpoint di estensione AWS Glue Iceberg REST](connect-glue-iceberg-rest-ext.md)
+ [AWS Glue Specifiche REST APIs per Apache Iceberg](iceberg-rest-apis.md)
+ [Connessione al Catalogo dati da un'applicazione Spark standalone](connect-gludc-spark.md)
+ [Mappatura di dati tra Amazon Redshift e Apache Iceberg](data-mapping-rs-iceberg.md)
+ [Considerazioni e limitazioni sull'utilizzo di AWS Glue Iceberg REST Catalog APIs](limitation-glue-iceberg-rest-api.md)
# Connessione al Data Catalog utilizzando l'endpoint REST AWS Glue Iceberg
L'endpoint AWS Glue Iceberg Rest supporta le operazioni API specificate nella specifica di Apache Iceberg REST. Utilizzando un client Iceberg REST, è possibile collegare l'applicazione in esecuzione su un motore di analisi al catalogo REST ospitato nel Catalogo dati.
L'endpoint supporta entrambe le specifiche delle tabelle Apache Iceberg: v1 e v2, con l'impostazione predefinita su v2. Quando si utilizza la specifica della tabella Iceberg v1, occorre specificare v1 nella chiamata API. Usando l'operazione API, è possibile accedere alle tabelle Iceberg archiviate sia nello storage degli oggetti Amazon S3 che nello storage delle Tabelle Amazon S3.
**Configurazione dell'endpoint**
È possibile accedere al catalogo AWS Glue Iceberg REST utilizzando l'endpoint del servizio. Per l'endpoint specifico della regione, consulta la [guida di riferimento agli endpoint del servizio AWS Glue](https://docs.aws.amazon.com/general/latest/gr/glue.html#glue_region). Ad esempio, quando ti connetti ad AWS Glue nella regione us-east-1, devi configurare la proprietà URI dell'endpoint come segue:
```
Endpoint : https://glue.us-east-1.amazonaws.com/iceberg
```
**Proprietà di configurazione aggiuntive**: quando usi il client Iceberg per connettere un motore di analisi come Spark all'endpoint del servizio, devi specificare le seguenti proprietà di configurazione dell'applicazione:
```
catalog_name = "mydatacatalog"
aws_account_id = "123456789012"
aws_region = "us-east-1"
spark = SparkSession.builder \
... \
.config("spark.sql.defaultCatalog", catalog_name) \
.config(f"spark.sql.catalog.{catalog_name}", "org.apache.iceberg.spark.SparkCatalog") \
.config(f"spark.sql.catalog.{catalog_name}.type", "rest") \
.config(f"spark.sql.catalog.{catalog_name}.uri", "https://glue.{aws_region}.amazonaws.com/iceberg") \
.config(f"spark.sql.catalog.{catalog_name}.warehouse", "{aws_account_id}") \
.config(f"spark.sql.catalog.{catalog_name}.rest.sigv4-enabled", "true") \
.config(f"spark.sql.catalog.{catalog_name}.rest.signing-name", "glue") \
.config("spark.sql.extensions","org.apache.iceberg.spark.extensions.IcebergSparkSessionExtensions") \
.getOrCreate()
```
AWS Glue L'endpoint Iceberg ` https://glue.us-east-1.amazonaws.com/iceberg` supporta i seguenti Iceberg REST: APIs
+ GetConfig
+ ListNamespaces
+ CreateNamespace
+ LoadNamespaceMetadata
+ UpdateNamespaceProperties
+ DeleteNamespace
+ ListTables
+ CreateTable
+ LoadTable
+ TableExists
+ UpdateTable
+ DeleteTable
## Parametri del percorso del catalogo e del prefisso
Il catalogo Iceberg REST APIs ha un prefisso in formato libero nella richiesta. URLs Ad esempio, la chiamata `ListNamespaces` API utilizza il formato URL. `GET/v1/{prefix}/namespaces` AWS Glue il prefisso segue sempre la `/catalogs/{catalog}` struttura per garantire che il percorso REST allinei la gerarchia AWS Glue multicatalogo. Il parametro di percorso `{catalog}` può essere derivato in base alle seguenti regole:
| **Schema di accesso** | **Stile ID Catalogo Glue** | **Stile del prefisso** | **Esempio di ID catalogo predefinito** | **Esempio di percorso REST** |
| --- | --- | --- | --- | --- |
| Accedi al catalogo predefinito nell'account corrente | non obbligatorio | : | non applicabile | GET /v1/catalogs/:/namespaces |
| Accesso al catalogo predefinito in un account specifico | accountID | accountID | 111122223333 | GET /v1/catalogs/111122223333/namespaces |
| Accesso a un catalogo annidato nell'account corrente | catalog1/catalog2 | catalog1/catalog2 | rmscatalog1:db1 | OTTIENI /v1/ catalogs/rmscatalog1:db1/namespaces |
| Accesso a un catalogo annidato in uno specifico account | accountId:catalog1/catalog2 | accountId:catalog1/catalog2 | 123456789012/rmscatalog1:db1 | GET /v1/catalogs/123456789012:rmscatalog1:db1/namespaces |
Questa mappatura tra l'ID del catalogo e il prefisso è richiesta solo quando si chiama direttamente REST. APIs Quando lavori con il catalogo REST di AWS Glue Iceberg APIs tramite un motore, devi specificare l'ID del AWS Glue catalogo nel `warehouse` parametro per l'impostazione dell'API del catalogo Iceberg REST o nel `glue.id` parametro per l' AWS Glue impostazione dell'API delle estensioni. Scopri come utilizzarlo ad esempio con EMR Spark in [Utilizza un cluster Iceberg con Spark](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-iceberg-use-spark-cluster.html).
## Parametro del percorso namespace
I namespace nel percorso del catalogo REST di Iceberg possono avere più livelli APIs . Tuttavia, AWS Glue supporta solo namespace a livello singolo. Per accedere a un namespace in una gerarchia di cataloghi multilivello, è possibile connettersi a un catalogo multilivello sopra il namespace per fare riferimento al namespace. Ciò consente a qualsiasi motore di query che supporti la notazione in 3 parti di accedere `catalog.namespace.table` agli oggetti nella gerarchia del catalogo a più livelli senza problemi AWS Glue di compatibilità rispetto all'utilizzo del namespace a più livelli.
# Connessione al Data Catalog utilizzando l'endpoint di estensione AWS Glue Iceberg REST
AWS Glue L'endpoint di estensione Iceberg REST fornisce funzionalità aggiuntive APIs, non presenti nella specifica Apache Iceberg REST, e fornisce funzionalità di pianificazione della scansione lato server. Questi elementi aggiuntivi APIs vengono utilizzati quando accedi alle tabelle archiviate nello storage gestito di Amazon Redshift. L'endpoint è accessibile da un'applicazione che utilizza le estensioni Apache Iceberg. AWS Glue Data Catalog
**Configurazione dell'endpoint**: è possibile accedere a un catalogo con tabelle nello storage gestito Redshift usando l'endpoint del servizio. Per l'endpoint specifico della regione, consulta la [guida di riferimento agli endpoint del servizio AWS Glue](https://docs.aws.amazon.com/general/latest/gr/glue.html#glue_region). Ad esempio, quando ci si connette alla AWS Glue regione us-east-1, è necessario configurare la proprietà URI dell'endpoint come segue:
```
Endpoint : https://glue.us-east-1.amazonaws.com/extensions
```
```
catalog_name = "myredshiftcatalog"
aws_account_id = "123456789012"
aws_region = "us-east-1"
spark = SparkSession.builder \
.config("spark.sql.defaultCatalog", catalog_name) \
.config(f"spark.sql.catalog.{catalog_name}", "org.apache.iceberg.spark.SparkCatalog") \
.config(f"spark.sql.catalog.{catalog_name}.type", "glue") \
.config(f"spark.sql.catalog.{catalog_name}.glue.id", "{123456789012}:redshiftnamespacecatalog/redshiftdb") \
.config("spark.sql.extensions","org.apache.iceberg.spark.extensions.IcebergSparkSessionExtensions") \
.getOrCreate()
```
# 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).
# Connessione al Catalogo dati da un'applicazione Spark standalone
È possibile connettersi al Catalogo dati da un'applicazione standalone usando un connettore Apache Iceberg.
1. Creazione di un ruolo IAM per l'applicazione Spark.
1. Connettiti all'endpoint AWS Glue Iceberg Rest utilizzando il connettore Iceberg.
```
# configure your application. Refer to https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html for best practices on configuring environment variables.
export AWS_ACCESS_KEY_ID=$(aws configure get appUser.aws_access_key_id)
export AWS_SECRET_ACCESS_KEY=$(aws configure get appUser.aws_secret_access_key)
export AWS_SESSION_TOKEN=$(aws configure get appUser.aws_secret_token)
export AWS_REGION=us-east-1
export REGION=us-east-1
export AWS_ACCOUNT_ID = {specify your aws account id here}
~/spark-3.5.3-bin-hadoop3/bin/spark-shell \
--packages org.apache.iceberg:iceberg-spark-runtime-3.4_2.12:1.6.0 \
--conf "spark.sql.extensions=org.apache.iceberg.spark.extensions.IcebergSparkSessionExtensions" \
--conf "spark.sql.defaultCatalog=spark_catalog" \
--conf "spark.sql.catalog.spark_catalog=org.apache.iceberg.spark.SparkCatalog" \
--conf "spark.sql.catalog.spark_catalog.type=rest" \
--conf "spark.sql.catalog.spark_catalog.uri=https://glue.us-east-1.amazonaws.com/iceberg" \
--conf "spark.sql.catalog.spark_catalog.warehouse = {AWS_ACCOUNT_ID}" \
--conf "spark.sql.catalog.spark_catalog.rest.sigv4-enabled=true" \
--conf "spark.sql.catalog.spark_catalog.rest.signing-name=glue" \
--conf "spark.sql.catalog.spark_catalog.rest.signing-region=us-east-1" \
--conf "spark.sql.catalog.spark_catalog.io-impl=org.apache.iceberg.aws.s3.S3FileIO" \
--conf "spark.hadoop.fs.s3a.aws.credentials.provider=org.apache.hadoop.fs.s3a.SimpleAWSCredentialProvider"
```
1. Esecuzione di query sui dati nel Catalogo dati.
```
spark.sql("create database myicebergdb").show()
spark.sql("""CREATE TABLE myicebergdb.mytbl (name string) USING iceberg location 's3://bucket_name/mytbl'""")
spark.sql("insert into myicebergdb.mytbl values('demo') ").show()
```
# Mappatura di dati tra Amazon Redshift e Apache Iceberg
Redshift e Iceberg supportano diversi tipi di dati. La seguente matrice di compatibilità descrive il supporto e le limitazioni nella mappatura dei dati tra questi due sistemi. Consulta le [specifiche dei tipi di dati di Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/dg/c_Supported_data_types.html) e della [tabella di Apache Iceberg](https://iceberg.apache.org/spec/#primitive-types) per maggiori dettagli sui tipi di dati supportati nei rispettivi sistemi.
| Tipi dati di Redshift | Alias | Tipo di dati di Iceberg |
| --- | --- | --- |
| SMALLINT | INT2 | int |
| INTEGER | INT, INT4 | int |
| BIGINT | INT8 | Long |
| DECIMAL | NUMERIC | decimal |
| REAL | FLOAT4 | virgola mobile |
| REAL | FLOAT4 | virgola mobile |
| DOUBLE PRECISION | FLOAT8, GALLEGGIANTE | virgola mobile a doppia precisione |
| CHAR | CHARACTER, NCHAR | stringa |
| VARCHAR | CHARACTER VARYING, NVARCHAR | stringa |
| BPCHAR | | stringa |
| TEXT | | stringa |
| DATE | | data |
| TIME | TIME WITHOUT TIMEZONE | time |
| TIME | TIME WITH TIMEZONE | non supportato |
| TIMESTAMP | TIMESTAMP WITHOUT TIMEZONE | TIMESTAMP |
| TIMESTAMPZ | TIMESTAMP WITH TIMEZONE | TIMESTAMPZ |
| INTERVAL YEAR TO MONTH | | Non supportata |
| INTERVAL DAY TO SECOND | | Non supportata |
| BOOLEAN | BOOL | bool |
| HLLSKETCH | | Non supportata |
| SUPER | | Non supportata |
| VARBYTE | VARBINARY, BINARY VARYING | binary |
| GEOMETRY | | Non supportata |
| GEOGRAPHY | | Non supportata |
# Considerazioni e limitazioni sull'utilizzo di AWS Glue Iceberg REST Catalog APIs
Di seguito sono riportate le considerazioni e le limitazioni relative all'utilizzo del comportamento operativo DDL (Rest Catalog Data Definition Language) di Apache Iceberg.
**Considerazioni**
+ **Comportamento delle API `RenameTable`**: l'operazione `RenameTable` è supportata nelle tabelle in Amazon Redshift ma non in Amazon S3.
+ **Operazioni DDL per namespace e tabelle in Amazon Redshift**: le operazioni Crea, Aggiorna ed Elimina per namespace e tabelle in Amazon Redshift sono operazioni asincrone perché dipendono da quando è disponibile il gruppo di lavoro gestito di Amazon Redshift e dal fatto che sia in corso una transazione DDL e DML in conflitto; l'operazione deve attendere il blocco e quindi tentare di apportare modifiche.
**Limitazioni**
+ Le visualizzazioni APIs nella specifica REST di Apache Iceberg non sono supportate nel AWS Glue catalogo REST di Iceberg.