API Table

• Struttura della tabella

• TableInput struttura

• FederatedTable struttura

• Struttura delle colonne

• StorageDescriptor struttura

• SchemaReference struttura

• SerDeInfo struttura

• Struttura dell'ordine

• SkewedInfo struttura

• TableVersion struttura

• TableError struttura

• TableVersionError struttura

• SortCriterion struttura

• TableIdentifier struttura

• KeySchemaElement struttura

• PartitionIndex struttura

• PartitionIndexDescriptor struttura

• BackfillError struttura

• IcebergInput struttura

• OpenTableFormatInput struttura

• ViewDefinition struttura

• ViewDefinitionInput struttura

• ViewRepresentation struttura

• ViewRepresentationInput struttura

• UpdateOpenTableFormatInput struttura

• UpdateIcebergInput struttura

• CreateIcebergTableInput struttura

• UpdateIcebergTableInput struttura

• IcebergSortOrder struttura

• IcebergSortField struttura

• IcebergPartitionSpec struttura

• IcebergPartitionField struttura

• IcebergSchema struttura

• IcebergStructField struttura

• IcebergTableUpdate struttura

• IcebergTableMetadata struttura

• IcebergEncryptedKey struttura

• TableStatus struttura

• StatusDetails struttura

• ViewValidation struttura

• AuditContext struttura

Campi

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

  Il nome della tabella. Per la compatibilità Hive, deve essere interamente in caratteri minuscoli.

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

  Nome del database dei metadati in cui risiedono i metadati della tabella. Per la compatibilità Hive, deve essere interamente in caratteri minuscoli.

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

  Descrizione della tabella.

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

  Il proprietario della tabella.

• CreateTime: timestamp.

  Ora della creazione della definizione della tabella nel catalogo dati.

• UpdateTime: timestamp.

  L'ultima volta che la tabella è stata aggiornata.

• LastAccessTime: timestamp.

  L'ultima volta che la tabella è stata consultata. Questo dato in genere viene fornito dall'HDFS e potrebbe non essere affidabile.

• LastAnalyzedTime: timestamp.

  L'ultima volta in cui sono state calcolate le statistiche di colonna per questa tabella.

• Retention: numero (intero).

  Tempo di conservazione per questa tabella.

• StorageDescriptor: un oggetto StorageDescriptor.

  Un descrittore di archiviazione contenente informazioni sull'archiviazione fisica di questa tabella.

• PartitionKeys: una matrice di oggetti Colonna.

  Un elenco di colonne in base al quale la tabella è partizionata. Solo i tipi primitivi sono supportati come chiavi di partizione.

  Quando crei una tabella utilizzata da Amazon Athena e non specifichi una partitionKeys, è necessario almeno impostare il valore di partitionKeys su un elenco vuoto. Ad esempio:

  "PartitionKeys": []

• ViewOriginalText— UTF-8 stringa, lunga non più di 409600 byte.

  Incluso per la compatibilità con Apache Hive. Non utilizzato nel normale corso delle operazioni. AWS Glue Se la tabella è unaVIRTUAL_VIEW, determinata Athena configurazione codificata in base64.

• ViewExpandedText— UTF-8 stringa lunga non più di 409600 byte.

  Incluso per la compatibilità con Apache Hive. Non utilizzato nel normale corso delle operazioni. AWS Glue

• TableType— UTF-8 stringa lunga non più di 255 byte.

  Il tipo di questa tabella. AWS Glue creerà tabelle con il EXTERNAL_TABLE tipo. Altri servizi, ad esempio Athena, possono creare tabelle con tipi di tabella aggiuntivi.

  AWS Glue tipi di tabella correlati:

  EXTERNAL_TABLE

  Attributo compatibile con Hive. Indica una tabella non gestita da Hive.

  GOVERNED

  Usato da AWS Lake Formation. Il AWS Glue Data Catalog capisceGOVERNED.

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

  Queste coppie chiave-valore definiscono proprietà associate a questa tabella.

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

  Persona o entità che ha creato la tabella.

• IsRegisteredWithLakeFormation: booleano.

  Indica se la tabella è stata registrata con AWS Lake Formation.

• TargetTable: un oggetto TableIdentifier.

  Una struttura TableIdentifier che descrive una tabella 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.

  L'ID del catalogo dati in cui risiede la tabella.

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

  L'ID della versione della tabella.

• FederatedTable: un oggetto FederatedTable.

  Una struttura FederatedTable che fa riferimento a un'entità esterna al AWS Glue Data Catalog.

• ViewDefinition: un oggetto ViewDefinition.

  Una struttura che contiene tutte le informazioni che definiscono la vista, compresi il dialetto o i dialetti della vista, e la query.

• IsMultiDialectView: booleano.

  Specifica se la vista supporta i dialetti SQL di uno o più motori di query diversi e può quindi essere letta da tali motori.

• IsMaterializedView: booleano.

  Indica che una tabella è unMaterializedView.

• IcebergTableMetadata: un oggetto IcebergTableMetadata.

  I metadati più recenti della tabella Apache Iceberg per la tabella, inclusi la versione del formato, gli schemi, le specifiche delle partizioni e i criteri di ordinamento. Questo campo è compilato per le tabelle Iceberg e riflette lo stato corrente dei metadati Iceberg della tabella.

• Status: un oggetto TableStatus.

  Indica lo stato di una modifica asincrona a una tabella.

Campi

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

  Il nome della tabella. 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.

  Descrizione della tabella.

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

  Il proprietario della tabella. Incluso per la compatibilità con Apache Hive. Non utilizzata nel normale corso delle AWS Glue operazioni.

• LastAccessTime: timestamp.

  L'ultima volta che la tabella è stata consultata.

• LastAnalyzedTime: timestamp.

  L'ultima volta in cui sono state calcolate le statistiche di colonna per questa tabella.

• Retention: numero (intero).

  Tempo di conservazione per questa tabella.

• StorageDescriptor: un oggetto StorageDescriptor.

  Un descrittore di archiviazione contenente informazioni sull'archiviazione fisica di questa tabella.

• PartitionKeys: una matrice di oggetti Colonna.

  Un elenco di colonne in base al quale la tabella è partizionata. Solo i tipi primitivi sono supportati come chiavi di partizione.

  Quando crei una tabella utilizzata da Amazon Athena e non specifichi una partitionKeys, è necessario almeno impostare il valore di partitionKeys su un elenco vuoto. Ad esempio:

  "PartitionKeys": []

• ViewOriginalText— UTF-8 stringa lunga non più di 409600 byte.

  Incluso per la compatibilità con Apache Hive. Non utilizzato nel normale corso delle operazioni. AWS Glue Se la tabella è unaVIRTUAL_VIEW, determinata Athena configurazione codificata in base64.

