Tabellen-API

• Tabellenstruktur

• TableInput Struktur

• FederatedTable Struktur

• Spaltenstruktur

• StorageDescriptor Struktur

• SchemaReference Struktur

• SerDeInfo Struktur

• Order-Struktur

• SkewedInfo Struktur

• TableVersion Struktur

• TableError Struktur

• TableVersionError Struktur

• SortCriterion Struktur

• TableIdentifier Struktur

• KeySchemaElement Struktur

• PartitionIndex Struktur

• PartitionIndexDescriptor Struktur

• BackfillError Struktur

• IcebergInput Struktur

• OpenTableFormatInput Struktur

• ViewDefinition Struktur

• ViewDefinitionInput Struktur

• ViewRepresentation Struktur

• ViewRepresentationInput Struktur

• UpdateOpenTableFormatInput Struktur

• UpdateIcebergInput Struktur

• CreateIcebergTableInput Struktur

• UpdateIcebergTableInput Struktur

• IcebergSortOrder Struktur

• IcebergSortField Struktur

• IcebergPartitionSpec Struktur

• IcebergPartitionField Struktur

• IcebergSchema Struktur

• IcebergStructField Struktur

• IcebergTableUpdate Struktur

• AuditContext Struktur

Felder

• Name – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Tabelle. Für Hive-Kompatibilität muss dieser vollständig aus Kleinbuchstaben bestehen.

• DatabaseName – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Datenbank, in der sich die Tabellenmetadaten befinden. Für Hive-Kompatibilität muss dieser vollständig aus Kleinbuchstaben bestehen.

• Description – Beschreibende Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum URI address multi-line string pattern.

  Die Beschreibung der Tabelle.

• Owner – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Eigentümer der Tabelle.

• CreateTime – Zeitstempel.

  Die Uhrzeit, wann die Tabellendefinition im Data Catalog erstellt wurde.

• UpdateTime – Zeitstempel.

  Der letzte Zeitpunkt, an dem die Tabelle aktualisiert wurde.

• LastAccessTime – Zeitstempel.

  Der letzte Zeitpunkt, an dem auf die Tabelle zugegriffen wurde. Dieser stammt in der Regel aus HDFS und ist möglicherweise nicht zuverlässig.

• LastAnalyzedTime – Zeitstempel.

  Letzter Zeitpunkt der Berechnung der Spaltenstatistiken für diese Tabelle.

• Retention – Zahl (Ganzzahl), nicht mehr als Keine.

  Aufbewahrungsdauer für diese Tabelle.

• StorageDescriptor – Ein StorageDescriptor-Objekt.

  Eine Speicherbeschreibung, die Informationen zur physischen Speicherung dieser Tabelle enthält.

• PartitionKeys – Ein Array mit Spalte-Objekten.

  Eine Liste der Spalten, nach denen die Tabelle partitioniert ist. Es werden nur primitive Typen als Partitionsschlüssel unterstützt.

  Wenn Sie eine Tabelle erstellen, die von Amazon Athena verwendet wird, und keine partitionKeys angeben, müssen Sie mindestens den Wert der partitionKeys auf eine leere Liste festlegen. Zum Beispiel:

  "PartitionKeys": []

• ViewOriginalText – UTF-8-Zeichenfolge, nicht mehr als 409 600 Bytes lang.

  Für Apache-Hive-Kompatibilität enthalten. Wird im normalen AWS Glue Betrieb nicht verwendet. Wenn es sich bei der Tabelle um eine bestimmte Athena Konfiguration handeltVIRTUAL_VIEW, die in Base64 codiert ist.

• ViewExpandedText – UTF-8-Zeichenfolge, nicht mehr als 409 600 Bytes lang.

  Für Apache-Hive-Kompatibilität enthalten. Wird im normalen Betriebsablauf nicht verwendet. AWS Glue

• TableType – UTF-8-Zeichenfolge, nicht mehr als 255 Bytes lang.

  Der Typ dieser Tabelle. AWS Glue erstellt Tabellen mit dem EXTERNAL_TABLE Typ. Andere Dienste, wie z. B. Athena, können Tabellen mit zusätzlichen Tabellentypen erstellen.

  AWS Glue verwandte Tabellentypen:

  EXTERNAL_TABLE

  Hive-kompatibles Attribut – zeigt eine nicht von Hive verwaltete Tabelle an.

  GOVERNED

  Wird verwendet von AWS Lake Formation. Der AWS Glue Datenkatalog versteht esGOVERNED.

• Parameters – Ein Map-Array von Schlüssel-Wert-Paaren.

  Jeder Schlüssel ist eine Schlüsselzeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang und entspricht dem Single-line string pattern.

  Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.

  Diese Schlüssel-Wert-Paare definieren die der Tabelle zugeordneten Eigenschaften.

• CreatedBy – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Person oder Entität, die die Tabelle erstellt hat.

• IsRegisteredWithLakeFormation – Boolesch.

  Gibt an, ob die Tabelle bei registriert wurde AWS Lake Formation.

• TargetTable – Ein TableIdentifier-Objekt.

  Eine TableIdentifier-Struktur, die eine Zieltabelle für die Verknüpfung von Ressourcen beschreibt.

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem die Tabelle gespeichert ist.

• VersionId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID der Tabellenversion.

• FederatedTable – Ein FederatedTable-Objekt.

  Eine FederatedTable-Struktur, die auf eine Entität außerhalb von AWS Glue Data Catalog verweist.

• ViewDefinition – Ein ViewDefinition-Objekt.

  Eine Struktur, die alle Informationen enthält, die die Ansicht definieren, einschließlich des Dialekts oder der Dialekte für die Ansicht und der Abfrage.

• IsMultiDialectView – Boolesch.

  Gibt an, ob die Ansicht die SQL-Dialekte unterschiedlicher Abfrage-Engines unterstützt und daher von diesen Engines gelesen werden kann.

Felder

• Name – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Tabelle. Für Hive-Kompatibilität wird dieser beim Speichern wie Kleinbuchstaben behandelt.

• Description – Beschreibende Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum URI address multi-line string pattern.

  Die Beschreibung der Tabelle.

• Owner – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Eigentümer der Tabelle. Für Apache-Hive-Kompatibilität enthalten. Wird im normalen AWS Glue Betriebsablauf nicht verwendet.

• LastAccessTime – Zeitstempel.

  Der letzte Zeitpunkt, an dem auf die Tabelle zugegriffen wurde.

