View a markdown version of this page

Integrations-APIs in AWS Glue - AWS Glue

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.

Integrations-APIs in AWS Glue

Datentypen

Integrationsstruktur

Beschreibt eine Null-ETL-Integration.

Felder
  • SourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN für die Quelle der Integration.

  • TargetArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN für das Ziel der Integration.

  • Description— UTF-8 Zeichenfolge, nicht länger als 1000 Byte, die dem entsprichtCustom string pattern #17.

    Eine Beschreibung für die Integration.

  • IntegrationName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Ein eindeutiger Name für die Integration.

  • IntegrationArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Amazon-Ressourcenname (ARN) für die Integration.

  • KmsKeyId— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang.

    Der ARN eines KMS-Schlüssels, der für die Verschlüsselung des Kanals verwendet wird.

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

    Jeder Schlüssel ist eine UTF-8 Zeichenfolge.

    Jeder Wert ist eine UTF-8 Zeichenfolge.

    Ein optionaler Satz von nicht geheimen Schlüssel-Wert-Paaren, der zusätzliche kontextbezogene Informationen für die Verschlüsselung enthält. Dies kann nur bereitgestellt werden, wenn KMSKeyId bereitgestellt wird.

  • Tags – Ein Array mit Markierung-Objekten.

    Die der Ressource zugewiesenen Metadaten bestehen aus einer Liste von Schlüssel-Wert-Paaren.

  • Status Erforderlich: UTF-8 Zeichenfolge (gültige Werte: CREATING | ACTIVE | MODIFYING | FAILED | DELETING | SYNCING |NEEDS_ATTENTION).

    Die folgenden Status sind möglich:

    • CREATING: Die Integration wird erstellt.

    • ACTIVE: Die Integrationserstellung ist erfolgreich.

    • MODIFYING: Die Integration wird geändert.

    • FAILED: Die Integrationserstellung schlägt fehl.

    • DELETING: Die Integration wird gelöscht.

    • SYNCING: Die Integration wird synchronisiert.

    • NEEDS_ATTENTION: Die Integration erfordert Aufmerksamkeit, z. B. Synchronisation.

  • CreateTimeErforderlich: Zeitstempel.

    Die Zeit in UTC, zu der die Integration erstellt wurde.

  • IntegrationConfig – Ein IntegrationConfig-Objekt.

    Eigenschaften, die der Integration zugeordnet sind.

  • Errors – Ein Array mit IntegrationError-Objekten.

    Eine Liste der Fehler im Zusammenhang mit der Integration.

  • DataFilter— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang.

    Wählt Quelltabellen für die Integration mithilfe der Maxwell-Filtersyntax aus.

IntegrationConfig Struktur

Eigenschaften, die der Integration zugeordnet sind.

Felder
  • RefreshInterval— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Gibt die Häufigkeit an, mit der CDC-Pulls (Change Data Capture) oder inkrementelle Ladevorgänge ausgeführt werden sollen. Dieser Parameter bietet Flexibilität bei der Anpassung der Aktualisierungsrate an Ihre spezifischen Datenaktualisierungsmuster, Überlegungen zur Systemlast und Ziele zur Leistungsoptimierung. Das Zeitintervall kann zwischen 15 Minuten und 8640 Minuten (sechs Tage) eingestellt werden.

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

    Jeder Schlüssel ist eine UTF-8 Zeichenfolge.

    Jeder Wert ist eine UTF-8 Zeichenfolge.

    Eine Sammlung von Schlüssel-Wert-Paaren, die zusätzliche Eigenschaften für die Integrationsquelle angeben. Diese Eigenschaften bieten Konfigurationsoptionen, mit denen das Verhalten der ODB-Quelle bei Datenintegrationsvorgängen angepasst werden kann.

  • ContinuousSync – Boolesch.

    Ermöglicht die kontinuierliche Synchronisation für On-Demand-Datenextraktionen aus SaaS-Anwendungen zu AWS Datendiensten wie Amazon Redshift und. Amazon S3

IntegrationPartition Struktur

Eine Struktur, die beschreibt, wie Daten auf dem Ziel partitioniert werden.