• ViewExpandedText— UTF-8 stringa lunga non più di 409600 byte.

  Incluso per la compatibilità con Apache Hive. Non utilizzato nel normale corso delle operazioni. AWS Glue

• TableType— UTF-8 stringa lunga non più di 255 byte.

  Il tipo di questa tabella. AWS Glue creerà tabelle con il EXTERNAL_TABLE tipo. Altri servizi, ad esempio Athena, possono creare tabelle con tipi di tabella aggiuntivi.

  AWS Glue tipi di tabella correlati:

  EXTERNAL_TABLE

  Attributo compatibile con Hive. Indica una tabella non gestita da Hive.

  GOVERNED

  Usato da AWS Lake Formation. Il AWS Glue Data Catalog capisceGOVERNED.

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

  Queste coppie chiave-valore definiscono proprietà associate a questa tabella.

• TargetTable: un oggetto TableIdentifier.

  Una struttura TableIdentifier che descrive una tabella di destinazione per il collegamento delle risorse.

• ViewDefinition: un oggetto ViewDefinitionInput.

  Una struttura che contiene tutte le informazioni che definiscono la vista, compresi il dialetto o i dialetti della vista, e la query.

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 la tabella federata.

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

  Un identificatore univoco per la tabella federata.

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

  Il nome della connessione al metastore esterno.

• 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 alla tabella federata, che specifica il protocollo o il metodo per la connessione all'origine dati esterna.

Campi

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

  Nome della Column.

• Type— UTF-8 stringa, lunga non più di 131072 byte, corrispondente a. Single-line string pattern

  Il tipo di dati di Column.

• Comment: stringa di commento, non superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

  Commento con testo in formato libero.

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

  Queste coppie chiave-valore definiscono proprietà associate alla colonna.

Campi

• Columns: una matrice di oggetti Colonna.

  Un elenco delle Columns nella tabella.

• Location: stringa di posizione, non superiore a 2056 byte di lunghezza, corrispondente a URI address multi-line string pattern.

  La posizione fisica della tabella. Per default utilizza il formato della posizione del warehouse, seguita dalla posizione del database nel warehouse, seguita dal nome della tabella.

• AdditionalLocations— Una serie di UTF-8 stringhe.

  Un elenco di posizioni che puntano al percorso in cui si trova una tabella Delta.

• InputFormat: stringa di formato, non superiore a 128 byte di lunghezza, corrispondente a Single-line string pattern.

  Il formato di input: SequenceFileInputFormat (binario) o TextInputFormat o un formato personalizzato.

• OutputFormat: stringa di formato, non superiore a 128 byte di lunghezza, corrispondente a Single-line string pattern.

  Il formato di output: SequenceFileOutputFormat (binario) o IgnoreKeyTextOutputFormat o un formato personalizzato.

• Compressed: booleano.

  True se i dati nella tabella sono compressi, in caso contrario False.

• NumberOfBuckets: numero (intero).

  Deve essere specificato se la tabella contiene una qualsiasi colonna di dimensione.

• SerdeInfo: un oggetto SerDeInfo.

  Le informazioni serialization/deserialization (SerDe).

• BucketColumns— Una serie di UTF-8 stringhe.

  Un elenco di colonne per il raggruppamento del reducer, colonne di clustering, colonne di bucketing nella tabella.

• SortColumns: una matrice di oggetti Ordine.

  Un elenco specificando l'ordine di ciascuna bucket nella tabella.

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

  Le proprietà fornite dall'utente nel modulo chiave-valore.

• SkewedInfo: un oggetto SkewedInfo.

  Informazioni sui valori che appaiono di frequente in una colonna (valori disallineati).

• StoredAsSubDirectories: booleano.

  True se i dati nella tabella sono archiviati nelle sottodirectory, in caso contrario False.

• SchemaReference: un oggetto SchemaReference.

  Un oggetto che fa riferimento a uno schema memorizzato nel registro degli AWS Glue schemi.

  Quando crei una tabella, puoi passare un elenco vuoto di colonne per lo schema e utilizzare invece un riferimento allo schema.

Campi

• SchemaId: un oggetto SchemaId.

  Una struttura che contiene campi di identità dello schema. Deve essere fornito questo o SchemaVersionId.

• SchemaVersionId— UTF-8 stringa, lunga non meno di 36 o più di 36 byte, corrispondente a. Custom string pattern #42

  L'ID univoco assegnato a una versione dello schema. Deve essere fornito questo o SchemaId.

• SchemaVersionNumber: numero (intero), non inferiore a 1 o superiore a 100000.

  Il numero di versione dello schema.

Campi

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

  Nome di. SerDe

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

  Di solito la classe che implementa il. SerDe Un esempio è org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe.

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

  Queste coppie chiave-valore definiscono i parametri di inizializzazione per. SerDe

Campi

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

  Il nome della colonna.

• SortOrder - obbligatorio: numero (intero), non superiore a 1.

  Indica che la colonna è in ordine crescente (== 1) o in ordine decrescente (==0).

Campi

• SkewedColumnNames— Una serie di UTF-8 stringhe.

  Un elenco di nomi delle colonne contenenti i valori disallineati.

• SkewedColumnValues— Una serie di UTF-8 stringhe.

  Un elenco di valori che appaiono così frequentemente da poter essere considerati disallineati.

• SkewedColumnValueLocationMaps: una matrice della mappa di coppie chiave-valore.

  Ogni chiave è una UTF-8 stringa.

  Ogni valore è una UTF-8 stringa.

  Una mappatura di valori disallineati per le colonne che li contengono.

Campi

• Table: un oggetto Tabella.

  La tabella in questione

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

  Il valore ID identificativo di questa versione della tabella. VersionId è una rappresentazione di stringa di un numero intero. Ogni versione viene incrementata di 1.

Campi

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

  Nome della tabella. Per la compatibilità Hive, deve essere interamente in caratteri minuscoli.

• ErrorDetail: un oggetto ErrorDetail.

  I dettagli sull'errore.

Campi

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

  Nome della tabella in questione.

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

  Il valore ID della versione in questione. VersionID è una rappresentazione di stringa di un numero intero. Ogni versione viene incrementata di 1.

• ErrorDetail: un oggetto ErrorDetail.

  I dettagli sull'errore.

Campi

• FieldName: stringa Value, non inferiore a 1 o superiore a 1024 byte di lunghezza.

  Il nome del campo in base al quale eseguire l'ordinamento.

• Sort— UTF-8 stringa (valori validi: ASC="ASCENDING" |DESC="DESCENDING").

  Un ordinamento crescente o decrescente.

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 dati in cui risiede la tabella.

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

  Il nome del database di catalogo che contiene la tabella di destinazione.

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

  Il nome della tabella di destinazione.

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

  La regione della tabella di destinazione.

Campi

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

  Il nome di una chiave di partizione.