• LastAnalyzedTime – Zeitstempel.

  Letzter Zeitpunkt der Berechnung der Spaltenstatistiken für diese Tabelle.

• Retention – Zahl (Ganzzahl), nicht mehr als Keine.

  Aufbewahrungsdauer für diese Tabelle.

• StorageDescriptor – Ein StorageDescriptor-Objekt.

  Eine Speicherbeschreibung, die Informationen zur physischen Speicherung dieser Tabelle enthält.

• PartitionKeys – Ein Array mit Spalte-Objekten.

  Eine Liste der Spalten, nach denen die Tabelle partitioniert ist. Es werden nur primitive Typen als Partitionsschlüssel unterstützt.

  Wenn Sie eine Tabelle erstellen, die von Amazon Athena verwendet wird, und keine partitionKeys angeben, müssen Sie mindestens den Wert der partitionKeys auf eine leere Liste festlegen. Zum Beispiel:

  "PartitionKeys": []

• ViewOriginalText – UTF-8-Zeichenfolge, nicht mehr als 409 600 Bytes lang.

  Für Apache-Hive-Kompatibilität enthalten. Wird im normalen AWS Glue Betriebsablauf nicht verwendet. Wenn es sich bei der Tabelle um eine bestimmte Athena Konfiguration handeltVIRTUAL_VIEW, die in Base64 codiert ist.

• ViewExpandedText – UTF-8-Zeichenfolge, nicht mehr als 409 600 Bytes lang.

  Für Apache-Hive-Kompatibilität enthalten. Wird im normalen Betriebsablauf nicht verwendet. AWS Glue

• TableType – UTF-8-Zeichenfolge, nicht mehr als 255 Bytes lang.

  Der Typ dieser Tabelle. AWS Glue erstellt Tabellen mit dem EXTERNAL_TABLE Typ. Andere Dienste, wie z. B. Athena, können Tabellen mit zusätzlichen Tabellentypen erstellen.

  AWS Glue verwandte Tabellentypen:

  EXTERNAL_TABLE

  Hive-kompatibles Attribut – zeigt eine nicht von Hive verwaltete Tabelle an.

  GOVERNED

  Wird verwendet von AWS Lake Formation. Der AWS Glue Datenkatalog versteht esGOVERNED.

• Parameters – Ein Map-Array von Schlüssel-Wert-Paaren.

  Jeder Schlüssel ist eine Schlüsselzeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang und entspricht dem Single-line string pattern.

  Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.

  Diese Schlüssel-Wert-Paare definieren die der Tabelle zugeordneten Eigenschaften.

• TargetTable – Ein TableIdentifier-Objekt.

  Eine TableIdentifier-Struktur, die eine Zieltabelle für die Verknüpfung von Ressourcen beschreibt.

• ViewDefinition – Ein ViewDefinitionInput-Objekt.

  Eine Struktur, die alle Informationen enthält, die die Ansicht definieren, einschließlich des Dialekts oder der Dialekte für die Ansicht und der Abfrage.

Felder

• Identifier – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 512 Bytes lang, passend zum Single-line string pattern.

  Eine eindeutige Kennung für die Verbundtabelle.

• DatabaseIdentifier – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 512 Bytes lang, passend zum Single-line string pattern.

  Eine eindeutige Kennung für die Verbunddatenbank.

• ConnectionName – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Verbindung zum externen Metaspeicher.

• ConnectionType – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Typ der Verbindung, die für den Zugriff auf die Verbundtabelle verwendet wird, wobei das Protokoll oder die Methode für die Verbindung mit der externen Datenquelle angegeben wird.

Felder

• Name – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Column.

• Type – UTF-8-Zeichenfolge, nicht mehr als 131 072 Bytes lang, passend zum Single-line string pattern.

  Der Datentyp von Column.

• Comment – Kommentar-Zeichenfolge, nicht mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Ein Freitextkommentar.

• Parameters – Ein Map-Array von Schlüssel-Wert-Paaren.

  Jeder Schlüssel ist eine Schlüsselzeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang und entspricht dem Single-line string pattern.

  Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.

  Diese Schlüssel-Wert-Paare definieren die der Spalte zugeordneten Eigenschaften.

Felder

• Columns – Ein Array mit Spalte-Objekten.

  Eine Liste der Columns in der Tabelle.

• Location – Standort-Zeichenfolge, nicht mehr als 2056 Bytes lang, passend zum URI address multi-line string pattern.

  Der physische Speicherort der Tabelle. Standardmäßig ist dies der Lager-Speicherort, gefolgt vom Datenbank-Standort in der Lagerorganisation, gefolgt vom Namen der Tabelle.

• AdditionalLocations – Ein UTF-8-Zeichenfolgen-Array.

  Eine Liste von Speicherorten, die auf den Pfad verweisen, in dem sich eine Delta-Tabelle befindet.

• InputFormat – Format-Zeichenfolge, nicht mehr als 128 Bytes lang, passend zum Single-line string pattern.

  Eingabeformat SequenceFileInputFormat (binär), TextInputFormat oder ein benutzerdefiniertes Format.

• OutputFormat – Format-Zeichenfolge, nicht mehr als 128 Bytes lang, passend zum Single-line string pattern.

  Ausgabeformat SequenceFileOutputFormat (binär), IgnoreKeyTextOutputFormat oder ein benutzerdefiniertes Format.

• Compressed – Boolesch.

  True, wenn die Daten in der Tabelle komprimiert sind und False, wenn dies nicht der Fall ist.

• NumberOfBuckets – Zahl (Ganzzahl).

  Muss angegeben werden, wenn die Tabelle Dimensionsspalten enthält.

• SerdeInfo – Ein SerDeInfo-Objekt.

  Die serialization/deserialization (SerDe) Information.

• BucketColumns – Ein UTF-8-Zeichenfolgen-Array.

  Eine Liste mit Reducer-Gruppierungsspalten, Cluster-Spalten und Bucketing-Spalten in der Tabelle.

• SortColumns – Ein Array mit Order-Objekten.

  Eine Liste mit der Sortierreihenfolge der einzelnen Buckets in der Tabelle.

• Parameters – Ein Map-Array von Schlüssel-Wert-Paaren.

  Jeder Schlüssel ist eine Schlüsselzeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang und entspricht dem Single-line string pattern.

  Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.

  Vom Benutzer angegebene Eigenschaften im Schlüssel-Wert-Format.

• SkewedInfo – Ein SkewedInfo-Objekt.

  Informationen über Werte, die sehr häufig in einer Spalte vorkommen (verzerrte Werte).