Felder
  • FieldName— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Feldname, der zur Partitionierung von Daten auf dem Ziel verwendet wird. Vermeiden Sie es, Spalten mit eindeutigen Werten für jede Zeile (z. B. '', LastModifiedTimestamp 'SystemModTimeStamp') als Partitionsspalte zu verwenden. Diese Spalten eignen sich nicht für die Partitionierung, da sie eine große Anzahl kleiner Partitionen erstellen, was zu Leistungsproblemen führen kann.

  • FunctionSpec— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Gibt die Funktion an, die zum Partitionieren von Daten auf dem Ziel verwendet wird. Die akzeptierten Werte für diesen Parameter sind:

    • identity – verwendet Quellwerte direkt ohne Transformation

    • year – extrahiert das Jahr aus Zeitstempelwerten (z. B. 2023)

    • month – extrahiert den Monat aus Zeitstempelwerten (z. B. 2023-01)

    • day – extrahiert den Tag aus Zeitstempelwerten (z. B. 2023-01-15)

    • hour – extrahiert die Stunde aus Zeitstempelwerten (z. B. 2023-01-15-14)

  • ConversionSpec— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Gibt das Zeitstempelformat der Quelldaten an. Folgende sind gültige Werte:

    • epoch_sec – Zeitstempel der Unix-Epoche in Sekunden

    • epoch_milli – Zeitstempel der Unix-Epoche in Millisekunden

    • iso – Zeitstempel im ISO-8601-Format

    Anmerkung

    Geben Sie dies nur anConversionSpec, wenn Sie auf Zeitstempeln basierende Partitionsfunktionen verwenden (Jahr, Monat, Tag oder Stunde). AWS Glue Zero-ETLverwendet diesen Parameter, um Quelldaten vor der Partitionierung korrekt in das Zeitstempelformat umzuwandeln.

    Verwenden Sie für die Partitionsfunktion keine Spalten mit hoher Kardinalität. identity High-cardinality Zu den Spalten gehören:

    • Primärschlüssel

    • Zeitstempelfelder (z. B. LastModifiedTimestamp und CreatedDate)

    • System-generated Zeitstempel

    Durch die Verwendung von Spalten mit hoher Kardinalität und Identitätspartitionierung entstehen viele kleine Partitionen, wodurch die Aufnahmeleistung erheblich beeinträchtigt werden kann.

IntegrationError Struktur

Ein Fehler im Zusammenhang mit einer Null-ETL-Integration.

Felder
  • ErrorCode— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Code im Zusammenhang mit diesem Fehler.

  • ErrorMessage— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang.

    Eine Meldung mit einer Beschreibung des Fehlers.

IntegrationFilter Struktur

Ein Filter, der beim Aufrufen einer DescribeIntegrations-Anfrage verwendet werden kann.

Felder
  • Name— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Name des Filters

  • Values— Eine Reihe von UTF-8 Zeichenketten.

    Eine Liste von Filterwerten.

InboundIntegration -Struktur

Eine Struktur für eine Integration, die Daten in eine Ressource schreibt.

Felder
  • SourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN der Quellressource für die Integration.

  • TargetArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN der Zielressource für die Integration.

  • IntegrationArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der ARN der Null-ETL-Integration.

  • Status Erforderlich: UTF-8 Zeichenfolge (gültige Werte: CREATING | ACTIVE | MODIFYING | FAILED | DELETING | SYNCING |NEEDS_ATTENTION).

    Die folgenden Status sind möglich:

    • CREATING: Die Integration wird erstellt.

    • ACTIVE: Die Integrationserstellung ist erfolgreich.

    • MODIFYING: Die Integration wird geändert.

    • FAILED: Die Integrationserstellung schlägt fehl.

    • DELETING: Die Integration wird gelöscht.

    • SYNCING: Die Integration wird synchronisiert.

    • NEEDS_ATTENTION: Die Integration erfordert Aufmerksamkeit, z. B. Synchronisation.

  • CreateTimeErforderlich: Zeitstempel.

    Die Zeit in UTC, zu der die Integration erstellt wurde.

  • IntegrationConfig – Ein IntegrationConfig-Objekt.

    Eigenschaften, die der Integration zugeordnet sind.

  • Errors – Ein Array mit IntegrationError-Objekten.

    Eine Liste der Fehler im Zusammenhang mit der Integration.

SourceProcessingProperties Struktur

Die mit der Integrationsquelle verknüpften Ressourceneigenschaften.

Felder
  • RoleArn— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Die IAM-Rolle für den Zugriff auf die AWS Glue Verbindung.

TargetProcessingProperties Struktur

Die mit dem Integrationsziel verknüpften Ressourceneigenschaften.

Felder
  • RoleArn— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Die IAM-Rolle für den Zugriff auf die AWS Glue Datenbank.

  • KmsArn— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang.

    Der ARN des KMS-Schlüssels, der zur Verschlüsselung verwendet wird.

  • ConnectionName— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Die AWS Glue Netzwerkverbindung zur Konfiguration des AWS Glue Jobs, der in der Kunden-VPC ausgeführt wird.

  • EventBusArn— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Byte lang ist.

    Der ARN eines Eventbridge-Event Bus für den Empfang der Integrationsstatusbenachrichtigung.