• Type— Obbligatoria: UTF-8 stringa, lunga non più di 131072 byte, corrispondente a. Single-line string pattern

  Il tipo di una chiave di partizione.

Campi

• Keys— Obbligatorio: una matrice di UTF-8 stringhe, almeno 1 stringa.

  Le chiavi per l'indice della partizione.

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

  Il nome dell'indice della partizione.

Campi

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

  Il nome dell'indice della partizione.

• Keys - obbligatorio: una matrice di oggetti KeySchemaElement, almeno 1 struttura.

  Un elenco di una o più chiavi, come strutture KeySchemaElement, per l'indice della partizione.

• IndexStatus— Obbligatorio: UTF-8 stringa (valori validi: CREATING | ACTIVE | DELETING |FAILED).

  Lo stato dell'indice della partizione.

  I possibili stati sono:

  • CREATING: l'indice è in fase di creazione. Quando un indice è in uno stato CREATING, l'indice o la relativa tabella non possono essere eliminati.

  • ACTIVE: la creazione dell'indice ha esito positivo.

  • FAILED: la creazione dell'indice non riesce.

  • DELETING: l'indice viene eliminato dall'elenco degli indici.

• BackfillErrors: una matrice di oggetti BackfillError.

  Un elenco degli errori che possono verificarsi durante la registrazione degli indici delle partizioni per una tabella esistente.

• EncryptedPartitionError: Le partizioni sono crittografate.

• InvalidPartitionTypeDataError: il valore della partizione non corrisponde al tipo di dati per quella colonna di partizione.

• MissingPartitionValueError: le partizioni sono crittografate.

• UnsupportedPartitionCharacterError: i caratteri all'interno del valore della partizione non sono supportati. Ad esempio: U+0000, U+0001, U+0002.

• InternalError: Qualsiasi errore che non appartiene ad altri codici di errore.

Campi

• Code— UTF-8 stringa (valori validi: ENCRYPTED_PARTITION_ERROR | INTERNAL_ERROR | INVALID_PARTITION_TYPE_DATA_ERROR | MISSING_PARTITION_VALUE_ERROR |UNSUPPORTED_PARTITION_CHARACTER_ERROR).

  Il codice di errore per un errore che si è verificato durante la registrazione degli indici delle partizioni per una tabella esistente.

• Partitions: una matrice di oggetti PartitionValueList.

  Un elenco di un numero limitato di partizioni nella risposta.

Campi

• MetadataOperation— Obbligatorio: UTF-8 stringa (valori validi:CREATE).

  Un'operazione sui metadati richiesta. Questa opzione può essere impostata solo su CREATE.

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

  La versione della tabella per le tabelle Iceberg. L'impostazione predefinita è 2.

• CreateIcebergTableInput: un oggetto CreateIcebergTableInput.

  I parametri di configurazione necessari per creare una nuova tabella Iceberg nel AWS Glue Data Catalog, incluse le proprietà della tabella e le specifiche dei metadati.

Campi

• IcebergInput: un oggetto IcebergInput.

  Specifica una struttura IcebergInput che definisce una tabella di metadati di Apache Iceberg.

Campi

• IsProtected: booleano.

  È possibile impostare questo flag come true per ordinare al motore di non inviare le operazioni fornite dall'utente nel piano logico della vista durante la pianificazione delle query. Tuttavia, l'impostazione di questo flag non garantisce che il motore rispetti l'ordine. Consultare la documentazione del motore per comprendere le eventuali garanzie fornite.

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

  Il definitore in una vista in SQL.

• ViewVersionId— Numero (lungo), almeno -1.

  Il valore ID che identifica la versione di questa vista. Per le viste materializzate, l'ID della versione è l'ID dello snapshot della tabella Apache Iceberg.

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

  L'ID della versione della tabella Apache Iceberg.

• RefreshSeconds: numero (lungo).

  Intervallo di aggiornamento automatico in secondi per la vista materializzata. Se non viene specificato, la vista non verrà aggiornata automaticamente.

• LastRefreshType— UTF-8 stringa (valori validi: FULL |INCREMENTAL).

  Imposta il metodo utilizzato per l'aggiornamento più recente.

• SubObjects— Una serie di UTF-8 stringhe, non più di 10 stringhe.

  Un elenco di nomi della risorsa Amazon (ARN) della tabella.

• SubObjectVersionIds— Una matrice di numeri interi con segno a 64 bit, non più di 250 numeri.

  Elenco delle versioni della tabella Apache Iceberg a cui fa riferimento la vista materializzata.

• Representations: una matrice di oggetti ViewRepresentation, non inferiore a 1 o superiore a 1.000 strutture.

  Un elenco di rappresentazioni.

Campi

• IsProtected: booleano.

  È possibile impostare questo flag come true per ordinare al motore di non inviare le operazioni fornite dall'utente nel piano logico della vista durante la pianificazione delle query. Tuttavia, l'impostazione di questo flag non garantisce che il motore rispetti l'ordine. Consultare la documentazione del motore per comprendere le eventuali garanzie fornite.

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

  Il definitore in una vista in SQL.

• Representations— Una serie di ViewRepresentationInput oggetti, non meno di 1 o più di 10 strutture.

  Un elenco di strutture contenente il dialetto della vista e la query che la definisce.

• ViewVersionId— Numero (lungo), almeno -1.

  Il valore ID che identifica la versione di questa vista. Per le viste materializzate, l'ID della versione è l'ID dello snapshot della tabella Apache Iceberg.

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

  L'ID della versione della tabella Apache Iceberg.

• RefreshSeconds: numero (lungo).

  Intervallo di aggiornamento automatico in secondi per la vista materializzata. Se non viene specificato, la vista non verrà aggiornata automaticamente.

• LastRefreshType— UTF-8 stringa (valori validi: FULL |INCREMENTAL).

  Il tipo di ultimo aggiornamento della vista materializzata. Valori validi: Full, Incremental.

• SubObjects— Una serie di UTF-8 stringhe, non più di 10 stringhe.

  Un elenco di ARN della tabella di base che compongono la vista.

• SubObjectVersionIds— Una matrice di numeri interi con segno a 64 bit, non più di 250 numeri.

  Elenco delle versioni della tabella Apache Iceberg a cui fa riferimento la vista materializzata.

Campi

• Dialect— UTF-8 stringa (valori validi: REDSHIFT | ATHENA |SPARK).

  Il dialetto del motore di query.

• DialectVersion— UTF-8 stringa, lunga non meno di 1 o più di 255 byte.

  La versione del dialetto del motore di query. Ad esempio, 3.0.0.

• ViewOriginalText— UTF-8 stringa di lunghezza non superiore a 409600 byte.

  La query SELECT fornita dal cliente durante CREATE VIEW DDL. Questo codice SQL non viene utilizzato durante la query su una vista (viene invece utilizzato ViewExpandedText). ViewOriginalText viene usato in casi come SHOW CREATE VIEW in cui gli utenti desiderano vedere il comando DDL originale che ha creato la vista.

