API Cataloghi

• Struttura del catalogo

• CatalogInput struttura

• TargetRedshiftCatalog struttura

• CatalogProperties struttura

• CatalogPropertiesOutput struttura

• DataLakeAccessProperties struttura

• IcebergOptimizationProperties struttura

• DataLakeAccessPropertiesOutput struttura

• IcebergOptimizationPropertiesOutput struttura

• FederatedCatalog struttura

Campi

• CatalogId: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

  L'ID del catalogo. Per concedere l'accesso al catalogo predefinito, questo campo non deve essere fornito.

• Name— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 64 byte, corrispondente al. Custom string pattern #30

  Il nome del catalogo. Non può essere uguale all'ID account.

• ResourceArn— UTF-8 stringa.

  Il nome della risorsa Amazon (ARN) assegnato alla risorsa del catalogo.

• Description: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a URI address multi-line string pattern.

  Stringa di descrizione, non superiore a 2.048 byte di lunghezza, corrispondente al modello di stringa su più righe dell'indirizzo URI. Una descrizione del catalogo.

• 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.

  Ogni valore è una UTF-8 stringa, lunga non più di 512000 byte.

  Un array della mappa di coppie chiave-valore che definiscono parametri e proprietà del catalogo.

• CreateTime: timestamp.

  L'ora in cui è stato creato il catalogo.

• UpdateTime: timestamp.

  L'ora dell'ultimo aggiornamento del catalogo.

• TargetRedshiftCatalog: un oggetto TargetRedshiftCatalog.

  Un oggetto TargetRedshiftCatalog che descrive un catalogo di destinazione per il collegamento del database.

• FederatedCatalog: un oggetto FederatedCatalog.

  Un FederatedCatalog oggetto che punta a un'entità esterna al catalogo AWS Glue dati.

• CatalogProperties: un oggetto CatalogPropertiesOutput.

  Un oggetto CatalogProperties che specifica le proprietà di accesso al data lake e altre proprietà personalizzate.

• CreateTableDefaultPermissions: una matrice di oggetti PrincipalPermissions.

  Un array di oggetti PrincipalPermissions. Crea un set di autorizzazioni predefinite sulle tabelle per i principali. Usato da AWS Lake Formation. Non utilizzato nel normale corso delle AWS Glue operazioni.

• CreateDatabaseDefaultPermissions: una matrice di oggetti PrincipalPermissions.

  Un array di oggetti PrincipalPermissions. Crea un set di autorizzazioni predefinite sui database per i principali. Usato da AWS Lake Formation. Non utilizzato nel normale corso delle AWS Glue operazioni.

• AllowFullTableExternalDataAccess— UTF-8 stringa (valori validi: True |False).

  Consente ai motori di terze parti di accedere ai dati nelle Amazon S3 località registrate con Lake Formation.

Campi

• Description: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a URI address multi-line string pattern.

  Stringa di descrizione, non superiore a 2.048 byte di lunghezza, corrispondente al modello di stringa su più righe dell'indirizzo URI. Una descrizione del catalogo.

• FederatedCatalog: un oggetto FederatedCatalog.

  Oggetto FederatedCatalog. Una FederatedCatalog struttura che fa riferimento a un'entità esterna al AWS Glue Data Catalog, ad esempio un database Redshift.

• 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.

  Ogni valore è una UTF-8 stringa, lunga non più di 512000 byte.

  Un array della mappa di coppie chiave-valore che definiscono i parametri e le proprietà del catalogo.

• TargetRedshiftCatalog: un oggetto TargetRedshiftCatalog.

  Un oggetto TargetRedshiftCatalog che descrive un catalogo di destinazione per il collegamento delle risorse.

• CatalogProperties: un oggetto CatalogProperties.

  Un oggetto CatalogProperties che specifica le proprietà di accesso al data lake e altre proprietà personalizzate.

• CreateTableDefaultPermissions: una matrice di oggetti PrincipalPermissions.

  Un array di oggetti PrincipalPermissions. Crea un set di autorizzazioni predefinite sulle tabelle per i principali. Usato da. AWS Lake Formation In genere dovrebbe essere impostato in modo esplicito come elenco vuoto.