SourceTableConfig Struktur

Eigenschaften, die vom Quellteil verwendet werden, um Daten aus der Quelle zu verarbeiten.

Felder
  • Fields— Eine Reihe von UTF-8 Zeichenketten.

    Eine Liste von Feldern, die für die Filterung auf Spaltenebene verwendet werden. Wird derzeit nicht unterstützt.

  • FilterPredicate— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Eine Bedingungsklausel, die für die Filterung auf Zeilenebene verwendet wird. Wird derzeit nicht unterstützt.

  • PrimaryKey— Eine Reihe von UTF-8 Zeichenketten.

    Geben Sie den Primärschlüssel für diese Tabelle an. Wird derzeit auf Anfrage speziell für EntityOf-Entitäten von SAP unterstützt. Wenden Sie sich an den AWS Support, um diese Funktion verfügbar zu machen.

  • RecordUpdateField— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Inkrementelles Feld auf der Grundlage eines Zeitstempels für den Abruf. Wird derzeit nicht unterstützt.

TargetTableConfig Struktur

Eigenschaften, die vom Zielteil verwendet werden, um die Daten auf dem Ziel zu partitionieren.

Felder
  • UnnestSpec— UTF-8 Zeichenfolge (gültige Werte: TOPLEVEL | FULL |NOUNNEST).

    Gibt an, wie verschachtelte Objekte auf Elemente der obersten Ebene reduziert werden. Gültige Werte sind: „TOPLEVEL“, „FULL“ oder „NOUNNEST“.

  • PartitionSpec – Ein Array mit IntegrationPartition-Objekten.

    Bestimmt das Datei-Layout auf dem Ziel.

  • TargetTableName— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der optionale Name einer Zieltabelle.

Operationen

CreateIntegration Aktion (Python: create_integration)

Erstellt im Konto des Anrufers eine Zero-ETL Integration zwischen zwei Ressourcen mit Amazon-Ressourcennamen (ARNs): und. SourceArn TargetArn

Anforderung
  • IntegrationName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Ein eindeutiger Name für eine Integration in AWS Glue.

  • SourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN der Quellressource für die Integration.

  • TargetArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN der Zielressource für die Integration.

  • Description— UTF-8 Zeichenfolge, nicht länger als 1000 Byte, die dem entsprichtCustom string pattern #17.

    Eine Beschreibung der Integration.

  • DataFilter— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Byte lang ist.

    Wählt Quelltabellen für die Integration mithilfe der Maxwell-Filtersyntax aus.

  • KmsKeyId— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang.

    Der ARN eines KMS-Schlüssels, der für die Verschlüsselung des Kanals verwendet wird.

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

    Jeder Schlüssel ist eine UTF-8 Zeichenfolge.

    Jeder Wert ist eine UTF-8 Zeichenfolge.

    Ein optionaler Satz von nicht geheimen Schlüssel-Wert-Paaren, der zusätzliche kontextbezogene Informationen für die Verschlüsselung enthält. Dies kann nur bereitgestellt werden, wenn KMSKeyId bereitgestellt wird.

  • Tags – Ein Array mit Markierung-Objekten.

    Die der Ressource zugewiesenen Metadaten bestehen aus einer Liste von Schlüssel-Wert-Paaren.

  • IntegrationConfig – Ein IntegrationConfig-Objekt.

    Die Konfigurationseinstellungen.