• ViewExpandedText— UTF-8 stringa, lunga non più di 409600 byte.

  L'SQL esteso per la vista. Questo SQL viene utilizzato dai motori durante l'elaborazione di una query su una vista. I motori possono eseguire operazioni durante la creazione della vista per trasformare ViewOriginalText in ViewExpandedText. Ad esempio:

  • Identificatori completi: SELECT * from table1 -> SELECT * from db1.table1

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

  Il nome della connessione da utilizzare per convalidare la rappresentazione specifica della vista.

• IsStale: booleano.

  I dialetti contrassegnati come obsoleti non sono più validi e devono essere aggiornati prima che sia possibile eseguire query nei rispettivi motori di query.

Campi

• Dialect— UTF-8 stringa (valori validi: REDSHIFT | ATHENA |SPARK).

  Un parametro che specifica il tipo di motore di una rappresentazione specifica.

• DialectVersion— UTF-8 stringa, lunga non meno di 1 o più di 255 byte.

  Un parametro che specifica la versione del motore di una rappresentazione specifica.

• ViewOriginalText— UTF-8 stringa di lunghezza non superiore a 409600 byte.

  Una stringa che rappresenta la query SQL originale che descrive la vista.

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

  Il nome della connessione da utilizzare per convalidare la rappresentazione specifica della vista.

• ViewExpandedText— UTF-8 stringa, lunga non più di 409600 byte.

  Una stringa che rappresenta la query SQL che descrive la vista con gli ARN delle risorse estesi.

Campi

• UpdateIcebergInput: un oggetto UpdateIcebergInput.

  Parametri di Iceberg-specific aggiornamento di Apache che definiscono le modifiche alla tabella da applicare, incluse le modifiche allo schema, le specifiche delle partizioni e le proprietà della tabella.

Campi

• UpdateIcebergTableInput - obbligatorio: oggetto UpdateIcebergTableInput.

  Le operazioni di aggiornamento specifiche da applicare alla tabella Iceberg, contenenti un elenco di aggiornamenti che definiscono il nuovo stato della tabella, tra cui schema, partizioni e proprietà.

Campi

• Location - obbligatorio, stringa di posizione, non superiore a 2056 byte di lunghezza, corrispondente a URI address multi-line string pattern.

  La posizione S3 in cui saranno archiviati i dati della tabella Iceberg.

• Schema - obbligatorio: oggetto IcebergSchema.

  La definizione dello schema che specifica la struttura, i tipi di campo e i metadati della tabella Iceberg.

• PartitionSpec: un oggetto IcebergPartitionSpec.

  La specifica di partizionamento che definisce come saranno organizzati e partizionati i dati della tabella Iceberg per garantire prestazioni di query ottimali.

• WriteOrder: un oggetto IcebergSortOrder.

  La specifica di ordinamento che definisce come devono essere ordinati i dati all'interno di ogni partizione per ottimizzare le prestazioni di query.

• Properties: una matrice della mappa di coppie chiave-valore.

  Ogni chiave è una stringa. UTF-8

  Ogni valore è una UTF-8 stringa.

  Key-value coppie di proprietà e impostazioni di configurazione aggiuntive per la tabella Iceberg.

Campi

• Updates - obbligatorio: una matrice di oggetti IcebergTableUpdate.

  L'elenco delle operazioni di aggiornamento della tabella che specificano le modifiche da apportare alla tabella Iceberg, tra cui modifiche dello schema, specifiche di partizione e proprietà della tabella.

Campi

• OrderId - obbligatorio: numero (intero).

  L'identificatore univoco per questa specifica di ordinamento all'interno dei metadati della tabella Iceberg.

• Fields - obbligatorio: una matrice di oggetti IcebergSortField.

  L'elenco dei campi e delle relative direzioni di ordinamento che definiscono i criteri di ordinamento per i dati della tabella Iceberg.

Campi

• SourceId - obbligatorio: numero (intero).

  L'identificatore del campo di origine dallo schema della tabella su cui è basato questo campo di ordinamento.

• Transform— Obbligatorio: UTF-8 stringa.

  La funzione di trasformazione applicata al campo di origine prima dell'ordinamento, come identità, bucket o troncamento.

• Direction— Obbligatorio: UTF-8 stringa (valori validi: asc="ASC" |desc="DESC").

  La direzione di ordinamento di questo campo, ascendente o discendente.

• NullOrder— Obbligatorio: UTF-8 stringa (valori validi: nulls-first="NULLS_FIRST" |nulls-last="NULLS_LAST").

  Il comportamento di ordinamento dei valori null in questo campo, che specifica se tali valori devono comparire per primi o per ultimi nell'ordinamento.

Campi

• Fields - obbligatorio: una matrice di oggetti IcebergPartitionField.

  L'elenco dei campi di partizione che definiscono come devono essere partizionati i dati della tabella, compresi i campi di origine e le relative trasformazioni.

• SpecId: numero (intero).

  L'identificatore univoco per questa specifica di partizione all'interno della cronologia dei metadati della tabella Iceberg.

Campi

• SourceId - obbligatorio: numero (intero).

  L'identificatore del campo di origine dallo schema della tabella su cui è basato questo campo di partizione.

• Transform— Obbligatorio: UTF-8 stringa.

  La funzione di trasformazione applicata al campo di origine per creare la partizione, come identità, bucket, troncamento, anno, mese, giorno oppure ora.

• Name— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 1024 byte, corrispondente a. Single-line string pattern

  Il nome del campo di partizione come verrà visualizzato nella struttura della tabella partizionata.

• FieldId: numero (intero).

  L'identificatore univoco assegnato a questo campo di partizione all'interno della specifica di partizione della tabella Iceberg.

Campi

• SchemaId: numero (intero).

  L'identificatore univoco di questa versione dello schema all'interno della storia di evoluzione dello schema della tabella Iceberg.

• IdentifierFieldIds: una matrice di numeri interi a 32 bit firmati.

  L'elenco di identificatori dei campi che identificano in modo univoco i record nella tabella, utilizzati nelle operazioni e nella deduplicazione a livello di riga.

• Type— UTF-8 stringa (valori validi:struct="STRUCT").

  Il tipo di root della struttura dello schema, generalmente “struct” per gli schemi delle tabelle Iceberg.

• Fields - obbligatorio: una matrice di oggetti IcebergStructField.

  L'elenco delle definizioni dei campi che costituiscono lo schema della tabella, tra cui nomi e tipi di campi e metadati.

Campi

• Id - obbligatorio: numero (intero).

  L'identificatore univoco assegnato a questo campo all'interno dello schema della tabella Iceberg, utilizzato per l'evoluzione dello schema e il monitoraggio dei campi.