• StoredAsSubDirectories – Boolesch.

  True, wenn die Tabellendaten in Unterverzeichnissen gespeichert werden, andernfalls False.

• SchemaReference – Ein SchemaReference-Objekt.

  Ein Objekt, das auf ein in der Schemaregistrierung gespeichertes AWS Glue Schema verweist.

  Beim Erstellen einer Tabelle können Sie eine leere Liste von Spalten für das Schema übergeben und stattdessen eine Schemaverweisung verwenden.

Felder

• SchemaId – Ein SchemaId-Objekt.

  Eine Struktur, die Schema-Identitätsfelder enthält. Entweder dies oder SchemaVersionId muss zur Verfügung gestellt werden.

• SchemaVersionId – UTF-8-Zeichenfolge, nicht weniger als 36 oder mehr als 36 Bytes lang, passend zum Custom string pattern #45.

  Die eindeutige ID, die einer Version des Schemas zugewiesen ist. Entweder dies oder SchemaId muss zur Verfügung gestellt werden.

• SchemaVersionNumber – Zahl (lang), nicht kleiner als 1 oder größer als 100 000.

  Die Versionsnummer des Schemas.

Felder

• Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Name des SerDe.

• SerializationLibrary – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Normalerweise die Klasse, die das implementiert SerDe. Ein Beispiel ist org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe.

• Parameters – Ein Map-Array von Schlüssel-Wert-Paaren.

  Jeder Schlüssel ist eine Schlüsselzeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang und entspricht dem Single-line string pattern.

  Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.

  Diese Schlüssel-Wert-Paare definieren Initialisierungsparameter für. SerDe

Felder

• Column – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Spalte.

• SortOrder – Erforderlich: Zahl (Ganzzahl), nicht mehr als 1.

  Gibt an, dass die Spalte in aufsteigender Reihenfolge (== 1) oder in absteigender Reihenfolge (==0) sortiert wird.

Felder

• SkewedColumnNames – Ein UTF-8-Zeichenfolgen-Array.

  Eine Liste der Namen von Spalten, die verzerrte Werte enthalten.

• SkewedColumnValues – Ein UTF-8-Zeichenfolgen-Array.

  Eine Liste der Werte, die so häufig auftreten, dass sie als verzerrt betrachtet werden.

• SkewedColumnValueLocationMaps – Ein Map-Array von Schlüssel-Wert-Paaren.

  Jeder Schlüssel ist eine UTF-8-Zeichenfolge.

  Jeder Wert ist eine UTF-8-Zeichenfolge.

  Ein Mapping verzerrter Werte zu den Spalten, die sie enthalten.

Felder

• Table – Ein Tabelle-Objekt.

  Die betreffende Tabelle.

• VersionId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der ID-Wert für die Identifikation dieser Tabellenversion. Eine VersionId ist eine Zeichenfolgendarstellung einer Ganzzahl. Jede Version wird um 1 erhöht.

Felder

• TableName – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Tabelle. Für Hive-Kompatibilität muss dieser vollständig aus Kleinbuchstaben bestehen.

• ErrorDetail – Ein ErrorDetail-Objekt.

  Die Details zu dem Fehler.

Felder

• TableName – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der betreffenden Tabelle.

• VersionId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der ID-Wert der betreffenden Version. Eine VersionID ist eine Zeichenfolgendarstellung einer Ganzzahl. Jede Version wird um 1 erhöht.

• ErrorDetail – Ein ErrorDetail-Objekt.

  Die Details zu dem Fehler.

Felder

• FieldName – Wertzeichenfolge, mindestens 1 und höchstens 1024 Byte lang.

  Der Name des Felds, nach dem sortiert werden soll.

• Sort – UTF-8-Zeichenfolge (zulässige Werte: ASC="ASCENDING" | DESC="DESCENDING").

  Eine auf- oder absteigende Sortierung.

Felder

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem die Tabelle gespeichert ist.

• DatabaseName – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Katalogdatenbank, die die Zieltabelle enthält

• Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Zieltabelle.

• Region – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Region der Zieltabelle.

Felder

• Name – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name eines Partitionsschlüssels.

• Type – Erforderlich: UTF-8-Zeichenfolge, nicht mehr als 131 072 Bytes lang, passend zum Single-line string pattern.

  Der Typ eines Partitionsschlüssels.

Felder

• Keys – Erforderlich:Ein Array mit UTF-8-Zeichenfolgen, mindestens 1 Zeichenfolge.

  Die Schlüssel für den Partitionsindex.

• IndexName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name des Partitionsindex.

Felder

• IndexName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name des Partitionsindex.

• Keys – Erforderlich: Ein Array von KeySchemaElement-Objekten, mindestens 1 Struktur.

  Eine Liste mit einem oder mehreren Schlüsseln, wie z. B. KeySchemaElement-Strukturen für den Partitionsindex.

• IndexStatus – Erforderlich: UTF-8-Zeichenfolge (zulässige Werte: CREATING | ACTIVE | DELETING | FAILED).

  Der Status des Partitionsindex.

  Die folgenden Status sind möglich:

  • CREATING: Der Index wird erstellt. Wenn sich ein Index im CREATING-Zustand befindet, kann der Index oder seine Tabelle nicht gelöscht werden.

  • ACTIVE: Die Indexerstellung ist erfolgreich.

  • FAILED: Die Indexerstellung schlägt fehl.

  • DELETING: Der Index wird aus der Liste der Indizes gelöscht.

• BackfillErrors – Ein Array mit BackfillError-Objekten.

  Eine Liste von Fehlern, die beim Registrieren von Partitionsindizes für eine vorhandene Tabelle auftreten können.

• EncryptedPartitionError: Die Partitionen sind verschlüsselt.

• InvalidPartitionTypeDataError: Der Partitionswert entspricht nicht dem Datentyp für diese Partitionsspalte.

• MissingPartitionValueError: Die Partitionen sind verschlüsselt.

• UnsupportedPartitionCharacterError: Zeichen innerhalb des Partitionswerts werden nicht unterstützt. Beispiel: U+0000, U+0001, U+0002.

• InternalError: Jeder Fehler, der nicht zu anderen Fehlercodes gehört.

Felder