Antwort
  • SourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN der Quellressource für die Integration.

  • TargetArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN der Zielressource für die Integration.

  • IntegrationName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Ein eindeutiger Name für eine Integration in AWS Glue.

  • Description— UTF-8 Zeichenfolge, nicht länger als 1000 Byte, die dem entsprichtCustom string pattern #17.

    Eine Beschreibung der Integration.

  • IntegrationArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Amazon-Ressourcenname (ARN) für die erstellte Integration.

  • KmsKeyId— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang.

    Der ARN eines KMS-Schlüssels, der für die Verschlüsselung des Kanals verwendet wird.

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

    Jeder Schlüssel ist eine UTF-8 Zeichenfolge.

    Jeder Wert ist eine UTF-8 Zeichenfolge.

    Ein optionaler Satz von nicht geheimen Schlüssel-Wert-Paaren, der zusätzliche kontextbezogene Informationen für die Verschlüsselung enthält.

  • Tags – Ein Array mit Markierung-Objekten.

    Die der Ressource zugewiesenen Metadaten bestehen aus einer Liste von Schlüssel-Wert-Paaren.

  • Status Erforderlich: UTF-8 Zeichenfolge (gültige Werte: CREATING | ACTIVE | MODIFYING | FAILED | DELETING | SYNCING |NEEDS_ATTENTION).

    Der Status der Integration, die gerade erstellt wird.

    Die folgenden Status sind möglich:

    • CREATING: Die Integration wird erstellt.

    • ACTIVE: Die Integrationserstellung ist erfolgreich.

    • MODIFYING: Die Integration wird geändert.

    • FAILED: Die Integrationserstellung schlägt fehl.

    • DELETING: Die Integration wird gelöscht.

    • SYNCING: Die Integration wird synchronisiert.

    • NEEDS_ATTENTION: Die Integration erfordert Aufmerksamkeit, z. B. Synchronisation.

  • CreateTimeErforderlich: Zeitstempel.

    Die Zeit in UTC, zu der die Integration erstellt wurde.

  • Errors – Ein Array mit IntegrationError-Objekten.

    Eine Liste der Fehler im Zusammenhang mit der Erstellung der Integration.

  • DataFilter— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang.

    Wählt Quelltabellen für die Integration mithilfe der Maxwell-Filtersyntax aus.

  • IntegrationConfig – Ein IntegrationConfig-Objekt.

    Die Konfigurationseinstellungen.

Fehler
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • IntegrationConflictOperationFault

  • IntegrationQuotaExceededFault

  • KMSKeyNotAccessibleFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • ResourceNumberLimitExceededException

  • InvalidInputException

ModifyIntegration Aktion (Python: modify_integration)

Ändert eine Zero-ETL Integration im Konto des Anrufers.

Anforderung
  • IntegrationIdentifier Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Amazon-Ressourcenname (ARN) für die Integration.

  • Description— UTF-8 Zeichenfolge, nicht länger als 1000 Byte, die dem entsprichtCustom string pattern #17.

    Eine Beschreibung der Integration.

  • DataFilter— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Byte lang ist.

    Wählt Quelltabellen für die Integration mithilfe der Maxwell-Filtersyntax aus.

  • IntegrationConfig – Ein IntegrationConfig-Objekt.

    Die Konfigurationseinstellungen für die Integration. Derzeit RefreshInterval kann nur der geändert werden.

  • IntegrationName— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Ein eindeutiger Name für eine Integration in AWS Glue.

Antwort
  • SourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN der Quelle für die Integration.

  • TargetArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN des Ziels für die Integration.

  • IntegrationName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Ein eindeutiger Name für eine Integration in AWS Glue.

  • Description— UTF-8 Zeichenfolge, nicht länger als 1000 Byte, die dem entsprichtCustom string pattern #17.

    Eine Beschreibung der Integration.

  • IntegrationArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Amazon-Ressourcenname (ARN) für die Integration.

  • KmsKeyId— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang.

    Der ARN eines KMS-Schlüssels, der für die Verschlüsselung des Kanals verwendet wird.

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

    Jeder Schlüssel ist eine UTF-8 Zeichenfolge.

    Jeder Wert ist eine UTF-8 Zeichenfolge.

    Ein optionaler Satz von nicht geheimen Schlüssel-Wert-Paaren, der zusätzliche kontextbezogene Informationen für die Verschlüsselung enthält.

  • Tags – Ein Array mit Markierung-Objekten.

    Die der Ressource zugewiesenen Metadaten bestehen aus einer Liste von Schlüssel-Wert-Paaren.

  • Status Erforderlich: UTF-8 Zeichenfolge (gültige Werte: CREATING | ACTIVE | MODIFYING | FAILED | DELETING | SYNCING |NEEDS_ATTENTION).

    Der Status der Integration, die gerade geändert wird.

    Die folgenden Status sind möglich:

    • CREATING: Die Integration wird erstellt.

    • ACTIVE: Die Integrationserstellung ist erfolgreich.

    • MODIFYING: Die Integration wird geändert.

    • FAILED: Die Integrationserstellung schlägt fehl.

    • DELETING: Die Integration wird gelöscht.

    • SYNCING: Die Integration wird synchronisiert.

    • NEEDS_ATTENTION: Die Integration erfordert Aufmerksamkeit, z. B. Synchronisation.

  • CreateTimeErforderlich: Zeitstempel.

    Die Zeit in UTC, zu der die Integration erstellt wurde.

  • Errors – Ein Array mit IntegrationError-Objekten.

    Eine Liste der Fehler im Zusammenhang mit der Änderung der Integration.

  • DataFilter— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang.

    Wählt Quelltabellen für die Integration mithilfe der Maxwell-Filtersyntax aus.

  • IntegrationConfig – Ein IntegrationConfig-Objekt.

    Die aktualisierten Konfigurationseinstellungen für die Integration.

