View a markdown version of this page

Verbindungs-API - 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.

Verbindungs-API

Die Verbindungs-API beschreibt AWS Glue Verbindungsdatentypen und die API zum Erstellen, Löschen, Aktualisieren und Auflisten von Verbindungen.

Datentypen

Connection-Struktur

Definiert eine Verbindung zu einer Datenquelle.

Felder
  • Name— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entsprichtSingle-line string pattern.

    Der Name der Verbindungsdefinition.

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

    Beschreibung der Verbindung.

  • ConnectionType— UTF-8 Zeichenfolge (gültige Werte: JDBC | | SFTP | MONGODB | KAFKA | NETWORK | MARKETPLACE | CUSTOM | SALESFORCE | VIEW_VALIDATION_REDSHIFT | VIEW_VALIDATION_ATHENA | GOOGLEADS | GOOGLESHEETS | GOOGLEANALYTICS4 | SERVICENOW | | MARKETO | SAPODATA | ZENDESK | JIRACLOUD | NETSUITEERP | HUBSPOT | FACEBOOKADS | INSTAGRAMADS | ZOHOCRM | SALESFORCEPARDOT | SALESFORCEMARKETINGCLOUD | ADOBEANALYTICS | SLACK | | LINKEDIN | MIXPANEL | ASANA | STRIPE | SMARTSHEET | DATADOG | WOOCOMMERCE | INTERCOM| SNAPCHATADS | PAYPAL | | QUICKBOOKS | FACEBOOKPAGEINSIGHTS | FRESHDESK | TWILIO | DOCUSIGNMONITOR | FRESHSALES | ZOOM | | GOOGLESEARCHCONSOLE | SALESFORCECOMMERCECLOUD | SAPCONCUR | DYNATRACE | MICROSOFTDYNAMIC365FINANCEANDOPS | MICROSOFTTEAMS | | BLACKBAUDRAISEREDGENXT | MAILCHIMP | GITLAB | PENDO | PRODUCTBOARD | CIRCLECI | | PIPEDIVE | SENDGRID | AZURECOSMOS | AZURESQL | BIGQUERY | BLACKBAUD | | CLOUDERAHIVE | CLOUDERAIMPALA | CLOUDWATCH | CLOUDWATCHMETRICS | CMDB | DATALAKEGEN2 | DB2 | | DB2AS400 | DOCUMENTDB | DOMO | DYNAMODB| GOOGLECLOUDSTORAGE | HBASE | KUSTOMER | MICROSOFTDYNAMICS365CRM | MONDAY | MYSQL | OKTA | OPENSEARCH | ORACLE | | PIPEDRIVE | POSTGRESQL | SAPHANA | SQLSERVER | SYNAPSE | TERADATA | TERADATANOS | TIMESTREAM | TPCDS |VERTICA).

    Typ der Verbindung. Derzeit wird SFTP nicht unterstützt.

  • MatchCriteria— Eine Reihe von UTF-8 Zeichenketten, nicht mehr als 10 Zeichenketten.

    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 | | PORT | USERNAME="USER_NAME" | PASSWORD | ENCRYPTED_PASSWORD | JDBC_DRIVER_JAR_URI | JDBC_DRIVER_CLASS_NAME | | JDBC_ENGINE | JDBC_ENGINE_VERSION | CONFIG_FILES | INSTANCE_ID | JDBC_CONNECTION_URL | JDBC_ENFORCE_SSL | CUSTOM_JDBC_CERT | SKIP_CUSTOM_JDBC_CERT_VALIDATION | CUSTOM_JDBC_CERT_STRING | CONNECTION_URL | KAFKA_BOOTSTRAP_SERVERS | | KAFKA_SSL_ENABLED | KAFKA_CUSTOM_CERT | KAFKA_SKIP_CUSTOM_CERT_VALIDATION | KAFKA_CLIENT_KEYSTORE | KAFKA_CLIENT_KEYSTORE_PASSWORD | KAFKA_CLIENT_KEY_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD | KAFKA_SASL_MECHANISM | KAFKA_SASL_PLAIN_USERNAME | KAFKA_SASL_PLAIN_PASSWORD | | ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD | KAFKA_SASL_SCRAM_USERNAME | KAFKA_SASL_SCRAM_PASSWORD | KAFKA_SASL_SCRAM_SECRETS_ARN | ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD | KAFKA_SASL_GSSAPI_KEYTAB | KAFKA_SASL_GSSAPI_KRB5_CONF| KAFKA_SASL_GSSAPI_SERVICE | KAFKA_SASL_GSSAPI_PRINCIPAL SECRET_ID | CONNECTOR_URL | CONNECTOR_TYPE | CONNECTOR_CLASS_NAME | ENDPOINT | ENDPOINT_TYPE | ROLE_ARN | REGION WORKGROUP_NAME | CLUSTER_IDENTIFIER |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 – Der Host-URI: entweder der vollständig qualifizierte Domain-Name (FQDN, Fully Qualified Domain Name) 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-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 im PEM-Format mit Base64-Kodierung vorliegen DER-encoded und bereitgestellt werden.

    • SKIP_CUSTOM_JDBC_CERT_VALIDATION- In der Standardeinstellung ist dies. false AWS Glue validiert den Signaturalgorithmus und den Subject Public Key-Algorithmus für das Kundenzertifikat. Die einzigen zulässigen Algorithmen für den Signaturalgorithmus sind SHA256withRSA, SHA384withRSA oder SHA512withRSA. 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-Zertifikatzeichenfolge, die für einen Domainabgleich oder einen Distinguished Name-Abgleich verwendet wird, um Man-in-the-Middle-Angriffe zu verhindern. 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: SHA256withRSA, SHA384withRSA und SHA512withRSA. 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 für den Kafka-Client (wenn 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 (wenn 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.

    • 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 (wenn 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 "" verwendet wird. SCRAM-SHA-512

    • KAFKA_SASL_SCRAM_PASSWORD- Ein Klartext-Passwort, das zur Authentifizierung mit dem Mechanismus "" verwendet wird. SCRAM-SHA-512

    • ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD- Die verschlüsselte Version des Kafka SASL SCRAM-Passworts (wenn der Benutzer die Einstellung „Passwörter AWS Glue verschlüsseln“ ausgewählt hat).

    • KAFKA_SASL_SCRAM_SECRETS_ARN— Der Amazon-Ressourcenname eines Geheimnisses in Secrets Manager. AWS

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

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

    • KAFKA_SASL_GSSAPI_SERVICE – Der Name des Kerberos-Services, wie er in Ihrer Kafka-Konfiguration 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.

    • 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 Byte lang ist.

    Jeder Wert ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Byte 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 Byte lang ist.

    Jeder Wert ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Byte 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 Byte lang ist.

    Jeder Wert ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Byte lang ist.

    Spezifische Verbindungseigenschaften für die Python-Datenverarbeitungsumgebung.

  • PhysicalConnectionRequirements – Ein 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, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem Single-line string pattern entspricht.

    Der Benutzer, die Gruppe oder die Rolle, von dem bzw. der diese Verbindung zuletzt aktualisiert wurde.

  • Status— UTF-8 Zeichenfolge (gültige Werte: READY | IN_PROGRESS |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-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— Eine Reihe von UTF-8 Zeichenketten.

    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 Byte lang, die dem entsprichtSingle-line string pattern.

    Der Name der Verbindung.

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

    Beschreibung der Verbindung.

  • ConnectionType Erforderlich: UTF-8 Zeichenfolge (gültige Werte: JDBC | SFTP | MONGODB | KAFKA | NETWORK | MARKETPLACE | CUSTOM | SALESFORCE | VIEW_VALIDATION_REDSHIFT | VIEW_VALIDATION_ATHENA | GOOGLEADS | GOOGLESHEETS | | GOOGLEANALYTICS4 | SERVICENOW | MARKETO | SAPODATA | ZENDESK | JIRACLOUD | NETSUITEERP | HUBSPOT | FACEBOOKADS | INSTAGRAMADS | ZOHOCRM | SALESFORCEPARDOT | SALESFORCEMARKETINGCLOUD | | ADOBEANALYTICS | SLACK | LINKEDIN | MIXPANEL | ASANA | STRIPE | SMARTSHEET | DATADOG| WOOCOMMERCE | INTERCOM | | SNAPCHATADS | PAYPAL | QUICKBOOKS | FACEBOOKPAGEINSIGHTS | FRESHDESK | TWILIO | DOCUSIGNMONITOR | | FRESHSALES | ZOOM | GOOGLESEARCHCONSOLE | SALESFORCECOMMERCECLOUD | SAPCONCUR | DYNATRACE | | MICROSOFTDYNAMIC365FINANCEANDOPS | MICROSOFTTEAMS | BLACKBAUDRAISEREDGENXT | MAILCHIMP | GITLAB | PENDO | | PRODUCTBOARD | CIRCLECI | PIPEDIVE | SENDGRID | AZURECOSMOS | AZURESQL | | BIGQUERY | BLACKBAUD | CLOUDERAHIVE | CLOUDERAIMPALA | CLOUDWATCH | CLOUDWATCHMETRICS | CMDB | | DATALAKEGEN2 | DB2 | DB2AS400 | DOCUMENTDB| DOMO | DYNAMODB | GOOGLECLOUDSTORAGE | HBASE | KUSTOMER | MICROSOFTDYNAMICS365CRM | MONDAY | MYSQL | OKTA | OPENSEARCH | | ORACLE | PIPEDRIVE | POSTGRESQL | SAPHANA | SQLSERVER | SYNAPSE | TERADATA | TERADATANOS | TIMESTREAM | TPCDS |VERTICA).

    Typ der Verbindung. Derzeit werden folgende Typen unterstützt:

    • JDBC – Gibt eine Verbindung mit einer Datenbank über Java Database Connectivity (JDBC) an.

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

      KAFKAVerbindungen 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 die SASL/SCRAM-SHA-512 Authentifizierung mit zu konfigurierenKAFKA.

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

    • MONGODB – Gibt eine Verbindung zu einer MongoDB-Dokumentdatenbank an.

      MONGODBVerbindungen 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).

      NETWORKVerbindungen sind nicht erforderlich ConnectionParameters. Geben Sie stattdessen eine an PhysicalConnectionRequirements.

    • MARKETPLACE- Verwendet die Konfigurationseinstellungen, die in einem Connector enthalten sind, bei dem der Connector gekauft wurde, AWS Marketplace zum Lesen und Schreiben in Datenspeicher, die nicht nativ von AWS Glue unterstützt werden.

      MARKETPLACEVerbindungen 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 Verbindungsparametern, die für einen bestimmten Connector benötigt werden, finden Sie in der Dokumentation zum Connector unter Hinzufügen einer AWS Glue Verbindung im AWS Glue Benutzerhandbuch.

    SFTP wird nicht unterstützt.

    Weitere Informationen darüber, wie optionale Funktionen zur Konfiguration von Funktionen verwendet ConnectionProperties werden AWS Glue, finden Sie in den AWS Glue Verbindungseigenschaften.

    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.

  • MatchCriteria— Eine Reihe von UTF-8 Zeichenketten, nicht mehr als 10 Zeichenketten.

    Eine Liste von Kriterien, die bei der Auswahl dieser Verbindung verwendet werden können.

  • ConnectionPropertiesErforderlich: 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 | | PORT | USERNAME="USER_NAME" | PASSWORD | ENCRYPTED_PASSWORD | JDBC_DRIVER_JAR_URI | JDBC_DRIVER_CLASS_NAME | | JDBC_ENGINE | JDBC_ENGINE_VERSION | CONFIG_FILES | INSTANCE_ID | JDBC_CONNECTION_URL | JDBC_ENFORCE_SSL | CUSTOM_JDBC_CERT | SKIP_CUSTOM_JDBC_CERT_VALIDATION | CUSTOM_JDBC_CERT_STRING | CONNECTION_URL | KAFKA_BOOTSTRAP_SERVERS | | KAFKA_SSL_ENABLED | KAFKA_CUSTOM_CERT | KAFKA_SKIP_CUSTOM_CERT_VALIDATION | KAFKA_CLIENT_KEYSTORE | KAFKA_CLIENT_KEYSTORE_PASSWORD | KAFKA_CLIENT_KEY_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD | KAFKA_SASL_MECHANISM | KAFKA_SASL_PLAIN_USERNAME | KAFKA_SASL_PLAIN_PASSWORD | | ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD | KAFKA_SASL_SCRAM_USERNAME | KAFKA_SASL_SCRAM_PASSWORD | KAFKA_SASL_SCRAM_SECRETS_ARN | ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD | KAFKA_SASL_GSSAPI_KEYTAB | KAFKA_SASL_GSSAPI_KRB5_CONF| KAFKA_SASL_GSSAPI_SERVICE | KAFKA_SASL_GSSAPI_PRINCIPAL SECRET_ID | CONNECTOR_URL | CONNECTOR_TYPE | CONNECTOR_CLASS_NAME | ENDPOINT | ENDPOINT_TYPE | ROLE_ARN | REGION WORKGROUP_NAME | CLUSTER_IDENTIFIER |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 Byte lang ist.

    Jeder Wert ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Byte 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 Byte lang ist.

    Jeder Wert ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Byte 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 Byte lang ist.

    Jeder Wert ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Byte lang ist.

    Spezifische Verbindungseigenschaften für die Python-Datenverarbeitungsumgebung.

  • PhysicalConnectionRequirements – Ein PhysicalConnectionRequirements-Objekt.

    Die physischen Verbindungsanforderungen, z. B. Virtual Private Cloud (VPC) und SecurityGroup, die erforderlich sind, um diese Verbindung erfolgreich herzustellen.

  • AuthenticationConfiguration – Ein AuthenticationConfigurationInput-Objekt.

    Die Authentifizierungseigenschaften der Verbindung.

  • ValidateCredentials – Boolesch.

    Eine Markierung zur Überprüfung der Anmeldeinformationen beim Erstellen der Verbindung. Der Standardwert ist „true“.

  • ValidateForComputeEnvironments— Eine Reihe von UTF-8 Zeichenketten.

    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 Zeichenfolge (gültige Werte: JDBC | SFTP | | MONGODB | KAFKA | NETWORK | MARKETPLACE | CUSTOM | SALESFORCE | VIEW_VALIDATION_REDSHIFT | | VIEW_VALIDATION_ATHENA | GOOGLEADS | GOOGLESHEETS | GOOGLEANALYTICS4 | SERVICENOW | MARKETO | | SAPODATA | ZENDESK | JIRACLOUD | NETSUITEERP | HUBSPOT | FACEBOOKADS | INSTAGRAMADS | | ZOHOCRM | SALESFORCEPARDOT | SALESFORCEMARKETINGCLOUD | ADOBEANALYTICS | SLACK | LINKEDIN | MIXPANEL | | ASANA | STRIPE | SMARTSHEET | DATADOG| WOOCOMMERCE | INTERCOM | | SNAPCHATADS | PAYPAL | QUICKBOOKS | FACEBOOKPAGEINSIGHTS | FRESHDESK | TWILIO | DOCUSIGNMONITOR | | FRESHSALES | ZOOM | GOOGLESEARCHCONSOLE | SALESFORCECOMMERCECLOUD | SAPCONCUR | DYNATRACE | | MICROSOFTDYNAMIC365FINANCEANDOPS | MICROSOFTTEAMS | BLACKBAUDRAISEREDGENXT | MAILCHIMP | GITLAB | PENDO | | PRODUCTBOARD | CIRCLECI | PIPEDIVE | SENDGRID | AZURECOSMOS | AZURESQL | | BIGQUERY | BLACKBAUD | CLOUDERAHIVE | CLOUDERAIMPALA | CLOUDWATCH | CLOUDWATCHMETRICS | CMDB | | DATALAKEGEN2 | DB2 | DB2AS400 | DOCUMENTDB| DOMO | DYNAMODB | GOOGLECLOUDSTORAGE | HBASE | KUSTOMER | MICROSOFTDYNAMICS365CRM | MONDAY | MYSQL | OKTA | OPENSEARCH | | ORACLE | PIPEDRIVE | POSTGRESQL | SAPHANA | SQLSERVER | SYNAPSE | TERADATA | TERADATANOS | TIMESTREAM | TPCDS |VERTICA).

    Der zu testende Verbindungstyp. Dieser Vorgang ist nur für die Verbindungen JDBC oder SALESFORCE verfügbar.

  • ConnectionPropertiesErforderlich: 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 | | PORT | USERNAME="USER_NAME" | PASSWORD | ENCRYPTED_PASSWORD | JDBC_DRIVER_JAR_URI | JDBC_DRIVER_CLASS_NAME | JDBC_ENGINE | JDBC_ENGINE_VERSION | CONFIG_FILES | INSTANCE_ID | JDBC_CONNECTION_URL | JDBC_ENFORCE_SSL | | CUSTOM_JDBC_CERT | SKIP_CUSTOM_JDBC_CERT_VALIDATION | CUSTOM_JDBC_CERT_STRING | CONNECTION_URL | KAFKA_BOOTSTRAP_SERVERS | KAFKA_SSL_ENABLED | KAFKA_CUSTOM_CERT | KAFKA_SKIP_CUSTOM_CERT_VALIDATION | KAFKA_CLIENT_KEYSTORE | KAFKA_CLIENT_KEYSTORE_PASSWORD | KAFKA_CLIENT_KEY_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD | KAFKA_SASL_MECHANISM | KAFKA_SASL_PLAIN_USERNAME | | KAFKA_SASL_PLAIN_PASSWORD | ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD | KAFKA_SASL_SCRAM_USERNAME | KAFKA_SASL_SCRAM_PASSWORD | KAFKA_SASL_SCRAM_SECRETS_ARN | ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD | KAFKA_SASL_GSSAPI_KEYTAB | KAFKA_SASL_GSSAPI_KRB5_CONF| KAFKA_SASL_GSSAPI_SERVICE | KAFKA_SASL_GSSAPI_PRINCIPAL SECRET_ID | CONNECTOR_URL | CONNECTOR_TYPE | CONNECTOR_CLASS_NAME | ENDPOINT | ENDPOINT_TYPE | ROLE_ARN | REGION WORKGROUP_NAME | CLUSTER_IDENTIFIER |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-Objekt.

    Eine Struktur, die die Authentifizierungskonfiguration in der TestConnection Anfrage enthält. Erforderlich für eine Verbindung zu Salesforce mittels OAuth-Authentifizierung.

PhysicalConnectionRequirements Struktur

Die OAuth-Client-App als Antwort. GetConnection

Felder
  • SubnetId— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entspricht. Single-line string pattern

    Die Subnetz-ID, die von der Verbindung verwendet wird.

  • SecurityGroupIdList— Eine Reihe von UTF-8 Zeichenketten, nicht mehr als 50 Zeichenketten.

    Die Sicherheitsgruppen-ID-Liste, die von der Verbindung verwendet wird.

  • AvailabilityZone— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entsprichtSingle-line string pattern.

    Die Availability Zone der Verbindung.

GetConnectionsFilter Struktur

Filtert die von der GetConnections-API-Operation zurückgegebenen Verbindungsdefinitionen.

Felder
  • MatchCriteria— Eine Reihe von UTF-8 Zeichenketten, nicht mehr als 10 Zeichenketten.

    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 | | SFTP | MONGODB | KAFKA | NETWORK | MARKETPLACE | CUSTOM | SALESFORCE | VIEW_VALIDATION_REDSHIFT | VIEW_VALIDATION_ATHENA | GOOGLEADS | GOOGLESHEETS | GOOGLEANALYTICS4 | SERVICENOW | | MARKETO | SAPODATA | ZENDESK | JIRACLOUD | NETSUITEERP | HUBSPOT | FACEBOOKADS | INSTAGRAMADS | ZOHOCRM | SALESFORCEPARDOT | SALESFORCEMARKETINGCLOUD | ADOBEANALYTICS | SLACK | | LINKEDIN | MIXPANEL | ASANA | STRIPE | SMARTSHEET | DATADOG | WOOCOMMERCE | INTERCOM| SNAPCHATADS | PAYPAL | | QUICKBOOKS | FACEBOOKPAGEINSIGHTS | FRESHDESK | TWILIO | DOCUSIGNMONITOR | FRESHSALES | ZOOM | | GOOGLESEARCHCONSOLE | SALESFORCECOMMERCECLOUD | SAPCONCUR | DYNATRACE | MICROSOFTDYNAMIC365FINANCEANDOPS | MICROSOFTTEAMS | | BLACKBAUDRAISEREDGENXT | MAILCHIMP | GITLAB | PENDO | PRODUCTBOARD | CIRCLECI | | PIPEDIVE | SENDGRID | AZURECOSMOS | AZURESQL | BIGQUERY | BLACKBAUD | | CLOUDERAHIVE | CLOUDERAIMPALA | CLOUDWATCH | CLOUDWATCHMETRICS | CMDB | DATALAKEGEN2 | DB2 | | DB2AS400 | DOCUMENTDB | DOMO | DYNAMODB| GOOGLECLOUDSTORAGE | HBASE | KUSTOMER | MICROSOFTDYNAMICS365CRM | MONDAY | MYSQL | OKTA | OPENSEARCH | ORACLE | | PIPEDRIVE | POSTGRESQL | SAPHANA | SQLSERVER | SYNAPSE | TERADATA | TERADATANOS | TIMESTREAM | TPCDS |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 (gültige Werte: BASIC | OAUTH2 | CUSTOM |IAM).

    Eine Struktur, die die Authentifizierungskonfiguration enthält.

  • SecretArn— UTF-8 Zeichenfolge, die dem entsprichtCustom string pattern #32.

    Der Secret-Manager-ARN zur Speicherung von Anmeldeinformationen.

  • KmsKeyArn— UTF-8 Zeichenfolge, die dem entsprichtCustom string pattern #39.

    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 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 (gültige Werte: BASIC | OAUTH2 | CUSTOM |IAM).

    Eine Struktur, die die Authentifizierungskonfiguration in der CreateConnection Anfrage enthält.

  • OAuth2Properties – Ein OAuth2PropertiesInput-Objekt.

    Die Eigenschaften für die OAuth2-Authentifizierung in der CreateConnection Anfrage.

  • SecretArn— UTF-8 Zeichenfolge, die dem entspricht. Custom string pattern #32

    Das Secret Manager-ARN zum Speichern der Anmeldeinformationen in der CreateConnection Anfrage.

  • KmsKeyArn— UTF-8 Zeichenfolge, die dem entsprichtCustom string pattern #39.

    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-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 Byte lang ist.

    Jeder Wert ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Byte lang ist.

    Die Anmeldeinformationen, die verwendet werden, wenn es sich bei dem Authentifizierungstyp um eine benutzerdefinierte Authentifizierung handelt.

OAuth2Properties Struktur

Eine Struktur mit Eigenschaften für die OAuth2-Authentifizierung.

Felder
  • OAuth2GrantType— UTF-8 Zeichenfolge (gültige Werte: AUTHORIZATION_CODE | CLIENT_CREDENTIALS |JWT_BEARER).

    Der OAuth2-Gewährungstyp. Beispiel: AUTHORIZATION_CODE, JWT_BEARER oder CLIENT_CREDENTIALS.

  • OAuth2ClientApplication – Ein OAuth2ClientApplication-Objekt.

    Der Client-Anwendungstyp. Zum Beispiel AWS_MANAGED oder USER_MANAGED.

  • TokenUrl— UTF-8 Zeichenfolge, nicht länger als 256 Byte, die dem entsprichtCustom string pattern #37.

    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 Byte lang ist.

    Jeder Wert ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 512 Byte 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 (gültige Werte: AUTHORIZATION_CODE | CLIENT_CREDENTIALS |JWT_BEARER).

    Der OAuth2-Grant-Typ in der CreateConnection Anfrage. Beispiel: AUTHORIZATION_CODE, JWT_BEARER oder CLIENT_CREDENTIALS.

  • OAuth2ClientApplication – Ein OAuth2ClientApplication-Objekt.

    Der Client-Anwendungstyp in der CreateConnection Anfrage. Zum Beispiel AWS_MANAGED oder USER_MANAGED.

  • TokenUrl— UTF-8 Zeichenfolge, nicht länger als 256 Byte, die dem entsprichtCustom string pattern #37.

    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 Byte lang ist.

    Jeder Wert ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 512 Byte lang ist.

    Eine Zuordnung von Parametern, die der Token-GET-Anfrage hinzugefügt werden.

  • AuthorizationCodeProperties – Ein AuthorizationCodeProperties-Objekt.

    Die für den OAuth2-AUTHORIZATION_CODE-Gewährungstyp erforderlichen Eigenschaften.

  • OAuth2Credentials – Ein OAuth2Credentials-Objekt.

    Die Anmeldeinformationen, die verwendet werden, wenn es sich bei dem Authentifizierungstyp um eine OAuth2-Authentifizierung handelt.

OAuth2ClientApplication Struktur

Die für die Verbindung verwendete OAuth2-Client-App.

Felder
  • UserManagedClientApplicationClientId— UTF-8 Zeichenfolge, nicht länger als 2048 Byte, die dem Custom string pattern #33 entspricht.

    Die ClientID der Client-Anwendung, falls ClientAppType USER_MANAGED

  • AWSManagedClientApplicationReference— UTF-8 Zeichenfolge, nicht länger als 2048 Byte, die dem entspricht. Custom string pattern #33

    Der Verweis auf die SaaS-side Client-App, die AWS verwaltet wird.

AuthorizationCodeProperties Struktur

Die für den Workflow des OAuth2-AUTHORIZATION_CODE-Gewährungstyps erforderlichen Eigenschaften.

Felder
  • AuthorizationCode— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 4096 Byte lang ist und der Custom string pattern #33 entspricht.

    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 länger als 512 Byte, die dem Custom string pattern #38 entspricht.

    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 länger als 512 Byte, die dem entsprichtCustom string pattern #33.

    Der Benutzername zur Verbindung mit der Datenquelle.

  • Password— UTF-8 Zeichenfolge, nicht länger als 512 Byte, die dem entsprichtCustom string pattern #34.

    Das Passwort für die Verbindung zur Datenquelle.

OAuth2Credentials Struktur

Die Anmeldeinformationen, die verwendet werden, wenn es sich bei dem Authentifizierungstyp um eine OAuth2-Authentifizierung handelt.

Felder
  • UserManagedClientApplicationClientSecret— UTF-8 Zeichenfolge, nicht länger als 512 Byte, die dem entsprichtCustom string pattern #35.

    Das Client-Geheimnis der Client-Anwendung, wenn die Client-Anwendung vom Benutzer verwaltet wird.

  • AccessToken— UTF-8 Zeichenfolge, nicht länger als 4096 Byte, die dem Custom string pattern #35 entspricht.

    Das Zugriffstoken, das verwendet wird, wenn der Authentifizierungstyp OAuth2 ist.

  • RefreshToken— UTF-8 Zeichenfolge, nicht länger als 4096 Byte, die dem entspricht. Custom string pattern #35

    Das Aktualisierungstoken, das verwendet wird, wenn der Authentifizierungstyp OAuth2 ist.

  • JwtToken— UTF-8 Zeichenfolge, nicht länger als 8000 Byte, die dem Custom string pattern #36 entspricht.

    Das JSON Web Token (JWT), das verwendet wird, wenn der Authentifizierungstyp OAuth2 ist.

Operationen

CreateConnection Aktion (Python: create_connection)

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.

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

  • ConnectionInputErforderlich: Ein 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 Byte lang ist.

    Jeder Wert ist eine UTF-8 Zeichenfolge, die nicht länger als 256 Byte ist.

    Die Tags, die Sie der Verbindung zuweisen.

Antwort
  • CreateConnectionStatus— UTF-8 Zeichenfolge (gültige Werte: READY | IN_PROGRESS |FAILED).

    Der Status der Anfrage für die Verbindungserstellung. Die Anfrage kann bei bestimmten Authentifizierungstypen einige Zeit in Anspruch nehmen, beispielsweise beim Erstellen einer OAuth-Verbindung mit Tokenaustausch über VPC.

Fehler
  • AlreadyExistsException

  • InvalidInputException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • GlueEncryptionException

DeleteConnection Aktion (Python: delete_connection)

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.

    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 Byte lang, die dem entsprichtSingle-line string pattern.

    Der Name der zu löschenden Verbindung.

Antwort
  • Keine Antwortparameter.

Fehler
  • EntityNotFoundException

  • OperationTimeoutException

GetConnection Aktion (Python: get_connection)

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.

    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 Byte lang, die dem entsprichtSingle-line string pattern.

    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. Stellen Sie diesen Parameter ein, 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 (gültige Werte: SPARK | ATHENA |PYTHON).

    Für Verbindungen, die in mehreren Diensten verwendet werden können, werden die zurückgegebenen Eigenschaften für die angegebene Datenverarbeitungsumgebung angegeben.

Antwort
Fehler
  • EntityNotFoundException

  • OperationTimeoutException

  • InvalidInputException

  • GlueEncryptionException

GetConnections Aktion (Python: get_connections)

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.

    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-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. Stellen Sie diesen Parameter ein, 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— Zeichenfolge UTF-8 .

    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)-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_connection)

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.

    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 Byte lang, die dem entsprichtSingle-line string pattern.

    Der Name der Verbindungsdefinition, die aktualisiert werden soll.

  • ConnectionInputErforderlich: Ein ConnectionInput-Objekt.

    Ein ConnectionInput-Objekt, das die jeweilige Verbindung neu definiert.

Antwort
  • Keine Antwortparameter.

Fehler
  • InvalidInputException

  • EntityNotFoundException

  • OperationTimeoutException

  • InvalidInputException

  • GlueEncryptionException

TestConnection Aktion (Python: test_connection)

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, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entspricht. Single-line string pattern

    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.

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

  • TestConnectionInput – Ein 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_delete_connection)

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.

    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 von UTF-8 Zeichenketten, nicht mehr als 25 Zeichenketten.

    Eine Liste der Namen der Verbindungen, die gelöscht werden sollen.

Antwort
  • Succeeded— Eine Reihe von UTF-8 Zeichenketten.

    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, die nicht weniger als 1 oder mehr als 255 Byte lang ist und mit der übereinstimmtSingle-line string pattern.

    Jeder Wert ist ein An ErrorDetail-Objekt.

    Eine Zuweisung der Namen von Verbindungen, die nicht erfolgreich gelöscht wurden, zu Fehlerdetails.

Fehler
  • InternalServiceException

  • OperationTimeoutException