• Code – UTF-8-Zeichenfolge (zulässige Werte: ENCRYPTED_PARTITION_ERROR | INTERNAL_ERROR | INVALID_PARTITION_TYPE_DATA_ERROR | MISSING_PARTITION_VALUE_ERROR | UNSUPPORTED_PARTITION_CHARACTER_ERROR).

  Der Fehlercode für einen Fehler, der beim Registrieren von Partitionsindizes für eine vorhandene Tabelle aufgetreten ist.

• Partitions – Ein Array mit PartitionValueList-Objekten.

  Eine Liste einer begrenzten Anzahl an Partitionen in der Antwort.

Felder

• MetadataOperation – Erforderlich: UTF-8-Zeichenfolge (zulässige Werte: CREATE).

  Ein erforderlicher Metadatenvorgang. Kann nur auf CREATE festgelegt werden.

• Version – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die TabelOpenTableFormatInputlenversion für die Iceberg-Tabelle. Standard-Einstellung: 2.

• CreateIcebergTableInput – Ein CreateIcebergTableInput-Objekt.

  Die Konfigurationsparameter, die zum Erstellen einer neuen Iceberg-Tabelle im AWS Glue Datenkatalog erforderlich sind, einschließlich Tabelleneigenschaften und Metadatenspezifikationen.

Felder

• IcebergInput – Ein IcebergInput-Objekt.

  Spezifiziert eine IcebergInput-Struktur, die eine Apache-Iceberg-Metadatentabelle definiert.

Felder

• IsProtected – Boolesch.

  Sie können dieses Flag auf „true“ setzen, um die Engine anzuweisen, vom Benutzer bereitgestellte Vorgänge während der Abfrageplanung nicht in den logischen Plan der Ansicht zu übernehmen. Das Setzen dieses Flags garantiert jedoch nicht, dass die Engine dies auch tut. Informationen zu den gegebenenfalls angebotenen Garantien finden Sie in der Dokumentation der Engine.

• Definer – UTF-8-Zeichenfolge, nicht weniger als 20 oder mehr als 2 048 Bytes lang, passend zum Single-line string pattern.

  Der Definer einer Ansicht in SQL.

• SubObjects – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 10 Zeichenfolgen.

  Eine Liste der Tabellen Amazon Resource Names (ARNs).

• Representations – Ein Array mit ViewRepresentation-Objekten, nicht weniger als 1 und nicht mehr als 1 000 Strukturen.

  Eine Liste von Darstellungen.

Felder

• IsProtected – Boolesch.

  Sie können dieses Flag auf „true“ setzen, um die Engine anzuweisen, vom Benutzer bereitgestellte Vorgänge während der Abfrageplanung nicht in den logischen Plan der Ansicht zu übernehmen. Das Setzen dieses Flags garantiert jedoch nicht, dass die Engine dies auch tut. Informationen zu den gegebenenfalls angebotenen Garantien finden Sie in der Dokumentation der Engine.

• Definer – UTF-8-Zeichenfolge, nicht weniger als 20 oder mehr als 2 048 Bytes lang, passend zum Single-line string pattern.

  Der Definer einer Ansicht in SQL.

• Representations— Eine Reihe von ViewRepresentationInput Objekten, nicht weniger als 1 oder mehr als 10 Strukturen.

  Eine Liste von Strukturen, die den Dialekt der Ansicht und die Abfrage enthält, die die Ansicht definiert.

• SubObjects – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 10 Zeichenfolgen.

  Eine Liste der Basistabellen ARNs , aus denen die Ansicht besteht.

Felder

• Dialect – UTF-8-Zeichenfolge (zulässige Werte: REDSHIFT | ATHENA | SPARK).

  Der Dialekt der Abfrage-Engine.

• DialectVersion – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang.

  Die Version des Dialekts der Abfrage-Engine. Beispiel: 3.0.0.

• ViewOriginalText – UTF-8-Zeichenfolge, nicht mehr als 409 600 Bytes lang.

  Die SELECT-Abfrage, die vom Kunden während CREATE VIEW DDL bereitgestellt wird. Diese SQL wird nicht während einer Abfrage einer Ansicht verwendet (stattdessen wird ViewExpandedText verwendet). ViewOriginalText wird für Fälle wie SHOW CREATE VIEW verwendet, in denen Benutzer den ursprünglichen DDL-Befehl sehen möchten, mit dem die Ansicht erstellt wurde.

• ViewExpandedText – UTF-8-Zeichenfolge, nicht mehr als 409 600 Bytes lang.

  Die erweiterte SQL für die Ansicht. Diese SQL wird von Engines bei der Verarbeitung einer Abfrage in einer Ansicht verwendet. Engines können während der Erstellung der Ansicht Vorgänge ausführen, um ViewOriginalText in ViewExpandedText umzuwandeln. Zum Beispiel:

  • Vollständig qualifizierte Bezeichner: SELECT * from table1 -> SELECT * from db1.table1

• ValidationConnection – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Verbindung, die zum Validieren der spezifischen Darstellung der Ansicht verwendet werden soll.

• IsStale – Boolesch.

  Als veraltet markierte Dialekte sind nicht mehr gültig und müssen aktualisiert werden, bevor sie in den jeweiligen Abfrage-Engines abgefragt werden können.

Felder

• Dialect – UTF-8-Zeichenfolge (zulässige Werte: REDSHIFT | ATHENA | SPARK).

  Ein Parameter, der den Engine-Typ einer bestimmten Darstellung angibt.

• DialectVersion – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang.

  Ein Parameter, der die Version der Engine einer bestimmten Darstellung angibt.

• ViewOriginalText – UTF-8-Zeichenfolge, nicht mehr als 409 600 Bytes lang.

  Eine Zeichenfolge, die die ursprüngliche SQL-Abfrage darstellt, die die Ansicht beschreibt.

• ValidationConnection – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Verbindung, die zum Validieren der spezifischen Darstellung der Ansicht verwendet werden soll.

• ViewExpandedText – UTF-8-Zeichenfolge, nicht mehr als 409 600 Bytes lang.

  Eine Zeichenfolge, die die SQL-Abfrage darstellt, die die Ansicht mit erweiterter Ressource beschreibt ARNs

Felder

• UpdateIcebergInput – Ein UpdateIcebergInput-Objekt.

  Apache-Iceberg-spezifische Aktualisierungsparameter, die die anzuwendenden Tabellenänderungen definieren, einschließlich Schemaänderungen, Partitionsspezifikationen und Tabelleneigenschaften.

Felder