Fehler
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • IntegrationConflictOperationFault

  • InvalidIntegrationStateFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • InvalidStateException

  • InvalidInputException

DescribeIntegrations Aktion (Python: describe_integrations)

Die API wird verwendet, um eine Liste von Integrationen abzurufen.

Anforderung
  • IntegrationIdentifier— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Amazon-Ressourcenname (ARN) für die Integration.

  • Marker— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Ein Wert, der den Ausgangspunkt für den nächsten Satz von Antwortdatensätzen in einer nachfolgenden Anfrage angibt.

  • MaxRecords – Zahl (Ganzzahl).

    Die Gesamtzahl der Elemente, die in der Ausgabe zurückgegeben werden sollen.

  • Filters – Ein Array mit IntegrationFilter-Objekten.

    Eine Liste von Schlüsseln und Werten, um die Ergebnisse herauszufiltern. Unterstützte Schlüssel sind „Status“, "IntegrationName„und"SourceArn“. IntegrationName ist auf nur einen Wert beschränkt.

Antwort
  • Integrations – Ein Array mit Integration-Objekten.

    Eine Liste der Null-ETL-Integrationen.

  • Marker— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Ein Wert, der den Ausgangspunkt für den nächsten Satz von Antwortdatensätzen in einer nachfolgenden Anfrage angibt.

Fehler
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

DeleteIntegration Aktion (Python: delete_integration)

Löscht die angegebene Integration. Zero-ETL

Anforderung
  • IntegrationIdentifier Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Amazon-Ressourcenname (ARN) für die Integration.

Antwort
  • SourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN der Quelle für die Integration.

  • TargetArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der ARN des Ziels für die Integration.

  • IntegrationName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Ein eindeutiger Name für eine Integration in AWS Glue.

  • Description— UTF-8 Zeichenfolge, nicht länger als 1000 Byte, die dem entsprichtCustom string pattern #17.

    Eine Beschreibung der Integration.

  • IntegrationArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Amazon-Ressourcenname (ARN) für die Integration.

  • KmsKeyId— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang.

    Der ARN eines KMS-Schlüssels, der für die Verschlüsselung des Kanals verwendet wird.

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

    Jeder Schlüssel ist eine UTF-8 Zeichenfolge.

    Jeder Wert ist eine UTF-8 Zeichenfolge.

    Ein optionaler Satz von nicht geheimen Schlüssel-Wert-Paaren, der zusätzliche kontextbezogene Informationen für die Verschlüsselung enthält.

  • Tags – Ein Array mit Markierung-Objekten.

    Die der Ressource zugewiesenen Metadaten bestehen aus einer Liste von Schlüssel-Wert-Paaren.

  • Status Erforderlich: UTF-8 Zeichenfolge (gültige Werte: CREATING | ACTIVE | MODIFYING | FAILED | DELETING | SYNCING |NEEDS_ATTENTION).

    Der Status der Integration, die gerade gelöscht wird.

    Die folgenden Status sind möglich:

    • CREATING: Die Integration wird erstellt.

    • ACTIVE: Die Integrationserstellung ist erfolgreich.

    • MODIFYING: Die Integration wird geändert.

    • FAILED: Die Integrationserstellung schlägt fehl.

    • DELETING: Die Integration wird gelöscht.

    • SYNCING: Die Integration wird synchronisiert.

    • NEEDS_ATTENTION: Die Integration erfordert Aufmerksamkeit, z. B. Synchronisation.

  • CreateTimeErforderlich: Zeitstempel.

    Die Zeit in UTC, zu der die Integration erstellt wurde.

  • Errors – Ein Array mit IntegrationError-Objekten.

    Eine Liste der Fehler im Zusammenhang mit der Integration.

  • DataFilter— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang.

    Wählt Quelltabellen für die Integration mithilfe der Maxwell-Filtersyntax aus.

Fehler
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • IntegrationConflictOperationFault

  • InvalidIntegrationStateFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • InvalidStateException

  • InvalidInputException

DescribeInboundIntegrations Aktion (Python: describe_inbound_integrations)

Gibt eine Liste der eingehenden Integrationen für die angegebene Integration zurück.

