Freigeben über

Konfigurieren von REST in einer Kopieraktivität

  • Artikel

In diesem Artikel wird beschrieben, wie Sie die Kopieraktivität in der Datenpipeline verwenden, um Daten von und zu einem REST-Endpunkt zu kopieren.

Dieser allgemeine REST-Connector unterstützt Folgendes:

  • Kopieren von Daten von einem REST-Endpunkt mithilfe der Methoden GET oder POST und Kopieren von Daten in einen REST-Endpunkt mithilfe der Methoden POST, PUT oder PATCH.
  • Die Paginierung in den REST-APIs.
  • Bei REST als Quelle kopieren Sie die unveränderte REST-JSON-Antwort oder analysieren sie mithilfe der Schemazuordnung. In JSON werden lediglich die Antwortnutzdaten unterstützt.

Unterstützte Konfiguration

Die Konfiguration der einzelnen Registerkarten unter einer Kopieraktivität finden Sie in den folgenden Abschnitten.

Allgemein

Wechseln Sie für die Konfiguration der Registerkarte Allgemein zu Allgemein.

Quelle

Die folgenden Eigenschaften werden für REST auf der Registerkarte Quelle einer Kopieraktivität unterstützt.

Screenshot showing source tab and the list of properties.

Die folgenden ersten drei Eigenschaften sind erforderlich:

  • Datenspeichertyp: Wählen Sie Extern aus.
  • Verbindung: Wählen Sie eine REST-Verbindung aus der Verbindungsliste aus. Wenn keine Verbindung existiert, erstellen Sie eine neue REST-Verbindung, indem Sie Neu auswählen.
  • Verbindungstyp: Wählen Sie REST aus.
  • Relative URL: Eine relative URL zu der Ressource, die die Daten enthält. Wenn diese Eigenschaft nicht angegeben ist, wird nur die URL verwendet, die in der Verbindungsdefinition angegeben ist. Der HTTP-Connector kopiert Daten aus der kombinierten URL: [URL specified in connection]/[relative URL specified].

Unter Erweitert können Sie die folgenden Felder angeben:

  • Anforderungsmethode: Die HTTP-Methode. Zulässige Werte sind GET (Standardwert) und POST.

    Screenshot showing request method.

  • Anforderungstimeout: Das Timeout (der Zeitspannenwert) für die HTTP-Anforderung, um eine Antwort zu empfangen. Bei diesem Wert handelt es sich um das Timeout zum Empfangen einer Antwort, nicht um das Timeout zum Lesen von Antwortdaten. Der Standardwert ist 00:01:40.

  • Anforderungsintervall (ms): Die Intervallzeit zwischen verschiedenen Anforderungen für mehrere Seiten in Millisekunden. Der Wert für das Anforderungsintervall sollte eine Zahl zwischen 10 und 60000 sein.

  • Zusätzliche Header: Zusätzliche HTTP-Anforderungsheader.

    Screenshot showing additional headers.

  • Paginierungsregeln: Die Paginierungsregeln, um die Anforderungen für die nächste Seite zusammenzustellen. Weitere Informationen finden Sie im Abschnitt Unterstützung der Paginierung.

    Screenshot showing pagination rules.

  • Zusätzliche Spalten: Fügen Sie weitere Datenspalten hinzu, um den relativen Pfad oder statischen Wert der Quelldateien zu speichern. Wenn Sie einen statischen Wert verwenden, können Sie ihn mit Hilfe von benutzerdefinierten Ausdrücken generieren.

    Screenshot showing additional columns.

Destination

Die folgenden Eigenschaften werden für REST auf der Registerkarte Ziel einer Kopieraktivität unterstützt.

Screenshot showing destination tab.

Die folgenden ersten drei Eigenschaften sind erforderlich:

  • Datenspeichertyp: Wählen Sie Extern aus.
  • Verbindung: Wählen Sie eine REST-Verbindung aus der Verbindungsliste aus. Wenn keine Verbindung existiert, erstellen Sie eine neue REST-Verbindung, indem Sie Neu auswählen.
  • Verbindungstyp: Wählen Sie REST aus.
  • Relative URL: Eine relative URL zu der Ressource, die die Daten enthält. Wenn diese Eigenschaft nicht angegeben ist, wird nur die URL verwendet, die in der Verbindungsdefinition angegeben ist. Der HTTP-Connector kopiert Daten aus der kombinierten URL: [URL specified in connection]/[relative URL specified].

Unter Erweitert können Sie die folgenden Felder angeben:

  • Anforderungsmethode: Die HTTP-Methode. Zulässige Werte sind POST (Standardwert), PUT und PATCH.

  • Anforderungstimeout: Das Timeout (der Zeitspannenwert) für die HTTP-Anforderung, um eine Antwort zu empfangen. Bei diesem Wert handelt es sich um das Timeout für den Empfang einer Antwort, nicht um das Timeout für das Schreiben der Daten. Der Standardwert ist 00:01:40.

  • Anforderungsintervall (ms): Die Intervallzeit zwischen verschiedenen Anforderungen für mehrere Seiten in Millisekunden. Der Wert für das Anforderungsintervall sollte eine Zahl zwischen 10 und 60000 sein.

  • Schreibbatchgröße: Anzahl der Datensätze, die pro Batch an das REST-Ziel geschrieben werden sollen. Der Standardwert ist 10.000.

  • HTTP-Komprimierungstyp: Der HTTP-Komprimierungstyp, der zum Senden von Daten mit der optimalen Komprimierungsstufe verwendet werden soll. Zulässige Werte sind Keine und GZip.

  • Zusätzliche Header: Zusätzliche HTTP-Anforderungsheader.

    Screenshot showing additional headers.

Zuordnung

Für die Konfiguration der Registerkarte Zuordnung wechseln Sie zu Konfigurieren der Zuordnungen auf der Registerkarte „Zuordnung“. Die Zuordnung wird nicht unterstützt, wenn sowohl Quelle als auch Ziel hierarchische Daten sind.

Einstellungen

Wechseln Sie für die Konfiguration der Registerkarte Einstellungen zu Konfigurieren der anderen Einstellungen auf der Registerkarte „Einstellungen“.

Tabellenzusammenfassung

Die folgenden Tabellen enthalten weitere Informationen über die Kopieraktivitäten in REST.

Quellinformationen

Name Beschreibung Wert Erforderlich JSON-Skripteigenschaft
Datenspeichertyp Ihr Datenspeichertyp • Arbeitsbereich
• Extern
• Beispieldataset
 Ja Typ
Verbindung Ihre Verbindung mit dem Quelldatenspeicher <Ihre Verbindung> Ja Verbindung
Verbindungstyp Ihr Verbindungstyp. Wählen Sie REST aus. REST Ja Typ:
RestResource
Relative URL Eine relative URL zu der Ressource, die die Daten enthält. Wenn diese Eigenschaft nicht angegeben ist, wird nur die URL verwendet, die in der Verbindungsdefinition angegeben ist. Der HTTP-Connector kopiert Daten aus der kombinierten URL: [URL specified in connection]/[relative URL specified]. <Ihre relative URL> Nein relativeUrl
Anforderungsmethode Die HTTP-Methode. Zulässige Werte sind GET (Standardwert) und POST. • GET
• POST		 Nein requestMethod
Anforderungstimeout Das Timeout (der Zeitspannenwert) für die HTTP-Anforderung, um eine Antwort zu erhalten. Bei diesem Wert handelt es sich um das Timeout zum Empfangen einer Antwort, nicht um das Timeout zum Lesen von Antwortdaten. Der Standardwert ist 00:01:40. Zeitraum Nein httpRequestTimeout
Anforderungsintervall (ms) Die Intervallzeit zwischen verschiedenen Anforderungen für mehrere Seiten in Millisekunden. Der Wert für das Anforderungsintervall sollte eine Zahl zwischen 10 und 60000 sein. [10, 60000] Nein requestInterval
Zusätzliche Header Zusätzliche HTTP-Anforderungsheader <Ihre zusätzlichen Header> Nein additionalHeaders
Paginierungsregeln Die Paginierungsregeln zum Zusammenstellen der nächsten Seitenanforderungen. Weitere Informationen finden Sie im Abschnitt Unterstützung der Paginierung. Wechseln Sie zu Paginierung. Nein paginationRules
Zusätzliche Spalten Fügen Sie weitere Datenspalten zum relativen Pfad oder statischen Wert der Speicherquelldateien hinzu. Für Letzteres wird ein Ausdruck unterstützt. • Name
• Wert		 Nein additionalColumns:
• Name
• Wert

Zielinformationen

Name Beschreibung Wert Erforderlich JSON-Skripteigenschaft
Datenspeichertyp Ihr Datenspeichertyp • Arbeitsbereich
• Extern		 Ja Typ
Verbindung Ihre Verbindung mit dem Quelldatenspeicher <Ihre Verbindung> Ja Verbindung
Verbindungstyp Ihr Verbindungstyp. Wählen Sie REST aus. REST Ja Typ:
RestResource
Relative URL Eine relative URL zu der Ressource, die die Daten enthält. Wenn diese Eigenschaft nicht angegeben ist, wird nur die URL verwendet, die in der Verbindungsdefinition angegeben ist. Der HTTP-Connector kopiert Daten aus der kombinierten URL: [URL specified in connection]/[relative URL specified]. <Ihre relative URL> Nein relativeUrl
Anforderungsmethode Die HTTP-Methode. Zulässige Werte sind POST (Standardwert), PUT und PATCH. • POST
• GET
• PATCH		 Nein requestMethod
Anforderungstimeout Das Timeout (der Zeitspannenwert) für die HTTP-Anforderung, um eine Antwort zu erhalten. Bei diesem Wert handelt es sich um das Timeout zum Empfangen einer Antwort, nicht um das Timeout zum Lesen von Antwortdaten. Der Standardwert ist 00:01:40. Zeitraum Nein httpRequestTimeout
Anforderungsintervall (ms) Die Intervallzeit zwischen verschiedenen Anforderungen für mehrere Seiten in Millisekunden. Der Wert für das Anforderungsintervall sollte eine Zahl zwischen 10 und 60000 sein. [10, 60000] Nein requestInterval
Schreibbatchgröße Anzahl der Datensätze, die pro Batch in das REST-Ziel geschrieben werden sollen. Der Standardwert ist 10.000. <Anzahl von Zeilen>
(Integer)		 Nein writeBatchSize
HTTP-Komprimierungstyp Der HTTP-Komprimierungstyp, der zum Senden von Daten mit der optimalen Komprimierungsstufe verwendet werden soll. Zulässige Werte sind Keine und GZip. • Keine
• GZip		 Nein httpCompressionType
Zusätzliche Header Zusätzliche HTTP-Anforderungsheader <Ihre zusätzlichen Header> Nein additionalHeaders

Zugehöriger Inhalt