Konfigurer REST i en kopiaktivitet
I denne artikel beskrives det, hvordan du bruger kopiaktiviteten i datapipeline til at kopiere data fra og til et REST-slutpunkt.
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'erne.
- For REST som en kilde skal du kopiere REST JSON-svaret, som det er, eller fortolke det ved hjælp af skematilknytning. Kun nyttedata for svar i JSON understøttes.
Understøttet konfiguration
Hvis du vil konfigurere hver fane under en kopiaktivitet, skal du gå til henholdsvis følgende afsnit.
Generelt
Gå til Generelt for konfiguration af fanen Generelt.
Kilde
Følgende egenskaber understøttes for REST under fanen Kilde for en kopiaktivitet.
Følgende første tre egenskaber er påkrævet:
- Datalagertype: Vælg ekstern.
- Forbind ion: 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.
- Forbind ionstype: 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 få et svar, ikke timeout for at læse svardata. Standardværdien er 00:01:40.
Anmodningsinterval (ms): Intervallet mellem forskellige anmodninger om flere sider i millisekunder. Værdien for anmodningsintervallet skal være et tal mellem [10, 60000].
Flere headere: Flere HTTP-anmodningsheadere.
Sideinddelingsregler: De sideinddelingsregler, der skal oprettes ved 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. Hvis du bruger en statisk værdi, kan du bruge brugerdefinerede udtryk til at generere den.
Destination
Følgende egenskaber understøttes for REST under fanen Destination for en kopiaktivitet.
Følgende første tre egenskaber er påkrævet:
- Datalagertype: Vælg ekstern.
- Forbind ion: 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.
- Forbind ionstype: 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 om 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 under afsendelse af data med optimalt komprimeringsniveau. Tilladte værdier er None og GZip.
Flere headere: Flere HTTP-anmodningsheadere.
Tilknytning
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 | Obligatorisk | JSON-scriptegenskab |
|---|---|---|---|---|
| Datalagertype | Datalagertypen. | • Arbejdsområde • Ekstern • Eksempeldatasæt |
Ja | type |
| Forbind ion | Din forbindelse til kildedatalageret. | <din forbindelse> | Ja | Forbindelse |
| Forbind ionstype | Din forbindelsestype. Vælg REST. | RESTEN | Ja | Type: RestRessource |
| 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> | Nr. | relativeUrl |
| Anmodningsmetode | HTTP-metoden. Tilladte værdier er GET (standard) og POST. | • HENT • POST |
Nr. | requestMethod |
| Timeout for anmodning | Timeout (tidsangivelsesvæ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 | Nr. | httpRequestTimeout |
| Anmodningsinterval (ms) | Intervallet mellem forskellige anmodninger om flere sider i millisekunder. Værdien for anmodningsintervallet skal være et tal mellem [10, 60000]. | [10, 60000] | Nr. | requestInterval |
| Flere overskrifter | Flere HTTP-anmodningsheadere. | <dine ekstra overskrifter> | Nr. | additionalHeaders |
| Regler for sideinddeling | Reglerne for sideinddeling til oprettelse af næste sideanmodninger. Se afsnittet understøttelse af sideinddeling for at få flere oplysninger. | Gå til sideinddeling | Nr. | sideinddelingRules |
| Flere kolonner | Føj flere datakolonner til lagringskildefilernes relative sti eller statiske værdi. Udtrykket understøttes for sidstnævnte. | • Navn •Værdi |
Nr. | additionalColumns: •Navn •Værdi |
Destinationsoplysninger
| Navn | Beskrivelse | Værdi | Obligatorisk | JSON-scriptegenskab |
|---|---|---|---|---|
| Datalagertype | Datalagertypen. | • Arbejdsområde • Ekstern |
Ja | type |
| Forbind ion | Din forbindelse til kildedatalageret. | <din forbindelse> | Ja | Forbindelse |
| Forbind ionstype | Din forbindelsestype. Vælg REST. | RESTEN | Ja | Type: RestRessource |
| 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> | Nr. | relativeUrl |
| Anmodningsmetode | HTTP-metoden. Tilladte værdier er POST (standard), PUT og PATCH. | • POST • HENT • PATCH |
Nr. | requestMethod |
| Timeout for anmodning | Timeout (tidsangivelsesvæ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 | Nr. | httpRequestTimeout |
| Anmodningsinterval (ms) | Intervallet mellem forskellige anmodninger om flere sider i millisekunder. Værdien for anmodningsintervallet skal være et tal mellem [10, 60000]. | [10, 60000] | Nr. | requestInterval |
| Skriv batchstørrelse | Antal poster, der skal skrives til REST-destinationen pr. batch. Standardværdien er 10000. | <antal rækker> (heltal) |
Nr. | writeBatchSize |
| Http-komprimeringstype | HTTP-komprimeringstype, der skal bruges under afsendelse af data med optimalt komprimeringsniveau. Tilladte værdier er None og GZip. | • Ingen • GZip |
Nr. | httpCompressionType |
| Flere overskrifter | Flere HTTP-anmodningsheadere. | <dine ekstra overskrifter> | Nr. | additionalHeaders |