• UpdateIcebergTableInput – Erforderlich: Ein UpdateIcebergTableInput-Objekt.

  Die spezifischen Aktualisierungsvorgänge, die auf die Iceberg-Tabelle angewendet werden sollen, einschließlich einer Liste von Aktualisierungen, die den neuen Status der Tabelle definieren, einschließlich Schema, Partitionen und Eigenschaften.

Felder

• Location – Erforderlich: Speicherort-Zeichenfolge, höchstens 2056 Bytes lang, die dem URI address multi-line string pattern entspricht.

  Der S3-Speicherort, an dem die Iceberg-Tabellendaten gespeichert werden.

• Schema – Erforderlich: Ein IcebergSchema-Objekt.

  Die Schemadefinition, die die Struktur, Feldtypen und Metadaten für die Iceberg-Tabelle festlegt.

• PartitionSpec – Ein IcebergPartitionSpec-Objekt.

  Die Partitionierungsspezifikation, die festlegt, wie die Daten der Iceberg-Tabelle organisiert und partitioniert werden, um eine optimale Abfrageleistung zu erzielen.

• WriteOrder – Ein IcebergSortOrder-Objekt.

  Die Spezifikation der Sortierreihenfolge, die festlegt, wie die Daten innerhalb jeder Partition sortiert werden sollen, um die Abfrageleistung zu optimieren.

• Properties –

  Schlüssel-Wert-Paare zusätzlicher Tabelleneigenschaften und Konfigurationseinstellungen für die Iceberg-Tabelle.

Felder

• Updates – Erforderlich: Ein Array mit IcebergTableUpdate-Objekten.

  Die Liste der Tabellenaktualisierungsvorgänge, die die an der Iceberg-Tabelle vorzunehmenden Änderungen festlegen, einschließlich Schemaänderungen, Partitionierungsspezifikationen und Tabelleneigenschaften.

Felder

• OrderId – Erforderlich: Zahl (Ganzzahl).

  Der eindeutige Bezeichner für diese Sortierreihenfolgespezifikation in den Metadaten der Iceberg-Tabelle.

• Fields – Erforderlich: Ein Array mit IcebergSortField-Objekten.

  Die Liste der Felder und ihrer Sortierrichtungen, die die Sortierkriterien für die Daten der Iceberg-Tabelle definieren.

Felder

• SourceId – Erforderlich: Zahl (Ganzzahl).

  Der Bezeichner des Quellfeldes aus dem Tabellenschema, auf dem dieses Sortierfeld basiert.

• Transform – Erforderlich: UTF-8-Zeichenfolge.

  Die Transformationsfunktion, die vor dem Sortieren auf das Quellfeld angewendet wird, z. B. Identität, Bucket oder Kürzung.

• Direction – Erforderlich: UTF-8-Zeichenfolge (zulässige Werte: asc="ASC" | desc="DESC").

  Die Sortierrichtung für dieses Feld, entweder aufsteigend oder absteigend.

• NullOrder – Erforderlich: UTF-8-Zeichenfolge (zulässige Werte: nulls-first="NULLS_FIRST" | nulls-last="NULLS_LAST").

  Das Sortierverhalten für Nullwerte in diesem Feld, wobei angegeben wird, ob Nullwerte in der Sortierreihenfolge an erster oder letzter Stelle stehen sollen.

Felder

• Fields – Erforderlich: Ein Array mit IcebergPartitionField-Objekten.

  Die Liste der Partitionsfelder, die festlegen, wie die Tabellendaten partitioniert werden sollen, einschließlich der Quellfelder und ihrer Transformationen.

• SpecId – Zahl (Ganzzahl).

  Der eindeutige Bezeichner für diese Partitionsspezifikation im Metadatenverlauf der Iceberg-Tabelle.

Felder

• SourceId – Erforderlich: Zahl (Ganzzahl).

  Der Bezeichner des Quellfeldes aus dem Tabellenschema, auf dem dieses Partitionsfeld basiert.

• Transform – Erforderlich: UTF-8-Zeichenfolge.

  Die Transformationsfunktion, die auf das Quellfeld angewendet wird, um die Partition zu erstellen, z. B. Identität, Bucket, Kürzung, Jahr, Monat, Tag oder Stunde.

• Name – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 1024 Bytes lang, passend zum Single-line string pattern.

  Der Name des Partitionsfelds, wie er in der partitionierten Tabellenstruktur angezeigt wird.

• FieldId – Zahl (Ganzzahl).

  Der eindeutige Bezeichner, der diesem Partitionsfeld innerhalb der Partitionsspezifikation der Iceberg-Tabelle zugewiesen wurde.

Felder

• SchemaId – Zahl (Ganzzahl).

  Der eindeutige Bezeichner für diese Schemaversion innerhalb des Schemaentwicklungsverlaufs der Iceberg-Tabelle.

• IdentifierFieldIds – Ein Array von 32-Bit-Ganzzahlen mit Vorzeichen.

  Die Liste der Feldbezeichner, die Datensätze in der Tabelle eindeutig identifizieren und für Vorgänge auf Zeilenebene und zur Deduplizierung verwendet werden.

• Type – UTF-8-Zeichenfolge (zulässige Werte: struct="STRUCT").

  Der Stammtyp der Schemastruktur, typischerweise „struct“ für Iceberg-Tabellenschemas.

• Fields – Erforderlich: Ein Array mit IcebergStructField-Objekten.

  Die Liste der Felddefinitionen, aus denen das Tabellenschema besteht, einschließlich Feldnamen, Typen und Metadaten.

Felder

• Id – Erforderlich: Zahl (Ganzzahl).

  Der eindeutige Bezeichner, der diesem Feld innerhalb des Iceberg-Tabellenschemas zugewiesen ist und für die Schemaentwicklung und Feldverfolgung verwendet wird.

• Name – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 1024 Bytes lang, passend zum Single-line string pattern.

  Der Name des Felds, wie er im Tabellenschema und in Abfragevorgängen angezeigt wird.

• Type – Erforderlich: Eine leere Struktur mit dem Namen IcebergDocument.

  Die Datentypdefinition für dieses Feld, die die Struktur und das Format der darin enthaltenen Daten angibt.

• Required – Erforderlich: Boolean.

  Gibt an, ob dieses Feld im Tabellenschema erforderlich (nicht NULL-fähig) oder optional (NULL-fähig) ist.

• Doc – Kommentar-Zeichenfolge, nicht mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Optionaler Dokumentations- oder Beschreibungstext, der zusätzliche Informationen zum Zweck und zur Verwendung dieses Feldes liefert.

Felder