Anforderung
  • IntegrationArn— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Amazon-Ressourcenname (ARN) der Integration.

  • Marker— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Ein Token für den Beginn der Seitennummerierung. Diese ist die Markierung aus einer zuvor abgeschnittenen Antwort.

  • MaxRecords – Zahl (Ganzzahl).

    Die Gesamtzahl der Elemente, die in der Ausgabe zurückgegeben werden sollen.

  • TargetArn— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Amazon-Ressourcenname (ARN) der Zielressource in der Integration.

Antwort
  • InboundIntegrations – Ein Array mit InboundIntegration-Objekten.

    Eine Liste der eingehenden Integrationen.

  • Marker— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Ein Wert, der den Ausgangspunkt für den nächsten Satz von Antwortdatensätzen in einer nachfolgenden Anfrage angibt.

Fehler
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • TargetResourceNotFound

  • OperationNotSupportedException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

CreateIntegrationTableProperties Aktion (Python: create_integration_table_properties)

Diese API wird verwendet, um optionale Außerkraftsetzungseigenschaften für die Tabellen bereitzustellen, die repliziert werden müssen. Diese Eigenschaften können Eigenschaften zum Filtern und Partitionieren für die Quell- und Zieltabellen beinhalten. Um sowohl Quell- als auch Zieleigenschaften festzulegen, muss dieselbe API mit dem AWS Glue Verbindungs-ARN wie mit bzw. dem Datenbank-ARN wie ResourceArn mit SourceTableConfig aufgerufen werden. AWS Glue ResourceArn TargetTableConfig

Anforderung
  • ResourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Amazon-Ressourcenname (ARN) der Zieltabelle, für die Integrationstabelleneigenschaften erstellt werden sollen. Derzeit unterstützt diese API nur das Erstellen von Integrationstabelleneigenschaften für Zieltabellen, und der angegebene ARN sollte der ARN der Zieltabelle im AWS Glue Datenkatalog sein. Der Support für die Erstellung von Integrationstabelleneigenschaften für Quellverbindungen (mithilfe des Verbindungs-ARN) ist noch nicht implementiert und wird in einer zukünftigen Version hinzugefügt.

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Name der Tabelle, die repliziert werden soll.

  • SourceTableConfig – Ein SourceTableConfig-Objekt.

    Eine Struktur für die Quelltabellen-Konfiguration. In der SourceTableConfig-Struktur finden Sie eine Liste der unterstützten Quelleigenschaften.

  • TargetTableConfig – Ein TargetTableConfig-Objekt.

    Eine Struktur für die Zieltabellen-Konfiguration.

Antwort
  • Keine Antwortparameter.

Fehler
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UpdateIntegrationTableProperties Aktion (Python: update_integration_table_properties)

Diese API wird verwendet, um optionale Außerkraftsetzungseigenschaften für die Tabellen bereitzustellen, die repliziert werden müssen. Diese Eigenschaften können Eigenschaften zum Filtern und Partitionieren für die Quell- und Zieltabellen beinhalten. Um sowohl Quell- als auch Zieleigenschaften festzulegen, muss dieselbe API mit dem AWS Glue Verbindungs-ARN wie mit bzw. dem Datenbank-ARN wie ResourceArn mit SourceTableConfig aufgerufen werden. AWS Glue ResourceArn TargetTableConfig

Die Überschreibung wird für alle Integrationen übernommen, die dieselbe ResourceArn und Quelltabelle verwenden.

Anforderung
  • ResourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Verbindungs-ARN der Quelle oder der Datenbank-ARN des Ziels.

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Name der Tabelle, die repliziert werden soll.

  • SourceTableConfig – Ein SourceTableConfig-Objekt.

    Eine Struktur für die Quelltabellen-Konfiguration.

  • TargetTableConfig – Ein TargetTableConfig-Objekt.

    Eine Struktur für die Zieltabellen-Konfiguration.

Antwort
  • Keine Antwortparameter.

Fehler
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

GetIntegrationTableProperties Aktion (Python: get_integration_table_properties)

Diese API wird verwendet, um optionale Außerkraftsetzungseigenschaften für die Tabellen abzurufen, die repliziert werden müssen. Diese Eigenschaften können Eigenschaften zum Filtern und Partitionieren für die Quell- und Zieltabellen beinhalten.