• CreateDatabaseDefaultPermissions: una matrice di oggetti PrincipalPermissions.

  Un array di oggetti PrincipalPermissions. Crea un set di autorizzazioni predefinite sui database per i principali. Usato da AWS Lake Formation. In genere dovrebbe essere impostato in modo esplicito come elenco vuoto.

• AllowFullTableExternalDataAccess— UTF-8 stringa (valori validi: True |False).

  Consente ai motori di terze parti di accedere ai dati nelle Amazon S3 località registrate con Lake Formation.

• OverwriteChildResourcePermissionsWithDefault— UTF-8 stringa (valori validi: Accept |Deny).

  Sovrascrive AWS Lake Formation le autorizzazioni esistenti con CatalogInput$CreateTableDefaultPermissions e CatalogInput$CreateDatabaseDefaultPermissions per tutte le risorse secondarie.

Campi

• CatalogArn— Obbligatorio: UTF-8 stringa.

  Il nome della risorsa Amazon (ARN) della risorsa del catalogo.

Campi

• DataLakeAccessProperties: un oggetto DataLakeAccessProperties.

  Un DataLakeAccessProperties oggetto che specifica le proprietà per configurare l'accesso al data lake per la risorsa del catalogo nel AWS Glue Data Catalog.

• IcebergOptimizationProperties: un oggetto IcebergOptimizationProperties.

  Una struttura che specifica le proprietà di ottimizzazione della tabella Iceberg per il catalogo. Ciò include la configurazione per le operazioni di compattazione, conservazione ed eliminazione dei file orfani che possono essere applicate alle tabelle Iceberg in questo catalogo.

• CustomProperties: 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.

  Ogni valore è una UTF-8 stringa, lunga non più di 512000 byte.

  Proprietà chiave-valore aggiuntive per il catalogo, come le ottimizzazioni delle statistiche delle colonne.

Campi

• DataLakeAccessProperties: un oggetto DataLakeAccessPropertiesOutput.

  Un DataLakeAccessProperties oggetto con proprietà di input per configurare l'accesso al data lake per la risorsa del catalogo nel AWS Glue Data Catalog.

• IcebergOptimizationProperties: un oggetto IcebergOptimizationPropertiesOutput.

  Un oggetto IcebergOptimizationPropertiesOutput che specifica le impostazioni di ottimizzazione delle tabelle Iceberg per il catalogo, incluse le configurazioni per le operazioni di compattazione, conservazione ed eliminazione dei file orfani.

• CustomProperties: 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.

  Ogni valore è una UTF-8 stringa, lunga non più di 512000 byte.

  Proprietà chiave-valore aggiuntive per il catalogo, come le ottimizzazioni delle statistiche delle colonne.

Campi

• DataLakeAccess: booleano.

  Attiva o disattiva l'accesso al data lake per le applicazioni Apache Spark che accedono ai database Amazon Redshift nel Data Catalog da qualsiasi motore non Redshift, come Amazon Athena, Amazon EMR o ETL. AWS Glue

• DataTransferRole— UTF-8 stringa, corrispondente a. Custom string pattern #50

  Un ruolo che verrà assunto AWS Glue per il trasferimento dei dati into/out del bucket di staging durante una query.

• KmsKey— stringa. UTF-8

  Una chiave di crittografia utilizzata per il bucket di staging che verrà creato insieme al catalogo.

• CatalogType— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Specifica un tipo di catalogo federato per la risorsa del catalogo nativa. Il tipo attualmente supportato è aws:redshift.

Campi

• RoleArn— UTF-8 stringa, corrispondente aCustom string pattern #50.

  Il nome della risorsa Amazon (ARN) del ruolo IAM che deve essere assunto per eseguire le operazioni di ottimizzazione delle tabelle Iceberg.

• Compaction: 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.

  Ogni valore è una UTF-8 stringa, lunga non più di 512000 byte.

  Una mappa di coppie chiave-valore che specificano i parametri di configurazione per le operazioni di compattazione delle tabelle Iceberg, le quali ottimizzano il layout dei file di dati per migliorare le prestazioni delle query.

