Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Katalogobjekte-API
Die API für Katalogobjekte beschreibt die Datentypen und die API im Zusammenhang mit der Arbeit mit Katalogen in AWS Glue.
**Topics**
+ [Catalogs-API](aws-glue-api-catalog-catalogs.md)
+ [Datenbank-API](aws-glue-api-catalog-databases.md)
+ [Tabellen-API](aws-glue-api-catalog-tables.md)
+ [Partitions-API](aws-glue-api-catalog-partitions.md)
+ [Verbindungs-API](aws-glue-api-catalog-connections.md)
+ [Benutzerdefinierte Funktion (API)](aws-glue-api-catalog-functions.md)
+ [Einen Athena Katalog importieren nach AWS Glue](aws-glue-api-catalog-migration.md)
# Catalogs-API
Die Catalogs API beschreibt das APIs Erstellen, Löschen, Suchen, Aktualisieren und Auflisten von Katalogen.
## Datentypen
+ [Katalogstruktur](#aws-glue-api-catalog-catalogs-Catalog)
+ [CatalogInput Struktur](#aws-glue-api-catalog-catalogs-CatalogInput)
+ [TargetRedshiftCatalog Struktur](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog)
+ [CatalogProperties Struktur](#aws-glue-api-catalog-catalogs-CatalogProperties)
+ [CatalogPropertiesOutput Struktur](#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput)
+ [DataLakeAccessProperties Struktur](#aws-glue-api-catalog-catalogs-DataLakeAccessProperties)
+ [IcebergOptimizationProperties Struktur](#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties)
+ [DataLakeAccessPropertiesOutput Struktur](#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput)
+ [IcebergOptimizationPropertiesOutput Struktur](#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput)
+ [FederatedCatalog Struktur](#aws-glue-api-catalog-catalogs-FederatedCatalog)
## Katalogstruktur
Das Katalogobjekt stellt eine logische Gruppierung von Datenbanken im AWS Glue Datenkatalog oder eine Verbundquelle dar. Sie können jetzt einen Redshift-Verbundkatalog oder einen Katalog mit Ressourcenlinks zu Redshift-Datenbanken in einem anderen Konto oder einer anderen Region erstellen.
**Felder**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Katalogs. Um Zugriff auf den Standardkatalog zu gewähren, sollte dieses Feld nicht angegeben werden.
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 65 536 Bytes lang, passend zum [Custom string pattern #25](aws-glue-api-common.md#regex_25).
Der Name des Katalogs. Kann nicht mit der Konto-ID identisch sein.
+ `ResourceArn` – UTF-8-Zeichenfolge.
Der Amazon-Ressourcenname (ARN), der der Katalogressource zugewiesen ist.
+ `Description` – Beschreibende Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Beschreibende Zeichenfolge mit maximal 2.048 Bytes an, entsprechend der mehrzeiligen Zeichenfolgenmuster für URI-Adressen. Eine Beschreibung des Katalogs.
+ `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Ein Map-Array von Schlüssel-Wert-Paaren, die Parameter und Eigenschaften des Katalogs definieren.
+ `CreateTime` – Zeitstempel.
Die Uhrzeit, zu der der Katalog erstellt wurde.
+ `UpdateTime` – Zeitstempel.
Die Uhrzeit, zu der der Katalog zuletzt aktualisiert wurde.
+ `TargetRedshiftCatalog` – Ein [TargetRedshiftCatalog](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog)-Objekt.
Ein `TargetRedshiftCatalog`-Objekt, das einen Zielkatalog für die Verknüpfung von Datenbankressourcen beschreibt.
+ `FederatedCatalog` – Ein [FederatedCatalog](#aws-glue-api-catalog-catalogs-FederatedCatalog)-Objekt.
Ein `FederatedCatalog` Objekt, das auf eine Entität außerhalb des AWS Glue Datenkatalogs verweist.
+ `CatalogProperties` – Ein [CatalogPropertiesOutput](#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput)-Objekt.
Ein `CatalogProperties`-Objekt, das die Eigenschaften für den Zugriff auf Data Lake und andere benutzerdefinierte Eigenschaften angibt.
+ `CreateTableDefaultPermissions` – Ein Array mit [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions)-Objekten.
Ein Array von `PrincipalPermissions`-Objekten. Erstellt einen Satz von Standardberechtigungen für die Tabelle(n) für Prinzipale. Wird verwendet von AWS Lake Formation. Wird im normalen AWS Glue Betriebsablauf nicht verwendet.
+ `CreateDatabaseDefaultPermissions` – Ein Array mit [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions)-Objekten.
Ein Array von `PrincipalPermissions`-Objekten. Erstellt einen Satz von Standardberechtigungen für die Datenbank(en) für Prinzipale. Wird von verwendet AWS Lake Formation. Wird im normalen AWS Glue Betriebsablauf nicht verwendet.
+ `AllowFullTableExternalDataAccess` – UTF-8-Zeichenfolge (zulässige Werte: `True` \$1 `False`).
Ermöglicht Engines von Drittanbietern den Zugriff auf Daten an Amazon S3 Standorten, die bei Lake Formation registriert sind.
## CatalogInput Struktur
Eine Struktur, die Katalogeigenschaften beschreibt.
**Felder**
+ `Description` – Beschreibende Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Beschreibende Zeichenfolge mit maximal 2.048 Bytes an, entsprechend der mehrzeiligen Zeichenfolgenmuster für URI-Adressen. Eine Beschreibung des Katalogs.
+ `FederatedCatalog` – Ein [FederatedCatalog](#aws-glue-api-catalog-catalogs-FederatedCatalog)-Objekt.
Ein `FederatedCatalog`-Objekt. Eine `FederatedCatalog` Struktur, die auf eine Entität außerhalb des AWS Glue Datenkatalogs verweist, z. B. eine Redshift-Datenbank.
+ `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Ein Map-Array von Schlüssel-Wert-Paaren, die die Parameter und Eigenschaften des Katalogs definieren.
+ `TargetRedshiftCatalog` – Ein [TargetRedshiftCatalog](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog)-Objekt.
Ein `TargetRedshiftCatalog`-Objekt, das einen Zielkatalog für die Verknüpfung von Ressourcen beschreibt.
+ `CatalogProperties` – Ein [CatalogProperties](#aws-glue-api-catalog-catalogs-CatalogProperties)-Objekt.
Ein `CatalogProperties`-Objekt, das die Eigenschaften für den Zugriff auf Data Lake und andere benutzerdefinierte Eigenschaften angibt.
+ `CreateTableDefaultPermissions` – Ein Array mit [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions)-Objekten.
Ein Array von `PrincipalPermissions`-Objekten. Erstellt einen Satz von Standardberechtigungen für die Tabelle(n) für Prinzipale. Wird verwendet von AWS Lake Formation. Sollte normalerweise explizit als leere Liste festgelegt werden.
+ `CreateDatabaseDefaultPermissions` – Ein Array mit [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions)-Objekten.
Ein Array von `PrincipalPermissions`-Objekten. Erstellt einen Satz von Standardberechtigungen für die Datenbank(en) für Prinzipale. Benutzt von AWS Lake Formation. Sollte normalerweise explizit als leere Liste festgelegt werden.
+ `AllowFullTableExternalDataAccess` – UTF-8-Zeichenfolge (zulässige Werte: `True` \$1 `False`).
Ermöglicht Engines von Drittanbietern den Zugriff auf Daten an Amazon S3 Standorten, die bei Lake Formation registriert sind.
## TargetRedshiftCatalog Struktur
Eine Struktur, die einen Zielkatalog für die Verknüpfung von Ressourcen beschreibt.
**Felder**
+ `CatalogArn` – *Erforderlich:* UTF-8-Zeichenfolge.
Der Amazon-Ressourcenname (ARN) der Katalogressource.
## CatalogProperties Struktur
Eine Struktur, die die Eigenschaften für den Zugriff auf Data Lake und andere benutzerdefinierte Eigenschaften angibt.
**Felder**
+ `DataLakeAccessProperties` – Ein [DataLakeAccessProperties](#aws-glue-api-catalog-catalogs-DataLakeAccessProperties)-Objekt.
Ein `DataLakeAccessProperties` Objekt, das Eigenschaften zur Konfiguration des Data Lake-Zugriffs für Ihre Katalogressource im AWS Glue Datenkatalog festlegt.
+ `IcebergOptimizationProperties` – Ein [IcebergOptimizationProperties](#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties)-Objekt.
Eine Struktur, die die Iceberg-Tabellenoptimierungseigenschaften für den Katalog festlegt. Dazu gehört die Konfiguration für Vorgänge zum Komprimieren, Aufbewahren und Löschen verwaister Dateien, die auf Iceberg-Tabellen in diesem Katalog angewendet werden können.
+ `CustomProperties` – 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Zusätzliche Schlüssel-Wert-Eigenschaften für den Katalog, beispielsweise Optimierungen der Spaltenstatistiken.
## CatalogPropertiesOutput Struktur
Eigenschaftsattribute, die die Konfigurationseigenschaften für die Katalogressource enthalten.
**Felder**
+ `DataLakeAccessProperties` – Ein [DataLakeAccessPropertiesOutput](#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput)-Objekt.
Ein `DataLakeAccessProperties` Objekt mit Eingabeeigenschaften zur Konfiguration des Data Lake-Zugriffs für Ihre Katalogressource im AWS Glue Datenkatalog.
+ `IcebergOptimizationProperties` – Ein [IcebergOptimizationPropertiesOutput](#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput)-Objekt.
Ein `IcebergOptimizationPropertiesOutput`-Objekt, das die Iceberg-Tabellenoptimierungseinstellungen für den Katalog festlegt, einschließlich Konfigurationen für Vorgänge zum Komprimieren, Aufbewahren und Löschen verwaister Dateien.
+ `CustomProperties` – 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Zusätzliche Schlüssel-Wert-Eigenschaften für den Katalog, beispielsweise Optimierungen der Spaltenstatistiken.
## DataLakeAccessProperties Struktur
Geben Sie Eigenschaften ein, um den Data Lake-Zugriff für Ihre Katalogressource im AWS Glue Datenkatalog zu konfigurieren.
**Felder**
+ `DataLakeAccess` – Boolesch.
Aktiviert oder deaktiviert den Data-Lake-Zugriff für Apache Spark-Anwendungen, die über eine Nicht-Redshift-Engine wie Amazon Athena, Amazon EMR oder ETL auf Amazon Redshift-Datenbanken im Data Catalog zugreifen. AWS Glue
+ `DataTransferRole` – UTF-8-Zeichenfolge, die [Custom string pattern #53](aws-glue-api-common.md#regex_53) entspricht.
Eine Rolle, die AWS Glue für die Übertragung von Daten aus dem Staging-Bucket während into/out einer Abfrage übernommen wird.
+ `KmsKey` – UTF-8-Zeichenfolge.
Ein Verschlüsselungsschlüssel, der für den Staging-Bucket verwendet wird, der zusammen mit dem Katalog erstellt wird.
+ `CatalogType` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Gibt einen Verbundkatalogtyp für die systemeigene Katalogressource an. Der derzeit unterstützte Typ ist `aws:redshift`.
## IcebergOptimizationProperties Struktur
Eine Struktur, die die Iceberg-Tabellenoptimierungseigenschaften für den Katalog festlegt, einschließlich Konfigurationen für Vorgänge zum Komprimieren, Aufbewahren und Löschen verwaister Dateien.
**Felder**
+ `RoleArn` – UTF-8-Zeichenfolge, die [Custom string pattern #53](aws-glue-api-common.md#regex_53) entspricht.
Der Amazon-Ressourcenname (ARN) der IAM-Rolle, von der angenommen wird, dass sie Vorgänge zur Iceberg-Tabellenoptimierung ausführt.
+ `Compaction` – 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Eine Zuordnung von Schlüssel-Wert-Paaren, die Konfigurationsparameter für Vorgänge zur Iceberg-Tabellenkomprimierung angeben, die das Layout von Datendateien optimieren, um die Abfrageleistung zu verbessern.
+ `Retention` – 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Eine Zuordnung von Schlüssel-Wert-Paaren, die Konfigurationsparameter für Vorgänge zur Iceberg-Tabellenaufbewahrung angeben, die den Lebenszyklus von Tabellen-Snapshots verwalten, um die Speicherkosten zu kontrollieren.
+ `OrphanFileDeletion` – 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Eine Zuordnung von Schlüssel-Wert-Paaren, die Konfigurationsparameter für Iceberg-Vorgänge zum Löschen verwaister Dateien angeben, mit denen Dateien identifiziert und entfernt werden, auf die in den Tabellenmetadaten nicht mehr verwiesen wird.
## DataLakeAccessPropertiesOutput Struktur
Die Ausgabeeigenschaften der Data Lake-Zugriffskonfiguration für Ihre Katalogressource im AWS Glue Datenkatalog.
**Felder**
+ `DataLakeAccess` – Boolesch.
Aktiviert oder deaktiviert den Data-Lake-Zugriff für Apache Spark-Anwendungen, die auf Amazon-Redshift-Datenbanken im Datenkatalog zugreifen.
+ `DataTransferRole` – UTF-8-Zeichenfolge, die [Custom string pattern #53](aws-glue-api-common.md#regex_53) entspricht.
Eine Rolle, die AWS Glue für die Übertragung into/out von Daten aus dem Staging-Bucket während einer Abfrage übernommen wird.
+ `KmsKey` – UTF-8-Zeichenfolge.
Ein Verschlüsselungsschlüssel, der für den Staging-Bucket verwendet wird, der zusammen mit dem Katalog erstellt wird.
+ `ManagedWorkgroupName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der verwaltete Redshift-Serverless-Name der Datenverarbeitungsumgebung, der für Ihre Katalogressource erstellt wurde.
+ `ManagedWorkgroupStatus` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der verwaltete Redshift-Serverless-Status der Datenverarbeitungsumgebung.
+ `RedshiftDatabaseName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Standardname der Redshift-Datenbankressource in der verwalteten Datenverarbeitungsumgebung.
+ `StatusMessage` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Eine Nachricht mit detaillierteren Informationen zum Status der verwalteten Arbeitsgruppe.
+ `CatalogType` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Gibt einen Verbundkatalogtyp für die systemeigene Katalogressource an. Der derzeit unterstützte Typ ist `aws:redshift`.
## IcebergOptimizationPropertiesOutput Struktur
Eine Struktur, die die Ausgabeeigenschaften der Iceberg-Tabellenoptimierungskonfiguration für Ihre Katalogressource im AWS Glue Datenkatalog enthält.
**Felder**
+ `RoleArn` – UTF-8-Zeichenfolge, die [Custom string pattern #53](aws-glue-api-common.md#regex_53) entspricht.
Der Amazon-Ressourcenname (ARN) der IAM-Rolle, die verwendet wird, um Vorgänge zur Iceberg-Tabellenoptimierung auszuführen.
+ `Compaction` – 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Eine Zuordnung von Schlüssel-Wert-Paaren, die Konfigurationsparameter für Vorgänge zur Iceberg-Tabellenkomprimierung angeben, die das Layout von Datendateien optimieren, um die Abfrageleistung zu verbessern.
+ `Retention` – 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Eine Zuordnung von Schlüssel-Wert-Paaren, die Konfigurationsparameter für Vorgänge zur Iceberg-Tabellenaufbewahrung angeben, die den Lebenszyklus von Tabellen-Snapshots verwalten, um die Speicherkosten zu kontrollieren.
+ `OrphanFileDeletion` – 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Eine Zuordnung von Schlüssel-Wert-Paaren, die Konfigurationsparameter für Iceberg-Vorgänge zum Löschen verwaister Dateien angeben, mit denen Dateien identifiziert und entfernt werden, auf die in den Tabellenmetadaten nicht mehr verwiesen wird.
+ `LastUpdatedTime` – Zeitstempel.
Der Zeitstempel der letzten Aktualisierung der Eigenschaften zur Iceberg-Optimierung.
## FederatedCatalog Struktur
Ein Katalog, der auf eine Entität außerhalb des AWS Glue Datenkatalogs verweist.
**Felder**
+ `Identifier` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 512 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Eine eindeutige Kennung für den Verbundkatalog.
+ `ConnectionName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Verbindung zu einer externen Datenquelle, beispielsweise einem RedShift-Verbundkatalog.
+ `ConnectionType` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Typ der Verbindung, die für den Zugriff auf den Verbundkatalog verwendet wird, wobei das Protokoll oder die Methode für die Verbindung mit der externen Datenquelle angegeben wird.
## Operationen
+ [CreateCatalog Aktion (Python: create\$1catalog)](#aws-glue-api-catalog-catalogs-CreateCatalog)
+ [UpdateCatalog Aktion (Python: update\$1catalog)](#aws-glue-api-catalog-catalogs-UpdateCatalog)
+ [DeleteCatalog Aktion (Python: delete\$1catalog)](#aws-glue-api-catalog-catalogs-DeleteCatalog)
+ [GetCatalog Aktion (Python: get\$1catalog)](#aws-glue-api-catalog-catalogs-GetCatalog)
+ [GetCatalogs Aktion (Python: get\$1catalogs)](#aws-glue-api-catalog-catalogs-GetCatalogs)
## CreateCatalog Aktion (Python: create\$1catalog)
Erstellt einen neuen Katalog im AWS Glue Datenkatalog.
**Anforderung**
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 65 536 Bytes lang, passend zum [Custom string pattern #25](aws-glue-api-common.md#regex_25).
Der Name des zu erstellenden Katalogs.
+ `CatalogInput` – *Erforderlich:* Ein [CatalogInput](#aws-glue-api-catalog-catalogs-CatalogInput)-Objekt.
Ein `CatalogInput`-Objekt, das die Metadaten für den Katalog definiert.
+ `Tags` – Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 50 Paare.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht mehr als 256 Bytes lang ist.
Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 50 Paare. Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist. Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht mehr als 256 Bytes lang ist. Die Tags, die Sie dem Katalog zuweisen.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederatedResourceAlreadyExistsException`
+ `FederationSourceException`
## UpdateCatalog Aktion (Python: update\$1catalog)
Aktualisiert die Eigenschaften eines vorhandenen Katalogs im AWS Glue Datenkatalog.
**Anforderung**
+ `CatalogId` – *Erforderlich:* Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Katalogs.
+ `CatalogInput` – *Erforderlich:* Ein [CatalogInput](#aws-glue-api-catalog-catalogs-CatalogInput)-Objekt.
Ein `CatalogInput`-Objekt, das die neuen Eigenschaften eines vorhandenen Katalogs angibt.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `FederationSourceException`
## DeleteCatalog Aktion (Python: delete\$1catalog)
Entfernt den angegebenen Katalog aus dem AWS Glue Datenkatalog.
Nach Abschluss dieses Vorgangs haben Sie keinen Zugriff mehr auf die Datenbanken, Tabellen (und alle Tabellenversionen und Partitionen, die möglicherweise zu den Tabellen gehören) und die benutzerdefinierten Funktionen im gelöschten Katalog. AWS Glue löscht diese „verwaisten“ Ressourcen nach Ermessen des Dienstes asynchron und rechtzeitig.
Um die sofortige Löschung aller damit verbundenen Ressourcen zu gewährleisten, bevor Sie den `DeleteCatalog`-Vorgang aufrufen, verwenden Sie `DeleteTableVersion` (oder `BatchDeleteTableVersion`), `DeletePartition` (oder `BatchDeletePartition`), `DeleteTable` (oder `BatchDeleteTable`), `DeleteUserDefinedFunction` und `DeleteDatabase`, um alle Ressourcen zu löschen, die zum Katalog gehören.
**Anforderung**
+ `CatalogId` – *Erforderlich:* Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Katalogs.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `FederationSourceException`
## GetCatalog Aktion (Python: get\$1catalog)
Der Name des abzurufenden Katalogs. Alles sollte in Kleinbuchstaben geschrieben sein.
**Anforderung**
+ `CatalogId` – *Erforderlich:* Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des übergeordneten Katalogs, in dem der Katalog gespeichert ist. Wenn keine angegeben wird, wird standardmäßig die AWS Kontonummer verwendet.
**Antwort**
+ `Catalog` – Ein [Katalog](#aws-glue-api-catalog-catalogs-Catalog)-Objekt.
Ein `Catalog`-Objekt. Die Definition des angegebenen Katalogs im AWS Glue Datenkatalog.
**Fehler**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## GetCatalogs Aktion (Python: get\$1catalogs)
Ruft alle Kataloge ab, die in einem Katalog im AWS Glue -Datenkatalog definiert sind. Für einen Anwendungsfall mit einem Redshift-Verbundkatalog gibt dieser Vorgang die Liste der Kataloge zurück, die Redshift-Datenbanken im Redshift-Namespace-Katalog zugeordnet sind.
**Anforderung**
+ `ParentCatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des übergeordneten Katalogs, in dem der Katalog gespeichert ist. Wenn keine angegeben wird, wird standardmäßig die AWS Kontonummer verwendet.
+ `NextToken` – UTF-8-Zeichenfolge.
Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist.
+ `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000.
Die maximale Anzahl der Kataloge, die in einer Antwort zurückgegeben werden können.
+ `Recursive` – Boolesch.
Gibt an, ob alle Kataloge in der Kataloghierarchie aufgelistet werden sollen, beginnend mit `ParentCatalogId`. Standardeinstellung: `false`. Bei `true` werden alle Katalogobjekte in der `ParentCatalogID`-Hierarchie in der Antwort aufgezählt.
+ `IncludeRoot` – Boolesch.
Gibt an, ob der Standardkatalog für das Konto und die Region in der Antwort aufgelistet werden soll. Standardeinstellung: `false`. Bei `true` und `ParentCatalogId = NULL | AWS Account ID` werden alle Kataloge und der Standardkatalog in der Antwort aufgelistet.
Wenn `ParentCatalogId` nicht gleich null ist und dieses Attribut als `false` oder `true` übergeben wird, wird ein `InvalidInputException` ausgelöst.
**Antwort**
+ `CatalogList` – *Erforderlich:* Ein Array mit [Katalog](#aws-glue-api-catalog-catalogs-Catalog)-Objekten.
Ein Array von `Catalog`-Objekten. Eine Liste von `Catalog`-Objekten aus dem angegebenen übergeordneten Katalog.
+ `NextToken` – UTF-8-Zeichenfolge.
Ein Fortsetzungs-Token zum Paginieren der zurückgegebenen Token-Liste. Wird zurückgegeben, wenn das aktuelle Segment der Liste nicht das letzte ist.
**Fehler**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
# Datenbank-API
Die Datenbank-API beschreibt Datenbankdatentypen und umfasst die API zum Erstellen, Löschen, Auffinden, Aktualisieren und Auflisten von Datenbanken.
## Datentypen
+ [Database-Struktur](#aws-glue-api-catalog-databases-Database)
+ [DatabaseInput Struktur](#aws-glue-api-catalog-databases-DatabaseInput)
+ [PrincipalPermissions Struktur](#aws-glue-api-catalog-databases-PrincipalPermissions)
+ [DataLakePrincipal Struktur](#aws-glue-api-catalog-databases-DataLakePrincipal)
+ [DatabaseIdentifier Struktur](#aws-glue-api-catalog-databases-DatabaseIdentifier)
+ [FederatedDatabase Struktur](#aws-glue-api-catalog-databases-FederatedDatabase)
## Database-Struktur
Das `Database`-Objekt stellt eine logische Gruppierung von Tabellen dar, die sich in einem Hive-Metastore oder einem RDBMS befinden können.
**Felder**
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Name der Datenbank. 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](aws-glue-api-common.md#aws-glue-api-regex-uri).
Eine Beschreibung der Datenbank.
+ `LocationUri` – Uniform Resource Identifier (uri), nicht weniger als 1 oder mehr als 1024 Bytes lang, passend zum [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Die Speicheradresse der Datenbank (z. B. HDFS-Pfad).
+ `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Diese Schlüssel-Wert-Paare definieren Parameter und Eigenschaften der Datenbank.
+ `CreateTime` – Zeitstempel.
Der Zeitpunkt, zu dem die Metadatenbank im Katalog angelegt wurde.
+ `CreateTableDefaultPermissions` – Ein Array mit [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions)-Objekten.
Erstellt einen Satz von Standardberechtigungen für die Tabelle für Prinzipale. Benutzt von AWS Lake Formation. Wird im normalen AWS Glue Betriebsablauf nicht verwendet.
+ `TargetDatabase` – Ein [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier)-Objekt.
Eine `DatabaseIdentifier`-Struktur, die eine Zieldatenbank 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem die Datenbank gespeichert ist.
+ `FederatedDatabase` – Ein [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase)-Objekt.
Eine `FederatedDatabase`-Struktur, die auf eine Entität außerhalb von AWS Glue Data Catalog verweist.
## DatabaseInput Struktur
Die Struktur, die zum Anlegen oder Aktualisieren einer Datenbank verwendet wird.
**Felder**
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Name der Datenbank. 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](aws-glue-api-common.md#aws-glue-api-regex-uri).
Eine Beschreibung der Datenbank.
+ `LocationUri` – Uniform Resource Identifier (uri), nicht weniger als 1 oder mehr als 1024 Bytes lang, passend zum [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Die Speicheradresse der Datenbank (z. B. HDFS-Pfad).
+ `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Diese Schlüssel-Wert-Paare definieren Parameter und Eigenschaften der Datenbank.
Diese Schlüssel-Wert-Paare definieren Parameter und Eigenschaften der Datenbank.
+ `CreateTableDefaultPermissions` – Ein Array mit [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions)-Objekten.
Erstellt einen Satz von Standardberechtigungen für die Tabelle für Prinzipale. Benutzt von AWS Lake Formation. Wird im normalen AWS Glue Betriebsablauf nicht verwendet.
+ `TargetDatabase` – Ein [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier)-Objekt.
Eine `DatabaseIdentifier`-Struktur, die eine Zieldatenbank für die Verknüpfung von Ressourcen beschreibt.
+ `FederatedDatabase` – Ein [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase)-Objekt.
Eine `FederatedDatabase`-Struktur, die auf eine Entität außerhalb von AWS Glue Data Catalog verweist.
## PrincipalPermissions Struktur
Berechtigungen, die einem Prinzipal erteilt wurden.
**Felder**
+ `Principal` – Ein [DataLakePrincipal](#aws-glue-api-catalog-databases-DataLakePrincipal)-Objekt.
Der Prinzipal, dem Berechtigungen erteilt werden.
+ `Permissions` – Ein UTF-8-Zeichenfolgen-Array.
Die Berechtigungen, die dem Prinzipal gewährt werden.
## DataLakePrincipal Struktur
Der AWS Lake Formation Schulleiter.
**Felder**
+ `DataLakePrincipalIdentifier` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang.
Eine Kennung für den AWS Lake Formation Principal.
## DatabaseIdentifier Struktur
Eine Struktur, die eine Zieldatenbank für die Verknüpfung von Ressourcen beschreibt.
**Felder**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem die Datenbank gespeichert ist.
+ `DatabaseName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Katalogdatenbank.
+ `Region` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Region der Zieldatenbank.
## FederatedDatabase Struktur
Eine Datenbank, die auf eine Entität außerhalb der AWS Glue Data Catalog verweist.
**Felder**
+ `Identifier` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 512 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Verbindungstyp, der für den Zugriff auf die Verbunddatenbank verwendet wird, z. B. JDBC, ODBC oder andere unterstützte Verbindungsprotokolle.
## Operationen
+ [CreateDatabase Aktion (Python: create\$1database)](#aws-glue-api-catalog-databases-CreateDatabase)
+ [UpdateDatabase Aktion (Python: update\$1database)](#aws-glue-api-catalog-databases-UpdateDatabase)
+ [DeleteDatabase Aktion (Python: delete\$1database)](#aws-glue-api-catalog-databases-DeleteDatabase)
+ [GetDatabase Aktion (Python: get\$1database)](#aws-glue-api-catalog-databases-GetDatabase)
+ [GetDatabases Aktion (Python: get\$1databases)](#aws-glue-api-catalog-databases-GetDatabases)
## CreateDatabase Aktion (Python: create\$1database)
Erstellt eine neue Datenbank in einem Data Catalog.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem die Datenbank erstellt wird. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `DatabaseInput` – *Erforderlich:* Ein [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput)-Objekt.
Die Metadaten für die Datenbank.
+ `Tags` – Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 50 Paare.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht mehr als 256 Bytes lang ist.
Die Tags, die Sie der Datenbank zuweisen.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `FederatedResourceAlreadyExistsException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## UpdateDatabase Aktion (Python: update\$1database)
Aktualisiert eine bestehende Datenbankdefinition in einem Data Catalog.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem die Metadaten-Datenbank gespeichert ist. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Datenbank, die im Katalog aktualisiert werden soll. Für Hive-Kompatibilität wird er in Kleinbuchstaben gespeichert.
+ `DatabaseInput` – *Erforderlich:* Ein [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput)-Objekt.
Ein `DatabaseInput`-Objekt, das die neue Definition der Metadaten-Datenbank im Katalog angibt.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
+ `AlreadyExistsException`
## DeleteDatabase Aktion (Python: delete\$1database)
Entfernt eine angegebene Datenbank aus einem Data Catalog.
**Anmerkung**
Nach Abschluss dieses Vorgangs haben Sie keinen Zugriff mehr auf die Tabellen (und alle Tabellenversionen und Partitionen, die möglicherweise zu den Tabellen gehören) und die benutzerdefinierten Funktionen in der gelöschten Datenbank. AWS Glue löscht diese „verwaisten“ Ressourcen nach Ermessen des Dienstes asynchron und rechtzeitig.
Um die sofortige Löschung aller damit verbundenen Ressourcen zu gewährleisten, bevor Sie `DeleteDatabase` aufrufen, verwenden Sie `DeleteTableVersion` oder `BatchDeleteTableVersion`, `DeletePartition` oder `BatchDeletePartition`, `DeleteUserDefinedFunction` und `DeleteTable` oder `BatchDeleteTable`, um alle Ressourcen zu löschen, die zur Datenbank gehören.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem die Datenbank gespeichert ist. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der zu löschenden Datenbank. Für Hive-Kompatibilität muss dieser vollständig aus Kleinbuchstaben bestehen.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## GetDatabase Aktion (Python: get\$1database)
Ruft die Definition einer angegebenen Datenbank ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem die Datenbank gespeichert ist. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Datenbank, die abgerufen werden soll. Für Hive-Kompatibilität sollte dieser vollständig aus Kleinbuchstaben bestehen.
**Antwort**
+ `Database` – Ein [Datenbank](#aws-glue-api-catalog-databases-Database)-Objekt.
Die Definition der angegebenen Datenbank im Data Catalog.
**Fehler**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## GetDatabases Aktion (Python: get\$1databases)
Ruft alle Datenbanken ab, die in einem bestimmten Data Catalog definiert sind.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, aus dem abgerufen werden soll `Databases`. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `NextToken` – UTF-8-Zeichenfolge.
Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist.
+ `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 100.
Die maximale Anzahl der Datenbanken, die in einer Antwort zurückgegeben werden können.
+ `ResourceShareType` – UTF-8-Zeichenfolge (zulässige Werte: `FOREIGN` \$1 `ALL` \$1 `FEDERATED`).
Hier können Sie angeben, dass Sie sich die für Ihr Konto freigegebenen Datenbanken auflisten lassen möchten. Die zulässigen Werte sind `FEDERATED`, `FOREIGN` oder `ALL`.
+ Wenn auf `FEDERATED` festgelegt, werden die Verbunddatenbanken (die auf eine externe Entität verweisen) aufgelistet, die für Ihr Konto freigegeben sind.
+ Bei Auswahl von `FOREIGN` werden die Datenbanken aufgelistet, die für Ihr Konto freigegeben wurden.
+ Bei Auswahl von `ALL` werden die Datenbanken aufgelistet, die für Ihr Konto freigegeben sind, sowie die Datenbanken in Ihrem lokalen Konto.
+ `AttributesToGet` – Ein UTF-8-Zeichenfolgen-Array.
Gibt die vom `GetDatabases`-Aufruf zurückgegebenen Datenbankfelder an. Dieser Parameter akzeptiert keine leere Liste. Die Anforderung muss den `NAME` enthalten.
**Antwort**
+ `DatabaseList` – *Erforderlich:* Ein Array mit [Datenbank](#aws-glue-api-catalog-databases-Database)-Objekten.
Eine Liste von `Database`-Objekten aus dem angegebenen Katalog.
+ `NextToken` – UTF-8-Zeichenfolge.
Ein Fortsetzungs-Token zum Paginieren der zurückgegebenen Token-Liste. Wird zurückgegeben, wenn das aktuelle Segment der Liste nicht das letzte ist.
**Fehler**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
# Tabellen-API
Die Tabellen-API beschreibt Datentypen und Operationen im Zusammenhang mit Tabellen.
## Datentypen
+ [Tabellenstruktur](#aws-glue-api-catalog-tables-Table)
+ [TableInput Struktur](#aws-glue-api-catalog-tables-TableInput)
+ [FederatedTable Struktur](#aws-glue-api-catalog-tables-FederatedTable)
+ [Spaltenstruktur](#aws-glue-api-catalog-tables-Column)
+ [StorageDescriptor Struktur](#aws-glue-api-catalog-tables-StorageDescriptor)
+ [SchemaReference Struktur](#aws-glue-api-catalog-tables-SchemaReference)
+ [SerDeInfo Struktur](#aws-glue-api-catalog-tables-SerDeInfo)
+ [Order-Struktur](#aws-glue-api-catalog-tables-Order)
+ [SkewedInfo Struktur](#aws-glue-api-catalog-tables-SkewedInfo)
+ [TableVersion Struktur](#aws-glue-api-catalog-tables-TableVersion)
+ [TableError Struktur](#aws-glue-api-catalog-tables-TableError)
+ [TableVersionError Struktur](#aws-glue-api-catalog-tables-TableVersionError)
+ [SortCriterion Struktur](#aws-glue-api-catalog-tables-SortCriterion)
+ [TableIdentifier Struktur](#aws-glue-api-catalog-tables-TableIdentifier)
+ [KeySchemaElement Struktur](#aws-glue-api-catalog-tables-KeySchemaElement)
+ [PartitionIndex Struktur](#aws-glue-api-catalog-tables-PartitionIndex)
+ [PartitionIndexDescriptor Struktur](#aws-glue-api-catalog-tables-PartitionIndexDescriptor)
+ [BackfillError Struktur](#aws-glue-api-catalog-tables-BackfillError)
+ [IcebergInput Struktur](#aws-glue-api-catalog-tables-IcebergInput)
+ [OpenTableFormatInput Struktur](#aws-glue-api-catalog-tables-OpenTableFormatInput)
+ [ViewDefinition Struktur](#aws-glue-api-catalog-tables-ViewDefinition)
+ [ViewDefinitionInput Struktur](#aws-glue-api-catalog-tables-ViewDefinitionInput)
+ [ViewRepresentation Struktur](#aws-glue-api-catalog-tables-ViewRepresentation)
+ [ViewRepresentationInput Struktur](#aws-glue-api-catalog-tables-ViewRepresentationInput)
+ [UpdateOpenTableFormatInput Struktur](#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput)
+ [UpdateIcebergInput Struktur](#aws-glue-api-catalog-tables-UpdateIcebergInput)
+ [CreateIcebergTableInput Struktur](#aws-glue-api-catalog-tables-CreateIcebergTableInput)
+ [UpdateIcebergTableInput Struktur](#aws-glue-api-catalog-tables-UpdateIcebergTableInput)
+ [IcebergSortOrder Struktur](#aws-glue-api-catalog-tables-IcebergSortOrder)
+ [IcebergSortField Struktur](#aws-glue-api-catalog-tables-IcebergSortField)
+ [IcebergPartitionSpec Struktur](#aws-glue-api-catalog-tables-IcebergPartitionSpec)
+ [IcebergPartitionField Struktur](#aws-glue-api-catalog-tables-IcebergPartitionField)
+ [IcebergSchema Struktur](#aws-glue-api-catalog-tables-IcebergSchema)
+ [IcebergStructField Struktur](#aws-glue-api-catalog-tables-IcebergStructField)
+ [IcebergTableUpdate Struktur](#aws-glue-api-catalog-tables-IcebergTableUpdate)
+ [AuditContext Struktur](#aws-glue-api-catalog-tables-AuditContext)
## Tabellenstruktur
Stellt eine Sammlung zusammengehöriger Daten organisiert in Spalten und Zeilen dar.
**Felder**
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-uri).
Die Beschreibung der Tabelle.
+ `Owner` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor)-Objekt.
Eine Speicherbeschreibung, die Informationen zur physischen Speicherung dieser Tabelle enthält.
+ `PartitionKeys` – Ein Array mit [Spalte](#aws-glue-api-catalog-tables-Column)-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 handelt`VIRTUAL_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\$1TABLE
Hive-kompatibles Attribut – zeigt eine nicht von Hive verwaltete Tabelle an.
GOVERNED
Wird verwendet von AWS Lake Formation. Der AWS Glue Datenkatalog versteht es`GOVERNED`.
+ `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID der Tabellenversion.
+ `FederatedTable` – Ein [FederatedTable](#aws-glue-api-catalog-tables-FederatedTable)-Objekt.
Eine `FederatedTable`-Struktur, die auf eine Entität außerhalb von AWS Glue Data Catalog verweist.
+ `ViewDefinition` – Ein [ViewDefinition](#aws-glue-api-catalog-tables-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.
## TableInput Struktur
Eine Struktur, die Sie nutzen können, um eine Tabelle zu definieren.
**Felder**
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-uri).
Die Beschreibung der Tabelle.
+ `Owner` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor)-Objekt.
Eine Speicherbeschreibung, die Informationen zur physischen Speicherung dieser Tabelle enthält.
+ `PartitionKeys` – Ein Array mit [Spalte](#aws-glue-api-catalog-tables-Column)-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 handelt`VIRTUAL_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\$1TABLE
Hive-kompatibles Attribut – zeigt eine nicht von Hive verwaltete Tabelle an.
GOVERNED
Wird verwendet von AWS Lake Formation. Der AWS Glue Datenkatalog versteht es`GOVERNED`.
+ `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](#aws-glue-api-catalog-tables-TableIdentifier)-Objekt.
Eine `TableIdentifier`-Struktur, die eine Zieltabelle für die Verknüpfung von Ressourcen beschreibt.
+ `ViewDefinition` – Ein [ViewDefinitionInput](#aws-glue-api-catalog-tables-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.
## FederatedTable Struktur
Eine Datenbank, die auf eine Entität außerhalb von AWS Glue Data Catalog verweist.
**Felder**
+ `Identifier` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 512 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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.
## Spaltenstruktur
Eine Spalte in einer `Table`.
**Felder**
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der `Column`.
+ `Type` – UTF-8-Zeichenfolge, nicht mehr als 131 072 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Datentyp von `Column`.
+ `Comment` – Kommentar-Zeichenfolge, nicht mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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.
## StorageDescriptor Struktur
Beschreibt den physischen Speicher von Tabellendaten.
**Felder**
+ `Columns` – Ein Array mit [Spalte](#aws-glue-api-catalog-tables-Column)-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](aws-glue-api-common.md#aws-glue-api-regex-uri).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Eingabeformat `SequenceFileInputFormat` (binär), `TextInputFormat` oder ein benutzerdefiniertes Format.
+ `OutputFormat` – Format-Zeichenfolge, nicht mehr als 128 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-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](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-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.
## SchemaReference Struktur
Ein Objekt, das auf ein in der Schemaregistry gespeichertes AWS Glue Schema verweist.
**Felder**
+ `SchemaId` – Ein [SchemaId](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-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](aws-glue-api-common.md#regex_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.
## SerDeInfo Struktur
Informationen über ein serialization/deserialization Programm (SerDe), das als Extraktor und Loader dient.
**Felder**
+ `Name` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Name des SerDe.
+ `SerializationLibrary` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Diese Schlüssel-Wert-Paare definieren Initialisierungsparameter für. SerDe
## Order-Struktur
Gibt die Sortierreihenfolge einer sortierten Spalte an.
**Felder**
+ `Column` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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.
## SkewedInfo Struktur
Gibt verzerrte Werte in einer Tabelle an. Verzerrte Werte sind solche, die mit sehr hoher Häufigkeit auftreten.
**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.
## TableVersion Struktur
Gibt eine Version einer Tabelle an.
**Felder**
+ `Table` – Ein [Tabelle](#aws-glue-api-catalog-tables-Table)-Objekt.
Die betreffende Tabelle.
+ `VersionId` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der ID-Wert für die Identifikation dieser Tabellenversion. Eine `VersionId` ist eine Zeichenfolgendarstellung einer Ganzzahl. Jede Version wird um 1 erhöht.
## TableError Struktur
Ein Fehlerdatensatz für Tabellenoperationen.
**Felder**
+ `TableName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Tabelle. Für Hive-Kompatibilität muss dieser vollständig aus Kleinbuchstaben bestehen.
+ `ErrorDetail` – Ein [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail)-Objekt.
Die Details zu dem Fehler.
## TableVersionError Struktur
Ein Fehlerdatensatz für Tabellenversionsoperationen.
**Felder**
+ `TableName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der ID-Wert der betreffenden Version. Eine `VersionID` ist eine Zeichenfolgendarstellung einer Ganzzahl. Jede Version wird um 1 erhöht.
+ `ErrorDetail` – Ein [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail)-Objekt.
Die Details zu dem Fehler.
## SortCriterion Struktur
Gibt das Feld an, nach dem sortiert werden soll, und eine Sortierreihenfolge.
**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"` \$1 `DESC="DESCENDING"`).
Eine auf- oder absteigende Sortierung.
## TableIdentifier Struktur
Eine -Struktur, die eine Zieltabelle für die Verknüpfung von Ressourcen beschreibt.
**Felder**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Zieltabelle.
+ `Region` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Region der Zieltabelle.
## KeySchemaElement Struktur
Ein Partitionsschlüsselpaar bestehend aus einem Namen und einem Typ.
**Felder**
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name eines Partitionsschlüssels.
+ `Type` – *Erforderlich:* UTF-8-Zeichenfolge, nicht mehr als 131 072 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Typ eines Partitionsschlüssels.
## PartitionIndex Struktur
Eine Struktur für einen Partitionsindex.
**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name des Partitionsindex.
## PartitionIndexDescriptor Struktur
Ein Deskriptor für einen Partitionsindex in einer Tabelle.
**Felder**
+ `IndexName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name des Partitionsindex.
+ `Keys` – *Erforderlich:* Ein Array von [KeySchemaElement](#aws-glue-api-catalog-tables-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` \$1 `ACTIVE` \$1 `DELETING` \$1 `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](#aws-glue-api-catalog-tables-BackfillError)-Objekten.
Eine Liste von Fehlern, die beim Registrieren von Partitionsindizes für eine vorhandene Tabelle auftreten können.
## BackfillError Struktur
Eine Liste von Fehlern, die beim Registrieren von Partitionsindizes für eine vorhandene Tabelle auftreten können.
Diese Fehler geben die Details zu den Gründen an, weshalb eine Indexregistrierung fehlgeschlagen ist, und stellen eine begrenzte Anzahl von Partitionen in der Antwort bereit, sodass Sie die fehlerhaften Partitionen beheben und die erneute Registrierung des Index probieren können. Die häufigsten Fehler, die auftreten können, lassen sich wie folgt kategorisieren:
+ 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\$10000, U\$10001, U\$10002.
+ InternalError: Jeder Fehler, der nicht zu anderen Fehlercodes gehört.
**Felder**
+ `Code` – UTF-8-Zeichenfolge (zulässige Werte: `ENCRYPTED_PARTITION_ERROR` \$1 `INTERNAL_ERROR` \$1 `INVALID_PARTITION_TYPE_DATA_ERROR` \$1 `MISSING_PARTITION_VALUE_ERROR` \$1 `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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionValueList)-Objekten.
Eine Liste einer begrenzten Anzahl an Partitionen in der Antwort.
## IcebergInput Struktur
Eine Struktur, die eine im Katalog zu erstellende Apache-Iceberg-Metadatentabelle definiert.
**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die TabelOpenTableFormatInputlenversion für die Iceberg-Tabelle. Standard-Einstellung: 2.
+ `CreateIcebergTableInput` – Ein [CreateIcebergTableInput](#aws-glue-api-catalog-tables-CreateIcebergTableInput)-Objekt.
Die Konfigurationsparameter, die zum Erstellen einer neuen Iceberg-Tabelle im AWS Glue Datenkatalog erforderlich sind, einschließlich Tabelleneigenschaften und Metadatenspezifikationen.
## OpenTableFormatInput Struktur
Eine Struktur, die eine Tabelle im offenen Format darstellt.
**Felder**
+ `IcebergInput` – Ein [IcebergInput](#aws-glue-api-catalog-tables-IcebergInput)-Objekt.
Spezifiziert eine `IcebergInput`-Struktur, die eine Apache-Iceberg-Metadatentabelle definiert.
## ViewDefinition Struktur
Eine Struktur, die Details für Darstellungen enthält.
**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](#aws-glue-api-catalog-tables-ViewRepresentation)-Objekten, nicht weniger als 1 und nicht mehr als 1 000 Strukturen.
Eine Liste von Darstellungen.
## ViewDefinitionInput Struktur
Eine Struktur, die Details zum Erstellen oder Aktualisieren einer AWS Glue Ansicht enthält.
**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Definer einer Ansicht in SQL.
+ `Representations`— Eine Reihe von [ViewRepresentationInput](#aws-glue-api-catalog-tables-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.
## ViewRepresentation Struktur
Eine Struktur, die den Dialekt der Ansicht und die Abfrage enthält, die die Ansicht definiert.
**Felder**
+ `Dialect` – UTF-8-Zeichenfolge (zulässige Werte: `REDSHIFT` \$1 `ATHENA` \$1 `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. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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.
## ViewRepresentationInput Struktur
Eine Struktur, die Details einer Darstellung enthält, um eine Lake-Formation-Ansicht zu aktualisieren oder zu erstellen.
**Felder**
+ `Dialect` – UTF-8-Zeichenfolge (zulässige Werte: `REDSHIFT` \$1 `ATHENA` \$1 `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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
## UpdateOpenTableFormatInput Struktur
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.
**Felder**
+ `UpdateIcebergInput` – Ein [UpdateIcebergInput](#aws-glue-api-catalog-tables-UpdateIcebergInput)-Objekt.
Apache-Iceberg-spezifische Aktualisierungsparameter, die die anzuwendenden Tabellenänderungen definieren, einschließlich Schemaänderungen, Partitionsspezifikationen und Tabelleneigenschaften.
## UpdateIcebergInput Struktur
Spezifische Eingabeparameter für die Aktualisierung von Apache Iceberg-Tabellen im AWS Glue Datenkatalog, die die Aktualisierungsvorgänge enthalten, die auf eine bestehende Iceberg-Tabelle angewendet werden sollen.
**Felder**
+ `UpdateIcebergTableInput` – *Erforderlich:* Ein [UpdateIcebergTableInput](#aws-glue-api-catalog-tables-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.
## CreateIcebergTableInput Struktur
Die Konfigurationsparameter, die zum Erstellen einer neuen Iceberg-Tabelle im AWS Glue Datenkatalog erforderlich sind, einschließlich Tabelleneigenschaften und Metadatenspezifikationen.
**Felder**
+ `Location` – *Erforderlich:* Speicherort-Zeichenfolge, höchstens 2056 Bytes lang, die dem [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) entspricht.
Der S3-Speicherort, an dem die Iceberg-Tabellendaten gespeichert werden.
+ `Schema` – *Erforderlich:* Ein [IcebergSchema](#aws-glue-api-catalog-tables-IcebergSchema)-Objekt.
Die Schemadefinition, die die Struktur, Feldtypen und Metadaten für die Iceberg-Tabelle festlegt.
+ `PartitionSpec` – Ein [IcebergPartitionSpec](#aws-glue-api-catalog-tables-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](#aws-glue-api-catalog-tables-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.
## UpdateIcebergTableInput Struktur
Enthält die Aktualisierungsvorgänge, die auf eine bestehende Iceberg-Tabelle im AWS Glue Datenkatalog angewendet werden sollen, und definiert den neuen Status der Tabellenmetadaten.
**Felder**
+ `Updates` – *Erforderlich:* Ein Array mit [IcebergTableUpdate](#aws-glue-api-catalog-tables-IcebergTableUpdate)-Objekten.
Die Liste der Tabellenaktualisierungsvorgänge, die die an der Iceberg-Tabelle vorzunehmenden Änderungen festlegen, einschließlich Schemaänderungen, Partitionierungsspezifikationen und Tabelleneigenschaften.
## IcebergSortOrder Struktur
Legt die Sortierreihenfolge für eine Iceberg-Tabelle fest und bestimmt, wie Daten innerhalb von Partitionen sortiert werden sollen, um die Abfrageleistung zu optimieren.
**Felder**
+ `OrderId` – *Erforderlich:* Zahl (Ganzzahl).
Der eindeutige Bezeichner für diese Sortierreihenfolgespezifikation in den Metadaten der Iceberg-Tabelle.
+ `Fields` – *Erforderlich:* Ein Array mit [IcebergSortField](#aws-glue-api-catalog-tables-IcebergSortField)-Objekten.
Die Liste der Felder und ihrer Sortierrichtungen, die die Sortierkriterien für die Daten der Iceberg-Tabelle definieren.
## IcebergSortField Struktur
Definiert ein einzelnes Feld innerhalb einer Iceberg-Sortierreihenfolgespezifikation einschließlich Quellfeld, Transformation, Sortierrichtung und Nullwertreihenfolge.
**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"` \$1 `desc="DESC"`).
Die Sortierrichtung für dieses Feld, entweder aufsteigend oder absteigend.
+ `NullOrder` – *Erforderlich:* UTF-8-Zeichenfolge (zulässige Werte: `nulls-first="NULLS_FIRST"` \$1 `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.
## IcebergPartitionSpec Struktur
Legt die Partitionierungsspezifikation für eine Iceberg-Tabelle fest und bestimmt, wie die Tabellendaten für eine optimale Abfrageleistung organisiert und partitioniert werden.
**Felder**
+ `Fields` – *Erforderlich:* Ein Array mit [IcebergPartitionField](#aws-glue-api-catalog-tables-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.
## IcebergPartitionField Struktur
Legt ein einzelnes Partitionsfeld innerhalb einer Iceberg-Partitionsspezifikation fest, einschließlich des Quellfelds, der Transformationsfunktion, des Partitionsnamens und des eindeutigen Bezeichners.
**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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.
## IcebergSchema Struktur
Definiert die Schemastruktur für eine Iceberg-Tabelle, einschließlich Felddefinitionen, Datentypen und Schemametadaten.
**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](#aws-glue-api-catalog-tables-IcebergStructField)-Objekten.
Die Liste der Felddefinitionen, aus denen das Tabellenschema besteht, einschließlich Feldnamen, Typen und Metadaten.
## IcebergStructField Struktur
Definiert ein einzelnes Feld innerhalb eines Iceberg-Tabellenschemas, einschließlich seiner Kennung, seines Namens, seines Datentyps, seiner NULL-Fähigkeit und seiner Dokumentation.
**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Optionaler Dokumentations- oder Beschreibungstext, der zusätzliche Informationen zum Zweck und zur Verwendung dieses Feldes liefert.
## IcebergTableUpdate Struktur
Definiert einen vollständigen Satz von Aktualisierungen, die auf eine Iceberg-Tabelle angewendet werden sollen, einschließlich Schemaänderungen, Partitionierungsänderungen, Sortierreihenfolgeanpassungen, Standortaktualisierungen und Eigenschaftsänderungen.
**Felder**
+ `Schema` – *Erforderlich:* Ein [IcebergSchema](#aws-glue-api-catalog-tables-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](#aws-glue-api-catalog-tables-IcebergPartitionSpec)-Objekt.
Die aktualisierte Partitionierungsspezifikation, die festlegt, wie die Tabellendaten neu organisiert und partitioniert werden sollen.
+ `SortOrder` – Ein [IcebergSortOrder](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-uri) 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.
## AuditContext Struktur
Eine Struktur, die den Lake Formation Prüfungskontext enthält.
**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.
## Operationen
+ [CreateTable Aktion (Python: create\$1table)](#aws-glue-api-catalog-tables-CreateTable)
+ [UpdateTable Aktion (Python: update\$1table)](#aws-glue-api-catalog-tables-UpdateTable)
+ [DeleteTable Aktion (Python: delete\$1table)](#aws-glue-api-catalog-tables-DeleteTable)
+ [BatchDeleteTable Aktion (Python: batch\$1delete\$1table)](#aws-glue-api-catalog-tables-BatchDeleteTable)
+ [GetTable Aktion (Python: get\$1table)](#aws-glue-api-catalog-tables-GetTable)
+ [GetTables Aktion (Python: get\$1tables)](#aws-glue-api-catalog-tables-GetTables)
+ [GetTableVersion Aktion (Python: get\$1table\$1version)](#aws-glue-api-catalog-tables-GetTableVersion)
+ [GetTableVersions Aktion (Python: get\$1table\$1versions)](#aws-glue-api-catalog-tables-GetTableVersions)
+ [DeleteTableVersion Aktion (Python: delete\$1table\$1version)](#aws-glue-api-catalog-tables-DeleteTableVersion)
+ [BatchDeleteTableVersion Aktion (Python: batch\$1delete\$1table\$1version)](#aws-glue-api-catalog-tables-BatchDeleteTableVersion)
+ [SearchTables Aktion (Python: search\$1tables)](#aws-glue-api-catalog-tables-SearchTables)
+ [GetPartitionIndexes Aktion (Python: get\$1partition\$1indexes)](#aws-glue-api-catalog-tables-GetPartitionIndexes)
+ [CreatePartitionIndex Aktion (Python: create\$1partition\$1index)](#aws-glue-api-catalog-tables-CreatePartitionIndex)
+ [DeletePartitionIndex Aktion (Python: delete\$1partition\$1index)](#aws-glue-api-catalog-tables-DeletePartitionIndex)
+ [GetColumnStatisticsForTable Aktion (Python: get\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-GetColumnStatisticsForTable)
+ [UpdateColumnStatisticsForTable Aktion (Python: update\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable)
+ [DeleteColumnStatisticsForTable Aktion (Python: delete\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable)
## CreateTable Aktion (Python: create\$1table)
Erstellt eine neue Tabellendefinition im Data Catalog.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die eindeutige Kennung für die Tabelle in der angegebenen Datenbank, die im AWS Glue Datenkatalog erstellt wird.
+ `TableInput` – Ein [TableInput](#aws-glue-api-catalog-tables-TableInput)-Objekt.
Das `TableInput`-Objekt, das die im Katalog zu erstellende Metadatentabelle definiert.
+ `PartitionIndexes` – Ein Array mit [PartitionIndex](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#regex_44).
Die ID der Transaktion.
+ `OpenTableFormatInput` – Ein [OpenTableFormatInput](#aws-glue-api-catalog-tables-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`
## UpdateTable Aktion (Python: update\$1table)
Aktualisiert eine Metadatentabelle im Data Catalog.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die eindeutige Kennung für die Tabelle in der angegebenen Datenbank, die im AWS Glue Datenkatalog erstellt wird.
+ `TableInput` – Ein [TableInput](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#regex_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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Versions-ID, bei der der Tabelleninhalt aktualisiert werden soll.
+ `ViewUpdateAction` – UTF-8-Zeichenfolge (zulässige Werte: `ADD` \$1 `REPLACE` \$1 `ADD_OR_REPLACE` \$1 `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](#aws-glue-api-catalog-tables-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`
## DeleteTable Aktion (Python: delete\$1table)
Entfernt eine Tabellendefinition aus dem Data Catalog.
**Anmerkung**
Nach Abschluss dieser Operation haben Sie keinen Zugriff mehr auf die Tabellenversionen und Partitionen, die zu der gelöschten Tabelle gehören. AWS Glue Löscht diese „verwaisten“ Ressourcen asynchron und zeitnah nach Ermessen des Services.
Um die sofortige Löschung aller damit verbundenen Ressourcen zu gewährleisten, bevor Sie `DeleteTable` aufrufen, verwenden Sie `DeleteTableVersion` oder `BatchDeleteTableVersion` und `DeletePartition` oder `BatchDeletePartition`, um alle Ressourcen zu löschen, die zur Tabelle gehören.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#regex_44).
Die Transaktions-ID, an der der Tabellinhalt gelöscht werden soll.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## BatchDeleteTable Aktion (Python: batch\$1delete\$1table)
Löscht mehrere Tabellen auf einmal.
**Anmerkung**
Nach Abschluss dieser Operation haben Sie keinen Zugriff mehr auf die Tabellenversionen und Partitionen, die zu der gelöschten Tabelle gehören. AWS Glue Löscht diese „verwaisten“ Ressourcen asynchron und zeitnah nach Ermessen des Services.
Um die sofortige Löschung aller damit verbundenen Ressourcen zu gewährleisten, bevor Sie `BatchDeleteTable` aufrufen, verwenden Sie `DeleteTableVersion` oder `BatchDeleteTableVersion` und `DeletePartition` oder `BatchDeletePartition`, um alle Ressourcen zu löschen, die zur Tabelle gehören.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#regex_44).
Die Transaktions-ID, an der der Tabellinhalt gelöscht werden soll.
**Antwort**
+ `Errors` – Ein Array mit [TableError](#aws-glue-api-catalog-tables-TableError)-Objekten.
Eine Liste der Fehler, die beim Löschen der angegebenen Tabellen aufgetreten sind.
**Fehler**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ResourceNotReadyException`
## GetTable Aktion (Python: get\$1table)
Ruft die `Table`-Definition in einem Data Catalog für eine bestimmte Tabelle ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#regex_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](#aws-glue-api-catalog-tables-AuditContext)-Objekt.
Eine Struktur, die den Lake Formation [Prüfungskontext](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html) 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](#aws-glue-api-catalog-tables-Table)-Objekt.
Das `Table`-Objekt, das die angegebene Tabelle definiert.
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## GetTables Aktion (Python: get\$1tables)
Ruft die Definitionen von einigen oder allen Tabellen in einer bestimmten `Database` ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#regex_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](#aws-glue-api-catalog-tables-AuditContext)-Objekt.
Eine Struktur, die den Lake Formation [Prüfungskontext](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html) 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](#aws-glue-api-catalog-tables-Table)-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`
## GetTableVersion Aktion (Python: get\$1table\$1version)
Ruft eine angegebene Version einer Tabelle ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](#aws-glue-api-catalog-tables-TableVersion)-Objekt.
Die angeforderte Tabellenversion.
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## GetTableVersions Aktion (Python: get\$1table\$1versions)
Ruft eine Liste der Zeichenfolgen ab, die verfügbare Versionen einer angegebenen Tabelle identifizieren.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](#aws-glue-api-catalog-tables-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`
## DeleteTableVersion Aktion (Python: delete\$1table\$1version)
Löscht eine angegebene Version einer Tabelle.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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`
## BatchDeleteTableVersion Aktion (Python: batch\$1delete\$1table\$1version)
Löscht einen angegebenen Batch von Versionen einer Tabelle.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](#aws-glue-api-catalog-tables-TableVersionError)-Objekten.
Eine Liste der Fehler, die beim Löschen der angegebenen Tabellenversionen aufgetreten sind.
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
## SearchTables Aktion (Python: search\$1tables)
Durchsucht eine Gruppe von Tabellen basierend auf Eigenschaften in den Tabellenmetadaten sowie auf der übergeordneten Datenbank. Sie können nach Text- oder Filterbedingungen suchen.
Sie können nur Tabellen abrufen, auf die Sie Zugriff haben, basierend auf den in Lake Formation definierten Sicherheitsrichtlinien. Sie benötigen mindestens einen schreibgeschützten Zugriff auf die Tabelle, damit sie zurückgegeben wird. Wenn Sie nicht auf alle Spalten in der Tabelle zugreifen können, wurden diese Spalten nicht durchsucht, wenn die Liste der Tabellen an Sie zurückgesendet wird. Wenn Sie Zugriff auf die Spalten haben, jedoch nicht auf die Daten in den Spalten, sind diese Spalten und die zugehörigen Metadaten für diese Spalten in der Suche enthalten.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-common-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 -, :, \$1 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](#aws-glue-api-catalog-tables-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` \$1 `ALL` \$1 `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](#aws-glue-api-catalog-tables-Table)-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`
## GetPartitionIndexes Aktion (Python: get\$1partition\$1indexes)
Ruft die Partitionsindizes ab, die einer Tabelle zugeordnet sind.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](#aws-glue-api-catalog-tables-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`
## CreatePartitionIndex Aktion (Python: create\$1partition\$1index)
Erstellt einen angegebenen Partitionsindex in einer vorhandenen Tabelle.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Gibt den Namen einer Tabelle an, in der Sie einen Partitionsindex erstellen möchten.
+ `PartitionIndex` – *Erforderlich:* Ein [PartitionIndex](#aws-glue-api-catalog-tables-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`
## DeletePartitionIndex Aktion (Python: delete\$1partition\$1index)
Löscht einen angegebenen Partitionsindex aus einer vorhandenen Tabelle.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name des Partitionsindexes, der gelöscht werden soll.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `ConflictException`
+ `GlueEncryptionException`
## GetColumnStatisticsForTable Aktion (Python: get\$1column\$1statistics\$1for\$1table)
Ruft Tabellenstatistiken von Spalten ab.
Die für diesen Vorgang erforderliche Identity and Access Management (IAM)-Berechtigung lautet `GetTable`.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics)-Objekten.
Liste von ColumnStatistics.
+ `Errors` – Ein Array mit [ColumnError](aws-glue-api-common.md#aws-glue-api-common-ColumnError)-Objekten.
Die Liste ColumnStatistics davon konnte nicht abgerufen werden.
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## UpdateColumnStatisticsForTable Aktion (Python: update\$1column\$1statistics\$1for\$1table)
Erstellt oder aktualisiert Tabellenstatistiken von Spalten.
Die für diesen Vorgang erforderliche Identity and Access Management (IAM)-Berechtigung lautet `UpdateTable`.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Partitionentabelle.
+ `ColumnStatisticsList` – *Erforderlich:* Ein Array mit [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics)-Objekten, nicht mehr als 25 Strukturen.
Eine Liste der Spaltenstatistiken.
**Antwort**
+ `Errors` – Ein Array mit [ColumnStatisticsError](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError)-Objekten.
Liste von ColumnStatisticsErrors.
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## DeleteColumnStatisticsForTable Aktion (Python: delete\$1column\$1statistics\$1for\$1table)
Ruft Tabellenstatistiken von Spalten ab.
Die für diesen Vorgang erforderliche Identity and Access Management (IAM)-Berechtigung lautet `DeleteTable`.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Spalte.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
# Partitions-API
Die Partitions-API beschreibt Datentypen und Operationen für die Arbeit mit Partitionen.
## Datentypen
+ [Partitionsstruktur](#aws-glue-api-catalog-partitions-Partition)
+ [PartitionInput Struktur](#aws-glue-api-catalog-partitions-PartitionInput)
+ [PartitionSpecWithSharedStorageDescriptor Struktur](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor)
+ [PartitionListComposingSpec Struktur](#aws-glue-api-catalog-partitions-PartitionListComposingSpec)
+ [PartitionSpecProxy Struktur](#aws-glue-api-catalog-partitions-PartitionSpecProxy)
+ [PartitionValueList Struktur](#aws-glue-api-catalog-partitions-PartitionValueList)
+ [Segmentstruktur](#aws-glue-api-catalog-partitions-Segment)
+ [PartitionError Struktur](#aws-glue-api-catalog-partitions-PartitionError)
+ [BatchUpdatePartitionFailureEntry Struktur](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry)
+ [BatchUpdatePartitionRequestEntry Struktur](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry)
+ [StorageDescriptor Struktur](#aws-glue-api-catalog-partitions-StorageDescriptor)
+ [SchemaReference Struktur](#aws-glue-api-catalog-partitions-SchemaReference)
+ [SerDeInfo Struktur](#aws-glue-api-catalog-partitions-SerDeInfo)
+ [SkewedInfo Struktur](#aws-glue-api-catalog-partitions-SkewedInfo)
## Partitionsstruktur
Stellt ein Segment der Tabellendaten dar.
**Felder**
+ `Values` – Ein UTF-8-Zeichenfolgen-Array.
Die Werte der Partition.
+ `DatabaseName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Name der Katalogdatenbank, in der die Partition angelegt wird.
+ `TableName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Datenbanktabelle, in der die Partition erstellt wird.
+ `CreationTime` – Zeitstempel.
Die Uhrzeit, zu der die Partition erstellt wurde.
+ `LastAccessTime` – Zeitstempel.
Die Uhrzeit, zu der das letzte Mal auf die Partition zugegriffen wurde.
+ `StorageDescriptor` – Ein [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor)-Objekt.
Stellt Informationen über den physischen Standort bereit, an dem die Partition gespeichert ist.
+ `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Diese Schlüssel-Wert-Paare definieren Partitionsparameter.
+ `LastAnalyzedTime` – Zeitstempel.
Der letzte Zeitpunkt, zu dem die Spaltenstatistiken für diese Partition berechnet wurden.
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalogs, in dem die Partition gespeichert ist.
## PartitionInput Struktur
Die Struktur, die zum Erstellen und Aktualisieren einer Partition verwendet wird.
**Felder**
+ `Values` – Ein UTF-8-Zeichenfolgen-Array.
Die Werte der Partition. Obwohl dieser Parameter nicht von der SDK gefordert wird, müssen Sie diesen Parameter als einen gültigen Wert angeben.
Die Werte für die Schlüssel für die neue Partition müssen als Array von Zeichenfolgenobjekten übergeben werden, die in derselben Reihenfolge wie die Partitionsschlüssel im Amazon S3-Präfix sortiert werden müssen. Andernfalls AWS Glue werden die Werte zu den falschen Schlüsseln hinzugefügt.
+ `LastAccessTime` – Zeitstempel.
Die Uhrzeit, zu der das letzte Mal auf die Partition zugegriffen wurde.
+ `StorageDescriptor` – Ein [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor)-Objekt.
Stellt Informationen über den physischen Standort bereit, an dem die Partition gespeichert ist.
+ `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Diese Schlüssel-Wert-Paare definieren Partitionsparameter.
+ `LastAnalyzedTime` – Zeitstempel.
Der letzte Zeitpunkt, zu dem die Spaltenstatistiken für diese Partition berechnet wurden.
## PartitionSpecWithSharedStorageDescriptor Struktur
Eine Partitionsspezifikation für Partitionen mit einem gemeinsamen physischen Standort.
**Felder**
+ `StorageDescriptor` – Ein [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor)-Objekt.
Die freigegebenen physischen Speicherinformationen.
+ `Partitions` – Ein Array mit [Partition](#aws-glue-api-catalog-partitions-Partition)-Objekten.
Eine Liste der Partitionen, die diesen physischen Standort gemeinsam verwenden.
## PartitionListComposingSpec Struktur
Listet die zugehörigen Partitionen auf.
**Felder**
+ `Partitions` – Ein Array mit [Partition](#aws-glue-api-catalog-partitions-Partition)-Objekten.
Eine Liste der Partitionen in der Erstellungsspezifikation.
## PartitionSpecProxy Struktur
Bietet einen Stammpfad für angegebene Partitionen.
**Felder**
+ `DatabaseName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Katalogdatenbank, in der die Partitionen gespeichert sind.
+ `TableName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Tabelle, die die Partitionen enthält.
+ `RootPath` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Stammpfad des Proxys zur Adressierung der Partitionen.
+ `PartitionSpecWithSharedSD` – Ein [PartitionSpecWithSharedStorageDescriptor](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor)-Objekt.
Eine Spezifikation für Partitionen, die denselben physischen Standort verwenden.
+ `PartitionListComposingSpec` – Ein [PartitionListComposingSpec](#aws-glue-api-catalog-partitions-PartitionListComposingSpec)-Objekt.
Gibt eine Liste der Partitionen an.
## PartitionValueList Struktur
Enthält eine Liste von Werten zur Definition von Partitionen.
**Felder**
+ `Values` – *Erforderlich:* Ein Array von UTF-8 Zeichenketten.
Die Liste der Werte.
## Segmentstruktur
Definiert eine nicht überlappende Region der Partitionen einer Tabelle, sodass mehrere Anforderungen parallel ausgeführt werden können.
**Felder**
+ `SegmentNumber` – *Erforderlich:* Zahl (Ganzzahl), nicht mehr als Keine.
Die nullbasierte Indexnummer dieses Segments. Wenn beispielsweise die Gesamtzahl der Segmente 4 ist, liegen die `SegmentNumber`-Werte im Bereich von 0 bis 3.
+ `TotalSegments` – *Erforderlich:*Zahl (Ganzzahl), nicht weniger als 1 oder mehr als 10.
Die Gesamtzahl der Segmente.
## PartitionError Struktur
Enthält Informationen zu einem Partitionsfehler.
**Felder**
+ `PartitionValues` – Ein UTF-8-Zeichenfolgen-Array.
Die Werte, die die Partition definieren.
+ `ErrorDetail` – Ein [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail)-Objekt.
Details zum Partitionsfehler.
## BatchUpdatePartitionFailureEntry Struktur
Enthält Informationen zu einem Batch-Update-Partitionsfehler.
**Felder**
+ `PartitionValueList` – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 100 Zeichenfolgen.
Eine Liste der Werte zur Definition der Partitionen.
+ `ErrorDetail` – Ein [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail)-Objekt.
Details zum Batch-Update-Partitionsfehler.
## BatchUpdatePartitionRequestEntry Struktur
Eine Struktur, welche die Werte und die Struktur enthält, die zum Aktualisieren einer Partition verwendet werden.
**Felder**
+ `PartitionValueList` – *Erforderlich:* Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 100 Zeichenfolgen.
Eine Liste der Werte zur Definition der Partitionen.
+ `PartitionInput` – *Erforderlich:* Ein [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput)-Objekt.
Die Struktur, die zum Aktualisieren einer Partition verwendet wird.
## StorageDescriptor Struktur
Beschreibt den physischen Speicher von Tabellendaten.
**Felder**
+ `Columns` – Ein Array mit [Spalte](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Column)-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](aws-glue-api-common.md#aws-glue-api-regex-uri).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Eingabeformat `SequenceFileInputFormat` (binär), `TextInputFormat` oder ein benutzerdefiniertes Format.
+ `OutputFormat` – Format-Zeichenfolge, nicht mehr als 128 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](#aws-glue-api-catalog-partitions-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](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](#aws-glue-api-catalog-partitions-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](#aws-glue-api-catalog-partitions-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.
## SchemaReference Struktur
Ein Objekt, das auf ein in der Schemaregistry gespeichertes AWS Glue Schema verweist.
**Felder**
+ `SchemaId` – Ein [SchemaId](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-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](aws-glue-api-common.md#regex_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.
## SerDeInfo Struktur
Informationen über ein serialization/deserialization Programm (SerDe), das als Extraktor und Loader dient.
**Felder**
+ `Name` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Name des SerDe.
+ `SerializationLibrary` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist eine UTF-8-Zeichenfolge, nicht mehr als 512 000 Bytes lang.
Diese Schlüssel-Wert-Paare definieren Initialisierungsparameter für. SerDe
## SkewedInfo Struktur
Gibt verzerrte Werte in einer Tabelle an. Verzerrte Werte sind solche, die mit sehr hoher Häufigkeit auftreten.
**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.
## Operationen
+ [CreatePartition Aktion (Python: create\$1partition)](#aws-glue-api-catalog-partitions-CreatePartition)
+ [BatchCreatePartition Aktion (Python: batch\$1create\$1partition)](#aws-glue-api-catalog-partitions-BatchCreatePartition)
+ [UpdatePartition Aktion (Python: update\$1partition)](#aws-glue-api-catalog-partitions-UpdatePartition)
+ [DeletePartition Aktion (Python: delete\$1partition)](#aws-glue-api-catalog-partitions-DeletePartition)
+ [BatchDeletePartition Aktion (Python: batch\$1delete\$1partition)](#aws-glue-api-catalog-partitions-BatchDeletePartition)
+ [GetPartition Aktion (Python: get\$1partition)](#aws-glue-api-catalog-partitions-GetPartition)
+ [GetPartitions Aktion (Python: get\$1partitions)](#aws-glue-api-catalog-partitions-GetPartitions)
+ [BatchGetPartition Aktion (Python: batch\$1get\$1partition)](#aws-glue-api-catalog-partitions-BatchGetPartition)
+ [BatchUpdatePartition Aktion (Python: batch\$1update\$1partition)](#aws-glue-api-catalog-partitions-BatchUpdatePartition)
+ [GetColumnStatisticsForPartition Aktion (Python: get\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition)
+ [UpdateColumnStatisticsForPartition Aktion (Python: update\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition)
+ [DeleteColumnStatisticsForPartition Aktion (Python: delete\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition)
## CreatePartition Aktion (Python: create\$1partition)
Erstellt eine neue Partition.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die AWS Konto-ID des Katalogs, in dem die Partition erstellt werden soll.
+ `DatabaseName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Metadatendatenbank, in der die Partition erstellt werden soll.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Metadatendatentabelle, in der die Partition erstellt werden soll.
+ `PartitionInput` – *Erforderlich:* Ein [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput)-Objekt.
Eine `PartitionInput`-Struktur, die die zu erstellende Partition definiert.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## BatchCreatePartition Aktion (Python: batch\$1create\$1partition)
Erstellt eine oder mehrere Partitionen in einem Batchvorgang.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Katalogs, in dem die Partition erstellt wird. Derzeit sollte dies die Konto-ID sein. AWS
+ `DatabaseName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Metadatendatenbank, in der die Partition erstellt werden soll.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Metadatendatentabelle, in der die Partition erstellt werden soll.
+ `PartitionInputList` – *Erforderlich:* Ein Array mit [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput)-Objekten, nicht mehr als 100 Strukturen.
Eine Liste der `PartitionInput`-Strukturen, die die zu erstellenden Partitionen definieren.
**Antwort**
+ `Errors` – Ein Array mit [PartitionError](#aws-glue-api-catalog-partitions-PartitionError)-Objekten.
Die beim Erstellen der angeforderten Partitionen aufgetretenen Fehler.
**Fehler**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## UpdatePartition Aktion (Python: update\$1partition)
Aktualisiert eine Partition.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die zu aktualisierende Partition 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Katalogdatenbank, in der sich die entsprechende Tabelle befindet.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Tabelle, in der sich die zu aktualisierende Partition befindet.
+ `PartitionValueList` – *Erforderlich:* Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 100 Zeichenfolgen.
Liste von Partitionsschlüsselwerten, welche die Partition definieren.
+ `PartitionInput` – *Erforderlich:* Ein [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput)-Objekt.
Das neue Partitionsobjekt zur Aktualisierung der Partition.
Die `Values`-Eigenschaft kann nicht geändert werden. Wenn Sie die Partitionsschlüsselwerte für eine Partition ändern möchten, löschen Sie die Partition und erstellen Sie sie neu.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## DeletePartition Aktion (Python: delete\$1partition)
Löscht eine angegebene Partition.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die zu löschende Partition 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Katalogdatenbank, in der sich die entsprechende Tabelle befindet.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Tabelle, die die Partition enthält, die gelöscht werden soll.
+ `PartitionValues` – *Erforderlich:* Ein Array von UTF-8-Zeichenketten.
Die Werte, die die Partition definieren.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
## BatchDeletePartition Aktion (Python: batch\$1delete\$1partition)
Löscht eine oder mehrere Partitionen in einem Batchvorgang.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die zu löschende Partition 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Katalogdatenbank, in der sich die entsprechende Tabelle befindet.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Tabelle, die die Partitionen enthält, die gelöscht werden sollen.
+ `PartitionsToDelete` – *Erforderlich:* Ein Array mit [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList)-Objekten, nicht mehr als 25 Strukturen.
Eine Liste der `PartitionInput`-Strukturen, die die zu löschenden Partitionen definieren.
**Antwort**
+ `Errors` – Ein Array mit [PartitionError](#aws-glue-api-catalog-partitions-PartitionError)-Objekten.
Die beim Löschen der angeforderten Partitionen aufgetretenen Fehler.
**Fehler**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
## GetPartition Aktion (Python: get\$1partition)
Ruft Informationen zu einer bestimmten Partition ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die entsprechende Partition 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Katalogdatenbank, in der sich die Partition befindet.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Partitionstabelle.
+ `PartitionValues` – *Erforderlich:* Ein Array von UTF-8-Zeichenketten.
Die Werte, die die Partition definieren.
**Antwort**
+ `Partition` – Ein [Partition](#aws-glue-api-catalog-partitions-Partition)-Objekt.
Die angeforderten Informationen in Form eines `Partition`-Objekts.
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## GetPartitions Aktion (Python: get\$1partitions)
Ruft Informationen über die Partitionen in einer Tabelle ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die entsprechenden Partitionen 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Partitionentabelle.
+ `Expression` – Prädikatszeichenfolge, nicht mehr als 2048 Bytes lang, passend zum [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Ein Ausdruck, der die Partitionen filtert, die zurückgegeben werden sollen.
Der Ausdruck verwendet SQL-Syntax ähnlich wie die SQL-Filterklausel `WHERE`. Der Parser für SQL-Anweisungen [JSQLParser](http://jsqlparser.sourceforge.net/home.php)analysiert den Ausdruck.
*Operatoren*: Im Folgenden finden Sie die Operatoren, die Sie im `Expression` API-Aufruf verwenden können:
=
Prüft, ob die Werte der beiden Operanden gleich sind. Wenn ja, wird die Bedingung wahr.
Beispiel: Angenommen, 'variable a' hat den Wert 10, und 'variable b' hat den Wert 20.
(a = b) ist nicht wahr.
< >
Prüft, ob die Werte der beiden Operanden gleich sind. Sind die Werte nicht gleich, wird die Bedingung wahr.
Beispiel: (a < > b) ist wahr.
>
Prüft, ob der Wert des linken Operanden größer als der Wert des rechten Operanden ist. Wenn ja, wird die Bedingung wahr.
Beispiel: (a > b) ist nicht wahr.
<
Prüft, ob der Wert des linken Operanden kleiner als der Wert des rechten Operanden ist. Wenn ja, wird die Bedingung wahr.
Beispiel: (a < b) ist wahr.
>=
Prüft, ob der Wert des linken Operanden größer oder gleich dem Wert des rechten Operanden ist. Wenn ja, wird die Bedingung wahr.
Beispiel: (a >= b) ist nicht wahr.
<=
Prüft, ob der Wert des linken Operanden kleiner oder gleich dem Wert des rechten Operanden ist. Wenn ja, wird die Bedingung wahr.
Beispiel: (a <= b) ist wahr.
AND, OR, IN, BETWEEN, LIKE, NOT, IS NULL
Logische Operatoren.
*Unterstützte Partitionsschlüsseltypen*: Im Folgenden finden Sie die unterstützten Partitionsschlüssel.
+ `string`
+ `date`
+ `timestamp`
+ `int`
+ `bigint`
+ `long`
+ `tinyint`
+ `smallint`
+ `decimal`
Wird ein Typ erkannt, der nicht gültig ist, wird eine Ausnahme ausgegeben.
Die folgende Liste zeigt die gültigen Operatoren für jeden Typ. Wenn Sie einen Crawler definieren, wird der `partitionKey`-Typ als `STRING`erstellt, damit er mit den Katalogpartitionen kompatibel ist.
*API-Beispielaufruf*:
**Example**
Die Tabelle `twitter_partition` hat drei Partitionen:
```
year = 2015
year = 2016
year = 2017
```
**Example**
Partition `year` gleich 2015 abrufeb
```
aws glue get-partitions --database-name dbname --table-name twitter_partition
--expression "year*=*'2015'"
```
**Example**
Partition `year` zwischen 2016 und 2018 (ausschließlich) abrufen
```
aws glue get-partitions --database-name dbname --table-name twitter_partition
--expression "year>'2016' AND year<'2018'"
```
**Example**
Partition `year` zwischen 2015 und 2018 (einschließlich) abrufen. Die folgenden API-Aufrufe sind miteinander äquivalent:
```
aws glue get-partitions --database-name dbname --table-name twitter_partition
--expression "year>='2015' AND year<='2018'"
aws glue get-partitions --database-name dbname --table-name twitter_partition
--expression "year BETWEEN 2015 AND 2018"
aws glue get-partitions --database-name dbname --table-name twitter_partition
--expression "year IN (2015,2016,2017,2018)"
```
**Example**
Ein Platzhalter-Partitionsfilter, wobei die Ausgabe des folgendes Aufrufs Partition Jahr = 2017 ist. Ein regulärer Ausdruck wird in `LIKE` nicht unterstützt.
```
aws glue get-partitions --database-name dbname --table-name twitter_partition
--expression "year LIKE '%7'"
```
+ `NextToken` – UTF-8-Zeichenfolge.
Ein Fortsetzungs-Token, wenn dies nicht der erste Aufruf zum Abrufen dieser Partitionen ist.
+ `Segment` – Ein [Segment](#aws-glue-api-catalog-partitions-Segment)-Objekt.
Das Segment der Tabellenpartitionen, das in dieser Anforderung gescannt werden soll.
+ `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000.
Gibt die maximale Anzahl der Partitionen an, die in einer Antwort zurückzugeben sind.
+ `ExcludeColumnSchema` – Boolesch.
Wenn der Wert „true“ ist, wird das Partitionsspaltenschema nicht zurückgegeben. Nützlich, wenn Sie nur an anderen Partitionsattributen wie Partitionswerten oder Speicherort interessiert sind. Bei diesem Ansatz wird eine große Antwort vermieden, da keine doppelten Daten zurückgegeben werden.
+ `TransactionId` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Custom string pattern #44](aws-glue-api-common.md#regex_44).
Die Transaktions-ID, an der der Partitionsinhalt gelesen werden soll.
+ `QueryAsOfTime` – Zeitstempel.
Die Zeit, zu der der Partitionsinhalt gelesen werden muss. Wenn nicht festgelegt, wird die letzte Transaktions-Commit-Zeit verwendet. Kann nicht zusammen mit `TransactionId` angegeben werden.
**Antwort**
+ `Partitions` – Ein Array mit [Partition](#aws-glue-api-catalog-partitions-Partition)-Objekten.
Eine Liste von angeforderten Partitionen.
+ `NextToken` – UTF-8-Zeichenfolge.
Ein Fortsetzungs-Token, falls die zurückgegebene Liste der Partitionen die letzte nicht enthält.
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
+ `InvalidStateException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## BatchGetPartition Aktion (Python: batch\$1get\$1partition)
Ruft Partitionen in einer Batchanforderung ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die entsprechenden Partitionen 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Partitionentabelle.
+ `PartitionsToGet` – *Erforderlich:* Ein Array mit [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList)-Objekten, nicht mehr als 1000 Strukturen.
Eine Liste der Partitionswerte, die die abzurufenden Partitionen identifizieren.
**Antwort**
+ `Partitions` – Ein Array mit [Partition](#aws-glue-api-catalog-partitions-Partition)-Objekten.
Eine Liste der angeforderten Partitionen.
+ `UnprocessedKeys` – Ein Array mit [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList)-Objekten, nicht mehr als 1000 Strukturen.
Eine Liste der Partitionswerte in der Anforderung, für die keine Partitionen zurückgegeben wurden.
**Fehler**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
+ `InvalidStateException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## BatchUpdatePartition Aktion (Python: batch\$1update\$1partition)
Aktualisiert eine oder mehrere Partitionen in einem Batchvorgang.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Katalogs, in dem die Partition aktualisiert wird. Derzeit sollte dies die Konto-ID sein. AWS
+ `DatabaseName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Metadatendatenbank, in der die Partition aktualisiert werden soll.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Metadatentabelle, in der die Partition aktualisiert werden soll.
+ `Entries` – *Erforderlich:* Ein Array mit [BatchUpdatePartitionRequestEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry)-Objekten, nicht weniger als 1 und nicht mehr als 100 Strukturen.
Eine Liste von bis zu 100 `BatchUpdatePartitionRequestEntry`-Objekte, die aktualisiert werden sollen.
**Antwort**
+ `Errors` – Ein Array mit [BatchUpdatePartitionFailureEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry)-Objekten.
Die beim Aktualisieren der angeforderten Partitionen aufgetretenen Fehler. Eine Liste von `BatchUpdatePartitionFailureEntry`-Objekten.
**Fehler**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
## GetColumnStatisticsForPartition Aktion (Python: get\$1column\$1statistics\$1for\$1partition)
Ruft Partitionsstatistiken von Spalten ab.
Die für diesen Vorgang erforderliche Identity and Access Management (IAM)-Berechtigung lautet `GetPartition`.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Partitionentabelle.
+ `PartitionValues` – *Erforderlich:* Ein Array von UTF-8-Zeichenketten.
Eine Liste der Partitionswerte, welche die Partition identifizieren.
+ `ColumnNames` – *Erforderlich:* Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 100 Zeichenfolgen.
Eine Liste der Spaltennamen.
**Antwort**
+ `ColumnStatisticsList` – Ein Array mit [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics)-Objekten.
Die Liste ColumnStatistics davon konnte nicht abgerufen werden.
+ `Errors` – Ein Array mit [ColumnError](aws-glue-api-common.md#aws-glue-api-common-ColumnError)-Objekten.
Beim Abrufen von Spaltenstatistikdaten ist ein Fehler aufgetreten.
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## UpdateColumnStatisticsForPartition Aktion (Python: update\$1column\$1statistics\$1for\$1partition)
Erstellt oder aktualisiert die Partitionsstatistiken von Spalten.
Die für diesen Vorgang erforderliche Identity and Access Management (IAM)-Berechtigung lautet `UpdatePartition`.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Partitionentabelle.
+ `PartitionValues` – *Erforderlich:* Ein Array von UTF-8-Zeichenketten.
Eine Liste der Partitionswerte, welche die Partition identifizieren.
+ `ColumnStatisticsList` – *Erforderlich:* Ein Array mit [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics)-Objekten, nicht mehr als 25 Strukturen.
Eine Liste der Spaltenstatistiken.
**Antwort**
+ `Errors` – Ein Array mit [ColumnStatisticsError](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError)-Objekten.
Beim Aktualisieren von Spaltenstatistikdaten ist ein Fehler aufgetreten.
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## DeleteColumnStatisticsForPartition Aktion (Python: delete\$1column\$1statistics\$1for\$1partition)
Löscht die Partitionsspaltenstatistiken einer Spalte.
Die für diesen Vorgang erforderliche Identity and Access Management (IAM)-Berechtigung lautet `DeletePartition`.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Partitionentabelle.
+ `PartitionValues` – *Erforderlich:* Ein Array von UTF-8-Zeichenketten.
Eine Liste der Partitionswerte, welche die Partition identifizieren.
+ `ColumnName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Name der Spalte.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
# Verbindungs-API
Die Connections-API beschreibt die Datentypen und die API im Zusammenhang mit der Arbeit mit Verbindungen in AWS Glue.
**Topics**
+ [Verbindungs-API](aws-glue-api-catalog-connections-connections.md)
+ [Verbindungstypen-API](aws-glue-api-catalog-connections-connections-type.md)
+ [Verbindungsmetadaten und Vorschau-API](aws-glue-api-catalog-connections-connections-metadata.md)
# Verbindungs-API
Die Verbindungs-API beschreibt AWS Glue Verbindungsdatentypen und die API zum Erstellen, Löschen, Aktualisieren und Auflisten von Verbindungen.
## Datentypen
+ [Connection-Struktur](#aws-glue-api-catalog-connections-connections-Connection)
+ [ConnectionInput Struktur](#aws-glue-api-catalog-connections-connections-ConnectionInput)
+ [TestConnectionInput Struktur](#aws-glue-api-catalog-connections-connections-TestConnectionInput)
+ [PhysicalConnectionRequirements Struktur](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements)
+ [GetConnectionsFilter Struktur](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter)
+ [AuthenticationConfiguration Struktur](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration)
+ [AuthenticationConfigurationInput Struktur](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput)
+ [OAuth2Struktur der Eigenschaften](#aws-glue-api-catalog-connections-connections-OAuth2Properties)
+ [OAuth2PropertiesInput Struktur](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput)
+ [OAuth2ClientApplication Struktur](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication)
+ [AuthorizationCodeProperties Struktur](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties)
+ [BasicAuthenticationCredentials Struktur](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials)
+ [OAuth2Struktur der Anmeldeinformationen](#aws-glue-api-catalog-connections-connections-OAuth2Credentials)
## Connection-Struktur
Definiert eine Verbindung zu einer Datenquelle.
**Felder**
+ `Name` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Verbindungsdefinition.
+ `Description` – Beschreibende Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Beschreibung der Verbindung.
+ `ConnectionType`— UTF-8-Zeichenfolge (gültige Werte: `JDBC` \$1 \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` `DYNAMODB` `GOOGLECLOUDSTORAGE`\$1 `HBASE` \$1 `KUSTOMER` \$1 \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 \$1 `TPCDS` \$1`VERTICA`).
Typ der Verbindung. Derzeit wird SFTP nicht unterstützt.
+ `MatchCriteria` – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 10 Zeichenfolgen.
Eine Liste von Kriterien, die bei der Auswahl dieser Verbindung verwendet werden können.
+ `ConnectionProperties` – Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 100 Paare.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge (gültige Werte: `HOST` \$1 \$1 \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` `KAFKA_SASL_GSSAPI_KEYTAB` `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` `CLUSTER_IDENTIFIER` \$1`DATABASE`).
Jeder Wert ist eine Wertzeichenfolge, die mindestens 1 und höchstens 1024 Bytes lang ist.
Diese Schlüssel-Wert-Paare definieren Parameter für die Verbindung bei Verwendung des Verbindungsschemas der Version 1:
+ `HOST`- Die Host-URI: entweder der vollqualifizierte Domainname (FQDN) oder die IPv4 Adresse des Datenbank-Hosts.
+ `PORT` – Die Portnummer zwischen 1024 und 65535 des Ports, auf dem der Datenbank-Host auf Datenbankverbindungen wartet.
+ `USER_NAME` – Der Name, unter dem Sie sich bei der Datenbank anmelden. Die Wert-Zeichenfolge für `USER_NAME` ist „`USERNAME`“.
+ `PASSWORD` – Ein Passwort, falls eines verwendet wird, für den Benutzernamen.
+ `ENCRYPTED_PASSWORD` – Wenn Sie den Verbindungspasswortschutz aktivieren, indem Sie in den Verschlüsselungseinstellungen des Data Catalog `ConnectionPasswordEncryption` festlegen, wird das verschlüsselte Passwort in diesem Feld gespeichert.
+ `JDBC_DRIVER_JAR_URI` – Der Amazon Simple Storage Service (Amazon S3)-Pfad der JAR-Datei, die den zu verwendenden JDBC-Treiber enthält.
+ `JDBC_DRIVER_CLASS_NAME` – Der Klassenname des zu verwendenden JDBC-Treibers.
+ `JDBC_ENGINE` – Der Name der zu verwendenden JDBC-Engine.
+ `JDBC_ENGINE_VERSION` – Die zu verwendende Version der JDBC-Engine.
+ `CONFIG_FILES` - (Zur späteren Verwendung reserviert.)
+ `INSTANCE_ID` – Die zu verwendende Instance-ID.
+ `JDBC_CONNECTION_URL` – Die URL für die Verbindung mit einer JDBC-Datenquelle.
+ `JDBC_ENFORCE_SSL` – Eine boolesche Zeichenfolge (true, false), bei der die Groß-/Kleinschreibung nicht beachtet wird und die angibt, ob Secure Sockets Layer (SSL) mit übereinstimmenden Hostnamen für die JDBC-Verbindung auf dem Client erzwungen wird. Der Standardwert lautet „false“.
+ `CUSTOM_JDBC_CERT`- Ein Amazon S3 S3-Standort, der das Stammzertifikat des Kunden angibt. AWS Glue verwendet dieses Stammzertifikat, um das Zertifikat des Kunden zu validieren, wenn eine Verbindung zur Kundendatenbank hergestellt wird. AWS Glue verarbeitet nur X.509-Zertifikate. Das bereitgestellte Zertifikat muss DER-codiert sein und im Base64-PEM-Codierungsformat bereitgestellt werden.
+ `SKIP_CUSTOM_JDBC_CERT_VALIDATION`- Standardmäßig ist `false` das. AWS Glue validiert den Signaturalgorithmus und den Subject Public Key Algorithm für das Kundenzertifikat. Die einzigen zulässigen Algorithmen für den Signaturalgorithmus sind SHA256with RSA, RSA oder SHA384with RSA. SHA512with Die Schlüssellänge für den Algorithmus für den öffentlichen Schlüssel muss mindestens 2048 betragen. Sie können den Wert dieser Eigenschaft auf `true` festlegen, um die AWS Glue-Validierung des Kundenzertifikats zu überspringen.
+ `CUSTOM_JDBC_CERT_STRING`- Eine benutzerdefinierte JDBC-Zertifikatszeichenfolge, die für den Domänenabgleich oder den Abgleich definierter Namen verwendet wird, um einen Angriff zu verhindern. man-in-the-middle In Oracle Database wird sie als `SSL_SERVER_CERT_DN` verwendet. In Microsoft SQL Server wird sie als `hostNameInCertificate` verwendet.
+ `CONNECTION_URL` – Die URL für die Verbindung mit einer allgemeinen Datenquelle (nicht JDBC).
+ `SECRET_ID` – Die geheime ID, die für den Secrets Manager der Anmeldeinformationen verwendet wird.
+ `CONNECTOR_URL` – Die Connector-URL für eine MARKETPLACE- oder CUSTOM-Verbindung.
+ `CONNECTOR_TYPE` – Der Konnektor-Typ für eine MARKETPLACE- oder CUSTOM-Verbindung.
+ `CONNECTOR_CLASS_NAME` – Die Konnektor-Klassenname für eine MARKETPLACE- oder CUSTOM-Verbindung.
+ `KAFKA_BOOTSTRAP_SERVERS` - Eine durch Kommata getrennte Liste von Host- und Portpaaren, die die Adressen der Apache Kafka Broker in einem Kafka-Cluster sind, zu dem ein Kafka-Client eine Verbindung herstellt und Bootstrapping durchführt.
+ `KAFKA_SSL_ENABLED` – Ob SSL auf einer Apache-Kafka-Verbindung aktiviert oder deaktiviert werden soll. Der Standardwert ist „true“.
+ `KAFKA_CUSTOM_CERT` – Die Amazon-S3-URL für die private CA-Zertifikatdatei (PEM-Format). Der Standardwert ist eine leere Zeichenfolge.
+ `KAFKA_SKIP_CUSTOM_CERT_VALIDATION`— Ob die Validierung der CA-Zertifikatsdatei übersprungen werden soll oder nicht. AWS Glue validiert für drei Algorithmen: SHA256with RSA, RSA und SHA384with RSA. SHA512with Der Standardwert ist „false“.
+ `KAFKA_CLIENT_KEYSTORE` – Der Amazon-S3-Speicherort der Client-Keystore-Datei für die clientseitige Kafka-Authentifizierung (optional).
+ `KAFKA_CLIENT_KEYSTORE_PASSWORD` – Das Passwort für den Zugriff auf den bereitgestellten Keystore (optional).
+ `KAFKA_CLIENT_KEY_PASSWORD` – Ein Keystore kann aus mehreren Schlüsseln bestehen, also ist dies das Passwort für den Zugriff auf den Clientschlüssel, der mit dem serverseitigen Kafka-Schlüssel verwendet werden soll (optional).
+ `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD`- Die verschlüsselte Version des Keystore-Passworts des Kafka-Clients (falls der Benutzer die Einstellung Passwörter verschlüsseln ausgewählt hat). AWS Glue
+ `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD`- Die verschlüsselte Version des Kafka-Client-Schlüsselkennworts (falls der Benutzer die Einstellung Passwörter AWS Glue verschlüsseln ausgewählt hat).
+ `KAFKA_SASL_MECHANISM` – `"SCRAM-SHA-512"`, `"GSSAPI"`, `"AWS_MSK_IAM"` oder `"PLAIN"`. Dies sind die unterstützten [SASL-Mechanismen](https://www.iana.org/assignments/sasl-mechanisms/sasl-mechanisms.xhtml).
+ `KAFKA_SASL_PLAIN_USERNAME` – Ein Klartext-Benutzername, der zur Authentifizierung mit dem Mechanismus „PLAIN“ verwendet wird.
+ `KAFKA_SASL_PLAIN_PASSWORD` – Ein Klartext-Passwort, das zur Authentifizierung mit dem Mechanismus „PLAIN“ verwendet wird.
+ `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD`- Die verschlüsselte Version des Kafka-SASL-PLAIN-Passworts (falls der Benutzer die Einstellung Passwörter AWS Glue verschlüsseln ausgewählt hat).
+ `KAFKA_SASL_SCRAM_USERNAME` – Ein Klartext-Benutzername, der zur Authentifizierung mit dem Mechanismus „SCRAM-SHA-512" verwendet wird.
+ `KAFKA_SASL_SCRAM_PASSWORD` – Ein Klartext-Passwort, das zur Authentifizierung mit dem Mechanismus „SCRAM-SHA-512" verwendet wird.
+ `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD`- Die verschlüsselte Version des Kafka-SASL-SCRAM-Passworts (falls der Benutzer die Einstellung Passwörter verschlüsseln ausgewählt hat). AWS Glue
+ `KAFKA_SASL_SCRAM_SECRETS_ARN`- Der Amazon-Ressourcenname eines Geheimnisses in AWS Secrets Manager.
+ `KAFKA_SASL_GSSAPI_KEYTAB` – Der S3-Speicherort einer Kerberos-`keytab`-Datei. Ein Keytab speichert Langzeitschlüssel für ein oder mehrere Prinzipale. Weitere Informationen finden Sie unter [MIT-Kerberos-Dokumentation: Keytab](https://web.mit.edu/kerberos/krb5-latest/doc/basic/keytab_def.html).
+ `KAFKA_SASL_GSSAPI_KRB5_CONF` – Der S3-Speicherort einer Kerberos-`krb5.conf`-Datei. Eine krb5.conf speichert Kerberos-Konfigurationsinformationen, z. B. den Standort des KDC-Servers. Weitere Informationen finden Sie in der [MIT-Kerberos-Dokumentation: krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html).
+ `KAFKA_SASL_GSSAPI_SERVICE` – Der Name des Kerberos-Services, wie er in Ihrer [Kafka-Konfiguration](https://kafka.apache.org/documentation/#brokerconfigs_sasl.kerberos.service.name) mit `sasl.kerberos.service.name` festgelegt wurde.
+ `KAFKA_SASL_GSSAPI_PRINCIPAL`- Der Name des Kerberos-Prinzials, der von verwendet wird. AWS Glue Weitere Informationen finden Sie in der [Kafka-Dokumentation: Konfigurieren von Kafka-Brokern](https://kafka.apache.org/documentation/#security_sasl_kerberos_clientconfig).
+ `ROLE_ARN` – Die Rolle, die für die Ausführung von Abfragen verwendet werden soll.
+ `REGION`- Die AWS Region, in der Abfragen ausgeführt werden.
+ `WORKGROUP_NAME` – Der Name einer Arbeitsgruppe von Amazon Redshift Serverless oder einer Amazon-Athena-Arbeitsgruppe, in der die Abfragen ausgeführt werden.
+ `CLUSTER_IDENTIFIER` – Die Cluster-ID eines Amazon-Redshift-Clusters, in dem die Abfragen ausgeführt werden.
+ `DATABASE` – Die Amazon-Redshift-Datenbank, mit der Sie eine Verbindung herstellen.
+ `SparkProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Spark-Datenverarbeitungsumgebung.
+ `AthenaProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Athena-Datenverarbeitungsumgebung.
+ `PythonProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Python-Datenverarbeitungsumgebung.
+ `PhysicalConnectionRequirements` – Ein [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements)-Objekt.
Die physischen Verbindungsanforderungen, z. B. Virtual Private Cloud (VPC) und `SecurityGroup`, die erforderlich sind, um diese Verbindung erfolgreich herzustellen.
+ `CreationTime` – Zeitstempel.
Der Zeitstempel der Erstellung dieser Verbindungsdefinition.
+ `LastUpdatedTime` – Zeitstempel.
Der Zeitstempel der letzten Aktualisierung der Verbindungsdefinition.
+ `LastUpdatedBy` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Benutzer, die Gruppe oder die Rolle, von dem bzw. der diese Verbindung zuletzt aktualisiert wurde.
+ `Status` – UTF-8-Zeichenfolge (zulässige Werte: `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).
Der Status der Verbindung. Dabei kann es sich um `READY`, `IN_PROGRESS` oder `FAILED` handeln.
+ `StatusReason`— UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 16384 Byte lang.
Der Grund für den Verbindungsstatus.
+ `LastConnectionValidationTime` – Zeitstempel.
Ein Zeitstempel, der den Zeitpunkt der letzten Überprüfung dieser Verbindung angibt.
+ `AuthenticationConfiguration` – Ein [AuthenticationConfiguration](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration)-Objekt.
Die Authentifizierungseigenschaften der Verbindung.
+ `ConnectionSchemaVersion`— Zahl (Ganzzahl), nicht weniger als 1 oder mehr als 2.
Die Version des Verbindungsschemas für diese Verbindung. Version 2 unterstützt Eigenschaften für bestimmte Datenverarbeitungsumgebungen.
+ `CompatibleComputeEnvironments` – Ein UTF-8-Zeichenfolgen-Array.
Eine Liste von Datenverarbeitungsumgebungen, die mit der Verbindung kompatibel sind.
## ConnectionInput Struktur
Eine Struktur, die zum Angeben einer Verbindung verwendet wird, die erstellt oder aktualisiert werden soll.
**Felder**
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Verbindung.
+ `Description` – Beschreibende Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Beschreibung der Verbindung.
+ `ConnectionType`— *Erforderlich:* UTF-8-String (gültige Werte: `JDBC` `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` `DATADOG` `WOOCOMMERCE`\$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` `DOCUMENTDB` `DOMO`\$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 \$1 `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).
Typ der Verbindung. Derzeit werden folgende Typen unterstützt:
+ `JDBC` – Gibt eine Verbindung mit einer Datenbank über Java Database Connectivity (JDBC) an.
`JDBC`Verbindungen verwenden Folgendes ConnectionParameters.
+ Erforderlich: Alle von (`HOST`, `PORT`, `JDBC_ENGINE`) oder `JDBC_CONNECTION_URL`.
+ Erforderlich: Alle (`USERNAME`, `PASSWORD`,) oder `SECRET_ID`.
+ Optional: `JDBC_ENFORCE_SSL`, `CUSTOM_JDBC_CERT`, `CUSTOM_JDBC_CERT_STRING`, `SKIP_CUSTOM_JDBC_CERT_VALIDATION`. Diese Parameter werden verwendet, um SSL mit JDBC zu konfigurieren.
+ `KAFKA` - Bezeichnet eine Verbindung zu einer Apache-Kafka-Streaming-Plattform.
`KAFKA`Verbindungen verwenden Folgendes ConnectionParameters.
+ Erforderlich: `KAFKA_BOOTSTRAP_SERVERS`.
+ Optional: `KAFKA_SSL_ENABLED`, `KAFKA_CUSTOM_CERT`, `KAFKA_SKIP_CUSTOM_CERT_VALIDATION`. Diese Parameter werden verwendet, um SSL mit `KAFKA` zu konfigurieren.
+ Optional: `KAFKA_CLIENT_KEYSTORE`, `KAFKA_CLIENT_KEYSTORE_PASSWORD`, `KAFKA_CLIENT_KEY_PASSWORD`, `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD`, `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD`. Diese Parameter werden verwendet, um TLS-Client-Konfiguration mit SSL in `KAFKA` zu konfigurieren.
+ Fakultativ:`KAFKA_SASL_MECHANISM`. Kann als `SCRAM-SHA-512`, `GSSAPI` oder `AWS_MSK_IAM` angegeben werden.
+ Optional: `KAFKA_SASL_SCRAM_USERNAME`, `KAFKA_SASL_SCRAM_PASSWORD`, `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD`. Diese Parameter werden verwendet, um SASL/SCRAM-SHA-512-Authentifizierung mit `KAFKA` zu konfigurieren.
+ Optional: `KAFKA_SASL_GSSAPI_KEYTAB`, `KAFKA_SASL_GSSAPI_KRB5_CONF`, `KAFKA_SASL_GSSAPI_SERVICE`, `KAFKA_SASL_GSSAPI_PRINCIPAL`. Diese Parameter werden verwendet, um die SASL/GSSAPI Authentifizierung mit zu konfigurieren`KAFKA`.
+ `MONGODB` – Gibt eine Verbindung zu einer MongoDB-Dokumentdatenbank an.
`MONGODB`Verbindungen verwenden Folgendes ConnectionParameters.
+ Erforderlich: `CONNECTION_URL`.
+ Erforderlich: Alle von (`USERNAME`, `PASSWORD`) oder `SECRET_ID`.
+ `VIEW_VALIDATION_REDSHIFT` – Bezeichnet eine Verbindung, die von Amazon Redshift zur Überprüfung von Ansichten verwendet wird.
+ `VIEW_VALIDATION_ATHENA` – Bezeichnet eine Verbindung, die von Amazon Athena zur Überprüfung von Ansichten verwendet wird.
+ `NETWORK` – Bezeichnet eine Netzwerkverbindung zu einer Datenquelle in einer Amazon Virtual Private Cloud-Umgebung (Amazon VPC).
`NETWORK`Verbindungen sind nicht erforderlich ConnectionParameters. Geben Sie stattdessen eine an PhysicalConnectionRequirements.
+ `MARKETPLACE`- Verwendet Konfigurationseinstellungen, die in einem Connector enthalten sind AWS Marketplace , um aus Datenspeichern zu lesen und in diese zu schreiben, die nicht nativ von AWS Glue unterstützt werden.
`MARKETPLACE`Verbindungen verwenden Folgendes ConnectionParameters.
+ Erforderlich: `CONNECTOR_TYPE`, `CONNECTOR_URL`, `CONNECTOR_CLASS_NAME`, `CONNECTION_URL`.
+ Erforderlich für `JDBC` `CONNECTOR_TYPE`-Verbindungen: Alle von (`USERNAME`, `PASSWORD`) oder `SECRET_ID`.
+ `CUSTOM` – Verwendet die in einem benutzerdefinierten Konnektor enthaltenen Konfigurationseinstellungen, der zum Lesen und Schreiben in nicht nativ von AWS Glue unterstützten Datastores erworben wurde.
Weitere Informationen zu den für einen bestimmten Connector benötigten Verbindungsparametern finden Sie in der Dokumentation zum Connector unter [AWS Glue Verbindung hinzufügen](https://docs.aws.amazon.com/glue/latest/dg/console-connections.html) im AWS Glue Benutzerhandbuch.
`SFTP` wird nicht unterstützt.
Weitere Informationen darüber, wie optionale Funktionen zur Konfiguration verwendet ConnectionProperties werden AWS Glue, finden Sie unter [AWS Glue Verbindungseigenschaften](https://docs.aws.amazon.com/glue/latest/dg/connection-defining.html).
Weitere Informationen darüber, wie optionale Funktionen zur Konfiguration von Funktionen in AWS Glue Studio verwendet ConnectionProperties werden, finden Sie unter [Verwenden von Konnektoren und Verbindungen](https://docs.aws.amazon.com/glue/latest/ug/connectors-chapter.html).
+ `MatchCriteria` – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 10 Zeichenfolgen.
Eine Liste von Kriterien, die bei der Auswahl dieser Verbindung verwendet werden können.
+ `ConnectionProperties` – *Erforderlich:* Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 100 Paare.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge (gültige Werte: `HOST` \$1 \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` `KAFKA_SASL_GSSAPI_KEYTAB` `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` `CLUSTER_IDENTIFIER` \$1`DATABASE`).
Jeder Wert ist eine Wertzeichenfolge, die mindestens 1 und höchstens 1024 Bytes lang ist.
Diese Schlüssel-Wert-Paare definieren Parameter für die Verbindung.
+ `SparkProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Spark-Datenverarbeitungsumgebung.
+ `AthenaProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Athena-Datenverarbeitungsumgebung.
+ `PythonProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Python-Datenverarbeitungsumgebung.
+ `PhysicalConnectionRequirements` – Ein [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements)-Objekt.
Die physischen Verbindungsanforderungen, z. B. Virtual Private Cloud (VPC) und `SecurityGroup`, die erforderlich sind, um diese Verbindung erfolgreich herzustellen.
+ `AuthenticationConfiguration` – Ein [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput)-Objekt.
Die Authentifizierungseigenschaften der Verbindung.
+ `ValidateCredentials` – Boolesch.
Eine Markierung zur Überprüfung der Anmeldeinformationen beim Erstellen der Verbindung. Der Standardwert ist „true“.
+ `ValidateForComputeEnvironments` – Ein UTF-8-Zeichenfolgen-Array.
Die Datenverarbeitungsumgebungen, gegen die die angegebenen Verbindungseigenschaften validiert werden.
## TestConnectionInput Struktur
Eine Struktur, die zum Angeben des Testens einer Verbindung zu einem Service verwendet wird.
**Felder**
+ `ConnectionType`— *Erforderlich:* UTF-8-String (gültige Werte: `JDBC` `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` `DATADOG` `WOOCOMMERCE`\$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` `DOCUMENTDB` `DOMO`\$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 \$1 `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).
Der zu testende Verbindungstyp. Dieser Vorgang ist nur für die Verbindungen `JDBC` oder `SALESFORCE` verfügbar.
+ `ConnectionProperties` – *Erforderlich:* Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 100 Paare.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge (gültige Werte: `HOST` \$1 \$1 \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` `KAFKA_SASL_GSSAPI_KEYTAB` `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` `CLUSTER_IDENTIFIER` \$1`DATABASE`).
Jeder Wert ist eine Wertzeichenfolge, die mindestens 1 und höchstens 1024 Bytes lang ist.
Die Schlüssel-Wert-Paare, die die Parameter für die Verbindung definieren.
JDBC-Verbindungen verwenden die folgenden Verbindungseigenschaften:
+ Erforderlich: Alle von (`HOST`, `PORT`, `JDBC_ENGINE`) oder `JDBC_CONNECTION_URL`.
+ Erforderlich: Alle (`USERNAME`, `PASSWORD`,) oder `SECRET_ID`.
+ Optional: `JDBC_ENFORCE_SSL`, `CUSTOM_JDBC_CERT`, `CUSTOM_JDBC_CERT_STRING`, `SKIP_CUSTOM_JDBC_CERT_VALIDATION`. Diese Parameter werden verwendet, um SSL mit JDBC zu konfigurieren.
Für SALESFORCE-Verbindungen muss das `AuthenticationConfiguration`-Mitglied konfiguriert werden.
+ `AuthenticationConfiguration` – Ein [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput)-Objekt.
Eine Struktur, die die Authentifizierungskonfiguration in der TestConnection Anfrage enthält. Erforderlich für eine Verbindung zu Salesforce mithilfe von OAuth Authentifizierung.
## PhysicalConnectionRequirements Struktur
Die OAuth Client-App als GetConnection Antwort.
**Felder**
+ `SubnetId` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Subnetz-ID, die von der Verbindung verwendet wird.
+ `SecurityGroupIdList` – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 50 Zeichenfolgen.
Die Sicherheitsgruppen-ID-Liste, die von der Verbindung verwendet wird.
+ `AvailabilityZone` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Availability Zone der Verbindung.
## GetConnectionsFilter Struktur
Filtert die von der `GetConnections`-API-Operation zurückgegebenen Verbindungsdefinitionen.
**Felder**
+ `MatchCriteria` – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 10 Zeichenfolgen.
Eine Kriterienzeichenfolge, die den Kriterien entsprechen muss, die in der Verbindungsdefinition hinterlegt sind, damit diese Verbindungsdefinition zurückgegeben wird.
+ `ConnectionType`— UTF-8-Zeichenfolge (gültige Werte: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` `DYNAMODB` `GOOGLECLOUDSTORAGE`\$1 `HBASE` \$1 `KUSTOMER` \$1 \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 \$1 `TPCDS` \$1`VERTICA`).
Der Typ von Verbindungen, der zurückgegeben werden soll. Derzeit wird SFTP nicht unterstützt.
+ `ConnectionSchemaVersion`— Zahl (Ganzzahl), nicht weniger als 1 oder mehr als 2.
Gibt an, ob die Verbindung mit Schemaversion 1 oder 2 erstellt wurde.
## AuthenticationConfiguration Struktur
Eine Struktur, die die Authentifizierungskonfiguration enthält.
**Felder**
+ `AuthenticationType` – UTF-8-Zeichenfolge (zulässige Werte: `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).
Eine Struktur, die die Authentifizierungskonfiguration enthält.
+ `SecretArn` – UTF-8-Zeichenfolge, die [Custom string pattern #36](aws-glue-api-common.md#regex_36) entspricht.
Der Secret-Manager-ARN zur Speicherung von Anmeldeinformationen.
+ `KmsKeyArn` – UTF-8-Zeichenfolge, die [Custom string pattern #42](aws-glue-api-common.md#regex_42) entspricht.
Der Amazon-Ressourcenname (ARN) des KMS-Schlüssels zum Verschlüsseln vertraulicher Authentifizierungsinformationen. Dieser Schlüssel dient dem Schutz von Anmeldeinformationen und anderen sensiblen Daten, die in der Authentifizierungskonfiguration gespeichert sind.
+ `OAuth2Properties` – Ein [OAuth2Eigenschaften](#aws-glue-api-catalog-connections-connections-OAuth2Properties)-Objekt.
Die Eigenschaften für die OAuth2 Authentifizierung.
## AuthenticationConfigurationInput Struktur
Eine Struktur, die die Authentifizierungskonfiguration in der CreateConnection Anfrage enthält.
**Felder**
+ `AuthenticationType` – UTF-8-Zeichenfolge (zulässige Werte: `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).
Eine Struktur, die die Authentifizierungskonfiguration in der CreateConnection Anfrage enthält.
+ `OAuth2Properties` – Ein [OAuth2PropertiesInput](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput)-Objekt.
Die Eigenschaften für die OAuth2 Authentifizierung in der CreateConnection Anfrage.
+ `SecretArn` – UTF-8-Zeichenfolge, die [Custom string pattern #36](aws-glue-api-common.md#regex_36) entspricht.
Der geheime Manager-ARN zum Speichern von Anmeldeinformationen in der CreateConnection Anfrage.
+ `KmsKeyArn` – UTF-8-Zeichenfolge, die [Custom string pattern #42](aws-glue-api-common.md#regex_42) entspricht.
Der ARN des KMS-Schlüssels, der zur Verschlüsselung der Verbindung verwendet wurde. Er wird ausschließlich als Eingabe in der Anfrage akzeptiert und im Secret Manager gespeichert.
+ `BasicAuthenticationCredentials` – Ein [BasicAuthenticationCredentials](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials)-Objekt.
Die Anmeldeinformationen, die verwendet werden, wenn es sich bei dem Authentifizierungstyp um eine Standardauthentifizierung handelt.
+ `CustomAuthenticationCredentials` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Die Anmeldeinformationen, die verwendet werden, wenn es sich bei dem Authentifizierungstyp um eine benutzerdefinierte Authentifizierung handelt.
## OAuth2Struktur der Eigenschaften
Eine Struktur, die Eigenschaften für die OAuth2 Authentifizierung enthält.
**Felder**
+ `OAuth2GrantType` – UTF-8-Zeichenfolge (zulässige Werte: `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).
Die Art des OAuth2 Zuschusses. Beispiel: `AUTHORIZATION_CODE`, `JWT_BEARER` oder `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication` – Ein [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication)-Objekt.
Der Client-Anwendungstyp. Zum Beispiel AWS\$1MANAGED oder USER\$1MANAGED.
+ `TokenUrl` – UTF-8-Zeichenfolge, nicht mehr als 256 Bytes lang, passend zum [Custom string pattern #40](aws-glue-api-common.md#regex_40).
Die URL des Authentifizierungsservers des Anbieters für den Austausch eines Autorisierungscodes gegen ein Zugriffstoken.
+ `TokenUrlParametersMap` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 512 Bytes lang ist.
Eine Zuordnung von Parametern, die der Token-`GET`-Anfrage hinzugefügt werden.
## OAuth2PropertiesInput Struktur
Eine Struktur, die Eigenschaften für OAuth2 in der CreateConnection Anfrage enthält.
**Felder**
+ `OAuth2GrantType` – UTF-8-Zeichenfolge (zulässige Werte: `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).
Der OAuth2 Zuschusstyp in der CreateConnection Anfrage. Beispiel: `AUTHORIZATION_CODE`, `JWT_BEARER` oder `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication` – Ein [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication)-Objekt.
Der Typ der Client-Anwendung in der CreateConnection Anfrage. Zum Beispiel `AWS_MANAGED` oder `USER_MANAGED`.
+ `TokenUrl` – UTF-8-Zeichenfolge, nicht mehr als 256 Bytes lang, passend zum [Custom string pattern #40](aws-glue-api-common.md#regex_40).
Die URL des Authentifizierungsservers des Anbieters für den Austausch eines Autorisierungscodes gegen ein Zugriffstoken.
+ `TokenUrlParametersMap` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 512 Bytes lang ist.
Eine Zuordnung von Parametern, die der Token-`GET`-Anfrage hinzugefügt werden.
+ `AuthorizationCodeProperties` – Ein [AuthorizationCodeProperties](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties)-Objekt.
Der Satz von Eigenschaften, die für den OAuth2 `AUTHORIZATION_CODE` Grant-Typ erforderlich sind.
+ `OAuth2Credentials` – Ein [OAuth2Erweitern Sie im angezeigten Detailbereich die Option](#aws-glue-api-catalog-connections-connections-OAuth2Credentials)-Objekt.
Die Anmeldeinformationen, die verwendet werden, wenn der Authentifizierungstyp OAuth2 Authentifizierung ist.
## OAuth2ClientApplication Struktur
Die für die Verbindung verwendete OAuth2 Client-App.
**Felder**
+ `UserManagedClientApplicationClientId` – UTF-8-Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum [Custom string pattern #37](aws-glue-api-common.md#regex_37).
Die ClientID der Client-Anwendung, falls ja. ClientAppType `USER_MANAGED`
+ `AWSManagedClientApplicationReference` – UTF-8-Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum [Custom string pattern #37](aws-glue-api-common.md#regex_37).
Der Verweis auf die SaaS-seitige Client-App, die verwaltet wird AWS .
## AuthorizationCodeProperties Struktur
Der Satz von Eigenschaften, die für den Workflow mit der Art des OAuth2 `AUTHORIZATION_CODE` Zuschusses erforderlich sind.
**Felder**
+ `AuthorizationCode`— UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 4096 Byte lang, entspricht. [Custom string pattern #37](aws-glue-api-common.md#regex_37)
Ein Autorisierungscode, der in der dritten Phase des `AUTHORIZATION_CODE`-Gewährungs-Workflows verwendet werden soll. Dieser Code ist nur einmal verwendbar und wird ungültig, sobald er gegen ein Zugriffstoken ausgetauscht wird. Daher ist es zulässig, diesen Wert als Anforderungsparameter zu verwenden.
+ `RedirectUri`— UTF-8-Zeichenfolge, nicht mehr als 512 Byte lang, entspricht. [Custom string pattern #41](aws-glue-api-common.md#regex_41)
Die Umleitungs-URI, zu der der Benutzer bei der Ausgabe eines Autorisierungscodes vom Autorisierungsserver umgeleitet wird. Diese URI wird anschließend verwendet, wenn der Autorisierungscode gegen ein Zugriffstoken ausgetauscht wird.
## BasicAuthenticationCredentials Struktur
Zur Bereitstellung von Anmeldeinformationen für die Basisauthentifizierung, wenn kein `SecretArn`-Wert angegeben wird.
**Felder**
+ `Username`— UTF-8-Zeichenfolge, nicht mehr als 512 Byte lang, entspricht. [Custom string pattern #37](aws-glue-api-common.md#regex_37)
Der Benutzername zur Verbindung mit der Datenquelle.
+ `Password`— UTF-8-Zeichenfolge, nicht mehr als 512 Byte lang, entspricht der. [Custom string pattern #33](aws-glue-api-common.md#regex_33)
Das Passwort für die Verbindung zur Datenquelle.
## OAuth2Struktur der Anmeldeinformationen
Die Anmeldeinformationen, die verwendet werden, wenn der Authentifizierungstyp OAuth2 Authentifizierung ist.
**Felder**
+ `UserManagedClientApplicationClientSecret`— UTF-8-Zeichenfolge, nicht mehr als 512 Byte lang, entspricht. [Custom string pattern #38](aws-glue-api-common.md#regex_38)
Das Client-Geheimnis der Client-Anwendung, wenn die Client-Anwendung vom Benutzer verwaltet wird.
+ `AccessToken`— UTF-8-Zeichenfolge, nicht mehr als 4096 Byte lang, entspricht der. [Custom string pattern #38](aws-glue-api-common.md#regex_38)
Das Zugriffstoken, das verwendet wird, wenn der Authentifizierungstyp ist. OAuth2
+ `RefreshToken`— UTF-8-Zeichenfolge, nicht mehr als 4096 Byte lang, entspricht. [Custom string pattern #38](aws-glue-api-common.md#regex_38)
Das Aktualisierungstoken, das verwendet wird, wenn der Authentifizierungstyp ist. OAuth2
+ `JwtToken`— UTF-8-Zeichenfolge, nicht mehr als 8000 Byte lang, entspricht. [Custom string pattern #39](aws-glue-api-common.md#regex_39)
Das JSON Web Token (JWT), das verwendet wird, wenn der Authentifizierungstyp ist. OAuth2
## Operationen
+ [CreateConnection Aktion (Python: create\$1connection)](#aws-glue-api-catalog-connections-connections-CreateConnection)
+ [DeleteConnection Aktion (Python: delete\$1connection)](#aws-glue-api-catalog-connections-connections-DeleteConnection)
+ [GetConnection Aktion (Python: get\$1connection)](#aws-glue-api-catalog-connections-connections-GetConnection)
+ [GetConnections Aktion (Python: get\$1connections)](#aws-glue-api-catalog-connections-connections-GetConnections)
+ [UpdateConnection Aktion (Python: update\$1connection)](#aws-glue-api-catalog-connections-connections-UpdateConnection)
+ [TestConnection Aktion (Python: test\$1connection)](#aws-glue-api-catalog-connections-connections-TestConnection)
+ [BatchDeleteConnection Aktion (Python: batch\$1delete\$1connection)](#aws-glue-api-catalog-connections-connections-BatchDeleteConnection)
## CreateConnection Aktion (Python: create\$1connection)
Erstellt eine Verbindungsdefinition im Data Catalog.
Verbindungen, die zum Erstellen von Verbundressourcen verwendet werden, erfordern die IAM-Berechtigung `glue:PassConnection`.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem die Verbindung erstellt wird. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `ConnectionInput` – *Erforderlich:* Ein [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput)-Objekt.
Ein `ConnectionInput`-Objekt, das die zu erstellende Verbindung definiert.
+ `Tags` – Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 50 Paare.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht mehr als 256 Bytes lang ist.
Die Tags, die Sie der Verbindung zuweisen.
**Antwort**
+ `CreateConnectionStatus` – UTF-8-Zeichenfolge (zulässige Werte: `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).
Der Status der Anfrage für die Verbindungserstellung. Die Anfrage kann bei bestimmten Authentifizierungstypen einige Zeit in Anspruch nehmen, z. B. beim Herstellen einer OAuth Verbindung mit Tokenaustausch über VPC.
**Fehler**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
## DeleteConnection Aktion (Python: delete\$1connection)
Löscht eine Verbindung aus dem Data Catalog.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die Verbindung befindet. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `ConnectionName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der zu löschenden Verbindung.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
## GetConnection Aktion (Python: get\$1connection)
Ruft eine Verbindungsdefinition aus dem Data Catalog ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die Verbindung befindet. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Verbindungsdefinition, die abgerufen werden soll.
+ `HidePassword` – Boolesch.
Damit können Sie die Verbindungsmetadaten abrufen, ohne das Passwort zurückzugeben. Beispielsweise verwendet die AWS Glue Konsole dieses Flag, um die Verbindung abzurufen, und zeigt das Passwort nicht an. Legen Sie diesen Parameter fest, wenn der Anrufer möglicherweise nicht berechtigt ist, den AWS KMS Schlüssel zum Entschlüsseln des Kennworts zu verwenden, er jedoch berechtigt ist, auf die übrigen Verbindungseigenschaften zuzugreifen.
+ `ApplyOverrideForComputeEnvironment` – UTF-8-Zeichenfolge (zulässige Werte: `SPARK` \$1 `ATHENA` \$1 `PYTHON`).
Für Verbindungen, die in mehreren Diensten verwendet werden können, werden die zurückgegebenen Eigenschaften für die angegebene Datenverarbeitungsumgebung angegeben.
**Antwort**
+ `Connection` – Ein [Connection (Verbindung)](#aws-glue-api-catalog-connections-connections-Connection)-Objekt.
Die angeforderte Verbindungsdefinition.
**Fehler**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
## GetConnections Aktion (Python: get\$1connections)
Ruft eine Liste von Verbindungsdefinitionen aus dem Data Catalog ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die Verbindungen befinden. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `Filter` – Ein [GetConnectionsFilter](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter)-Objekt.
Ein Filter, der steuert, welche Verbindungen zurückgegeben werden.
+ `HidePassword` – Boolesch.
Damit können Sie die Verbindungsmetadaten abrufen, ohne das Passwort zurückzugeben. Beispielsweise verwendet die AWS Glue Konsole dieses Flag, um die Verbindung abzurufen, und zeigt das Passwort nicht an. Legen Sie diesen Parameter fest, wenn der Anrufer möglicherweise nicht berechtigt ist, den AWS KMS Schlüssel zum Entschlüsseln des Kennworts zu verwenden, er jedoch berechtigt ist, auf die übrigen Verbindungseigenschaften zuzugreifen.
+ `NextToken` – UTF-8-Zeichenfolge.
Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist.
+ `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000.
Die maximale Anzahl von Verbindungen, die in einer Antwort zurückgegeben werden sollen.
**Antwort**
+ `ConnectionList` – Ein Array mit [Connection (Verbindung)](#aws-glue-api-catalog-connections-connections-Connection)-Objekten.
Eine Liste von angeforderten Verbindungsdefinitionen.
+ `NextToken` – UTF-8-Zeichenfolge.
Ein Fortsetzungs-Token, wenn die Liste der zurückgegebenen Verbindungen nicht die letzten gefilterten Verbindungen enthält.
**Fehler**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
## UpdateConnection Aktion (Python: update\$1connection)
Aktualisiert eine Verbindungsdefinition im Data Catalog.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die Verbindung befindet. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `Name` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Verbindungsdefinition, die aktualisiert werden soll.
+ `ConnectionInput` – *Erforderlich:* Ein [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput)-Objekt.
Ein `ConnectionInput`-Objekt, das die jeweilige Verbindung neu definiert.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
## TestConnection Aktion (Python: test\$1connection)
Testet eine Verbindung zu einem Dienst, um die von Ihnen angegebenen Anmeldeinformationen für den Dienst zu überprüfen.
Sie können entweder einen bestehenden Verbindungsnamen oder einen `TestConnectionInput` zum Testen einer nicht existierenden Verbindung angeben. Die gleichzeitige Angabe beider Werte führt zu einem Fehler.
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
**Anforderung**
+ `ConnectionName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Optional. Der Name der zu testenden Verbindung. Wenn nur der Name angegeben wird, stellt der Vorgang die Verbindung her und verwendet diese zum Testen.
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Katalog-ID, in dem sich die Verbindung befindet.
+ `TestConnectionInput` – Ein [TestConnectionInput](#aws-glue-api-catalog-connections-connections-TestConnectionInput)-Objekt.
Eine Struktur, die zum Angeben des Testens einer Verbindung zu einem Service verwendet wird.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ConflictException`
+ `InternalServiceException`
## BatchDeleteConnection Aktion (Python: batch\$1delete\$1connection)
Löscht eine Liste von Verbindungsdefinitionen aus dem Data Catalog.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die Verbindungen befinden. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `ConnectionNameList` – *Erforderlich:* Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 25 Zeichenfolgen.
Eine Liste der Namen der Verbindungen, die gelöscht werden sollen.
**Antwort**
+ `Succeeded` – Ein UTF-8-Zeichenfolgen-Array.
Eine Liste der Namen der Verbindungsdefinitionen, die erfolgreich gelöscht wurden.
+ `Errors` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, und entspricht dem [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Jeder Wert ist ein An [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail)-Objekt.
Eine Zuweisung der Namen von Verbindungen, die nicht erfolgreich gelöscht wurden, zu Fehlerdetails.
**Fehler**
+ `InternalServiceException`
+ `OperationTimeoutException`
# Verbindungstypen-API
Die Verbindungstyp-API beschreibt AWS Glue APIs im Zusammenhang mit der Beschreibung von Verbindungstypen.
## Verwaltung der Verbindungen APIs
+ [DescribeConnectionType Aktion (Python: describe\$1connection\$1type)](#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType)
+ [ListConnectionTypes Aktion (Python: list\$1connection\$1types)](#aws-glue-api-catalog-connections-connections-type-ListConnectionTypes)
+ [ConnectionTypeBrief Struktur](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief)
+ [ConnectionTypeVariant Struktur](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant)
## DescribeConnectionType Aktion (Python: describe\$1connection\$1type)
Die `DescribeConnectionType`-API stellt vollständige Informationen zu den unterstützten Optionen für einen bestimmten Verbindungstyp in AWS Glue bereit.
**Anforderung**
+ `ConnectionType` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name des zu beschreibenden Verbindungstyps.
**Antwort**
+ `ConnectionType` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name des Verbindungstyps.
+ `Description` – UTF-8-Zeichenfolge, nicht mehr als 1.024 Bytes lang.
Eine Beschreibung des Verbindungstyps.
+ `Capabilities` – Ein [Capabilities](#aws-glue-api-catalog-connections-connections-type-Capabilities)-Objekt.
Die unterstützten Authentifizierungstypen, Datenschnittstellentypen (Datenverarbeitungsumgebungen) und Datenoperationen des Connectors.
+ `ConnectionProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist ein A [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Verbindungseigenschaften, die in allen Datenverarbeitungsumgebungen üblich sind.
+ `ConnectionOptions` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist ein A [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Gibt Eigenschaften zurück, die beim Erstellen einer Verbindung in den `ConnectionInput.ConnectionProperties` festgelegt werden können. `ConnectionOptions` definiert Parameter, die in einem Spark-ETL-Skript in der Zuordnung der Verbindungsoptionen festgelegt werden können, die an einen Datenrahmen übergeben wird.
+ `AuthenticationConfiguration` – Ein [AuthConfiguration](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration)-Objekt.
Die Art der für die Verbindung zu verwendenden Authentifizierung.
+ `ComputeEnvironmentConfigurations` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist ein A [ComputeEnvironmentConfiguration](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration)-Objekt.
Die Datenverarbeitungsumgebungen, die von der Verbindung unterstützt werden.
+ `PhysicalConnectionRequirements` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist ein A [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Physikalische Anforderungen für eine Verbindung, beispielsweise VPC-, Subnetz- und Sicherheitsgruppenspezifikationen.
+ `AthenaConnectionProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist ein A [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Spezifische Verbindungseigenschaften für die Athena-Datenverarbeitungsumgebung.
+ `PythonConnectionProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist ein A [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Verbindungseigenschaften, die für die Python-Datenverarbeitungsumgebung spezifisch sind.
+ `SparkConnectionProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist ein A [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Spezifische Verbindungseigenschaften für die Spark-Datenverarbeitungsumgebung.
**Fehler**
+ `ValidationException`
+ `InvalidInputException`
+ `InternalServiceException`
## ListConnectionTypes Aktion (Python: list\$1connection\$1types)
Die `ListConnectionTypes`-API stellt einen Erkennungsmechanismus zum Ermitteln verfügbarer Verbindungstypen in AWS Glue bereit. Die Antwort enthält eine Liste von Verbindungstypen mit detaillierten Informationen dazu, was für die einzelnen Verbindungstypen unterstützt wird. Bei den aufgelisteten Verbindungstypen handelt es sich um eine Gruppe unterstützter Optionen für den `ConnectionType`-Wert in der `CreateConnection`-API.
**Anforderung**
+ `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000.
Die maximale Anzahl der auszugebenden Ergebnisse.
+ `NextToken` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Bytes lang, passend zum [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist.
**Antwort**
+ `ConnectionTypes` – Ein Array mit [ConnectionTypeBrief](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief)-Objekten.
Eine Liste von `ConnectionTypeBrief`-Objekten mit kurzen Informationen zu den unterstützten Verbindungstypen.
+ `NextToken` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Bytes lang, passend zum [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Ein Fortsetzungs-Token, wenn das aktuelle Listensegment nicht das letzte ist.
**Fehler**
+ `InternalServiceException`
## ConnectionTypeBrief Struktur
Kurze Informationen zu einem unterstützten Verbindungstyp, der von der `ListConnectionTypes`-API zurückgegeben wird.
**Felder**
+ `ConnectionType`— UTF-8-Zeichenfolge (gültige Werte: `JDBC` \$1 \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` `DYNAMODB` `GOOGLECLOUDSTORAGE`\$1 `HBASE` \$1 `KUSTOMER` \$1 \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 \$1 `TPCDS` \$1`VERTICA`).
Der Name des Verbindungstyps.
+ `DisplayName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 128 Bytes lang.
Der lesbare Name für den Verbindungstyp, der in der AWS Glue -Konsole angezeigt wird.
+ `Vendor` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 128 Bytes lang.
Der Name des Anbieters, der diesen Verbindungstyp erstellt oder verwaltet.
+ `Description` – UTF-8-Zeichenfolge, nicht mehr als 1.024 Bytes lang.
Eine Beschreibung des Verbindungstyps.
+ `Categories` – .
Eine Liste der Kategorien, zu denen dieser Verbindungstyp gehört. Mithilfe von Kategorien können Benutzer anhand ihrer Anwendungsfälle geeignete Verbindungstypen filtern und finden.
+ `Capabilities` – Ein [Capabilities](#aws-glue-api-catalog-connections-connections-type-Capabilities)-Objekt.
Die unterstützten Authentifizierungstypen, Datenschnittstellentypen (Datenverarbeitungsumgebungen) und Datenoperationen des Connectors.
+ `LogoUrl` – UTF-8-Zeichenfolge.
Die URL des Logos, das einem Verbindungstyp zugeordnet ist.
+ `ConnectionTypeVariants` – Ein Array mit [ConnectionTypeVariant](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant)-Objekten.
Eine Liste der für diesen Verbindungstyp verfügbaren Varianten. Verschiedene Varianten bieten möglicherweise spezielle Konfigurationen für bestimmte Anwendungsfälle oder Implementierungen desselben allgemeinen Verbindungstyps.
## ConnectionTypeVariant Struktur
Stellt eine Variante eines Verbindungstyps im AWS Glue Datenkatalog dar. Verbindungstypvarianten stellen spezifische Konfigurationen und Verhaltensweisen für verschiedene Implementierungen desselben allgemeinen Verbindungstyps bereit.
**Felder**
+ `ConnectionTypeVariantName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 128 Bytes lang.
Der eindeutige Bezeichner für die Verbindungstypvariante. Dieser Name wird intern verwendet, um die spezifische Variante eines Verbindungstyps zu identifizieren.
+ `DisplayName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 128 Bytes lang.
Der für Menschen lesbare Name für die Variante des Verbindungstyps, der in der AWS Glue Konsole angezeigt wird.
+ `Description` – UTF-8-Zeichenfolge, nicht mehr als 1.024 Bytes lang.
Eine ausführliche Beschreibung der Verbindungstypvariante, einschließlich Zweck, Anwendungsfälle und aller spezifischen Konfigurationsanforderungen.
+ `LogoUrl` – UTF-8-Zeichenfolge.
Die URL des Logos, das einer Verbindungstypvariante zugeordnet ist.
## Datentypen
+ [Validierungsstruktur](#aws-glue-api-catalog-connections-connections-type-Validation)
+ [AuthConfiguration Struktur](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration)
+ [Capabilities-Struktur](#aws-glue-api-catalog-connections-connections-type-Capabilities)
+ [Property-Struktur](#aws-glue-api-catalog-connections-connections-type-Property)
+ [AllowedValue Struktur](#aws-glue-api-catalog-connections-connections-type-AllowedValue)
+ [ComputeEnvironmentConfiguration Struktur](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration)
## Validierungsstruktur
Definiert, wie eine Verbindungseigenschaft validiert wird.
**Felder**
+ `ValidationType` – *Erforderlich:* UTF-8-Zeichenfolge (zulässige Werte: `REGEX` \$1 `RANGE`).
Die Art der durchzuführenden Validierung, beispielsweise `REGEX`.
+ `Patterns` – .
Eine Liste von Mustern, die für die Validierung gelten.
+ `Description` – *Erforderlich:* UTF-8-Zeichenkette, nicht weniger als 1 oder mehr als 1.024 Bytes lang.
Eine Beschreibung der Validierung.
+ `MaxLength` – Zahl (Ganzzahl).
Die maximale Länge für eine Verbindungseigenschaft einer Zeichenfolge.
+ `Maximum` – Zahl (Ganzzahl).
Der Maximalwert bei der Angabe eines `RANGE`-Validierungstyps.
+ `Minimum` – Zahl (Ganzzahl).
Der Mindestwert bei der Angabe eines `RANGE`-Validierungstyps.
## AuthConfiguration Struktur
Die Authentifizierungskonfiguration für eine Verbindung, die von der `DescribeConnectionType`-API zurückgegeben wurde.
**Felder**
+ `AuthenticationType` – *Erforderlich:* Ein [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Die Art der Authentifizierung für eine Verbindung.
+ `SecretArn` – Ein [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Der Amazon-Ressourcenname (ARN) für Secrets Manager.
+ `OAuth2Properties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist ein A [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Eine Karte mit Schlüssel-Wert-Paaren für die OAuth2 Eigenschaften. Jeder Wert ist ein `Property`-Objekt.
+ `BasicAuthenticationProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist ein A [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Eine Zuordnung von Schlüssel-Wert-Paaren für die Eigenschaften. OAuth2 Jeder Wert ist ein `Property`-Objekt.
+ `CustomAuthenticationProperties` – Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist ein A [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Eine Zuordnung von Schlüssel-Wert-Paaren für benutzerdefinierte Authentifizierungseigenschaften. Jeder Wert ist ein `Property`-Objekt.
## Capabilities-Struktur
Gibt die unterstützten Authentifizierungstypen an, die von der `DescribeConnectionType`-API zurückgegeben werden.
**Felder**
+ `SupportedAuthenticationTypes` – *Erforderlich:* Ein Array von UTF-8-Zeichenketten.
Eine Liste der unterstützten Authentifizierungstypen.
+ `SupportedDataOperations` – *Erforderlich:* Ein Array von UTF-8-Zeichenketten.
Eine Liste der unterstützten Datenoperationen.
+ `SupportedComputeEnvironments` – *Erforderlich:* Ein Array von UTF-8-Zeichenketten.
Eine Liste der unterstützten Datenverarbeitungsumgebungen.
## Property-Struktur
Ein Objekt, das einen Verbindungstyp für eine Datenverarbeitungsumgebung definiert.
**Felder**
+ `Name` – *Erforderlich:* UTF-8-Zeichenkette, nicht weniger als 1 oder mehr als 128 Bytes lang.
Der Name der Eigenschaft.
+ `Description` – *Erforderlich:* UTF-8-Zeichenfolge, nicht länger als 1.024 Bytes.
Eine Beschreibung der Eigenschaft.
+ `Required` – *Erforderlich:* Boolean.
Gibt an, ob die Eigenschaft erforderlich ist.
+ `PropertyTypes` – *Erforderlich:* Ein Array von UTF-8-Zeichenketten.
Beschreibt den Eigenschaftentyp.
+ `AllowedValues` – Ein Array mit [AllowedValue](#aws-glue-api-catalog-connections-connections-type-AllowedValue)-Objekten.
Eine Liste von `AllowedValue`-Objekten, die die für die Eigenschaft zulässigen Werte darstellen.
+ `DataOperationScopes` – Ein UTF-8-Zeichenfolgen-Array.
Gibt an, welche Datenoperationen auf die Eigenschaft anwendbar sind.
## AllowedValue Struktur
Ein Objekt, das einen für eine Eigenschaft zulässigen Wert darstellt.
**Felder**
+ `Description` – UTF-8-Zeichenfolge, nicht mehr als 1.024 Bytes lang.
Eine Beschreibung des zulässigen Werts.
+ `Value` – *Erforderlich:* UTF-8-Zeichenkette, nicht weniger als 1 oder mehr als 128 Bytes lang.
Der für die Eigenschaft zulässige Wert.
## ComputeEnvironmentConfiguration Struktur
Ein Objekt, das die Konfiguration für eine Datenverarbeitungsumgebung (wie Spark, Python oder Athena) enthält, die von der `DescribeConnectionType`-API zurückgegeben wird.
**Felder**
+ `Name` – *Erforderlich:* UTF-8-Zeichenkette, nicht weniger als 1 oder mehr als 128 Bytes lang.
Ein Name für die Konfiguration der Datenverarbeitungsumgebung.
+ `Description` – *Erforderlich:* UTF-8-Zeichenfolge, nicht länger als 1.024 Bytes.
Eine Beschreibung der Datenverarbeitungsumgebung.
+ `ComputeEnvironment` – *Erforderlich:* UTF-8-Zeichenfolge (zulässige Werte: `SPARK` \$1 `ATHENA` \$1 `PYTHON`).
Der Typ der Datenverarbeitungsumgebung.
+ `SupportedAuthenticationTypes` – *Erforderlich:* Ein Array von UTF-8-Zeichenketten.
Die unterstützten Authentifizierungstypen für die Datenverarbeitungsumgebung.
+ `ConnectionOptions` – *Erforderlich:* Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist ein A [Eigenschaft](#aws-glue-api-catalog-connections-connections-type-Property)-Objekt.
Die als Verbindungsoptionen für die Datenverarbeitungsumgebung verwendeten Parameter.
+ `ConnectionPropertyNameOverrides` – *Erforderlich:* Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Die Überschreibungen des Verbindungseigenschaftsnamens für die Datenverarbeitungsumgebung.
+ `ConnectionOptionNameOverrides` – *Erforderlich:* Ein Map-Array von Schlüssel-Wert-Paaren.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Die Überschreibungen des Verbindungsoptionsnamens für die Datenverarbeitungsumgebung.
+ `ConnectionPropertiesRequiredOverrides`— *Erforderlich:*.
Die Verbindungseigenschaften, die als Überschreibungen für die Datenverarbeitungsumgebung erforderlich sind.
+ `PhysicalConnectionPropertiesRequired` – Boolesch.
Gibt an, ob `PhysicalConnectionProperties` für die Datenverarbeitungsumgebung erforderlich sind.
# Verbindungsmetadaten und Vorschau-API
In der folgenden Verbindung APIs werden Operationen zur Beschreibung von Verbindungsmetadaten beschrieben.
## Datentypen
+ [Entitätsstruktur](#aws-glue-api-catalog-connections-connections-metadata-Entity)
+ [Feldstruktur](#aws-glue-api-catalog-connections-connections-metadata-Field)
## Entitätsstruktur
Eine Entität, die von einem bestimmten `ConnectionType` unterstützt wird.
**Felder**
+ `EntityName` – UTF-8-Zeichenfolge.
Der Name der Entität.
+ `Label` – UTF-8-Zeichenfolge.
Für die Entität verwendete Bezeichnung.
+ `IsParentEntity` – Boolesch.
Ein boolescher Wert, mit dem bestimmt werden kann, ob Unterobjekte aufgelistet werden können.
+ `Description` – UTF-8-Zeichenfolge.
Eine Beschreibung der Entität.
+ `Category` – UTF-8-Zeichenfolge.
Der Typ der Entitäten, die in der Antwort vorhanden sind. Dieser Wert hängt von der Quellverbindung ab. Dies ist beispielsweise `SObjects` für Salesforce und `databases` oder `schemas` oder `tables` für Quellen wie Amazon Redshift.
+ `CustomProperties` –
Eine optionale Zuordnung von Schlüsseln, die für eine Entität von einem Connector zurückgegeben werden können.
## Feldstruktur
Das `Field`-Objekt enthält Informationen über die verschiedenen Eigenschaften, die einem Feld im Connector zugeordnet sind.
**Felder**
+ `FieldName` – UTF-8-Zeichenfolge.
Eine eindeutige Kennung für das Feld.
+ `Label` – UTF-8-Zeichenfolge.
Eine lesbare Bezeichnung, die für das Feld verwendet wird.
+ `Description` – UTF-8-Zeichenfolge.
Eine Beschreibung des Felds.
+ `FieldType`— UTF-8-Zeichenfolge (gültige Werte: `INT` \$1 \$1 \$1 `SMALLINT` \$1 `BIGINT` \$1 `FLOAT` \$1 `LONG` \$1 `DATE` \$1 \$1 `BOOLEAN` \$1 `MAP` \$1 `ARRAY` \$1 `STRING` \$1 `TIMESTAMP` \$1 `DECIMAL` \$1 \$1 `BYTE` `SHORT` `DOUBLE` \$1`STRUCT`).
Der Typ der Daten im Feld.
+ `IsPrimaryKey` – Boolesch.
Gibt an, ob dieses Feld als Primärschlüssel für die angegebene Entität verwendet werden kann.
+ `IsNullable` – Boolesch.
Gibt an, ob dieses Feld löschbar ist oder nicht.
+ `IsRetrievable` – Boolesch.
Gibt an, ob dieses Feld der SELECT-Klausel der SQL-Abfrage hinzugefügt werden kann oder ob es abrufbar ist oder nicht.
+ `IsFilterable` – Boolesch.
Gibt an, ob dieses Feld in einer Filterklausel (`WHERE`-Klausel) einer SQL-Anweisung beim Abfragen von Daten verwendet werden kann.
+ `IsPartitionable` – Boolesch.
Gibt an, ob ein bestimmtes Feld zur Partitionierung der an Software as a Service (SaaS) gestellten Abfrage verwendet werden kann.
+ `IsCreateable` – Boolesch.
Gibt an, ob dieses Feld im Rahmen eines Schreibvorgangs an das Ziel erstellt werden kann.
+ `IsUpdateable` – Boolesch.
Gibt an, ob dieses Feld im Rahmen eines Schreibvorgangs an das Ziel aktualisiert werden kann.
+ `IsUpsertable` – Boolesch.
Gibt an, ob dieses Feld im Rahmen eines Schreibvorgangs an das Ziel geändert werden kann.
+ `IsDefaultOnCreate` – Boolesch.
Gibt an, ob dieses Feld automatisch gefüllt wird, wenn das Objekt erstellt wird, z. B. ein Erstellt am-Zeitstempel.
+ `SupportedValues` – .
Eine Liste von unterstützten Werten für das Feld.
+ `SupportedFilterOperators` – Ein UTF-8-Zeichenfolgen-Array.
Gibt an, welche Filtervorgänge für dieses Feld unterstützt werden.
+ `CustomProperties` –
Optionale Zuordnung von Schlüsseln, die zurückgegeben werden können.
## Operationen
+ [ListEntities Aktion (Python: list\$1entities)](#aws-glue-api-catalog-connections-connections-metadata-ListEntities)
+ [DescribeEntity Aktion (Python: describe\$1entity)](#aws-glue-api-catalog-connections-connections-metadata-DescribeEntity)
+ [GetEntityRecords Aktion (Python: get\$1entity\$1records)](#aws-glue-api-catalog-connections-connections-metadata-GetEntityRecords)
## ListEntities Aktion (Python: list\$1entities)
Gibt die verfügbaren Entitäten zurück, die vom Verbindungstyp unterstützt werden.
**Anforderung**
+ `ConnectionName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Ein Name für die Verbindung, für die Anmeldeinformationen erforderlich sind, um einen beliebigen Verbindungstyp abzufragen.
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Katalog-ID des Katalogs, der die Verbindung enthält. Dies kann Null sein. Standardmäßig ist die AWS Konto-ID die Katalog-ID.
+ `ParentEntityName` – UTF-8-Zeichenfolge.
Der Name der übergeordneten Entität, für die Sie die untergeordneten Entitäten aufführen möchten. Dieser Parameter verwendet einen vollständig qualifizierten Pfad der Entität, um die untergeordneten Entitäten aufzulisten.
+ `NextToken` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Bytes lang, passend zum [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Ein Fortsetzungs-Token, der enthalten ist, wenn dies ein Fortsetzungsaufruf ist.
+ `DataStoreApiVersion` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 256 Bytes lang, passend zum [Custom string pattern #23](aws-glue-api-common.md#regex_23).
Die API-Version des SaaS-Connectors.
**Antwort**
+ `Entities` – Ein Array mit [Entität](#aws-glue-api-catalog-connections-connections-metadata-Entity)-Objekten.
Eine Liste von `Entity`-Objekten.
+ `NextToken` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Bytes lang, passend zum [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Ein Fortsetzungs-Token, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist.
**Fehler**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`
## DescribeEntity Aktion (Python: describe\$1entity)
Enthält die Details zu der Entität, die mit dem Verbindungstyp verwendet wird, sowie eine Beschreibung des Datenmodells für jedes Feld in der ausgewählten Entität.
Die Antwort umfasst alle Felder, aus denen die Entität besteht.
**Anforderung**
+ `ConnectionName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Verbindung, die die Verbindungstyp-Anmeldeinformationen enthält.
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Katalog-ID des Katalogs, der die Verbindung enthält. Dies kann Null sein. Standardmäßig ist die AWS Konto-ID die Katalog-ID.
+ `EntityName` – *Erforderlich:* UTF-8-Zeichenfolge.
Der Name der Entität, die Sie anhand des Verbindungstyps beschreiben möchten.
+ `NextToken` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Bytes lang, passend zum [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Ein Fortsetzungs-Token, der enthalten ist, wenn dies ein Fortsetzungsaufruf ist.
+ `DataStoreApiVersion` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 256 Bytes lang, passend zum [Custom string pattern #23](aws-glue-api-common.md#regex_23).
Die Version der API, die für den Datenspeicher verwendet wird.
**Antwort**
+ `Fields` – Ein Array mit [Feld](#aws-glue-api-catalog-connections-connections-metadata-Field)-Objekten.
Beschreibt die Felder für diese Connector-Entität. Dies ist die Liste der `Field`-Objekte. `Field` ähnelt sehr einer Spalte in einer Datenbank. Das `Field`-Objekt enthält Informationen über verschiedene Eigenschaften, die Feldern im Connector zugeordnet sind.
+ `NextToken` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Bytes lang, passend zum [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Ein Fortsetzungs-Token, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist.
**Fehler**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`
## GetEntityRecords Aktion (Python: get\$1entity\$1records)
Diese API wird verwendet, um Vorschaudaten von einem bestimmten Verbindungstyp oder aus einem nativen Amazon S3 S3-basierten AWS Glue Datenkatalog abzufragen.
Gibt Datensätze als Array von JSON-Blobs zurück. Jeder Datensatz wird mithilfe von Jackson auf der JsonNode Grundlage des von der `DescribeEntity` API definierten Feldtyps formatiert.
Spark-Connectors generieren Schemas gemäß derselben Datentypzuordnung wie in der `DescribeEntity`-API. Spark-Connectors konvertieren Daten in die entsprechenden Datentypen, die dem Schema entsprechen, wenn Zeilen zurückgegeben werden.
**Anforderung**
+ `ConnectionName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Verbindung, die die Verbindungstyp-Anmeldeinformationen enthält.
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Katalog-ID des Katalogs, der die Verbindung enthält. Dies kann Null sein. Standardmäßig ist die AWS Konto-ID die Katalog-ID.
+ `EntityName` – *Erforderlich:* UTF-8-Zeichenfolge.
Der Name der Entität, für die wir die Vorschaudaten des angegebenen Verbindungstyps abfragen möchten.
+ `NextToken` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Bytes lang, passend zum [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Ein Fortsetzungs-Token, der enthalten ist, wenn dies ein Fortsetzungsaufruf ist.
+ `DataStoreApiVersion` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 256 Bytes lang, passend zum [Custom string pattern #23](aws-glue-api-common.md#regex_23).
Die API-Version des SaaS-Connectors.
+ `ConnectionOptions` – Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 100 Paare.
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 256 Byte lang ist und der entspricht. [Custom string pattern #18](aws-glue-api-common.md#regex_18)
Jeder Schlüssel ist eine UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 256 Bytes lang, und entspricht dem [Custom string pattern #17](aws-glue-api-common.md#regex_17).
Connectoroptionen, die zum Abfragen der Daten erforderlich sind.
+ `FilterPredicate` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 100.000 Bytes lang.
Ein Filterprädikat, das Sie in der Abfrageanforderung anwenden können.
+ `Limit` – *Erforderlich:* Zahl (lang), nicht kleiner als 1 oder größer als 1.000.
Beschränkt die Anzahl der mit der Anfrage abgerufenen Datensätze.
+ `SelectedFields` – Ein Array mit UTF-8-Zeichenfolgen, nicht weniger als 1 und nicht mehr als 1.000 Zeichenfolgen.
Liste der Felder, die als Teil der Vorschaudaten abgerufen werden sollen.
**Antwort**
+ `Records` – Eine Reihe von Strukturen.
Eine Liste der angeforderten -Objekte.
+ `NextToken` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Bytes lang, passend zum [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Ein Fortsetzungs-Token, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist.
**Fehler**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`
# Benutzerdefinierte Funktion (API)
Die API für benutzerdefinierte Funktionen beschreibt AWS Glue Datentypen und Operationen, die bei der Arbeit mit Funktionen verwendet werden.
## Datentypen
+ [UserDefinedFunction Struktur](#aws-glue-api-catalog-functions-UserDefinedFunction)
+ [UserDefinedFunctionInput Struktur](#aws-glue-api-catalog-functions-UserDefinedFunctionInput)
## UserDefinedFunction Struktur
Stellt das Äquivalent einer benutzerdefinierten Hive-Funktion (`UDF`) dar.
**Felder**
+ `FunctionName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Funktion.
+ `DatabaseName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Katalogdatenbank, die die Funktion enthält
+ `ClassName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Java-Klasse mit dem Funktionscode.
+ `OwnerName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Eigentümer der Funktion.
+ `OwnerType` – UTF-8-Zeichenfolge (zulässige Werte: `USER` \$1 `ROLE` \$1 `GROUP`).
Der Typ des Eigentümers.
+ `CreateTime` – Zeitstempel.
Die Uhrzeit, zu der die Funktion erstellt wurde.
+ `ResourceUris` – Ein Array mit [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri)-Objekten, nicht mehr als 1000 Strukturen.
Die Ressource URIs für die Funktion.
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die Funktion befindet.
## UserDefinedFunctionInput Struktur
Eine Struktur, mit der eine benutzerdefinierte Funktion angelegt oder aktualisiert wird.
**Felder**
+ `FunctionName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Funktion.
+ `ClassName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Java-Klasse mit dem Funktionscode.
+ `OwnerName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Eigentümer der Funktion.
+ `OwnerType` – UTF-8-Zeichenfolge (zulässige Werte: `USER` \$1 `ROLE` \$1 `GROUP`).
Der Typ des Eigentümers.
+ `ResourceUris` – Ein Array mit [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri)-Objekten, nicht mehr als 1000 Strukturen.
Die Ressource URIs für die Funktion.
## Operationen
+ [CreateUserDefinedFunction Aktion (Python: create\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-CreateUserDefinedFunction)
+ [UpdateUserDefinedFunction Aktion (Python: update\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-UpdateUserDefinedFunction)
+ [DeleteUserDefinedFunction Aktion (Python: delete\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-DeleteUserDefinedFunction)
+ [GetUserDefinedFunction Aktion (Python: get\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-GetUserDefinedFunction)
+ [GetUserDefinedFunctions Aktion (Python: get\$1user\$1defined\$1functions)](#aws-glue-api-catalog-functions-GetUserDefinedFunctions)
## CreateUserDefinedFunction Aktion (Python: create\$1user\$1defined\$1function)
Erstellt eine neue Funktionsdefinition im Data Catalog.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem die Funktion erstellt wird. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die Name der Katalogdatenbank, in der die Funktion angelegt wird.
+ `FunctionInput` – *Erforderlich:* Ein [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput)-Objekt.
Das `FunctionInput`-Objekt, das die im Data Catalog zu erstellende Funktion definiert.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
## UpdateUserDefinedFunction Aktion (Python: update\$1user\$1defined\$1function)
Aktualisiert eine bestehende Funktionsdefinition im Data Catalog.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die zu aktualisierende Funktion 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Katalogdatenbank, in der sich die zu aktualisierende Funktion befindet.
+ `FunctionName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Funktion.
+ `FunctionInput` – *Erforderlich:* Ein [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput)-Objekt.
Ein `FunctionInput`-Objekt, das die Funktion im Data Catalog neu definiert.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## DeleteUserDefinedFunction Aktion (Python: delete\$1user\$1defined\$1function)
Löscht eine bestehende Funktionsdefinition im Data Catalog.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die zu löschende Funktion befindet. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Katalogdatenbank, in der sich die Funktion befindet.
+ `FunctionName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Funktionsdefinition, die gelöscht werden soll.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
## GetUserDefinedFunction Aktion (Python: get\$1user\$1defined\$1function)
Ruft eine angegebene Funktionsdefinition aus dem Data Catalog ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die abzurufende Funktion 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Katalogdatenbank, in der sich die Funktion befindet.
+ `FunctionName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Funktion.
**Antwort**
+ `UserDefinedFunction` – Ein [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction)-Objekt.
Die angeforderte Funktionsdefinition.
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## GetUserDefinedFunctions Aktion (Python: get\$1user\$1defined\$1functions)
Ruft mehrere Funktionsdefinition aus dem Data Catalog ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Data Catalog, in dem sich die abzurufenden Funktionen befinden. Wenn keine angegeben wird, wird standardmäßig die AWS Konto-ID verwendet.
+ `DatabaseName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Katalogdatenbank, in der sich die Funktionen befinden. Wenn keine bereitgestellt wird, werden Funktionen aus allen Datenbanken im Katalog zurückgegeben.
+ `Pattern` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Ein optionaler Musterstring für Funktionsnamen, der die zurückgegebenen Funktionsdefinitionen filtert.
+ `NextToken` – UTF-8-Zeichenfolge.
Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist.
+ `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 100.
Die maximale Anzahl der Funktionen, die in einer Antwort zurückgegeben werden können.
**Antwort**
+ `UserDefinedFunctions` – Ein Array mit [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction)-Objekten.
Eine Liste der angeforderten Funktionsdefinitionen.
+ `NextToken` – UTF-8-Zeichenfolge.
Ein Fortsetzungs-Token, wenn die Liste der zurückgegebenen Funktionen nicht die zuletzt angeforderte Funktion enthält.
**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
# Einen Athena Katalog importieren nach AWS Glue
Die Migrations-API beschreibt AWS Glue Datentypen und Vorgänge, die mit der Migration eines Athena Datenkatalogs zu zu tun haben. AWS Glue
## Datentypen
+ [CatalogImportStatus Struktur](#aws-glue-api-catalog-migration-CatalogImportStatus)
## CatalogImportStatus Struktur
Eine Struktur, die Migrationsstatusinformationen enthält.
**Felder**
+ `ImportCompleted` – Boolesch.
`True`, wenn die Migration abgeschlossen ist, andernfalls `False`.
+ `ImportTime` – Zeitstempel.
Der Zeitpunkt des Beginns der Migration.
+ `ImportedBy` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Der Name der Person, die die Migration eingeleitet hat.
## Operationen
+ [ImportCatalogToGlue Aktion (Python: import\$1catalog\$1to\$1glue)](#aws-glue-api-catalog-migration-ImportCatalogToGlue)
+ [GetCatalogImportStatus Aktion (Python: get\$1catalog\$1import\$1status)](#aws-glue-api-catalog-migration-GetCatalogImportStatus)
## ImportCatalogToGlue Aktion (Python: import\$1catalog\$1to\$1glue)
Importiert einen vorhandenen Amazon Athena Athena-Datenkatalog in AWS Glue.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Katalogs, der importiert werden soll. Derzeit sollte dies die AWS Konto-ID sein.
**Antwort**
+ *Keine Antwortparameter.*
**Fehler**
+ `InternalServiceException`
+ `OperationTimeoutException`
## GetCatalogImportStatus Aktion (Python: get\$1catalog\$1import\$1status)
Ruft den Status einer Migrationsoperation ab.
**Anforderung**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Die ID des Katalogs, der migriert werden soll. Derzeit sollte dies die Konto-ID sein. AWS
**Antwort**
+ `ImportStatus` – Ein [CatalogImportStatus](#aws-glue-api-catalog-migration-CatalogImportStatus)-Objekt.
Der Status der angegebenen Katalogmigration.
**Fehler**
+ `InternalServiceException`
+ `OperationTimeoutException`