Sådan konfigurerer du REST i en kopiaktivitet
I denne artikel beskrives det, hvordan du bruger kopieringsaktiviteten i datapipelinen til at kopiere data fra og til et REST-slutpunkt.
Vigtigt
Microsoft Fabric findes i øjeblikket i PRØVEVERSION. Disse oplysninger er relateret til et foreløbig produkt, der kan blive ændret væsentligt, før det udgives. Microsoft giver ingen garantier, udtrykt eller stiltiende, med hensyn til de oplysninger, der er angivet her. Se Azure Data Factory dokumentation for tjenesten i Azure.
Denne generiske REST-connector understøtter specifikt:
- Kopiering af data fra et REST-slutpunkt ved hjælp af metoderne GET eller POST og kopiering af data til et REST-slutpunkt ved hjælp af metoderne POST, PUT eller PATCH .
- Sideinddeling i REST API'er.
- For REST som en kilde skal du kopiere REST JSON-svaret, som det er, eller fortolke det ved hjælp af skematilknytning. Det er kun nyttedata for svar i JSON , der understøttes.
Understøttet konfiguration
Hvis du vil konfigurere hver fane under en kopiaktivitet, skal du gå til henholdsvis følgende afsnit.
Generelt
Hvis du vil konfigurere fanen Generelt , skal du gå til Generelt.
Kilde
Følgende egenskaber understøttes for REST under fanen Kilde i en kopiaktivitet.
Følgende første tre egenskaber er påkrævet:
- Datalagertype: Vælg ekstern.
- Forbindelse: Vælg en REST-forbindelse på forbindelseslisten. Hvis der ikke findes nogen forbindelse, skal du oprette en ny REST-forbindelse ved at vælge Ny.
- Forbindelsestype: Vælg REST.
- Relativ URL-adresse: En relativ URL-adresse til den ressource, der indeholder dataene. Når denne egenskab ikke er angivet, bruges kun den URL-adresse, der er angivet i forbindelsesdefinitionen. HTTP-connectoren kopierer data fra den kombinerede URL-adresse:
[URL specified in connection]/[relative URL specified].
Under Avanceret kan du angive følgende felter:
Anmodningsmetode: HTTP-metoden. Tilladte værdier er GET (standard) og POST.
Timeout for anmodning: Timeout (tidstidsværdien) for HTTP-anmodningen for at få et svar. Denne værdi er timeout for at hente et svar, ikke timeout for læsning af svardata. Standardværdien er 00:01:40.
Anmodningsinterval (ms): Intervallet mellem forskellige anmodninger for flere sider i millisekunder. Værdien for anmodningsintervallet skal være et tal mellem [10, 60000].
Flere headere: Flere HTTP-anmodningsheadere.
Regler for sideinddeling: De regler for sideinddeling, der skal oprettes næste sideanmodninger. Se afsnittet understøttelse af sideinddeling for at få flere oplysninger.
Flere kolonner: Tilføj flere datakolonner for at gemme kildefilernes relative sti eller statiske værdi. Udtrykket understøttes for sidstnævnte.
Destination
Følgende egenskaber understøttes for REST under fanen Destination i en kopiaktivitet.
Følgende første tre egenskaber er påkrævet:
- Datalagertype: Vælg ekstern.
- Forbindelse: Vælg en REST-forbindelse på forbindelseslisten. Hvis der ikke findes nogen forbindelse, skal du oprette en ny REST-forbindelse ved at vælge Ny.
- Forbindelsestype: Vælg REST.
- Relativ URL-adresse: En relativ URL-adresse til den ressource, der indeholder dataene. Når denne egenskab ikke er angivet, bruges kun den URL-adresse, der er angivet i forbindelsesdefinitionen. HTTP-connectoren kopierer data fra den kombinerede URL-adresse:
[URL specified in connection]/[relative URL specified].
Under Avanceret kan du angive følgende felter:
Anmodningsmetode: HTTP-metoden. Tilladte værdier er POST (standard), PUT og PATCH.
Timeout for anmodning: Timeout (tidstidsværdien) for HTTP-anmodningen for at få et svar. Denne værdi er timeout for at få et svar, ikke timeout for at skrive dataene. Standardværdien er 00:01:40.
Anmodningsinterval (ms): Intervallet mellem forskellige anmodninger for flere sider i millisekunder. Værdien for anmodningsintervallet skal være et tal mellem [10, 60000].
Skriv batchstørrelse: Antal poster, der skal skrives til REST-destinationen pr. batch. Standardværdien er 10000.
Http-komprimeringstype: HTTP-komprimeringstype, der skal bruges, når der sendes data med optimalt komprimeringsniveau. Tilladte værdier er None og GZip.
Flere headere: Flere HTTP-anmodningsheadere.
Kortlægning
For konfigurationen af fanen Tilknytning skal du gå til Konfigurer dine tilknytninger under fanen Tilknytning. Tilknytning understøttes ikke, når både kilde og destination er hierarkiske data.
Indstillinger
For konfigurationen af fanen Indstillinger skal du gå til Konfigurer dine andre indstillinger under fanen Indstillinger.
Tabeloversigt
Følgende tabeller indeholder flere oplysninger om kopiaktiviteten i REST.
Kildeoplysninger
| Navn | Beskrivelse | Værdi | Påkrævet | JSON-scriptegenskab |
|---|---|---|---|---|
| Datalagertype | Typen af datalager. | • Arbejdsområde • Ekstern • Eksempeldatasæt |
Yes | type |
| Forbindelse | Din forbindelse til kildedatalageret. | <din forbindelse> | Yes | Forbindelse |
| Forbindelsestype | Din forbindelsestype. Vælg REST. | RESTEN | Yes | Type: RestResource |
| Relativ URL-adresse | En relativ URL-adresse til den ressource, der indeholder dataene. Når denne egenskab ikke er angivet, bruges kun den URL-adresse, der er angivet i forbindelsesdefinitionen. HTTP-connectoren kopierer data fra den kombinerede URL-adresse: [URL specified in connection]/[relative URL specified]. |
<din relative URL-adresse> | No | relativeUrl |
| Anmodningsmetode | HTTP-metoden. Tilladte værdier er GET (standard) og POST. | • HENT • POST |
No | requestMethod |
| Timeout for anmodning | Timeout (tidstidsværdien) for HTTP-anmodningen for at få et svar. Denne værdi er timeout for at få et svar, ikke timeout for at læse svardata. Standardværdien er 00:01:40. | Timespan | No | httpRequestTimeout |
| Anmodningsinterval (ms) | Tidsintervallet mellem forskellige anmodninger om flere sider i millisekunder. Værdien for anmodningsintervallet skal være et tal mellem [10, 60000]. | [10, 60000] | No | requestInterval |
| Flere overskrifter | Yderligere HTTP-anmodningsheadere. | <dine ekstra overskrifter> | No | additionalHeaders |
| Sideinddelingsregler | Sideinddelingsreglerne for oprettelse af næste sideanmodninger. Se afsnittet understøttelse af sideinddeling for at få flere oplysninger. | Gå til sideinddeling | No | sideinddelingsrules |
| Yderligere kolonner | Føj flere datakolonner til lagringskildefilernes relative sti eller statiske værdi. Udtrykket understøttes for sidstnævnte. | •Navn •Værdi |
No | additionalColumns: •Navn •Værdi |
Destinationsoplysninger
| Navn | Beskrivelse | Værdi | Påkrævet | JSON-scriptegenskab |
|---|---|---|---|---|
| Datalagertype | Datalagertypen. | • Arbejdsområde • Ekstern |
Yes | type |
| Forbindelse | Din forbindelse til kildedatalageret. | <din forbindelse> | Yes | Forbindelse |
| Forbindelsestype | Din forbindelsestype. Vælg REST. | RESTEN | Yes | Type: RestResource |
| Relativ URL-adresse | En relativ URL-adresse til den ressource, der indeholder dataene. Når denne egenskab ikke er angivet, bruges kun den URL-adresse, der er angivet i forbindelsesdefinitionen. HTTP-connectoren kopierer data fra den kombinerede URL-adresse: [URL specified in connection]/[relative URL specified]. |
<din relative URL-adresse> | No | relativeUrl |
| Anmodningsmetode | HTTP-metoden. Tilladte værdier er POST (standard), PUT og PATCH. | • POST • HENT • PATCH |
No | requestMethod |
| Timeout for anmodning | Timeout (tidstidsværdien) for HTTP-anmodningen for at få et svar. Denne værdi er timeout for at få et svar, ikke timeout for at læse svardata. Standardværdien er 00:01:40. | Timespan | No | httpRequestTimeout |
| Anmodningsinterval (ms) | Tidsintervallet mellem forskellige anmodninger om flere sider i millisekunder. Værdien for anmodningsintervallet skal være et tal mellem [10, 60000]. | [10, 60000] | No | requestInterval |
| Skriv batchstørrelse | Antal poster, der skal skrives til REST-destinationen pr. batch. Standardværdien er 10000. | <antal rækker> (heltal) |
No | writeBatchSize |
| Http-komprimeringstype | HTTP-komprimeringstype, der skal bruges under afsendelse af data med det optimale komprimeringsniveau. Tilladte værdier er None og GZip. | • Ingen • GZip |
No | httpCompressionType |
| Flere overskrifter | Yderligere HTTP-anmodningsheadere. | <dine ekstra overskrifter> | No | additionalHeaders |