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à. # API database L'API Database descrive i tipi di dati del database e include l'API per creare, eliminare, localizzare, aggiornare ed elencare i database. ## Tipi di dati + [Struttura dei database](#aws-glue-api-catalog-databases-Database) + [DatabaseInput struttura](#aws-glue-api-catalog-databases-DatabaseInput) + [PrincipalPermissions struttura](#aws-glue-api-catalog-databases-PrincipalPermissions) + [DataLakePrincipal struttura](#aws-glue-api-catalog-databases-DataLakePrincipal) + [DatabaseIdentifier struttura](#aws-glue-api-catalog-databases-DatabaseIdentifier) + [FederatedDatabase struttura](#aws-glue-api-catalog-databases-FederatedDatabase) ## Struttura dei database L'oggetto `Database` rappresenta un raggruppamento logico di tabelle che potrebbero trovarsi in un metastore Hive o in un RDBMS. **Campi** + `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nome del database. Per la compatibilità Hive, questo viene scritto in minuscolo durante la memorizzazione. + `Description`: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri). Descrizione del database. + `LocationUri`: uniform resource identifier (uri), non inferiore a 1 e non superiore a 1024 byte di lunghezza, corrispondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri). La posizione del database (per esempio, un percorso HDFS). + `Parameters`: una matrice della mappa di coppie chiave-valore. Ogni chiave è una stringa chiave, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Ogni valore è una stringa UTF-8, lunga non più di 512000 byte. Queste coppie chiave-valore definiscono parametri e proprietà del database. + `CreateTime`: timestamp. L'ora in cui è stato creato il database di metadati nel catalogo. + `CreateTableDefaultPermissions`: una matrice di oggetti [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions). Crea un set di autorizzazioni predefinite per la tabella dei principal. Usato da AWS Lake Formation. Non utilizzato nel normale corso delle AWS Glue operazioni. + `TargetDatabase`: un oggetto [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier). Una struttura `DatabaseIdentifier` che descrive un database di destinazione per il collegamento delle risorse. + `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). L'ID del catalogo dati in cui risiede il database. + `FederatedDatabase`: un oggetto [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase). Una struttura `FederatedDatabase` che fa riferimento a un'entità esterna al AWS Glue Data Catalog. ## DatabaseInput struttura Struttura utilizzata per la creazione o per l'aggiornamento di un database. **Campi** + `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nome del database. Per la compatibilità Hive, questo viene scritto in minuscolo durante la memorizzazione. + `Description`: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri). Descrizione del database. + `LocationUri`: uniform resource identifier (uri), non inferiore a 1 e non superiore a 1024 byte di lunghezza, corrispondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri). La posizione del database (per esempio, un percorso HDFS). + `Parameters`: una matrice della mappa di coppie chiave-valore. Ogni chiave è una stringa chiave, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Ogni valore è una stringa UTF-8, lunga non più di 512000 byte. Queste coppie chiave-valore definiscono parametri e proprietà del database. Queste coppie chiave-valore definiscono parametri e proprietà del database. + `CreateTableDefaultPermissions`: una matrice di oggetti [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions). Crea un set di autorizzazioni predefinite per la tabella dei principal. Usato da AWS Lake Formation. Non utilizzato nel normale corso delle AWS Glue operazioni. + `TargetDatabase`: un oggetto [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier). Una struttura `DatabaseIdentifier` che descrive un database di destinazione per il collegamento delle risorse. + `FederatedDatabase`: un oggetto [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase). Una struttura `FederatedDatabase` che fa riferimento a un'entità esterna al AWS Glue Data Catalog. ## PrincipalPermissions struttura Autorizzazioni concesse a un principal. **Campi** + `Principal`: un oggetto [DataLakePrincipal](#aws-glue-api-catalog-databases-DataLakePrincipal). Il principal a cui vengono concesse le autorizzazioni. + `Permissions`: una matrice di stringhe UTF-8. Le autorizzazioni concesse al principal. ## DataLakePrincipal struttura Il AWS Lake Formation preside. **Campi** + `DataLakePrincipalIdentifier`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza. Un identificatore per il AWS Lake Formation principale. ## DatabaseIdentifier struttura Una struttura che descrive un database di destinazione per il collegamento delle risorse. **Campi** + `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). L'ID del catalogo dati in cui risiede il database. + `DatabaseName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Il nome del database del catalogo. + `Region`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). La regione della tabella di destinazione. ## FederatedDatabase struttura Un database che punta a un'entità esterna al AWS Glue Data Catalog. **Campi** + `Identifier`: stringa UTF-8, non inferiore a 1 o superiore a 512 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Un identificatore univoco per la tabella federata. + `ConnectionName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Il nome della connessione al metastore esterno. + `ConnectionType`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Il tipo di connessione utilizzato per accedere al database federato, ad esempio JDBC, ODBC o altri protocolli di connessione supportati. ## Operazioni + [CreateDatabase azione (Python: create\$1database)](#aws-glue-api-catalog-databases-CreateDatabase) + [UpdateDatabase azione (Python: update\$1database)](#aws-glue-api-catalog-databases-UpdateDatabase) + [DeleteDatabase azione (Python: delete\$1database)](#aws-glue-api-catalog-databases-DeleteDatabase) + [GetDatabase azione (Python: get\$1database)](#aws-glue-api-catalog-databases-GetDatabase) + [GetDatabases azione (Python: get\$1databases)](#aws-glue-api-catalog-databases-GetDatabases) ## CreateDatabase azione (Python: create\$1database) Crea un nuovo database in un catalogo di dati. **Richiesta** + `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). L'ID del catalogo dati in cui creare il database. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account. + `DatabaseInput` - *obbligatorio:* un oggetto [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput). I metadati per il database. + `Tags`: una matrice di mappe con coppie chiave-valore, non superiore alle 50 coppie. Ogni chiave è una stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza. Ogni valore è una stringa UTF-8, lunga non più di 256 byte. I tag assegnati al database. **Risposta** + *Nessun parametro di risposta.* **Errori** + `InvalidInputException` + `AlreadyExistsException` + `ResourceNumberLimitExceededException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `ConcurrentModificationException` + `FederatedResourceAlreadyExistsException` + `FederationSourceException` + `FederationSourceRetryableException` ## UpdateDatabase azione (Python: update\$1database) Aggiorna una definizione di database esistente in un catalogo dati. **Richiesta** + `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). L'ID del catalogo dati in cui risiede il database dei metadati. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account. + `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Il nome del database da caricare nel catalogo. Per la compatibilità Hive, questo è scritto in caratteri minuscoli. + `DatabaseInput` - *obbligatorio:* un oggetto [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput). Un oggetto `DatabaseInput` che specifica la nuova definizione del database di metadati nel catalogo. **Risposta** + *Nessun parametro di risposta.* **Errori** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `ConcurrentModificationException` + `FederationSourceException` + `FederationSourceRetryableException` + `AlreadyExistsException` ## DeleteDatabase azione (Python: delete\$1database) Rimuove un database specificato da un catalogo dati. **Nota** Dopo aver completato questa operazione, non è più possibile accedere alle tabelle (e a tutte le versioni e partizioni delle tabelle che potrebbero appartenere alle tabelle) e alle funzioni definite dall'utente nel database eliminato. AWS Glue elimina queste risorse «orfane» in modo asincrono in modo tempestivo, a discrezione del servizio. Per garantire l'eliminazione immediata di tutte le risorse correlate, prima di chiamare `DeleteDatabase`, utilizza `DeleteTableVersion` o `BatchDeleteTableVersion`, `DeletePartition` o `BatchDeletePartition`, `DeleteUserDefinedFunction` e `DeleteTable` o `BatchDeleteTable` per eliminare eventuali risorse che appartengono al database. **Richiesta** + `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). L'ID del catalogo dati in cui risiede il database. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account. + `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Il nome del database da eliminare. Per la compatibilità Hive, deve essere interamente in caratteri minuscoli. **Risposta** + *Nessun parametro di risposta.* **Errori** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `ConcurrentModificationException` + `FederationSourceException` + `FederationSourceRetryableException` ## GetDatabase azione (Python: get\$1database) Recupera la definizione di un database specificato. **Richiesta** + `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). L'ID del catalogo dati in cui risiede il database. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account. + `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nome del database da ripristinare. Per la compatibilità Hive, deve essere interamente in caratteri minuscoli. **Risposta** + `Database`: un oggetto [Database](#aws-glue-api-catalog-databases-Database). La definizione del database specificato nel catalogo dati. **Errori** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `FederationSourceException` + `FederationSourceRetryableException` ## GetDatabases azione (Python: get\$1databases) Recupera tutti i database definiti in un determinato catalogo dati. **Richiesta** + `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). L'ID del catalogo dati da cui recuperare `Databases`. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account. + `NextToken`: stringa UTF-8. Un token di continuazione, se si tratta di una chiamata di continuazione. + `MaxResults`: numero (intero), non inferiore a 1 o superiore a 100. Il numero massimo di database da restituire in una risposta. + `ResourceShareType`: stringa UTF-8 (valori validi: `FOREIGN` \$1 `ALL` \$1 `FEDERATED`). Consente di specificare che si desidera elencare i database condivisi con l'account. I valori consentiti sono `FEDERATED`, `FOREIGN` o `ALL`. + Se impostato su `FEDERATED`, elencherà i database federati (con riferimento a un'entità esterna) condivisi con l'account. + Se impostato su `FOREIGN`, elencherà i database condivisi con l'account. + Se impostato su `ALL`, elencherà i database condivisi con l'account, così come i database nell'account locale. + `AttributesToGet`: una matrice di stringhe UTF-8. Specifica i campi del database restituiti dalla chiamata `GetDatabases`. Questo parametro non accetta un elenco vuoto. La richiesta deve includere `NAME`. **Risposta** + `DatabaseList` - *obbligatorio:* una matrice di oggetti [Database](#aws-glue-api-catalog-databases-Database). Un elenco di oggetti `Database` dal catalogo specificato. + `NextToken`: stringa UTF-8. Un token di continuazione per impaginare l'elenco restituito di token, restituiti se il segmento corrente dell'elenco non è l'ultimo. **Errori** + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `EntityNotFoundException` + `FederationSourceException` + `FederationSourceRetryableException`