Anforderung
  • ResourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Amazon-Ressourcenname (ARN) der Zieltabelle, für die Integrationstabelleneigenschaften abgerufen werden sollen. Derzeit unterstützt diese API nur das Abrufen von Eigenschaften für Zieltabellen, und der angegebene ARN sollte der ARN der Zieltabelle im AWS Glue Datenkatalog sein. Der Support für das Abrufen von Integrationstabelleneigenschaften für Quellverbindungen (mithilfe des Verbindungs-ARN) ist noch nicht implementiert und wird in einer zukünftigen Version hinzugefügt.

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Name der Tabelle, die repliziert werden soll.

Antwort
  • ResourceArn— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Amazon-Ressourcenname (ARN) der Zieltabelle, für die Integrationstabelleneigenschaften abgerufen werden sollen. Derzeit unterstützt diese API nur das Abrufen von Eigenschaften für Zieltabellen, und der angegebene ARN sollte der ARN der Zieltabelle im AWS Glue Datenkatalog sein. Der Support für das Abrufen von Integrationstabelleneigenschaften für Quellverbindungen (mithilfe des Verbindungs-ARN) ist noch nicht implementiert und wird in einer zukünftigen Version hinzugefügt.

  • TableName— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Name der Tabelle, die repliziert werden soll.

  • SourceTableConfig – Ein SourceTableConfig-Objekt.

    Eine Struktur für die Quelltabellen-Konfiguration.

  • TargetTableConfig – Ein TargetTableConfig-Objekt.

    Eine Struktur für die Zieltabellen-Konfiguration.

Fehler
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

DeleteIntegrationTableProperties Aktion (Python: delete_integration_table_properties)

Löscht die Tabelleneigenschaften, die für die Tabellen erstellt wurden, die repliziert werden müssen.

Anforderung
  • ResourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Verbindungs-ARN der Quelle oder der Datenbank-ARN des Ziels.

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang.

    Der Name der Tabelle, die repliziert werden soll.

Antwort
  • Keine Antwortparameter.

Fehler
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

CreateIntegrationResourceProperty Aktion (Python: create_integration_resource_property)

Diese API kann für die Einrichtung der AWS Glue Verbindung (für die Quelle) oder ResourceProperty AWS Glue des Datenbank-ARN (für das Ziel) verwendet werden. Diese Eigenschaften können die Rolle für den Zugriff auf die Verbindung oder Datenbank beinhalten. Um sowohl Quell- als auch Zieleigenschaften festzulegen, muss dieselbe API mit dem AWS Glue Verbindungs-ARN wie ResourceArn bei SourceProcessingProperties TargetProcessingProperties bzw. dem AWS Glue Datenbank-ARN wie ResourceArn bei aufgerufen werden.

Anforderung
  • ResourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Verbindungs-ARN der Quelle oder der Datenbank-ARN des Ziels.

  • SourceProcessingProperties – Ein SourceProcessingProperties-Objekt.

    Die mit der Integrationsquelle verknüpften Ressourceneigenschaften.

  • TargetProcessingProperties – Ein TargetProcessingProperties-Objekt.

    Die mit dem Integrationsziel verknüpften Ressourceneigenschaften.

  • Tags – Ein Array mit Markierung-Objekten.

    Die der Ressource zugewiesenen Metadaten bestehen aus einer Liste von Schlüssel-Wert-Paaren.