• Retention: 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.

  Ogni valore è una UTF-8 stringa di lunghezza non superiore a 512000 byte.

  Una mappa di coppie chiave-valore che specificano i parametri di configurazione per le operazioni di conservazione delle tabelle Iceberg, le quali gestiscono il ciclo di vita degli snapshot delle tabelle per controllare i costi di archiviazione.

• OrphanFileDeletion: 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.

  Ogni valore è una UTF-8 stringa di lunghezza non superiore a 512000 byte.

  Una mappa di coppie chiave-valore che specificano i parametri di configurazione per le operazioni di eliminazione dei file orfani di Iceberg, i quali identificano e rimuovono i file a cui non fanno più riferimento i metadati della tabella.

Campi

• DataLakeAccess: booleano.

  Attiva o disattiva l'accesso al data lake per le applicazioni Apache Spark che accedono ai database Amazon Redshift nel Catalogo Dati.

• DataTransferRole— UTF-8 stringa, corrispondente aCustom string pattern #50.

  Un ruolo che verrà assunto AWS Glue per il trasferimento dei dati into/out del bucket di staging durante una query.

• KmsKey— stringa. UTF-8

  Una chiave di crittografia utilizzata per il bucket di staging che verrà creato insieme al catalogo.

• ManagedWorkgroupName— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Il nome del calcolo gestito di Redshift serverless creato per la risorsa del catalogo.

• ManagedWorkgroupStatus— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Lo stato del calcolo gestito di Redshift serverless.

• RedshiftDatabaseName— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Il nome predefinito della risorsa del database Redshift nel calcolo gestito.

• StatusMessage— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Un messaggio che fornisce informazioni più dettagliate sullo stato del gruppo di lavoro gestito.

• CatalogType— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Specifica un tipo di catalogo federato per la risorsa del catalogo nativa. Il tipo attualmente supportato è aws:redshift.

Campi

• RoleArn— UTF-8 stringa, corrispondente a. Custom string pattern #50

  Il nome della risorsa Amazon (ARN) del ruolo IAM utilizzato per eseguire le operazioni di ottimizzazione delle tabelle Iceberg.

• Compaction: 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.

  Ogni valore è una UTF-8 stringa, lunga non più di 512000 byte.

  Una mappa di coppie chiave-valore che specificano i parametri di configurazione per le operazioni di compattazione delle tabelle Iceberg, le quali ottimizzano il layout dei file di dati per migliorare le prestazioni delle query.

• Retention: 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.

  Ogni valore è una UTF-8 stringa di lunghezza non superiore a 512000 byte.

  Una mappa di coppie chiave-valore che specificano i parametri di configurazione per le operazioni di conservazione delle tabelle Iceberg, le quali gestiscono il ciclo di vita degli snapshot delle tabelle per controllare i costi di archiviazione.

• OrphanFileDeletion: 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.

  Ogni valore è una UTF-8 stringa di lunghezza non superiore a 512000 byte.

  Una mappa di coppie chiave-valore che specificano i parametri di configurazione per le operazioni di eliminazione dei file orfani di Iceberg, i quali identificano e rimuovono i file a cui non fanno più riferimento i metadati della tabella.

• LastUpdatedTime: timestamp.

  Il timestamp relativo al momento dell'ultimo aggiornamento delle proprietà di Iceberg.

Campi

• Identifier— UTF-8 stringa, lunga non meno di 1 o più di 512 byte, corrispondente a. Single-line string pattern

  Un identificatore univoco per il catalogo federato.

• ConnectionName— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Il nome della connessione a un'origine dati esterna, ad esempio un Redshift-federated catalogo.

• ConnectionType— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

  Il tipo di connessione utilizzato per accedere al catalogo federato, che specifica il protocollo o il metodo per la connessione all'origine dati esterna.

• CreateCatalog azione (Python: create_catalog)

• UpdateCatalog azione (Python: update_catalog)

