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. # 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`