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
|SLACK
|STRIPE
INTERCOM
|SNAPCHATADS
).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_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 Wertezeichenfolge, die nicht weniger als 1 oder mehr als 1024 Byte lang ist.
Diese Schlüssel-Wert-Paare definieren Parameter für die Verbindung, wenn das Verbindungsschema der Version 1 verwendet wird:
-
HOST
- Der Host-URI: entweder der vollqualifizierte Domänenname (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_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 CatalogConnectionPasswordEncryption
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 boolescher Zeichenfolge (true, false), 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 istfalse
das. AWS Glue validiert den Signaturalgorithmus und den Subject Public Key Algorithm für das Kundenzertifikat. Die einzigen zulässigen Algorithmen für den Signaturalgorithmus sind SHA256with RSA, RSA oder SHA384with RSA. SHA512with Die Schlüssellänge für den Algorithmus für den öffentlichen Schlüssel muss mindestens 2048 betragen. Sie können den Wert dieser Eigenschaft auftrue
festlegen, um die AWS Glue-Validierung des Kundenzertifikats zu überspringen. -
CUSTOM_JDBC_CERT_STRING
- Eine benutzerdefinierte JDBC-Zertifikatszeichenfolge, die für den Domänenabgleich oder den Abgleich definierter Namen verwendet wird, um einen Angriff zu verhindern. man-in-the-middle In Oracle Database wird sie alsSSL_SERVER_CERT_DN
verwendet. In Microsoft SQL Server wird sie alshostNameInCertificate
verwendet. -
CONNECTION_URL
– Die URL für die Verbindung mit einer allgemeinen Datenquelle (nicht JDBC). -
SECRET_ID
– Die geheime ID, die für den Secrets Manager der Anmeldeinformationen verwendet wird. -
CONNECTOR_URL
– Die Connector-URL für eine MARKETPLACE- oder CUSTOM-Verbindung. -
CONNECTOR_TYPE
– Der Konnektor-Typ für eine MARKETPLACE- oder CUSTOM-Verbindung. -
CONNECTOR_CLASS_NAME
– Die Konnektor-Klassenname für eine MARKETPLACE- oder CUSTOM-Verbindung. -
KAFKA_BOOTSTRAP_SERVERS
- Eine durch Kommata getrennte Liste von Host- und Portpaaren, die die Adressen der Apache Kafka Broker in einem Kafka-Cluster sind, zu dem ein Kafka-Client eine Verbindung herstellt und Bootstrapping durchführt. -
KAFKA_SSL_ENABLED
– Ob SSL auf einer Apache-Kafka-Verbindung aktiviert oder deaktiviert werden soll. Der Standardwert ist „true“. -
KAFKA_CUSTOM_CERT
– Die Amazon-S3-URL für die private CA-Zertifikatdatei (PEM-Format). Der Standardwert ist eine leere Zeichenfolge. -
KAFKA_SKIP_CUSTOM_CERT_VALIDATION
— Ob die Validierung der CA-Zertifikatsdatei übersprungen werden soll oder nicht. AWS Glue validiert für drei Algorithmen: SHA256with RSA, RSA und SHA384with RSA. SHA512with Der Standardwert ist „false“. -
KAFKA_CLIENT_KEYSTORE
– Der Amazon-S3-Speicherort der Client-Keystore-Datei für die clientseitige Kafka-Authentifizierung (optional). -
KAFKA_CLIENT_KEYSTORE_PASSWORD
– Das Passwort für den Zugriff auf den bereitgestellten Keystore (optional). -
KAFKA_CLIENT_KEY_PASSWORD
– Ein Keystore kann aus mehreren Schlüsseln bestehen, also ist dies das Passwort für den Zugriff auf den Clientschlüssel, der mit dem serverseitigen Kafka-Schlüssel verwendet werden soll (optional). -
ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD
- Die verschlüsselte Version des Keystore-Passworts des Kafka-Clients (falls der Benutzer die Einstellung Passwörter verschlüsseln ausgewählt hat). AWS Glue -
ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD
- Die verschlüsselte Version des Kafka-Client-Schlüsselkennworts (falls der Benutzer die Einstellung Passwörter AWS Glue verschlüsseln ausgewählt hat). -
KAFKA_SASL_MECHANISM
-"SCRAM-SHA-512"
,"GSSAPI"
"AWS_MSK_IAM"
, oder."PLAIN"
Dies sind die unterstützten SASL-Mechanismen. -
KAFKA_SASL_PLAIN_USERNAME
- Ein Klartext-Benutzername, der zur Authentifizierung mit dem „PLAIN“ -Mechanismus verwendet wird. -
KAFKA_SASL_PLAIN_PASSWORD
- Ein Klartext-Passwort, das zur Authentifizierung mit dem „PLAIN“ -Mechanismus 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.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 serverlosen Amazon Redshift Redshift-Arbeitsgruppe oder Amazon Athena Athena-Arbeitsgruppe, in der Abfragen ausgeführt werden. -
CLUSTER_IDENTIFIER
— Die Cluster-ID eines Amazon Redshift Redshift-Clusters, in dem Abfragen ausgeführt werden. -
DATABASE
- Die Amazon Redshift 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 Byte lang ist.
Spezifische Verbindungseigenschaften für die Spark-Rechenumgebung.
-
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 Byte lang ist.
Spezifische Verbindungseigenschaften für die Athena-Rechenumgebung.
-
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 Byte lang ist.
Verbindungseigenschaften, die für die Python-Rechenumgebung spezifisch sind.
-
PhysicalConnectionRequirements
– Ein PhysicalConnectionRequirements-Objekt.Die physischen Verbindungsanforderungen, wie Virtual Private Cloud (VPC) und
SecurityGroup
, die erforderlich sind, um diese Verbindung erfolgreich herzustellen. -
CreationTime
– Zeitstempel.Der Zeitstempel des Zeitpunkts, zu dem diese Verbindungsdefinition erstellt wurde.
-
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_PROGRESS
oderFAILED
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 Uhrzeit, zu der diese Verbindung zuletzt validiert wurde.
-
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 Rechenumgebungen.
-
CompatibleComputeEnvironments
– Ein UTF-8-Zeichenfolgen-Array.Eine Liste von Rechenumgebungen, 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: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
| |SLACK
STRIPE
INTERCOM
|SNAPCHATADS
).Typ der Verbindung. Derzeit werden folgende Typen unterstützt:
-
JDBC
– Gibt eine Verbindung mit einer Datenbank über Java Database Connectivity (JDBC) an.JDBC
Verbindungen verwenden Folgendes. ConnectionParameters-
Erforderlich: Alle von (
HOST
,PORT
,JDBC_ENGINE
) 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.KAFKA
Verbindungen verwenden Folgendes ConnectionParameters.-
Erforderlich:
KAFKA_BOOTSTRAP_SERVERS
. -
Optional:
KAFKA_SSL_ENABLED
,KAFKA_CUSTOM_CERT
,KAFKA_SKIP_CUSTOM_CERT_VALIDATION
. Diese Parameter werden verwendet, um SSL mitKAFKA
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 inKAFKA
zu konfigurieren. -
Optional:
KAFKA_SASL_MECHANISM
. Kann alsSCRAM-SHA-512
,GSSAPI
oderAWS_MSK_IAM
angegeben werden. -
Optional:
KAFKA_SASL_SCRAM_USERNAME
,KAFKA_SASL_SCRAM_PASSWORD
,ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD
. Diese Parameter werden verwendet, um SASL/SCRAM-SHA-512-Authentifizierung mitKAFKA
zu konfigurieren. -
Optional:
KAFKA_SASL_GSSAPI_KEYTAB
,KAFKA_SASL_GSSAPI_KRB5_CONF
,KAFKA_SASL_GSSAPI_SERVICE
,KAFKA_SASL_GSSAPI_PRINCIPAL
. Diese Parameter werden verwendet, um die SASL/GSSAPI-Authentifizierung mitKAFKA
zu konfigurieren.
-
-
MONGODB
– Gibt eine Verbindung zu einer MongoDB-Dokumentendatenbank an.MONGODB
Verbindungen verwenden Folgendes ConnectionParameters.-
Erforderlich:
CONNECTION_URL
. -
Erforderlich: Alle von (
USERNAME
,PASSWORD
) oderSECRET_ID
.
-
-
VIEW_VALIDATION_REDSHIFT
— Bezeichnet eine Verbindung, die für die Überprüfung von Ansichten durch Amazon Redshift verwendet wird. -
VIEW_VALIDATION_ATHENA
- Bezeichnet eine Verbindung, die für die Überprüfung von Ansichten durch Amazon Athena verwendet wird. -
NETWORK
– Bezeichnet eine Netzwerkverbindung zu einer Datenquelle in einer Amazon Virtual Private Cloud-Umgebung (Amazon VPC).NETWORK
Verbindungen sind nicht erforderlich. ConnectionParameters Geben Sie stattdessen eine an PhysicalConnectionRequirements. -
MARKETPLACE
- Verwendet Konfigurationseinstellungen, die in einem Connector enthalten sind AWS Marketplace , um aus Datenspeichern zu lesen und in diese zu schreiben, die nicht nativ von AWS Glue unterstützt werden.MARKETPLACE
Verbindungen verwenden Folgendes ConnectionParameters.-
Erforderlich:
CONNECTOR_TYPE
,CONNECTOR_URL
,CONNECTOR_CLASS_NAME
,CONNECTION_URL
. -
Erforderlich für
JDBC
CONNECTOR_TYPE
-Verbindungen: Alle von (USERNAME
,PASSWORD
) 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.
Darüber hinaus wird ein
ConnectionType
für die folgenden SaaS-Konnektoren unterstützt:-
FACEBOOKADS
- Bezeichnet eine Verbindung zu Facebook-Werbeanzeigen. -
GOOGLEADS
- Bezeichnet eine Verbindung zu Google Ads. -
GOOGLESHEETS
- Bezeichnet eine Verbindung zu Google Sheets. -
GOOGLEANALYTICS4
- Bezeichnet eine Verbindung zu Google Analytics 4. -
HUBSPOT
- Bezeichnet eine Verbindung zu. HubSpot -
INSTAGRAMADS
- Bezeichnet eine Verbindung zu Instagram-Anzeigen. -
INTERCOM
- Bezeichnet eine Verbindung zu Intercom. -
JIRACLOUD
- Bezeichnet eine Verbindung zu Jira Cloud. -
MARKETO
— Bezeichnet eine Verbindung zu Adobe Marketo Engage. -
NETSUITEERP
- Bezeichnet eine Verbindung zu Oracle. NetSuite -
SALESFORCE
— Bezeichnet eine Verbindung zu Salesforce mithilfe von Authentifizierung. OAuth
Weitere Informationen zu den Verbindungsparametern, die für einen bestimmten Konnektor erforderlich sind, finden Sie in der Dokumentation zum Konnektor unter AWS Glue Verbindung hinzufügen im AWS Glue Benutzerhandbuch.
SFTP
wird nicht unterstützt.Weitere Informationen darüber, wie optionale Funktionen zur Konfiguration verwendet ConnectionProperties werden AWS Glue, finden Sie unter AWS Glue Verbindungseigenschaften.
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
– 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 Wertezeichenfolge, die nicht weniger als 1 oder mehr als 1024 Byte 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 Byte lang ist.
Spezifische Verbindungseigenschaften für die Spark-Rechenumgebung.
-
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 Byte lang ist.
Spezifische Verbindungseigenschaften für die Athena-Rechenumgebung.
-
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 Byte lang ist.
Verbindungseigenschaften, die für die Python-Rechenumgebung spezifisch sind.
-
PhysicalConnectionRequirements
– Ein PhysicalConnectionRequirements-Objekt.Die physischen Verbindungsanforderungen, wie 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 Computerumgebungen, anhand derer die angegebenen Verbindungseigenschaften validiert werden.
TestConnectionInput Struktur
Eine Struktur, die verwendet wird, um das Testen einer Verbindung zu einem Dienst zu spezifizieren.
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
|SLACK
|STRIPE
INTERCOM
|SNAPCHATADS
).Der Typ der zu testenden Verbindung. Dieser Vorgang ist nur für die
SALESFORCE
VerbindungstypenJDBC
oder verfügbar. -
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 Wertezeichenfolge, die nicht weniger als 1 oder mehr als 1024 Byte lang ist.
Die Schlüssel-Wert-Paare, 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
| |SLACK
STRIPE
INTERCOM
|SNAPCHATADS
).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 geheime Manager-ARN zum Speichern von Anmeldeinformationen.
-
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 #29 entspricht.Der ARN des KMS-Schlüssels, der zum Verschlüsseln der Verbindung verwendet wurde. Hat nur eine als Eingabe in der Anfrage akzeptiert und im Secret Manager gespeichert.
-
BasicAuthenticationCredentials
– Ein BasicAuthenticationCredentials-Objekt.Die Anmeldeinformationen, die verwendet werden, wenn der Authentifizierungstyp Standardauthentifizierung ist.
-
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 Byte lang ist.
Die Anmeldeinformationen, die verwendet werden, wenn der Authentifizierungstyp benutzerdefinierte Authentifizierung ist.
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_BEARER
oderCLIENT_CREDENTIALS
. -
OAuth2ClientApplication
– Ein OAuth2ClientApplication-Objekt.Der Typ der Client-Anwendung. 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, um einen Autorisierungscode gegen ein Zugriffstoken auszutauschen.
-
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 Byte lang ist.
Eine Zuordnung von Parametern, die der
GET
Token-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_BEARER
oderCLIENT_CREDENTIALS
. -
OAuth2ClientApplication
– Ein OAuth2ClientApplication-Objekt.Der Typ der Client-Anwendung in der CreateConnection Anfrage. Zum Beispiel
AWS_MANAGED
oderUSER_MANAGED
. -
TokenUrl
– UTF-8-Zeichenfolge, nicht mehr als 256 Bytes lang, passend zum Custom string pattern #40.Die URL des Authentifizierungsservers des Anbieters, um einen Autorisierungscode gegen ein Zugriffstoken auszutauschen.
-
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 Byte lang ist.
Eine Zuordnung von Parametern, die der
GET
Token-Anfrage hinzugefügt werden. -
AuthorizationCodeProperties
– Ein AuthorizationCodeProperties-Objekt.Der Satz von Eigenschaften, die für den OAuth2
AUTHORIZATION_CODE
Zuschusstyp 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 Grant-Workflows verwendet werden soll.
AUTHORIZATION_CODE
Dies ist ein einmalig verwendbarer Code, der ungültig wird, sobald er gegen ein Zugriffstoken eingetauscht wird. Daher ist es akzeptabel, 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. Der URI wird anschließend verwendet, wenn der Autorisierungscode gegen ein Zugriffstoken ausgetauscht wird.
BasicAuthenticationCredentials Struktur
Ein Objekt, das Anmeldeinformationen enthält, die verwendet werden, wenn der Authentifizierungstyp Standardauthentifizierung ist.
Felder
-
Username
— UTF-8-Zeichenfolge, nicht mehr als 512 Byte lang, entspricht. Custom string pattern #37Der Benutzername für die Standardauthentifizierung.
-
Password
— UTF-8-Zeichenfolge, nicht länger als 512 Byte, entspricht. Custom string pattern #33Das Passwort für die Standardauthentifizierung.
OAuth2Struktur der Anmeldeinformationen
Ein Objekt mit Anmeldeinformationen, das verwendet wird, wenn der Authentifizierungstyp ist OAuth2.
Felder
-
UserManagedClientApplicationClientSecret
— UTF-8-Zeichenfolge, nicht mehr als 512 Byte lang, entspricht. Custom string pattern #38Der geheime Client-Schlüssel für die vom Benutzer verwaltete Client-Anwendung.
-
AccessToken
— UTF-8-Zeichenfolge, nicht mehr als 4096 Byte lang, entspricht. Custom string pattern #38Das Zugriffstoken für die Authentifizierung. OAuth2
-
RefreshToken
— UTF-8-Zeichenfolge, nicht länger als 4096 Byte, entspricht. Custom string pattern #38Das Aktualisierungstoken für die Authentifizierung. OAuth2
-
JwtToken
— UTF-8-Zeichenfolge, nicht länger als 8000 Byte, entspricht. Custom string pattern #39Das JSON Web Token (JWT) für die Authentifizierung. 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 zur Verbindungserstellung. Die Anfrage kann bei bestimmten Authentifizierungstypen einige Zeit in Anspruch nehmen, z. B. beim Herstellen einer OAuth Verbindung mit Tokenaustausch über VPC.
Fehler
AlreadyExistsException
InvalidInputException
OperationTimeoutException
ResourceNumberLimitExceededException
GlueEncryptionException
DeleteConnection Aktion (Python: delete_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
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 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
).Gibt für Verbindungen, die in mehreren Diensten verwendet werden können, die Rückgabe von Eigenschaften für die angegebene Rechenumgebung an.
Antwort
-
Connection
– Ein Verbindung-Objekt.Die angeforderte Verbindungsdefinition.
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. 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 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 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
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 vorhandenen Verbindungsnamen oder eine Eingabe TestConnectionInput
zum Testen einer nicht vorhandenen Verbindung angeben. Wenn Sie beide gleichzeitig angeben, wird ein Fehler verursacht.
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 sie zum Testen.
-
CatalogId
– Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern. -
TestConnectionInput
– Ein TestConnectionInput-Objekt.Eine Struktur, die verwendet wird, um das Testen einer Verbindung zu einem Dienst anzugeben.
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 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
InternalServiceException
OperationTimeoutException