Konfigurieren von REST in einer Kopieraktivität
In diesem Artikel wird beschrieben, wie Sie die Kopieraktivität in der Datenpipeline verwenden, um Daten von und in einen REST-Endpunkt zu kopieren.
Wichtig
Microsoft Fabric befindet sich derzeit in der Vorschauversion. Diese Informationen beziehen sich auf eine Vorabversion des Produkts, an der vor der Veröffentlichung noch wesentliche Änderungen vorgenommen werden können. Microsoft übernimmt keine Garantie, weder ausdrücklich noch stillschweigend, für die hier bereitgestellten Informationen. Weitere Informationen finden Sie in Azure Data Factory Dokumentation für den Dienst in Azure.
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.
- Kopieren Sie für REST als Quelle die REST-JSON-Antwort unverändert, oder analysieren Sie sie mithilfe der Schemazuordnung. Nur die Antwortnutzlast in JSON wird unterstützt.
Unterstützte Konfiguration
Für die Konfiguration der einzelnen Registerkarten unter einer Kopieraktivität wechseln Sie zu den folgenden Abschnitten.
Allgemein
Wechseln Sie unter Registerkartenkonfiguration allgemein zu Allgemein.
Quelle
Die folgenden Eigenschaften werden für REST auf der Registerkarte Quelle einer Kopieraktivität unterstützt.
Die folgenden drei Eigenschaften sind erforderlich:
- Datenspeichertyp: Wählen Sie Extern aus.
- Verbindung: Wählen Sie eine REST-Verbindung aus der Verbindungsliste aus. Wenn keine Verbindung vorhanden ist, erstellen Sie eine neue REST-Verbindung, indem Sie Neu auswählen.
- Verbindungstyp: Wählen Sie REST aus.
- Relative URL: Eine relative URL zur Ressource, die die Daten enthält. Wenn diese Eigenschaft nicht angegeben wird, 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.
Anforderungstimeout: Das Timeout (der Zeitbereichswert) 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.
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.
Paginierungsregeln: Die Paginierungsregeln zum Verfassen von Anforderungen der nächsten Seite. Weitere Informationen finden Sie im Abschnitt Paginierungsunterstützung .
Zusätzliche Spalten: Fügen Sie weitere Datenspalten hinzu, um den relativen Pfad oder statischen Wert der Quelldateien zu speichern. Der Ausdruck wird für Letzteres unterstützt.
Destination
Die folgenden Eigenschaften werden für REST auf der Registerkarte Ziel einer Kopieraktivität unterstützt.
Die folgenden drei Eigenschaften sind erforderlich:
- Datenspeichertyp: Wählen Sie Extern aus.
- Verbindung: Wählen Sie eine REST-Verbindung aus der Verbindungsliste aus. Wenn keine Verbindung vorhanden ist, erstellen Sie eine neue REST-Verbindung, indem Sie Neu auswählen.
- Verbindungstyp: Wählen Sie REST aus.
- Relative URL: Eine relative URL zur Ressource, die die Daten enthält. Wenn diese Eigenschaft nicht angegeben wird, 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 Zeitbereichswert) für die HTTP-Anforderung, um eine Antwort zu erhalten. 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 in das REST-Ziel geschrieben werden sollen. Der Standardwert ist 10.000.
Http-Komprimierungstyp: HTTP-Komprimierungstyp, der beim Senden von Daten mit optimaler Komprimierungsebene verwendet werden soll. Zulässige Werte sind None und GZip.
Zusätzliche Header: Zusätzliche HTTP-Anforderungsheader.
Zuordnung
Navigieren Sie für die Konfiguration der Registerkarte Zuordnung auf der Registerkarte Zuordnung zu Konfigurieren Ihrer Zuordnungen. Die Zuordnung wird nicht unterstützt, wenn quelle und ziel hierarchische Daten sind.
Einstellungen
Wechseln Sie für die Konfiguration der Registerkarte Einstellungen auf der Registerkarte Einstellungen zu Konfigurieren Ihrer anderen Einstellungen.
Tabellenzusammenfassung
Die folgenden Tabellen enthalten weitere Informationen zur Kopieraktivität in REST.
Quellinformationen
| Name | BESCHREIBUNG | Wert | Erforderlich | JSON-Skripteigenschaft |
|---|---|---|---|---|
| Datenspeichertyp | Ihr Datenspeichertyp. | • Arbeitsbereich • Extern • Beispieldataset |
Ja | type |
| Connection | Ihre Verbindung mit dem Quelldatenspeicher. | <Ihre Verbindung> | Yes | connection |
| Verbindungstyp | Ihr Verbindungstyp. Wählen Sie REST aus. | REST | Yes | -Typ: RestResource |
| Relative URL | Eine relative URL zu der Ressource, die die Daten enthält. Wenn diese Eigenschaft nicht angegeben wird, 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> | No | relativeUrl |
| Anforderungsmethode | Die HTTP-Methode. Zulässige Werte sind GET (Standardwert) und POST. | • GET • POST |
Nein | requestMethod |
| Anforderungszeitlimit | Das Timeout (der Zeitbereichswert) für die HTTP-Anforderung zum Abrufen einer Antwort. 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 Paginierungsunterstützung . | Wechseln Sie zu Paginierung | Nein | paginationRules |
| Zusätzliche Spalten | Fügen Sie dem relativen Pfad oder statischen Wert der Quelldateien weitere Datenspalten hinzu. Der Ausdruck wird für Letzteres unterstützt. | • Name •Wert |
No | additionalColumns: •Namen •Wert |
Zielinformationen
| Name | BESCHREIBUNG | Wert | Erforderlich | JSON-Skripteigenschaft |
|---|---|---|---|---|
| Datenspeichertyp | Ihr Datenspeichertyp. | • Arbeitsbereich • Extern |
Ja | type |
| Connection | Ihre Verbindung mit dem Quelldatenspeicher. | <Ihre Verbindung> | Yes | connection |
| Verbindungstyp | Ihr Verbindungstyp. Wählen Sie REST aus. | REST | Yes | -Typ: RestResource |
| Relative URL | Eine relative URL zu der Ressource, die die Daten enthält. Wenn diese Eigenschaft nicht angegeben wird, 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> | No | relativeUrl |
| Anforderungsmethode | Die HTTP-Methode. Zulässige Werte sind POST (Standardwert), PUT und PATCH. | • POST • GET • PATCH |
Nein | requestMethod |
| Anforderungszeitlimit | Das Timeout (der Zeitbereichswert) für die HTTP-Anforderung zum Abrufen einer Antwort. 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. | <Zeilenanzahl> (Integer) |
Nein | writeBatchSize |
| Http-Komprimierungstyp | Der HTTP-Komprimierungstyp, der zum Senden von Daten mit der optimalen Komprimierungsstufe verwendet werden soll. Zulässige Werte sind None und GZip. | • Keine • GZip |
Nein | httpCompressionType |
| Zusätzliche Header | Zusätzliche HTTP-Anforderungsheader | <Ihre zusätzlichen Header> | Nein | additionalHeaders |