• Name— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 1024 byte, corrispondente a. Single-line string pattern

  Il nome del campo come visualizzato nello schema della tabella e nelle operazioni di query.

• Type -obbligatorio, una struttura vuota chiamata IcebergDocument.

  La definizione del tipo di dati di questo campo, che specifica la struttura e il formato dei dati in esso contenuti.

• Required - obbligatorio: booleano.

  Indica se questo campo è obbligatorio (non ammette valori null) o facoltativo (ammette valori null) nello schema della tabella.

• Doc: stringa di commento, non superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

  Documentazione o descrizione in formato testuale facoltative che forniscono contesto aggiuntivo sullo scopo e sull'utilizzo di questo campo.

• InitialDefault— Una struttura vuota denominata. IcebergDocument

  Valore predefinito utilizzato per compilare il valore del campo per tutti i record scritti prima dell'aggiunta del campo allo schema. Ciò consente la compatibilità con le versioni precedenti quando si aggiungono nuovi campi alle tabelle Iceberg esistenti.

• WriteDefault— Una struttura vuota denominata. IcebergDocument

  Valore predefinito utilizzato per compilare il valore del campo per tutti i record scritti dopo che il campo è stato aggiunto allo schema, se l'autore non fornisce il valore del campo. Questo può essere modificato tramite l'evoluzione dello schema.

Campi

• Schema - obbligatorio: oggetto IcebergSchema.

  La definizione dello schema aggiornata per la tabella Iceberg, che specifica eventuali modifiche alla struttura dei campi, ai tipi di dati o ai metadati dello schema.

• PartitionSpec: un oggetto IcebergPartitionSpec.

  La specifica di partizionamento aggiornata che definisce il modo in cui devono essere riorganizzati e partizionati i dati della tabella.

• SortOrder: un oggetto IcebergSortOrder.

  La specifica di ordinamento aggiornata che definisce come devono essere ordinati i dati all'interno delle partizioni per garantire prestazioni di query ottimali.

• Location - obbligatorio, stringa di posizione, non superiore a 2056 byte di lunghezza, corrispondente a URI address multi-line string pattern.

  La posizione S3 aggiornata in cui saranno archiviati i dati della tabella Iceberg.

• Properties: una matrice della mappa di coppie chiave-valore.

  Ogni chiave è una UTF-8 stringa.

  Ogni valore è una UTF-8 stringa.

  Le coppie chiave-valore aggiornate di proprietà della tabella e le impostazioni di configurazione della tabella Iceberg.

• Action— UTF-8 stringa (valori validi: add-schema="ADD_SCHEMA" set-current-schema="SET_CURRENT_SCHEMA" | add-spec="ADD_SPEC" | | set-default-spec="SET_DEFAULT_SPEC" | add-sort-order="ADD_SORT_ORDER" | set-default-sort-order="SET_DEFAULT_SORT_ORDER" | set-location="SET_LOCATION" | set-properties="SET_PROPERTIES" | remove-properties="REMOVE_PROPERTIES" | add-encryption-key="ADD_ENCRYPTION_KEY" |remove-encryption-key="REMOVE_ENCRYPTION_KEY").

  Il tipo di azione di aggiornamento da eseguire sulla tabella Iceberg. Definisce l'operazione specifica, ad esempio l'aggiunta dello schema, l'impostazione dello schema corrente, l'aggiunta di specifiche di partizione o la gestione delle chiavi di crittografia.

• EncryptionKey: un oggetto IcebergEncryptedKey.

  Informazioni sulla chiave di crittografia associate a un'operazione di aggiornamento della tabella Iceberg. Utilizzato per aggiungere o rimuovere chiavi di crittografia dai metadati della tabella durante l'evoluzione della tabella.

• KeyId— UTF-8 stringa, lunga non più di 2056 byte, corrispondente a. URI address multi-line string pattern

  Identificatore della chiave di crittografia coinvolta in un'operazione di aggiornamento della tabella Iceberg. Fa riferimento alla chiave specifica che viene aggiunta o rimossa dalla configurazione di crittografia della tabella.

Campi

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

  La versione in formato tabella Apache Iceberg, ad esempio o. 1 2 Determina l'insieme di funzionalità e il layout su disco supportati dalla tabella.

• TableUuid— UTF-8 stringa, lunga non più di 100 byte, corrispondente a. Single-line string pattern

  L'identificatore univoco (UUID) per la tabella Iceberg, assegnato al momento della creazione della tabella e utilizzato per tenere traccia della tabella attraverso gli aggiornamenti dei metadati.

• Location: stringa di posizione, non superiore a 2056 byte di lunghezza, corrispondente a URI address multi-line string pattern.

  La posizione S3 di base in cui sono archiviati i dati e i file di metadati della tabella Iceberg.

• Properties: una matrice della mappa di coppie chiave-valore.

  Ogni chiave è una stringa. UTF-8

  Ogni valore è una UTF-8 stringa.

  Una mappa di coppie chiave-valore che definiscono le proprietà a livello di tabella e le impostazioni di configurazione per la tabella Iceberg.

• Schemas: una matrice di oggetti IcebergSchema.

  L'elenco degli schemi che sono stati associati alla tabella Iceberg nel corso della sua storia, supportando l'evoluzione degli schemi.

• CurrentSchemaId: numero (intero).

  L'identificatore dello schema attualmente attivo per la tabella Iceberg. Corrisponde a una voce in. Schemas

• LastColumnId: numero (intero).

  L'identificatore di colonna più alto assegnato nello schema della tabella Iceberg, utilizzato per garantire ID univoci man mano che vengono aggiunte nuove colonne.

• PartitionSpecs: una matrice di oggetti IcebergPartitionSpec.

  L'elenco delle specifiche di partizione che sono state associate alla tabella Iceberg nel corso della sua storia, supportando l'evoluzione delle partizioni.

• DefaultSpecId: numero (intero).

  L'identificatore della specifica di partizione attualmente utilizzato per impostazione predefinita quando si scrivono nuovi dati nella tabella Iceberg.

• LastPartitionId: numero (intero).

  L'identificatore del campo di partizione più alto che è stato assegnato nelle specifiche di partizione della tabella.

• SortOrders: una matrice di oggetti IcebergSortOrder.

  L'elenco delle specifiche di ordinamento che sono state associate alla tabella Iceberg nel corso della sua cronologia.

• DefaultSortOrderId: numero (intero).

  L'identificatore del criterio di ordinamento attualmente utilizzato per impostazione predefinita quando si scrivono nuovi dati nella tabella Iceberg.

Campi

• KeyId— Obbligatoria: UTF-8 stringa, lunga non più di 2056 byte, corrispondente a. URI address multi-line string pattern

  Identificatore univoco della chiave di crittografia utilizzata per la crittografia delle tabelle Iceberg. Questo ID viene utilizzato per fare riferimento alla chiave nei metadati della tabella e tenere traccia della chiave utilizzata per crittografare dati specifici.

