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, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-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|WOOCOMMERCEINTERCOMSNAPCHATADS|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|DOMODYNAMODBGOOGLECLOUDSTORAGE|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– Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 10 Zeichenfolgen.Eine Liste von Kriterien, die bei der Auswahl dieser Verbindung verwendet werden können.
-
ConnectionProperties– Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 100 Paare.Jeder Schlüssel ist eine UTF-8-Zeichenfolge (gültige Werte:
HOST| | |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_PASSWORDKAFKA_SASL_GSSAPI_KEYTABKAFKA_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_NAMECLUSTER_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- Die Host-URI: entweder der vollqualifizierte Domainname (FQDN) oder die IPv4 Adresse des Datenbank-Hosts. -
PORT– Die Portnummer zwischen 1024 und 65535 des Ports, auf dem der Datenbank-Host auf Datenbankverbindungen wartet. -
USER_NAME– Der Name, unter dem Sie sich bei der Datenbank anmelden. Die Wert-Zeichenfolge fürUSER_NAMEist „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 CatalogConnectionPasswordEncryptionfestlegen, wird das verschlüsselte Passwort in diesem Feld gespeichert. -
JDBC_DRIVER_JAR_URI– Der Amazon Simple Storage Service (Amazon S3)-Pfad der JAR-Datei, die den zu verwendenden JDBC-Treiber enthält. -
JDBC_DRIVER_CLASS_NAME– Der Klassenname des zu verwendenden JDBC-Treibers. -
JDBC_ENGINE– Der Name der zu verwendenden JDBC-Engine. -
JDBC_ENGINE_VERSION– Die zu verwendende Version der JDBC-Engine. -
CONFIG_FILES- (Zur späteren Verwendung reserviert.) -
INSTANCE_ID– Die zu verwendende Instance-ID. -
JDBC_CONNECTION_URL– Die URL für die Verbindung mit einer JDBC-Datenquelle. -
JDBC_ENFORCE_SSL– Eine boolesche Zeichenfolge (true, false), bei der die Groß-/Kleinschreibung nicht beachtet wird und die angibt, ob Secure Sockets Layer (SSL) mit übereinstimmenden Hostnamen für die JDBC-Verbindung auf dem Client erzwungen wird. Der Standardwert lautet „false“. -
CUSTOM_JDBC_CERT- Ein Amazon S3 S3-Standort, der das Stammzertifikat des Kunden angibt. AWS Glue verwendet dieses Stammzertifikat, um das Zertifikat des Kunden zu validieren, wenn eine Verbindung zur Kundendatenbank hergestellt wird. AWS Glue verarbeitet nur X.509-Zertifikate. Das bereitgestellte Zertifikat muss DER-codiert sein und im Base64-PEM-Codierungsformat bereitgestellt werden. -
SKIP_CUSTOM_JDBC_CERT_VALIDATION- Standardmäßig istfalsedas. AWS Glue validiert den Signaturalgorithmus und den Subject Public Key Algorithm für das Kundenzertifikat. Die einzigen zulässigen Algorithmen für den Signaturalgorithmus sind SHA256with RSA, RSA oder SHA384with RSA. SHA512with Die Schlüssellänge für den Algorithmus für den öffentlichen Schlüssel muss mindestens 2048 betragen. Sie können den Wert dieser Eigenschaft auftruefestlegen, um die AWS Glue-Validierung des Kundenzertifikats zu überspringen. -
CUSTOM_JDBC_CERT_STRING- Eine benutzerdefinierte JDBC-Zertifikatszeichenfolge, die für den Domänenabgleich oder den Abgleich definierter Namen verwendet wird, um einen Angriff zu verhindern. man-in-the-middle In Oracle Database wird sie alsSSL_SERVER_CERT_DNverwendet. In Microsoft SQL Server wird sie alshostNameInCertificateverwendet. -
CONNECTION_URL– Die URL für die Verbindung mit einer allgemeinen Datenquelle (nicht JDBC). -
SECRET_ID– Die geheime ID, die für den Secrets Manager der Anmeldeinformationen verwendet wird. -
CONNECTOR_URL– Die Connector-URL für eine MARKETPLACE- oder CUSTOM-Verbindung. -
CONNECTOR_TYPE– Der Konnektor-Typ für eine MARKETPLACE- oder CUSTOM-Verbindung. -
CONNECTOR_CLASS_NAME– Die Konnektor-Klassenname für eine MARKETPLACE- oder CUSTOM-Verbindung. -
KAFKA_BOOTSTRAP_SERVERS- Eine durch Kommata getrennte Liste von Host- und Portpaaren, die die Adressen der Apache Kafka Broker in einem Kafka-Cluster sind, zu dem ein Kafka-Client eine Verbindung herstellt und Bootstrapping durchführt. -
KAFKA_SSL_ENABLED– Ob SSL auf einer Apache-Kafka-Verbindung aktiviert oder deaktiviert werden soll. Der Standardwert ist „true“. -
KAFKA_CUSTOM_CERT– Die Amazon-S3-URL für die private CA-Zertifikatdatei (PEM-Format). Der Standardwert ist eine leere Zeichenfolge. -
KAFKA_SKIP_CUSTOM_CERT_VALIDATION— Ob die Validierung der CA-Zertifikatsdatei übersprungen werden soll oder nicht. AWS Glue validiert für drei Algorithmen: SHA256with RSA, RSA und SHA384with RSA. SHA512with Der Standardwert ist „false“. -
KAFKA_CLIENT_KEYSTORE– Der Amazon-S3-Speicherort der Client-Keystore-Datei für die clientseitige Kafka-Authentifizierung (optional). -
KAFKA_CLIENT_KEYSTORE_PASSWORD– Das Passwort für den Zugriff auf den bereitgestellten Keystore (optional). -
KAFKA_CLIENT_KEY_PASSWORD– Ein Keystore kann aus mehreren Schlüsseln bestehen, also ist dies das Passwort für den Zugriff auf den Clientschlüssel, der mit dem serverseitigen Kafka-Schlüssel verwendet werden soll (optional). -
ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD- Die verschlüsselte Version des Keystore-Passworts des Kafka-Clients (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 (falls der Benutzer die Einstellung Passwörter AWS Glue verschlüsseln ausgewählt hat). -
KAFKA_SASL_MECHANISM–"SCRAM-SHA-512","GSSAPI","AWS_MSK_IAM"oder"PLAIN". Dies sind die unterstützten SASL-Mechanismen. -
KAFKA_SASL_PLAIN_USERNAME– Ein Klartext-Benutzername, der zur Authentifizierung mit dem Mechanismus „PLAIN“ verwendet wird. -
KAFKA_SASL_PLAIN_PASSWORD– Ein Klartext-Passwort, das zur Authentifizierung mit dem Mechanismus „PLAIN“ verwendet wird. -
ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD- Die verschlüsselte Version des Kafka-SASL-PLAIN-Passworts (falls der Benutzer die Einstellung Passwörter AWS Glue verschlüsseln ausgewählt hat). -
KAFKA_SASL_SCRAM_USERNAME– Ein Klartext-Benutzername, der zur Authentifizierung mit dem Mechanismus „SCRAM-SHA-512" verwendet wird. -
KAFKA_SASL_SCRAM_PASSWORD– Ein Klartext-Passwort, das zur Authentifizierung mit dem Mechanismus „SCRAM-SHA-512" verwendet wird. -
ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD- Die verschlüsselte Version des Kafka-SASL-SCRAM-Passworts (falls der Benutzer die Einstellung Passwörter verschlüsseln ausgewählt hat). AWS Glue -
KAFKA_SASL_SCRAM_SECRETS_ARN- Der Amazon-Ressourcenname eines Geheimnisses in AWS Secrets Manager. -
KAFKA_SASL_GSSAPI_KEYTAB– Der S3-Speicherort einer Kerberos-keytab-Datei. Ein Keytab speichert Langzeitschlüssel für ein oder mehrere Prinzipale. Weitere Informationen finden Sie unter MIT-Kerberos-Dokumentation: Keytab. -
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-Konfigurationmit sasl.kerberos.service.namefestgelegt 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 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Spark-Datenverarbeitungsumgebung.
-
AthenaProperties– Ein Map-Array von Schlüssel-Wert-Paaren.Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Athena-Datenverarbeitungsumgebung.
-
PythonProperties– Ein Map-Array von Schlüssel-Wert-Paaren.Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Python-Datenverarbeitungsumgebung.
-
PhysicalConnectionRequirements– Ein PhysicalConnectionRequirements-Objekt.Die physischen Verbindungsanforderungen, z. B. Virtual Private Cloud (VPC) und
SecurityGroup, die erforderlich sind, um diese Verbindung erfolgreich herzustellen. -
CreationTime– Zeitstempel.Der Zeitstempel der Erstellung dieser Verbindungsdefinition.
-
LastUpdatedTime– Zeitstempel.Der Zeitstempel der letzten Aktualisierung der Verbindungsdefinition.
-
LastUpdatedBy– UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Der Benutzer, die Gruppe oder die Rolle, von dem bzw. der diese Verbindung zuletzt aktualisiert wurde.
-
Status– UTF-8-Zeichenfolge (zulässige Werte:READY|IN_PROGRESS|FAILED).Der Status der Verbindung. Dabei kann es sich um
READY,IN_PROGRESSoderFAILEDhandeln. -
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– Ein UTF-8-Zeichenfolgen-Array.Eine Liste von Datenverarbeitungsumgebungen, die mit der Verbindung kompatibel sind.
ConnectionInput Struktur
Eine Struktur, die zum Angeben einer Verbindung verwendet wird, die erstellt oder aktualisiert werden soll.
Felder
-
Name– Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.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-String (gültige Werte:JDBCSFTP|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|SMARTSHEETDATADOGWOOCOMMERCE|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|DB2AS400DOCUMENTDBDOMO|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) oderJDBC_CONNECTION_URL. -
Erforderlich: Alle (
USERNAME,PASSWORD,) oderSECRET_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 mitKAFKAzu 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 inKAFKAzu konfigurieren. -
Fakultativ:
KAFKA_SASL_MECHANISM. Kann alsSCRAM-SHA-512,GSSAPIoderAWS_MSK_IAMangegeben werden. -
Optional:
KAFKA_SASL_SCRAM_USERNAME,KAFKA_SASL_SCRAM_PASSWORD,ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD. Diese Parameter werden verwendet, um SASL/SCRAM-SHA-512-Authentifizierung mitKAFKAzu konfigurieren. -
Optional:
KAFKA_SASL_GSSAPI_KEYTAB,KAFKA_SASL_GSSAPI_KRB5_CONF,KAFKA_SASL_GSSAPI_SERVICE,KAFKA_SASL_GSSAPI_PRINCIPAL. Diese Parameter werden verwendet, um die SASL/GSSAPI Authentifizierung mit zu konfigurierenKAFKA.
-
-
MONGODB– Gibt eine Verbindung zu einer MongoDB-Dokumentdatenbank an.MONGODBVerbindungen verwenden Folgendes ConnectionParameters.-
Erforderlich:
CONNECTION_URL. -
Erforderlich: Alle von (
USERNAME,PASSWORD) oderSECRET_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 Konfigurationseinstellungen, die in einem Connector enthalten sind AWS Marketplace , um aus Datenspeichern zu lesen und in diese zu schreiben, die nicht nativ von AWS Glue unterstützt werden.MARKETPLACEVerbindungen verwenden Folgendes ConnectionParameters.-
Erforderlich:
CONNECTOR_TYPE,CONNECTOR_URL,CONNECTOR_CLASS_NAME,CONNECTION_URL. -
Erforderlich für
JDBCCONNECTOR_TYPE-Verbindungen: Alle von (USERNAME,PASSWORD) oderSECRET_ID.
-
-
CUSTOM– Verwendet die in einem benutzerdefinierten Konnektor enthaltenen Konfigurationseinstellungen, der zum Lesen und Schreiben in nicht nativ von AWS Glue unterstützten Datastores erworben wurde.
Weitere Informationen zu den für einen bestimmten Connector benötigten Verbindungsparametern finden Sie in der Dokumentation zum Connector unter AWS Glue Verbindung hinzufügen im AWS Glue Benutzerhandbuch.
SFTPwird nicht unterstützt.Weitere Informationen darüber, wie optionale Funktionen zur Konfiguration verwendet ConnectionProperties werden AWS Glue, finden Sie unter 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– Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 10 Zeichenfolgen.Eine Liste von Kriterien, die bei der Auswahl dieser Verbindung verwendet werden können.
-
ConnectionProperties– Erforderlich: Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 100 Paare.Jeder Schlüssel ist eine UTF-8-Zeichenfolge (gültige Werte:
HOST| |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_PASSWORDKAFKA_SASL_GSSAPI_KEYTABKAFKA_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_NAMECLUSTER_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 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Spark-Datenverarbeitungsumgebung.
-
AthenaProperties– Ein Map-Array von Schlüssel-Wert-Paaren.Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Athena-Datenverarbeitungsumgebung.
-
PythonProperties– Ein Map-Array von Schlüssel-Wert-Paaren.Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Spezifische Verbindungseigenschaften für die Python-Datenverarbeitungsumgebung.
-
PhysicalConnectionRequirements– Ein PhysicalConnectionRequirements-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– Ein UTF-8-Zeichenfolgen-Array.Die Datenverarbeitungsumgebungen, gegen die die angegebenen Verbindungseigenschaften validiert werden.
TestConnectionInput Struktur
Eine Struktur, die zum Angeben des Testens einer Verbindung zu einem Service verwendet wird.
Felder
-
ConnectionType— Erforderlich: UTF-8-String (gültige Werte:JDBCSFTP|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|SMARTSHEETDATADOGWOOCOMMERCE|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|DB2AS400DOCUMENTDBDOMO|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
JDBCoderSALESFORCEverfügbar. -
ConnectionProperties– Erforderlich: Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 100 Paare.Jeder Schlüssel ist eine UTF-8-Zeichenfolge (gültige Werte:
HOST| | |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_PASSWORDKAFKA_SASL_GSSAPI_KEYTABKAFKA_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_NAMECLUSTER_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) oderJDBC_CONNECTION_URL. -
Erforderlich: Alle (
USERNAME,PASSWORD,) oderSECRET_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 mithilfe von OAuth Authentifizierung.
PhysicalConnectionRequirements Struktur
Die OAuth Client-App als GetConnection Antwort.
Felder
-
SubnetId– UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Die Subnetz-ID, die von der Verbindung verwendet wird.
-
SecurityGroupIdList– Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 50 Zeichenfolgen.Die Sicherheitsgruppen-ID-Liste, die von der Verbindung verwendet wird.
-
AvailabilityZone– UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Die Availability Zone der Verbindung.
GetConnectionsFilter Struktur
Filtert die von der GetConnections-API-Operation zurückgegebenen Verbindungsdefinitionen.
Felder
-
MatchCriteria– Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 10 Zeichenfolgen.Eine Kriterienzeichenfolge, die den Kriterien entsprechen muss, die in der Verbindungsdefinition hinterlegt sind, damit diese Verbindungsdefinition zurückgegeben wird.
-
ConnectionType— UTF-8-Zeichenfolge (gültige Werte:JDBC|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|WOOCOMMERCEINTERCOMSNAPCHATADS|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|DOMODYNAMODBGOOGLECLOUDSTORAGE|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 (zulässige Werte:BASIC|OAUTH2|CUSTOM|IAM).Eine Struktur, die die Authentifizierungskonfiguration enthält.
-
SecretArn– UTF-8-Zeichenfolge, die Custom string pattern #36 entspricht.Der Secret-Manager-ARN zur Speicherung von Anmeldeinformationen.
-
KmsKeyArn– UTF-8-Zeichenfolge, die Custom string pattern #42 entspricht.Der Amazon-Ressourcenname (ARN) des KMS-Schlüssels zum Verschlüsseln vertraulicher Authentifizierungsinformationen. Dieser Schlüssel dient dem Schutz von Anmeldeinformationen und anderen sensiblen Daten, die in der Authentifizierungskonfiguration gespeichert sind.
-
OAuth2Properties– Ein OAuth2Eigenschaften-Objekt.Die Eigenschaften für die OAuth2 Authentifizierung.
AuthenticationConfigurationInput Struktur
Eine Struktur, die die Authentifizierungskonfiguration in der CreateConnection Anfrage enthält.
Felder
-
AuthenticationType– UTF-8-Zeichenfolge (zulässige Werte:BASIC|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 Custom string pattern #36 entspricht.Der geheime Manager-ARN zum Speichern von Anmeldeinformationen in der CreateConnection Anfrage.
-
KmsKeyArn– UTF-8-Zeichenfolge, die Custom string pattern #42 entspricht.Der ARN des KMS-Schlüssels, der zur Verschlüsselung der Verbindung verwendet wurde. Er wird ausschließlich als Eingabe in der Anfrage akzeptiert und im Secret Manager gespeichert.
-
BasicAuthenticationCredentials– Ein BasicAuthenticationCredentials-Objekt.Die Anmeldeinformationen, die verwendet werden, wenn es sich bei dem Authentifizierungstyp um eine Standardauthentifizierung handelt.
-
CustomAuthenticationCredentials– Ein Map-Array von Schlüssel-Wert-Paaren.Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.
Die Anmeldeinformationen, die verwendet werden, wenn es sich bei dem Authentifizierungstyp um eine benutzerdefinierte Authentifizierung handelt.
OAuth2Struktur der Eigenschaften
Eine Struktur, die Eigenschaften für die OAuth2 Authentifizierung enthält.
Felder
-
OAuth2GrantType– UTF-8-Zeichenfolge (zulässige Werte:AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER).Die Art des OAuth2 Zuschusses. Beispiel:
AUTHORIZATION_CODE,JWT_BEARERoderCLIENT_CREDENTIALS. -
OAuth2ClientApplication– Ein OAuth2ClientApplication-Objekt.Der Client-Anwendungstyp. Zum Beispiel AWS_MANAGED oder USER_MANAGED.
-
TokenUrl– UTF-8-Zeichenfolge, nicht mehr als 256 Bytes lang, passend zum Custom string pattern #40.Die URL des Authentifizierungsservers des Anbieters für den Austausch eines Autorisierungscodes gegen ein Zugriffstoken.
-
TokenUrlParametersMap– Ein Map-Array von Schlüssel-Wert-Paaren.Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 512 Bytes lang ist.
Eine Zuordnung von Parametern, die der Token-
GET-Anfrage hinzugefügt werden.
OAuth2PropertiesInput Struktur
Eine Struktur, die Eigenschaften für OAuth2 in der CreateConnection Anfrage enthält.
Felder
-
OAuth2GrantType– UTF-8-Zeichenfolge (zulässige Werte:AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER).Der OAuth2 Zuschusstyp in der CreateConnection Anfrage. Beispiel:
AUTHORIZATION_CODE,JWT_BEARERoderCLIENT_CREDENTIALS. -
OAuth2ClientApplication– Ein OAuth2ClientApplication-Objekt.Der Typ der Client-Anwendung in der CreateConnection Anfrage. Zum Beispiel
AWS_MANAGEDoderUSER_MANAGED. -
TokenUrl– UTF-8-Zeichenfolge, nicht mehr als 256 Bytes lang, passend zum Custom string pattern #40.Die URL des Authentifizierungsservers des Anbieters für den Austausch eines Autorisierungscodes gegen ein Zugriffstoken.
-
TokenUrlParametersMap– Ein Map-Array von Schlüssel-Wert-Paaren.Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 512 Bytes lang ist.
Eine Zuordnung von Parametern, die der Token-
GET-Anfrage hinzugefügt werden. -
AuthorizationCodeProperties– Ein AuthorizationCodeProperties-Objekt.Der Satz von Eigenschaften, die für den OAuth2
AUTHORIZATION_CODEGrant-Typ erforderlich sind. -
OAuth2Credentials– Ein OAuth2Erweitern Sie im angezeigten Detailbereich die Option-Objekt.Die Anmeldeinformationen, die verwendet werden, wenn der Authentifizierungstyp OAuth2 Authentifizierung ist.
OAuth2ClientApplication Struktur
Die für die Verbindung verwendete OAuth2 Client-App.
Felder
-
UserManagedClientApplicationClientId– UTF-8-Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum Custom string pattern #37.Die ClientID der Client-Anwendung, falls ja. ClientAppType
USER_MANAGED -
AWSManagedClientApplicationReference– UTF-8-Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum Custom string pattern #37.Der Verweis auf die SaaS-seitige Client-App, die verwaltet wird AWS .
AuthorizationCodeProperties Struktur
Der Satz von Eigenschaften, die für den Workflow mit der Art des OAuth2 AUTHORIZATION_CODE Zuschusses erforderlich sind.
Felder
-
AuthorizationCode— UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 4096 Byte lang, entspricht. Custom string pattern #37Ein Autorisierungscode, der in der dritten Phase des
AUTHORIZATION_CODE-Gewährungs-Workflows verwendet werden soll. Dieser Code ist nur einmal verwendbar und wird ungültig, sobald er gegen ein Zugriffstoken ausgetauscht wird. Daher ist es zulässig, diesen Wert als Anforderungsparameter zu verwenden. -
RedirectUri— UTF-8-Zeichenfolge, nicht mehr als 512 Byte lang, entspricht. Custom string pattern #41Die Umleitungs-URI, zu der der Benutzer bei der Ausgabe eines Autorisierungscodes vom Autorisierungsserver umgeleitet wird. Diese URI wird anschließend verwendet, wenn der Autorisierungscode gegen ein Zugriffstoken ausgetauscht wird.
BasicAuthenticationCredentials Struktur
Zur Bereitstellung von Anmeldeinformationen für die Basisauthentifizierung, wenn kein SecretArn-Wert angegeben wird.
Felder
-
Username— UTF-8-Zeichenfolge, nicht mehr als 512 Byte lang, entspricht. Custom string pattern #37Der Benutzername zur Verbindung mit der Datenquelle.
-
Password— UTF-8-Zeichenfolge, nicht mehr als 512 Byte lang, entspricht der. Custom string pattern #33Das Passwort für die Verbindung zur Datenquelle.
OAuth2Struktur der Anmeldeinformationen
Die Anmeldeinformationen, die verwendet werden, wenn der Authentifizierungstyp OAuth2 Authentifizierung ist.
Felder
-
UserManagedClientApplicationClientSecret— UTF-8-Zeichenfolge, nicht mehr als 512 Byte lang, entspricht. Custom string pattern #38Das Client-Geheimnis der Client-Anwendung, wenn die Client-Anwendung vom Benutzer verwaltet wird.
-
AccessToken— UTF-8-Zeichenfolge, nicht mehr als 4096 Byte lang, entspricht der. Custom string pattern #38Das Zugriffstoken, das verwendet wird, wenn der Authentifizierungstyp ist. OAuth2
-
RefreshToken— UTF-8-Zeichenfolge, nicht mehr als 4096 Byte lang, entspricht. Custom string pattern #38Das Aktualisierungstoken, das verwendet wird, wenn der Authentifizierungstyp ist. OAuth2
-
JwtToken— UTF-8-Zeichenfolge, nicht mehr als 8000 Byte lang, entspricht. Custom string pattern #39Das JSON Web Token (JWT), das verwendet wird, wenn der Authentifizierungstyp ist. OAuth2
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.
-
ConnectionInput– Erforderlich: 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 Bytes lang ist.
Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht mehr als 256 Bytes lang ist.
Die Tags, die Sie der Verbindung zuweisen.
Antwort
-
CreateConnectionStatus– UTF-8-Zeichenfolge (zulässige Werte:READY|IN_PROGRESS|FAILED).Der Status der Anfrage für die Verbindungserstellung. Die Anfrage kann bei bestimmten Authentifizierungstypen einige Zeit in Anspruch nehmen, z. B. beim Herstellen einer OAuth Verbindung mit Tokenaustausch über VPC.
Fehler
AlreadyExistsExceptionInvalidInputExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionGlueEncryptionException
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 Bytes lang, passend zum Single-line string pattern.Der Name der zu löschenden Verbindung.
Antwort
Keine Antwortparameter.
Fehler
EntityNotFoundExceptionOperationTimeoutException
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 Bytes lang, passend zum Single-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. Legen Sie diesen Parameter fest, wenn der Anrufer möglicherweise nicht berechtigt ist, den AWS KMS Schlüssel zum Entschlüsseln des Kennworts zu verwenden, er jedoch berechtigt ist, auf die übrigen Verbindungseigenschaften zuzugreifen.
-
ApplyOverrideForComputeEnvironment– UTF-8-Zeichenfolge (zulässige Werte:SPARK|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
-
Connection– Ein Connection (Verbindung)-Objekt.Die angeforderte Verbindungsdefinition.
Fehler
EntityNotFoundExceptionOperationTimeoutExceptionInvalidInputExceptionGlueEncryptionException
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. Legen Sie diesen Parameter fest, wenn der Anrufer möglicherweise nicht berechtigt ist, den AWS KMS Schlüssel zum Entschlüsseln des Kennworts zu verwenden, er jedoch berechtigt ist, auf die übrigen Verbindungseigenschaften zuzugreifen.
-
NextToken– UTF-8-Zeichenfolge.Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist.
-
MaxResults– Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000.Die maximale Anzahl von Verbindungen, die in einer Antwort zurückgegeben werden sollen.
Antwort
-
ConnectionList– Ein Array mit Connection (Verbindung)-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
EntityNotFoundExceptionOperationTimeoutExceptionInvalidInputExceptionGlueEncryptionException
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 Bytes lang, passend zum Single-line string pattern.Der Name der Verbindungsdefinition, die aktualisiert werden soll.
-
ConnectionInput– Erforderlich: Ein ConnectionInput-Objekt.Ein
ConnectionInput-Objekt, das die jeweilige Verbindung neu definiert.
Antwort
Keine Antwortparameter.
Fehler
InvalidInputExceptionEntityNotFoundExceptionOperationTimeoutExceptionInvalidInputExceptionGlueEncryptionException
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, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum 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
InvalidInputExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionGlueEncryptionExceptionFederationSourceExceptionAccessDeniedExceptionEntityNotFoundExceptionConflictExceptionInternalServiceException
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 mit UTF-8-Zeichenfolgen, nicht mehr als 25 Zeichenfolgen.Eine Liste der Namen der Verbindungen, die gelöscht werden sollen.
Antwort
-
Succeeded– Ein UTF-8-Zeichenfolgen-Array.Eine Liste der Namen der Verbindungsdefinitionen, die erfolgreich gelöscht wurden.
-
Errors– Ein Map-Array von Schlüssel-Wert-Paaren.Jeder Schlüssel ist eine UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, und entspricht dem Single-line string pattern.
Jeder Wert ist ein An ErrorDetail-Objekt.
Eine Zuweisung der Namen von Verbindungen, die nicht erfolgreich gelöscht wurden, zu Fehlerdetails.
Fehler
InternalServiceExceptionOperationTimeoutException