• Schema – Erforderlich: Ein IcebergSchema-Objekt.

  Die aktualisierte Schemadefinition für die Iceberg-Tabelle, in der alle Änderungen an der Feldstruktur, den Datentypen oder den Schema-Metadaten angegeben sind.

• PartitionSpec – Ein IcebergPartitionSpec-Objekt.

  Die aktualisierte Partitionierungsspezifikation, die festlegt, wie die Tabellendaten neu organisiert und partitioniert werden sollen.

• SortOrder – Ein IcebergSortOrder-Objekt.

  Die aktualisierte Spezifikation der Sortierreihenfolge, die festlegt, wie Daten innerhalb von Partitionen für eine optimale Abfrageleistung sortiert werden sollen.

• Location – Erforderlich: Speicherort-Zeichenfolge, höchstens 2056 Bytes lang, die dem URI address multi-line string pattern entspricht.

  Der aktualisierte S3-Speicherort, an dem die Iceberg-Tabellendaten gespeichert werden.

• Properties –

  Aktualisierte Schlüssel-Wert-Paare von Tabelleneigenschaften und Konfigurationseinstellungen für die Iceberg-Tabelle.

Felder

• AdditionalAuditContext— UTF-8-Zeichenfolge, nicht länger als 2048 Byte.

  Eine Zeichenfolge, die die zusätzlichen Informationen zum Prüfungskontext enthält.

• RequestedColumns – Ein UTF-8-Zeichenfolgen-Array.

  Die angeforderten Spalten für die Prüfung.

• AllColumnsRequested – Boolesch.

  Für alle Spalten wird eine Prüfung beantragt.

• CreateTable Aktion (Python: create_table)

• UpdateTable Aktion (Python: update_table)

• DeleteTable Aktion (Python: delete_table)

• BatchDeleteTable Aktion (Python: batch_delete_table)

• GetTable Aktion (Python: get_table)

• GetTables Aktion (Python: get_tables)

• GetTableVersion Aktion (Python: get_table_version)

• GetTableVersions Aktion (Python: get_table_versions)

• DeleteTableVersion Aktion (Python: delete_table_version)

• BatchDeleteTableVersion Aktion (Python: batch_delete_table_version)

• SearchTables Aktion (Python: search_tables)

• GetPartitionIndexes Aktion (Python: get_partition_indexes)

• CreatePartitionIndex Aktion (Python: create_partition_index)

• DeletePartitionIndex Aktion (Python: delete_partition_index)

• GetColumnStatisticsForTable Aktion (Python: get_column_statistics_for_table)

• UpdateColumnStatisticsForTable Aktion (Python: update_column_statistics_for_table)

• DeleteColumnStatisticsForTable Aktion (Python: delete_column_statistics_for_table)

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem die erstellt wird Table. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die Katalogdatenbank, in der die neue Tabelle erstellt wird. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die eindeutige Kennung für die Tabelle in der angegebenen Datenbank, die im AWS Glue Datenkatalog erstellt wird.

• TableInput – Ein TableInput-Objekt.

  Das TableInput-Objekt, das die im Katalog zu erstellende Metadatentabelle definiert.

• PartitionIndexes – Ein Array mit PartitionIndex-Objekten, nicht mehr als 3 Strukturen.

  Eine Liste von Partitionsindizes, PartitionIndex-Strukturen, die in der Tabelle erstellt werden.

• TransactionId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Custom string pattern #44.

  Die ID der Transaktion.

• OpenTableFormatInput – Ein OpenTableFormatInput-Objekt.

  Gibt eine OpenTableFormatInput-Struktur an, wenn eine Tabelle im offenen Format erstellt wird.

Antwort

• Keine Antwortparameter.

Fehler

• AlreadyExistsException

• InvalidInputException

• EntityNotFoundException

• ResourceNumberLimitExceededException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ConcurrentModificationException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die Tabelle befindet. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Katalogdatenbank, in der sich die Tabelle befindet. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die eindeutige Kennung für die Tabelle in der angegebenen Datenbank, die im AWS Glue Datenkatalog erstellt wird.

• TableInput – Ein TableInput-Objekt.

  Ein aktualisiertes TableInput-Objekt, das die Metadatentabelle im Katalog definiert.

• SkipArchive – Boolesch.

  Standardmäßig erstellt UpdateTable immer eine archivierte Version der Tabelle, bevor sie aktualisiert wird. Wenn skipArchive auf „true“ gesetzt wurde, erstellt UpdateTable jedoch nicht die archivierte Version.

• TransactionId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Custom string pattern #44.

  Die Transaktions-ID, an der der Tabellinhalt aktualisiert werden soll.

• VersionId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die Versions-ID, bei der der Tabelleninhalt aktualisiert werden soll.

• ViewUpdateAction – UTF-8-Zeichenfolge (zulässige Werte: ADD | REPLACE | ADD_OR_REPLACE | DROP).

  Der Vorgang, der beim Aktualisieren der Ansicht ausgeführt werden soll.

• Force – Boolesch.

  Ein Flag, das auf „true“ gesetzt werden kann, um übereinstimmende Speicherdeskriptoren und Anforderungen an die Übereinstimmung von Unterobjekten zu ignorieren.

• UpdateOpenTableFormatInput – Ein UpdateOpenTableFormatInput-Objekt.

  Eingabeparameter für die Aktualisierung von Tabellen im offenen Tabellenformat in AWS Glue Data Catalog, die als Wrapper für formatspezifische Aktualisierungsvorgänge wie Apache Iceberg dienen.

Antwort

• Keine Antwortparameter.

Fehler

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

• ResourceNumberLimitExceededException

• GlueEncryptionException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

• AlreadyExistsException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die Tabelle befindet. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Katalogdatenbank, in der sich die Tabelle befindet. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• Name – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Tabelle, die gelöscht werden soll. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• TransactionId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Custom string pattern #44.

  Die Transaktions-ID, an der der Tabellinhalt gelöscht werden soll.

Antwort

• Keine Antwortparameter.

Fehler

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die Tabelle befindet. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Katalogdatenbank, in der sich die zu löschenden Tabellen befinden. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• TablesToDelete – Erforderlich: Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 100 Zeichenfolgen.

  Eine Liste der zu löschenden Tabellen.

• TransactionId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Custom string pattern #44.

  Die Transaktions-ID, an der der Tabellinhalt gelöscht werden soll.

Antwort

• Errors – Ein Array mit TableError-Objekten.

  Eine Liste der Fehler, die beim Löschen der angegebenen Tabellen aufgetreten sind.