• EncryptedKeyMetadata— Obbligatorio: UTF-8 stringa, lunga non più di 2056 byte, corrispondente a. URI address multi-line string pattern

  Chiave e metadati crittografati, codificati in base64. Il formato dei metadati delle chiavi crittografate è determinato dallo schema di crittografia della tabella e può essere un formato unificato specifico del provider KMS della tabella.

• EncryptedById— UTF-8 stringa, lunga non più di 2056 byte, corrispondente a. URI address multi-line string pattern

  ID opzionale della chiave utilizzata per crittografare o racchiudere i metadati della chiave nella crittografia delle tabelle Iceberg. Questo campo fa riferimento a un'altra chiave di crittografia utilizzata per crittografare i metadati della chiave corrente.

• Properties: una matrice della mappa di coppie chiave-valore.

  Ogni chiave è una stringa. UTF-8

  Ogni valore è una UTF-8 stringa.

  Una mappa da stringa a stringa di metadati aggiuntivi utilizzati dallo schema di crittografia della tabella. Queste proprietà forniscono un contesto e una configurazione aggiuntivi per l'implementazione della chiave di crittografia.

Campi

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

  L'ARN dell'utente che ha richiesto la modifica asincrona.

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

  L'ARN dell'utente che modifica manualmente per ultimo la modifica asincrona (richiesta di cancellazione, ecc.).

• RequestTime: timestamp.

  Una stringa di data in formato ISO 8601 che indica l'ora in cui è stata avviata la modifica.

• UpdateTime: timestamp.

  Una stringa di data in formato ISO 8601 che indica l'ora dell'ultimo aggiornamento dello stato.

• Action— UTF-8 stringa (valori validi: UPDATE |CREATE).

  Indica quale azione è stata richiamata sulla tabella, attualmente solo CREATE oUPDATE.

• State— UTF-8 stringa (valori validi: QUEUED | IN_PROGRESS | SUCCESS | STOPPED |FAILED).

  Uno stato generico per la modifica in corso, ad esempio QUEUED, IN_PROGRESS, SUCCESS o FAILED.

• Error: un oggetto ErrorDetail.

  Un errore che appare solo quando lo stato è «FALLITO». Questo è un messaggio di eccezione a livello principale, potrebbero esserci diverse Error s per ogni dialetto.

• Details: un oggetto StatusDetails.

  Un StatusDetails oggetto con informazioni sulla modifica richiesta.

Campi

• RequestedChange: un oggetto Tabella.

  Un Table oggetto che rappresenta le modifiche richieste.

• ViewValidations: una matrice di oggetti ViewValidation.

  Un elenco di ViewValidation oggetti che contengono informazioni per un motore analitico per convalidare una vista.

Campi

• Dialect— UTF-8 stringa (valori validi: REDSHIFT | ATHENA |SPARK).

  Il dialetto del motore di query.

• DialectVersion— UTF-8 stringa, lunga non meno di 1 o più di 255 byte.

  La versione del dialetto del motore di query. Ad esempio, 3.0.0.

• ViewValidationText— UTF-8 stringa lunga non più di 409600 byte.

  La SELECT query che definisce la visualizzazione, fornita dal cliente.

• UpdateTime: timestamp.

  L'ora dell'ultimo aggiornamento.

• State— UTF-8 stringa (valori validi: QUEUED | IN_PROGRESS | SUCCESS | STOPPED |FAILED).

  Lo stato della convalida.

• Error: un oggetto ErrorDetail.

  Un errore associato alla convalida.

Campi

• AdditionalAuditContext— UTF-8 stringa lunga non più di 2048 byte.

  Una stringa contenente le informazioni aggiuntive sul contesto di verifica.

• RequestedColumns— Una serie di UTF-8 stringhe.

  Le colonne richieste per l'audit.

• AllColumnsRequested: booleano.

  Tutte le colonne richiedono l'audit.

• CreateTable azione (Python: create_table)

• UpdateTable azione (Python: update_table)

• DeleteTable azione (Python: delete_table)

• BatchDeleteTable azione (Python: batch_delete_table)

• GetTable azione (Python: get_table)

• GetTables azione (Python: get_tables)

• GetTableVersion azione (Python: get_table_version)

• GetTableVersions azione (Python: get_table_versions)

• DeleteTableVersion azione (Python: delete_table_version)

• BatchDeleteTableVersion azione (Python: batch_delete_table_version)

• SearchTables azione (Python: search_tables)

• GetPartitionIndexes azione (Python: get_partition_indexes)

• CreatePartitionIndex azione (Python: create_partition_index)

• DeletePartitionIndex azione (Python: delete_partition_index)

• GetColumnStatisticsForTable azione (Python: get_column_statistics_for_table)

• UpdateColumnStatisticsForTable azione (Python: update_column_statistics_for_table)

• DeleteColumnStatisticsForTable azione (Python: delete_column_statistics_for_table)

Richiesta

• 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 dati in cui creare la Table. Se non ne viene fornito nessuno, l'ID dell' AWS account viene utilizzato per impostazione predefinita.

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il database del catalogo in cui creare la nuova tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

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

  L'identificatore univoco per la tabella all'interno del database specificato che verrà creata nel catalogo AWS Glue dati.

• TableInput: un oggetto TableInput.

  L'oggetto TableInput che definisce la tabella di metadati da creare nel catalogo.

• PartitionIndexes: una matrice di oggetti PartitionIndex.

  Un elenco di indici delle partizioni, PartitionIndex strutture, da creare nella tabella.

• TransactionId— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Custom string pattern #41

  L'ID della transazione.

• OpenTableFormatInput: un oggetto OpenTableFormatInput.

  Specifica una struttura OpenTableFormatInput durante la creazione di una tabella in formato aperto.

Risposta

• Nessun parametro di risposta.

Errori

• AlreadyExistsException

• InvalidInputException

• EntityNotFoundException

• ResourceNumberLimitExceededException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ConcurrentModificationException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

Richiesta

• 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 dati in cui risiede la tabella Se non viene fornito, l'ID dell' AWS account viene utilizzato per impostazione predefinita.

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il nome del database del catalogo in cui risiede la tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

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

  L'identificatore univoco per la tabella all'interno del database specificato che verrà creata nel catalogo AWS Glue dati.

• TableInput: un oggetto TableInput.

  Un'oggetto TableInput avanzato per la definizione della tabella di metadati nel catalogo.

• SkipArchive: booleano.

  Per impostazione predefinita, UpdateTable crea sempre una versione archiviata della tabella prima di aggiornarla. Se tuttavia skipArchive è impostato su true, UpdateTable non crea la versione archiviata.

• TransactionId— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Custom string pattern #41

  ID transazione in cui aggiornare il contenuto della tabella.

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

  ID della versione in cui aggiornare il contenuto della tabella.

• ViewUpdateAction— UTF-8 stringa (valori validi: ADD | | REPLACE ADD_OR_REPLACE |DROP).

  L'operazione da eseguire durante l'aggiornamento della vista.

• Force: booleano.

  Un flag che può essere impostato su true per ignorare i requisiti di corrispondenza di descrittore di archiviazione e oggetto secondario.

• UpdateOpenTableFormatInput: un oggetto UpdateOpenTableFormatInput.

  Parametri di input per l'aggiornamento delle tabelle in formato di tabella aperte in AWS Glue Data Catalog, che fungono da wrapper per operazioni di aggiornamento specifiche del formato come Apache Iceberg.

Risposta

• Nessun parametro di risposta.

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

• ResourceNumberLimitExceededException

• GlueEncryptionException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

• AlreadyExistsException

Richiesta

• 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 dati in cui risiede la tabella Se non viene fornito, l'ID dell' AWS account viene utilizzato per impostazione predefinita.

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il nome del database del catalogo in cui risiede la tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

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

  Il nome della tabella da eliminare. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

• TransactionId— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Custom string pattern #41

  ID transazione in cui eliminare il contenuto della tabella.

Risposta

• Nessun parametro di risposta.

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

Richiesta

• 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 dati in cui risiede la tabella Se non viene fornito, l'ID dell' AWS account viene utilizzato per impostazione predefinita.

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il nome del database del catalogo in cui risiede la tabella da eliminare. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

• TablesToDelete— Obbligatorio: una matrice di UTF-8 stringhe, non più di 100 stringhe.

  Un elenco della tabella da eliminare.

• TransactionId— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Custom string pattern #41

  ID transazione in cui eliminare il contenuto della tabella.

Risposta

• Errors: una matrice di oggetti TableError.

  Un elenco di errori riscontrati nel tentativo di eliminazione delle tabelle specificate.

Errori

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ResourceNotReadyException

Richiesta

• 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 dati in cui risiede la tabella Se non ne viene fornito nessuno, l'ID dell' AWS account viene utilizzato per impostazione predefinita.

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il nome del database nel catalogo in cui risiede la tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

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

  Il nome della tabella per cui recuperare la definizione. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

• TransactionId— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Custom string pattern #41

  ID transazione in cui leggere il contenuto della tabella.

• QueryAsOfTime: timestamp.

  Il momento a partire dal quale leggere il contenuto della tabella. Se non è impostato, verrà utilizzato l'orario di esecuzione del commit della transazione più recente. Non può essere specificato insieme a TransactionId.

• AuditContext: un oggetto AuditContext.

  Una struttura contenente il contesto dell' Lake Formationaudit.

• IncludeStatusDetails: booleano.

  Specifica se includere i dettagli sullo stato relativi a una richiesta di creazione o aggiornamento di una vista del catalogo AWS Glue dati.

• AttributesToGet— Una matrice di UTF-8 stringhe.

  Specifica i campi della tabella restituiti dalla chiamata GetTable. Questo parametro non accetta un elenco vuoto.

  Di seguito sono riportate le combinazioni di valori valide:

  • DEFAULT- Restituisce solo la definizione della Hive-style tabella.

  • LATEST_ICEBERG_METADATA- Restituisce solo i metadati della tabella Apache Iceberg più recenti.

  • DEFAULT, LATEST_ICEBERG_METADATA - Restituisce sia la definizione della Hive-style tabella che i metadati più recenti della tabella Apache Iceberg.

Risposta

• Table: un oggetto Tabella.

  L'oggetto Table che definisce la tabella specificata.

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

Richiesta

• 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 dati in cui risiede la tabella. Se non ne viene fornito nessuno, l'ID dell' AWS account viene utilizzato per impostazione predefinita.

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il database nel catalogo delle tabelle da elencare. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

• Expression— UTF-8 stringa, lunga non più di 2048 byte, corrispondente a. Single-line string pattern

  Un modello di espressione regolare. Se presente, vengono restituite solo le tabelle con i nomi corrispondenti al modello.

• NextToken— stringa UTF-8 .

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

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

  Il numero massimo di tabelle da restituire in una risposta singola.

• TransactionId— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Custom string pattern #41

  ID transazione in cui leggere il contenuto della tabella.

• QueryAsOfTime: timestamp.

  Il momento a partire dal quale leggere il contenuto della tabella. Se non è impostato, verrà utilizzato l'orario di esecuzione del commit della transazione più recente. Non può essere specificato insieme a TransactionId.

• AuditContext: un oggetto AuditContext.

  Una struttura contenente il contesto dell' Lake Formationaudit.

• IncludeStatusDetails: booleano.

  Specifica se includere i dettagli sullo stato relativi a una richiesta di creazione o aggiornamento di una vista del catalogo AWS Glue dati.

• AttributesToGet— Una matrice di UTF-8 stringhe.

  Specifica i campi della tabella restituiti dalla chiamata GetTables. Questo parametro non accetta un elenco vuoto. La richiesta deve includere NAME.

  Di seguito sono riportate le combinazioni di valori valide:

  • NAME: i nomi di tutte le tabelle nel database.

  • NAME, TABLE_TYPE: i nomi di tutte le tabelle e i tipi di tabelle.

Risposta

• TableList: una matrice di oggetti Tabella.

  Un elenco di tutti gli oggetti Table richiesti.

• NextToken— UTF-8 stringa.

  Un token di continuazione, presente se il segmento dell'elenco corrente non è l'ultimo.

Errori

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• GlueEncryptionException

• FederationSourceException

• FederationSourceRetryableException

Richiesta

• 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 dati in cui risiede la tabella. Se non ne viene fornito nessuno, l'ID dell' AWS account viene utilizzato per impostazione predefinita.

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il nome del database del catalogo in cui la tabella risiede. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

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

  Nome della tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

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

  Il valore ID della versione della tabella da recuperare. VersionID è una rappresentazione di stringa di un numero intero. Ogni versione viene incrementata di 1.

Risposta

• TableVersion: un oggetto TableVersion.

  La versione richiesta della tabella.

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Richiesta

• 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 dati in cui risiede la tabella. Se non ne viene fornito nessuno, l'ID dell' AWS account viene utilizzato per impostazione predefinita.

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il nome del database del catalogo in cui la tabella risiede. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

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

  Nome della tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

• NextToken— UTF-8 stringa.

  Un token di continuazione, se non è la prima chiamata.

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

  Il numero massimo di versioni della tabella da restituire in una risposta.

Risposta

• TableVersions: una matrice di oggetti TableVersion.

  Un elenco di stringhe identificativo delle versioni disponibili della tabella specificata.

• NextToken— UTF-8 corda.

  Un token di continuazione, se l'elenco delle versioni disponibili non comprende l'ultima.

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Richiesta