Antwort
  • ResourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Verbindungs-ARN der Quelle oder der Datenbank-ARN des Ziels.

  • ResourcePropertyArn— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Ressourcen-ARN, der über diese Erstellungs-API erstellt wurde. <region><account_id>Das Format ist so etwas wie arn:aws:glue: ::integrationresourceproperty/*

  • SourceProcessingProperties – Ein SourceProcessingProperties-Objekt.

    Die mit der Integrationsquelle verknüpften Ressourceneigenschaften.

  • TargetProcessingProperties – Ein TargetProcessingProperties-Objekt.

    Die mit dem Integrationsziel verknüpften Ressourceneigenschaften.

Fehler
  • ValidationException

  • AccessDeniedException

  • ConflictException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UpdateIntegrationResourceProperty Aktion (Python: update_integration_resource_property)

Diese API kann für die Aktualisierung der AWS Glue Verbindung (für die Quelle) oder ResourceProperty AWS Glue des Datenbank-ARN (für das Ziel) verwendet werden. Diese Eigenschaften können die Rolle für den Zugriff auf die Verbindung oder Datenbank beinhalten. Da dieselbe Ressource für mehrere Integrationen verwendet werden kann, wirkt sich die Aktualisierung der Ressourceneigenschaften auf alle Integrationen aus, die sie verwenden.

Anforderung
  • ResourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Verbindungs-ARN der Quelle oder der Datenbank-ARN des Ziels.

  • SourceProcessingProperties – Ein SourceProcessingProperties-Objekt.

    Die mit der Integrationsquelle verknüpften Ressourceneigenschaften.

  • TargetProcessingProperties – Ein TargetProcessingProperties-Objekt.

    Die mit dem Integrationsziel verknüpften Ressourceneigenschaften.

Antwort
  • ResourceArn— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Verbindungs-ARN der Quelle oder der Datenbank-ARN des Ziels.

  • ResourcePropertyArn— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Ressourcen-ARN, der über diese Erstellungs-API erstellt wurde. <region><account_id>Das Format ist so etwas wie arn:aws:glue: ::integrationresourceproperty/*

  • SourceProcessingProperties – Ein SourceProcessingProperties-Objekt.

    Die mit der Integrationsquelle verknüpften Ressourceneigenschaften.

  • TargetProcessingProperties – Ein TargetProcessingProperties-Objekt.

    Die mit dem Integrationsziel verknüpften Ressourceneigenschaften.

Fehler
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

GetIntegrationResourceProperty Aktion (Python: get_integration_resource_property)

Diese API wird zum Abrufen der AWS Glue Verbindungs-ARN (für die Quelle) ResourceProperty oder der Datenbank-ARN (für das Ziel) verwendet AWS Glue

Anforderung
  • ResourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Verbindungs-ARN der Quelle oder der Datenbank-ARN des Ziels.

Antwort
  • ResourceArn— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Verbindungs-ARN der Quelle oder der Datenbank-ARN des Ziels.

  • ResourcePropertyArn— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 512 Byte lang.

    Der Ressourcen-ARN, der über diese Erstellungs-API erstellt wurde. <region><account_id>Das Format ist so etwas wie arn:aws:glue: ::integrationresourceproperty/*

  • SourceProcessingProperties – Ein SourceProcessingProperties-Objekt.

    Die mit der Integrationsquelle verknüpften Ressourceneigenschaften.

  • TargetProcessingProperties – Ein TargetProcessingProperties-Objekt.

    Die mit dem Integrationsziel verknüpften Ressourceneigenschaften.

Fehler
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UntagResource Aktion (Python: untag_resource)

Entfernt die angegebenen Tags aus einer Integrationsressource.

Anforderung
  • ResourceArn Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 10240 Byte lang, die dem entspricht. Custom string pattern #47

    Der Amazon-Ressourcenname (ARN) für die Integrationsressource.

  • TagsToRemove Erforderlich: Ein Array von UTF-8 Zeichenketten, nicht mehr als 50 Zeichenketten.

    Eine Liste der Metadaten-Tags, die aus der Ressource entfernt werden sollen.

Antwort
  • Keine Antwortparameter.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

ListTagsForResource Aktion (Python: list_tags_for_resource)

Listet die Metadaten-Tags auf, die der angegebenen Ressource zugewiesen sind.

Anforderung
  • ResourceARN Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 10240 Byte lang, die dem entspricht. Custom string pattern #47

    Der Ressourcen-ARN für die Ressource.

Antwort
  • Tags – Ein Array mit Markierung-Objekten, nicht mehr als 10 Strukturen.

    Eine Liste von Tags.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

Ausnahmen

ResourceNotFoundException Struktur

Die Ressource konnte nicht gefunden werden.

Felder
  • Message— UTF-8 Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

InternalServerException Struktur

Es ist ein interner Serverfehler aufgetreten.

Felder
  • Message— UTF-8 Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

IntegrationAlreadyExistsFault Struktur

Die angegebene Integration ist bereits vorhanden.

Felder
  • Message— UTF-8 Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

IntegrationConflictOperationFault Struktur

Der angeforderte Vorgang steht in Konflikt mit einem anderen Vorgang.

Felder
  • Message— UTF-8 Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

IntegrationQuotaExceededFault Struktur

Die im Rahmen Ihrer Integration verarbeiteten Daten haben Ihr Kontingent überschritten.

Felder
  • Message— UTF-8 Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

KMSKeyNotAccessibleFault Struktur

Auf den angegebenen KMS-Schlüssel kann nicht zugegriffen werden.

Felder
  • Message— UTF-8 Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

IntegrationNotFoundFault Struktur

Die angegebene Integration konnte nicht gefunden werden.

Felder
  • Message— UTF-8 Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

TargetResourceNotFound Struktur

Die Zielressource konnte nicht gefunden werden.

Felder
  • Message— UTF-8 Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

InvalidIntegrationStateFault Struktur

Die Integration hat den Status „Ungültig“.

Felder
  • Message— UTF-8 Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.