Fehler

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ResourceNotReadyException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die Tabelle befindet. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• Name – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Tabelle, für die die Definition abgerufen werden soll. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• TransactionId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Custom string pattern #44.

  Die Transaktions-ID, an der der Tabellinhalt gelesen werden soll.

• QueryAsOfTime – Zeitstempel.

  Die Zeit, zu der der Tabelleninhalt gelesen werden muss. Wenn nicht festgelegt, wird die letzte Transaktions-Commit-Zeit verwendet. Kann nicht zusammen mit TransactionId angegeben werden.

• AuditContext – Ein AuditContext-Objekt.

  Eine Struktur, die den Lake Formation Prüfungskontext enthält.

• IncludeStatusDetails – Boolesch.

  Gibt an, ob Statusdetails im Zusammenhang mit einer Anforderung zur Erstellung oder Aktualisierung einer AWS Glue Datenkatalogansicht aufgenommen werden sollen.

Antwort

• Table – Ein Tabelle-Objekt.

  Das Table-Objekt, das die angegebene Tabelle definiert.

Fehler

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die Tabellen befinden. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die Datenbank im Katalog, dessen Tabellen aufgelistet werden sollen. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• Expression – UTF-8-Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum Single-line string pattern.

  Ein Muster von regulären Ausdrücken. Sofern vorhanden, werden nur die Tabellen, deren Namen mit dem Muster übereinstimmen, zurückgegeben.

• NextToken – UTF-8-Zeichenfolge.

  Ein Fortsetzungs-Token, der enthalten ist, wenn dies ein Fortsetzungsaufruf ist.

• MaxResults – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 100.

  Gibt die maximale Anzahl der Tabellen an, die in einer Antwort zurückzugeben sind.

• TransactionId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Custom string pattern #44.

  Die Transaktions-ID, an der der Tabellinhalt gelesen werden soll.

• QueryAsOfTime – Zeitstempel.

  Die Zeit, zu der der Tabelleninhalt gelesen werden muss. Wenn nicht festgelegt, wird die letzte Transaktions-Commit-Zeit verwendet. Kann nicht zusammen mit TransactionId angegeben werden.

• AuditContext – Ein AuditContext-Objekt.

  Eine Struktur, die den Lake Formation Prüfungskontext enthält.

• IncludeStatusDetails – Boolesch.

  Gibt an, ob Statusdetails im Zusammenhang mit einer Anforderung zur Erstellung oder Aktualisierung einer AWS Glue Datenkatalogansicht aufgenommen werden sollen.

• AttributesToGet – Ein UTF-8-Zeichenfolgen-Array.

  Gibt die vom GetTables-Aufruf zurückgegebenen Tabellenfelder an. Dieser Parameter akzeptiert keine leere Liste. Die Anforderung muss NAME enthalten.

  Im Folgenden sind die gültigen Kombinationen von Werten aufgeführt:

  • NAME – Namen aller Tabellen in der Datenbank.

  • NAME, TABLE_TYPE – Namen aller Tabellen und der Tabellentypen.

Antwort

• TableList – Ein Array mit Tabelle-Objekten.

  Eine Liste der angeforderten Table-Objekte.

• NextToken – UTF-8-Zeichenfolge.

  Ein Fortsetzungs-Token, der vorhanden ist, wenn das aktuelle Listensegment nicht das letzte ist.

Fehler

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• GlueEncryptionException

• FederationSourceException

• FederationSourceRetryableException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die Tabellen befinden. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die Datenbank im Katalog, in dem sich die Tabelle befindet. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• TableName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Tabelle. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• VersionId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der ID-Wert der Tabellenversion, die abgerufen werden soll. Eine VersionID ist eine Zeichenfolgendarstellung einer Ganzzahl. Jede Version wird um 1 erhöht.

Antwort

• TableVersion – Ein TableVersion-Objekt.

  Die angeforderte Tabellenversion.

Fehler

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die Tabellen befinden. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die Datenbank im Katalog, in dem sich die Tabelle befindet. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• TableName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Tabelle. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• NextToken – UTF-8-Zeichenfolge.

  Ein Fortsetzungs-Token, wenn dies nicht der erste Aufruf ist.

• MaxResults – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 100.

  Die maximale Anzahl von Tabellenversionen, die in einer Antwort zurückzugeben sind.

Antwort

• TableVersions – Ein Array mit TableVersion-Objekten.

  Eine Liste der Zeichenfolgen, die verfügbare Versionen der angegebenen Tabelle identifizieren.

• NextToken – UTF-8-Zeichenfolge.

  Ein Fortsetzungs-Token, wenn die Liste der verfügbaren Versionen nicht die letzte enthält.

Fehler

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die Tabellen befinden. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die Datenbank im Katalog, in dem sich die Tabelle befindet. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• TableName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Tabelle. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• VersionId – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der ID-Wert der Tabellenversion, die gelöscht werden soll. Eine VersionID ist eine Zeichenfolgendarstellung einer Ganzzahl. Jede Version wird um 1 erhöht.

Antwort

• Keine Antwortparameter.

Fehler

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die Tabellen befinden. Wenn keine angegeben wird, wird standardmäßig die Konto-ID verwendet. AWS

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die Datenbank im Katalog, in dem sich die Tabelle befindet. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• TableName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Tabelle. Für Hive-Kompatibilität muss dieser Name vollständig aus Kleinbuchstaben bestehen.

• VersionIds – Erforderlich: Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 100 Zeichenfolgen.

  Eine Liste IDs der Versionen, die gelöscht werden sollen. Eine VersionId ist eine Zeichenfolgendarstellung einer Ganzzahl. Jede Version wird um 1 erhöht.

Antwort

• Errors – Ein Array mit TableVersionError-Objekten.

  Eine Liste der Fehler, die beim Löschen der angegebenen Tabellenversionen aufgetreten sind.

Fehler

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Eine eindeutige Kennung, bestehend aus account_id.

• NextToken – UTF-8-Zeichenfolge.

  Ein Fortsetzungs-Token, der enthalten ist, wenn dies ein Fortsetzungsaufruf ist.