• 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 dati in cui risiede la tabella. Se non ne viene fornito nessuno, l'ID dell' AWS account viene utilizzato per impostazione predefinita.

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il nome del database del catalogo in cui la tabella risiede. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

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

  Nome della tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

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

  Il valore ID della versione della tabella da eliminare. VersionID è una rappresentazione di stringa di un numero intero. Ogni versione viene incrementata di 1.

Risposta

• Nessun parametro di risposta.

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

Richiesta

• 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 dati in cui risiede la tabella. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell'account. AWS

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il nome del database del catalogo in cui la tabella risiede. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

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

  Nome della tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.

• VersionIds— Obbligatorio: una matrice di UTF-8 stringhe, non più di 100 stringhe.

  Un elenco degli ID delle versioni da eliminare. VersionId è una rappresentazione di stringa di un numero intero. Ogni versione viene incrementata di 1.

Risposta

• Errors: una matrice di oggetti TableVersionError.

  Un elenco di errori riscontrati nel tentativo di eliminazione delle versioni della tabella specificata.

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

Richiesta

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

  Un identificatore univoco, costituito da account_id.

• NextToken— stringa UTF-8 .

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

• Filters: una matrice di oggetti PropertyPredicate.

  Un elenco di coppie chiave-valore e un comparatore utilizzato per filtrare i risultati della ricerca. Restituisce tutte le entità che corrispondono al predicato.

  Il membro Comparator della struttura PropertyPredicate viene utilizzata solo per i campi ora e può essere omesso per altri tipi di campo. Inoltre, quando si confrontano i valori di stringa, ad esempio quando Key=Name, viene utilizzato un algoritmo di corrispondenza parziale. Il campo Key (ad esempio, il valore del campo Name) è diviso su determinati caratteri di punteggiatura, ad esempio -, :, #, ecc. in token. Quindi ogni token è una corrispondenza esatta rispetto al membro Value di PropertyPredicate. Ad esempio se Key=Name e Value=link, le tabelle denominate customer-link e xx-link-yy vengono restituite, maxxlinkyy non viene restituita.

• SearchText: stringa Value, non inferiore a 1 o superiore a 1024 byte di lunghezza.

  Una stringa utilizzata per una ricerca di testo.

  Specifica un valore in filtri tra virgolette basato su una corrispondenza esatta con il valore.

• SortCriteria: una matrice di oggetti SortCriterion, non superiore a 1 struttura.

  Un elenco di criteri per ordinare i risultati in base a un nome di campo, in ordine crescente o decrescente.

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

  Il numero massimo di tabelle da restituire in una risposta singola.

• ResourceShareType— UTF-8 stringa (valori validi: FOREIGN | ALL |FEDERATED).

  Consente di specificare che si desidera eseguire la ricerca nelle tabelle condivise con l'account. I valori consentiti sono FOREIGN o ALL.

  • Se impostato su FOREIGN, cercherà le tabelle condivise con l'account.

  • Se impostato su ALL, cercherà le tabelle condivise con l'account, così come le tabelle nell'account locale.

• IncludeStatusDetails: booleano.

  Specifica se includere i dettagli sullo stato relativi a una richiesta di creazione o aggiornamento di una vista del catalogo AWS Glue dati.

Risposta

• NextToken— UTF-8 stringa.

  Un token di continuazione, presente se il segmento dell'elenco corrente non è l'ultimo.

• TableList: una matrice di oggetti Tabella.

  Un elenco di tutti gli oggetti Table richiesti. La risposta SearchTables restituisce solo le tabelle a cui hai accesso.

Errori

• InternalServiceException

• InvalidInputException

• OperationTimeoutException

Richiesta

• 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 in cui si trova la tabella.

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

  Specifica il nome di un database da cui si desidera recuperare gli indici delle partizioni.

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

  Specifica il nome di una tabella da cui si desidera recuperare gli indici delle partizioni.

• NextToken— UTF-8 stringa.

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

Risposta

• PartitionIndexDescriptorList: una matrice di oggetti PartitionIndexDescriptor.

  Un elenco di descrittori di indice.

• NextToken— UTF-8 corda.

  Un token di continuazione, presente se il segmento dell'elenco corrente non è l'ultimo.

Errori

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• EntityNotFoundException

• ConflictException

Richiesta

• 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 in cui si trova la tabella.

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

  Specifica il nome di un database in cui si desidera creare un indice della partizione.

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

  Specifica il nome di una tabella in cui si desidera creare un indice della partizione.

• PartitionIndex - obbligatorio: un oggetto PartitionIndex.

  Specifica una struttura PartitionIndex per creare un indice della partizione in una tabella esistente.

Risposta

• Nessun parametro di risposta.

Errori

• AlreadyExistsException

• InvalidInputException

• EntityNotFoundException

• ResourceNumberLimitExceededException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Richiesta

• 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 in cui si trova la tabella.

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

  Specifica il nome di un database da cui si desidera eliminare un indice della partizione.

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

  Specifica il nome di una tabella da cui si desidera eliminare un indice della partizione.

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

  Il nome dell'indice della partizione da eliminare.

Risposta

• Nessun parametro di risposta.

Errori

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• EntityNotFoundException

• ConflictException

• GlueEncryptionException

Richiesta

• 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 dati in cui si trovano le partizioni. Se non ne viene fornito nessuno, l'ID dell'account viene utilizzato per impostazione predefinita. AWS

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il nome del database del catalogo in cui risiedono le partizioni.

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

  Il nome della tabella della partizione.

• ColumnNames— Obbligatorio: una matrice di UTF-8 stringhe, non più di 100 stringhe.

  Un elenco dei nomi delle colonne.

Risposta

• ColumnStatisticsList: una matrice di oggetti ColumnStatistics.

  Elenco di. ColumnStatistics

• Errors: una matrice di oggetti ColumnError.

  La lista ColumnStatistics non è stata recuperata.

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Richiesta

• 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 dati in cui si trovano le partizioni. Se non ne viene fornito nessuno, l'ID dell'account viene utilizzato per impostazione predefinita. AWS

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il nome del database del catalogo in cui risiedono le partizioni.

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

  Il nome della tabella della partizione.

• ColumnStatisticsList - obbligatorio: una matrice di oggetti ColumnStatistics, non superiore a 25 strutture.

  Un elenco delle statistiche delle colonne.

Risposta

• Errors: una matrice di oggetti ColumnStatisticsError.

  Elenco di. ColumnStatisticsErrors

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Richiesta

• 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 dati in cui si trovano le partizioni. Se non ne viene fornito nessuno, l'ID dell'account viene utilizzato per impostazione predefinita. AWS

• DatabaseName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.

  Il nome del database del catalogo in cui risiedono le partizioni.

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

  Il nome della tabella della partizione.

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

  Il nome della colonna.

Risposta

• Nessun parametro di risposta.

Errori

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException