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.
Verbindungsmetadaten und Vorschau API
In der folgenden Verbindung APIs werden Operationen zur Beschreibung von Verbindungsmetadaten beschrieben.
Datentypen
Struktur der Entität
Eine Entität, die von einer bestimmten Person unterstützt wirdConnectionType.
Felder
-
EntityName— UTF -8 Zeichenfolge.Der Name der Entität.
-
Label— UTF -8 Zeichenfolge.Für die Entität verwendetes Label.
-
IsParentEntity– Boolesch.Ein boolescher Wert, mit dessen Hilfe bestimmt werden kann, ob Unterobjekte aufgelistet werden können.
-
Description— UTF -8 Zeichenfolge.Eine Beschreibung der Entität.
-
Category— UTF -8 Zeichenfolge.Der Typ der Entitäten, die in der Antwort vorhanden sind. Dieser Wert hängt von der Quellverbindung ab. Dies ist beispielsweise
SObjectsfür Salesforce und/oderdatabasesschemasodertablesfür Quellen wie Amazon Redshift. -
CustomProperties– Ein Map-Array von Schlüssel-Wert-Paaren.Jeder Schlüssel ist eine Zeichenfolge von UTF -8.
Jeder Wert ist eine Zeichenfolge mit UTF -8.
Eine optionale Zuordnung von Schlüsseln, die von einem Konnektor für eine Entität zurückgegeben werden können.
Struktur des Feldes
Das Field Objekt enthält Informationen über die verschiedenen Eigenschaften, die einem Feld im Konnektor zugeordnet sind.
Felder
-
FieldName— UTF -8 Zeichenfolge.Ein eindeutiger Bezeichner für das Feld.
-
Label— UTF -8 Zeichenfolge.Eine lesbare Bezeichnung, die für das Feld verwendet wird.
-
Description— UTF -8 Zeichenfolge.Eine Beschreibung des Feldes.
-
FieldType— UTF -8 Zeichenfolge (gültige Werte:INT| |SMALLINT|BIGINT|FLOAT| |LONG|DATE|BOOLEAN|MAP|ARRAY|STRING|TIMESTAMP|DECIMAL| |BYTE|SHORTDOUBLE|STRUCT).Der Datentyp im Feld.
-
IsPrimaryKey– Boolesch.Gibt an, ob dieses Feld als Primärschlüssel für die angegebene Entität verwendet werden kann.
-
IsNullable– Boolesch.Gibt an, ob für dieses Feld Nullwerte zulässig sind oder nicht.
-
IsRetrievable– Boolesch.Gibt an, ob dieses Feld der Select-Klausel der SQL Abfrage hinzugefügt werden kann oder ob es abrufbar ist oder nicht.
-
IsFilterable– Boolesch.Gibt an, ob dieses Feld in einer Filterklausel (
WHEREKlausel) einer SQL Anweisung verwendet werden kann, wenn Daten abgefragt werden. -
IsPartitionable– Boolesch.Gibt an, ob ein bestimmtes Feld zur Partitionierung der an SaaS gestellten Abfrage verwendet werden kann.
-
IsCreateable– Boolesch.Gibt an, ob dieses Feld als Teil eines Ziel-Schreibvorgangs erstellt werden kann.
-
IsUpdateable– Boolesch.Gibt an, ob dieses Feld im Rahmen eines Ziel-Schreibvorgangs aktualisiert werden kann.
-
IsUpsertable– Boolesch.Gibt an, ob dieses Feld im Rahmen eines Ziel-Schreibvorgangs geändert werden kann.
-
IsDefaultOnCreate– Boolesch.Gibt an, ob dieses Feld automatisch aufgefüllt wird, wenn das Objekt erstellt wird, z. B. ein Zeitstempel vom Typ Created at.
-
SupportedValues— Ein Array von UTF -8 Zeichenketten.Eine Liste der unterstützten Werte für das Feld.
-
SupportedFilterOperators— Ein Array von UTF -8 Zeichenketten.Gibt an, welche Filteroperatoren für dieses Feld unterstützt werden.
-
CustomProperties– Ein Map-Array von Schlüssel-Wert-Paaren.Jeder Schlüssel ist eine Zeichenfolge von UTF -8.
Jeder Wert ist eine Zeichenfolge mit UTF -8.
Optionale Zuordnung von Schlüsseln, die zurückgegeben werden können.
Operationen
ListEntities Aktion (Python: list_entities)
Gibt die verfügbaren Entitäten zurück, die vom Verbindungstyp unterstützt werden.
Anforderung
-
ConnectionName— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string patternEin Name für die Verbindung, für die Anmeldeinformationen erforderlich sind, um einen beliebigen Verbindungstyp abzufragen.
-
CatalogId– Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Die Katalog-ID des Katalogs, der die Verbindung enthält. Dies kann Null sein. Standardmäßig ist die AWS Konto-ID die Katalog-ID.
-
ParentEntityName— UTF -8 Zeichenfolge.Name der übergeordneten Entität, für die Sie die untergeordneten Entitäten auflisten möchten. Dieser Parameter verwendet einen vollständig qualifizierten Pfad der Entität, um die untergeordneten Entitäten aufzulisten.
-
NextToken— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang, entspricht. Custom string pattern #11Ein Fortsetzungs-Token, der enthalten ist, wenn dies ein Fortsetzungsaufruf ist.
-
DataStoreApiVersion— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang, entspricht der. Custom string pattern #23Die API Version des SaaS-Connectors.
Antwort
-
Entities– Ein Array mit Entität-Objekten.Eine Liste von
Entity-Objekten. -
NextToken— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang, entspricht. Custom string pattern #11Ein Fortsetzungstoken, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist.
Fehler
EntityNotFoundExceptionOperationTimeoutExceptionInvalidInputExceptionGlueEncryptionExceptionValidationExceptionFederationSourceExceptionAccessDeniedException
DescribeEntity Aktion (Python: describe_entity)
Enthält Details zu der Entität, die mit dem Verbindungstyp verwendet wird, sowie eine Beschreibung des Datenmodells für jedes Feld in der ausgewählten Entität.
Die Antwort umfasst alle Felder, aus denen die Entität besteht.
Anforderung
-
ConnectionName— Erforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string patternDer Name der Verbindung, die die Anmeldeinformationen für den Verbindungstyp enthält.
-
CatalogId– Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Die Katalog-ID des Katalogs, der die Verbindung enthält. Dies kann Null sein. Standardmäßig ist die AWS Konto-ID die Katalog-ID.
-
EntityName— Erforderlich: Zeichenfolge UTF -8.Der Name der Entität, die Sie anhand des Verbindungstyps beschreiben möchten.
-
NextToken— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang, entspricht. Custom string pattern #11Ein Fortsetzungs-Token, der enthalten ist, wenn dies ein Fortsetzungsaufruf ist.
-
DataStoreApiVersion— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang, entspricht der. Custom string pattern #23Die Version von, die für den Datenspeicher API verwendet wird.
Antwort
-
Fields– Ein Array mit Feld-Objekten.Beschreibt die Felder für diese Connector-Entität. Dies ist die Liste der
FieldObjekte.Fieldist einer Spalte in einer Datenbank sehr ähnlich. DasFieldObjekt enthält Informationen über verschiedene Eigenschaften, die Feldern im Konnektor zugeordnet sind. -
NextToken— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang, entspricht. Custom string pattern #11Ein Fortsetzungstoken, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist.
Fehler
EntityNotFoundExceptionOperationTimeoutExceptionInvalidInputExceptionGlueEncryptionExceptionValidationExceptionFederationSourceExceptionAccessDeniedException
GetEntityRecords Aktion (Python: get_entity_records)
Dies API wird verwendet, um Vorschaudaten von einem bestimmten Verbindungstyp oder aus einem nativen Amazon S3 S3-basierten AWS Glue Datenkatalog abzufragen.
Gibt Datensätze als Array von JSON Blobs zurück. Jeder Datensatz wird mit Jackson formatiert, JsonNode basierend auf dem Feldtyp, der durch den definiert ist. DescribeEntity API
Spark-Konnektoren generieren Schemas gemäß derselben Datentypzuordnung wie in der. DescribeEntity API Spark-Konnektoren konvertieren Daten in die entsprechenden Datentypen, die dem Schema entsprechen, wenn Zeilen zurückgegeben werden.
Anforderung
-
ConnectionName— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string patternDer Name der Verbindung, die die Anmeldeinformationen für den Verbindungstyp enthält.
-
CatalogId– Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Die Katalog-ID des Katalogs, der die Verbindung enthält. Dies kann Null sein. Standardmäßig ist die AWS Konto-ID die Katalog-ID.
-
EntityName— Erforderlich: Zeichenfolge UTF -8.Name der Entität, für die wir die Vorschaudaten des angegebenen Verbindungstyps abfragen möchten.
-
NextToken— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang, entspricht. Custom string pattern #11Ein Fortsetzungs-Token, der enthalten ist, wenn dies ein Fortsetzungsaufruf ist.
-
DataStoreApiVersion— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang, entspricht der. Custom string pattern #23Die API Version des SaaS-Connectors.
-
ConnectionOptions– Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 100 Paare.Jeder Schlüssel besteht aus einer Zeichenfolge von UTF -8, die nicht weniger als 1 oder mehr als 256 Byte lang ist und der Custom string pattern #18 entspricht.
Jeder Wert ist eine Zeichenfolge von UTF -8, die nicht weniger als 1 oder mehr als 256 Byte lang ist und dem entspricht. Custom string pattern #17
Konnektoroptionen, die zum Abfragen der Daten erforderlich sind.
-
FilterPredicate— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 100000 Byte lang.Ein Filterprädikat, das Sie in der Abfrageanforderung anwenden können.
-
Limit— Erforderlich: Zahl (lang), nicht weniger als 1 oder mehr als 1000.Beschränkt die Anzahl der mit der Anfrage abgerufenen Datensätze.
-
OrderBy— UTF -8 Zeichenfolge.Ein Parameter, der die Antwortvorschaudaten sortiert.
-
SelectedFields— Ein Array von UTF -8 Zeichenketten, nicht weniger als 1 oder mehr als 1000 Zeichenketten.Liste der Felder, die wir als Teil der Vorschaudaten abrufen möchten.
Antwort
-
Records– Eine Reihe von Strukturen.Eine Liste der angeforderten -Objekte.
-
NextToken— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang, entspricht. Custom string pattern #11Ein Fortsetzungstoken, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist.
Fehler
EntityNotFoundExceptionOperationTimeoutExceptionInvalidInputExceptionGlueEncryptionExceptionValidationExceptionFederationSourceExceptionAccessDeniedException