• DeleteCatalog azione (Python: delete_catalog)

• GetCatalog azione (Python: get_catalog)

• GetCatalogs azione (Python: get_catalogs)

Richiesta

• Name— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 64 byte, corrispondente a. Custom string pattern #30

  Nome del catalogo da creare.

• CatalogInput - obbligatorio: un oggetto CatalogInput.

  Un oggetto CatalogInput che definisce i metadati per il catalogo.

• Tags: una matrice di mappe con coppie chiave-valore, non superiore alle 50 coppie.

  Ogni chiave è una UTF-8 stringa, lunga non meno di 1 o più di 128 byte.

  Ogni valore è una UTF-8 stringa, lunga non più di 256 byte.

  Una matrice di mappe con coppie chiave-valore, non superiore alle 50 coppie. Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte. Ogni valore è una UTF-8 stringa, lunga non più di 256 byte. I tag assegnati al catalogo.

Risposta

• Nessun parametro di risposta.

Errori

• InvalidInputException

• AlreadyExistsException

• ResourceNumberLimitExceededException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ConcurrentModificationException

• AccessDeniedException

• EntityNotFoundException

• FederatedResourceAlreadyExistsException

• FederationSourceException

Richiesta

• CatalogId - Obbligatorio:: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern

  L'ID del catalogo.

• CatalogInput - obbligatorio: un oggetto CatalogInput.

  Un oggetto CatalogInput che specifica le nuove proprietà di un catalogo esistente.

Risposta

• Nessun parametro di risposta.

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ConcurrentModificationException

• AccessDeniedException

• FederationSourceException

Richiesta

• CatalogId - Obbligatorio:: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern

  L'ID del catalogo.

Risposta

• Nessun parametro di risposta.

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ConcurrentModificationException

• AccessDeniedException

• FederationSourceException

Richiesta

• CatalogId - Obbligatorio:: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern

  L'ID del catalogo padre in cui si trova il catalogo. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato il numero di AWS conto.

Risposta

• Catalog: un oggetto Catalogo.

  Oggetto Catalog. La definizione del catalogo specificato nel catalogo AWS Glue dati.

Errori

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• AccessDeniedException

• EntityNotFoundException

• FederationSourceException

• FederationSourceRetryableException

Richiesta

• ParentCatalogId: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

  L'ID del catalogo padre in cui si trova il catalogo. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato il numero di AWS conto.

• NextToken— UTF-8 stringa.

  Un token di continuazione, se si tratta di una chiamata di continuazione.

• MaxResults: numero (intero), non inferiore a 1 o superiore a 1.000.

  Il numero massimo di cataloghi da restituire in una risposta.

• Recursive: booleano.

  Se elencare tutti i cataloghi nella gerarchia dei cataloghi, a partire da ParentCatalogId. L'impostazione predefinita è false. Quando true, tutti gli oggetti del catalogo nella gerarchia ParentCatalogID vengono enumerati nella risposta.

• IncludeRoot: booleano.

  Se elencare il catalogo predefinito nell'account e nella regione nella risposta. L’impostazione predefinita è false. Quando true e ParentCatalogId = NULL | AWS Account ID, tutti i cataloghi e il catalogo predefinito vengono enumerati nella risposta.

  Quando ParentCatalogId è diverso da nullo e questo attributo viene passato come false o true, viene generato un InvalidInputException.

• HasDatabases: booleano.

  Quandotrue, la risposta include solo i cataloghi che possono contenere database. Alcuni cataloghi sono contenitori organizzativi che contengono solo altri cataloghi, non database. Quando questo parametro è impostato sutrue, i cataloghi contenenti solo contenitori vengono esclusi e vengono restituiti solo i cataloghi in grado di contenere database. L’impostazione predefinita è false.

Risposta

• CatalogList - obbligatorio: una matrice di oggetti Catalogo.

  Un array di oggetti Catalog. Un elenco di oggetti Catalog dal catalogo padre 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

• AccessDeniedException

• EntityNotFoundException

• FederationSourceException

• FederationSourceRetryableException