• Filters – Ein Array mit PropertyPredicate-Objekten.

  Eine Liste von Schlüssel-Wert-Paaren und ein Vergleichswert, der zum Filtern der Suchergebnisse verwendet wird. Gibt alle Entitäten zurück, die mit dem Prädikat übereinstimmen.

  Das Comparator-Mitglied von PropertyPredicate struct wird nur für Zeitfelder verwendet und kann für andere Feldtypen weggelassen werden. Auch beim Vergleichen von Zeichenfolgenwerten, z. B. Key=Name, wird ein Fuzzy-Match-Algorithmus verwendet. Das Key-Feld (z. B. der Wert des Name-Felds) wird auf bestimmte Satzzeichen aufgeteilt, zum Beispiel -, :, # usw. in Token. Dann ist jedes Token eine exakte Übereinstimmung im Vergleich mit dem Value-Mitglied von PropertyPredicate. Wenn zum Beispiel Key=Name und Value=link sind, werden Tabellen mit dem Namen customer-link und xx-link-yy zurückgegeben, aber xxlinkyy wird nicht zurückgegeben.

• SearchText – Wertzeichenfolge, mindestens 1 und höchstens 1024 Byte lang.

  Eine Zeichenfolge, die für eine Textsuche verwendet wird.

  Wenn Sie einen Wert in Anführungszeichen angeben, werden Filter basierend auf einer exakten Übereinstimmung mit dem Wert angewendet.

• SortCriteria – Ein Array mit SortCriterion-Objekten, nicht mehr als 1 Struktur.

  Eine Liste von Kriterien zum Sortieren der Ergebnisse nach einem Feldnamen in auf- oder absteigender Reihenfolge.

• MaxResults – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000.

  Gibt die maximale Anzahl der Tabellen an, die in einer Antwort zurückzugeben sind.

• ResourceShareType – UTF-8-Zeichenfolge (zulässige Werte: FOREIGN | ALL | FEDERATED).

  Hier können Sie angeben, dass Sie die für Ihr Konto freigegebenen Datenbanken durchsuchen möchten. Die zulässigen Werte sind FOREIGN oder ALL.

  • Bei Auswahl von FOREIGN werden die Tabellen durchsucht, die für Ihr Konto freigegeben wurden.

  • Bei Auswahl von ALL werden die Tabellen durchsucht, die für Ihr Konto freigegeben sind, sowie die Tabellen in Ihrem lokalen Konto.

• IncludeStatusDetails – Boolesch.

  Gibt an, ob Statusdetails im Zusammenhang mit einer Anforderung zur Erstellung oder Aktualisierung einer AWS Glue Datenkatalogansicht aufgenommen werden sollen.

Antwort

• NextToken – UTF-8-Zeichenfolge.

  Ein Fortsetzungs-Token, der vorhanden ist, wenn das aktuelle Listensegment nicht das letzte ist.

• TableList – Ein Array mit Tabelle-Objekten.

  Eine Liste der angeforderten Table-Objekte. Die SearchTables-Antwort gibt nur die Tabellen zurück, auf die Sie Zugriff haben.

Fehler

• InternalServiceException

• InvalidInputException

• OperationTimeoutException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die Katalog-ID, in dem sich die Tabelle befindet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Gibt den Namen einer Datenbank an, aus der Partitionsindizes abgerufen werden sollen.

• TableName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Gibt den Namen einer Tabelle an, für die Sie die Partitionsindizes abrufen möchten.

• NextToken – UTF-8-Zeichenfolge.

  Ein Fortsetzungs-Token, der enthalten ist, wenn dies ein Fortsetzungsaufruf ist.

Antwort

• PartitionIndexDescriptorList – Ein Array mit PartitionIndexDescriptor-Objekten.

  Eine Liste von Indexdeskriptoren.

• NextToken – UTF-8-Zeichenfolge.

  Ein Fortsetzungs-Token, der vorhanden ist, wenn das aktuelle Listensegment nicht das letzte ist.

Fehler

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• EntityNotFoundException

• ConflictException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die Katalog-ID, in dem sich die Tabelle befindet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Gibt den Namen einer Datenbank an, in der Sie einen Partitionsindex erstellen möchten.

• TableName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Gibt den Namen einer Tabelle an, in der Sie einen Partitionsindex erstellen möchten.

• PartitionIndex – Erforderlich: Ein PartitionIndex-Objekt.

  Gibt eine PartitionIndex-Struktur an, um einen Partitionsindex in einer vorhandenen Tabelle zu erstellen.

Antwort

• Keine Antwortparameter.

Fehler

• AlreadyExistsException

• InvalidInputException

• EntityNotFoundException

• ResourceNumberLimitExceededException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die Katalog-ID, in dem sich die Tabelle befindet.

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Gibt den Namen einer Datenbank an, aus der Sie einen Partitionsindex löschen möchten.

• TableName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Gibt den Namen einer Tabelle an, aus der Sie einen Partitionsindex löschen möchten.

• IndexName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name des Partitionsindexes, der gelöscht werden soll.

Antwort

• Keine Antwortparameter.

Fehler

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• EntityNotFoundException

• ConflictException

• GlueEncryptionException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die entsprechenden Partitionen befinden. Wenn keine angegeben wird, wird standardmäßig die Konto-ID verwendet. AWS

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Katalogdatenbank, in der sich die Partitionen befinden.

• TableName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Partitionentabelle.

• ColumnNames – Erforderlich: Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 100 Zeichenfolgen.

  Eine Liste der Spaltennamen.

Antwort

• ColumnStatisticsList – Ein Array mit ColumnStatistics-Objekten.

  Liste von ColumnStatistics.

• Errors – Ein Array mit ColumnError-Objekten.

  Die Liste ColumnStatistics davon konnte nicht abgerufen werden.

Fehler

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die entsprechenden Partitionen befinden. Wenn keine angegeben wird, wird standardmäßig die Konto-ID verwendet. AWS

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Katalogdatenbank, in der sich die Partitionen befinden.

• TableName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Partitionentabelle.

• ColumnStatisticsList – Erforderlich: Ein Array mit ColumnStatistics-Objekten, nicht mehr als 25 Strukturen.

  Eine Liste der Spaltenstatistiken.

Antwort

• Errors – Ein Array mit ColumnStatisticsError-Objekten.

  Liste von ColumnStatisticsErrors.

Fehler

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Anforderung

• CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Die ID des Data Catalog, in dem sich die entsprechenden Partitionen befinden. Wenn keine angegeben wird, wird standardmäßig die Konto-ID verwendet. AWS

• DatabaseName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Katalogdatenbank, in der sich die Partitionen befinden.

• TableName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Partitionentabelle.

• ColumnName – Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

  Der Name der Spalte.

Antwort

• Keine Antwortparameter.

Fehler

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException