Slik konfigurerer du REST i en kopiaktivitet
Denne artikkelen beskriver hvordan du bruker kopieringsaktiviteten i datasamlebåndet til å kopiere data fra og til et REST-endepunkt.
Viktig
Microsoft Fabric er for øyeblikket i FORHÅNDSVERSJON. Denne informasjonen er knyttet til et forhåndsutgitt produkt som kan endres vesentlig før det utgis. Microsoft gir ingen garantier, uttrykt eller underforstått, med hensyn til informasjonen som er oppgitt her. Se Azure Data Factory dokumentasjon for tjenesten i Azure.
Nærmere bestemt støtter denne generiske REST-koblingen:
- Kopiere data fra et REST-endepunkt ved hjelp av GET - eller POST-metodene og kopiere data til et REST-endepunkt ved hjelp av METODENE POST, PUT eller PATCH .
- Paginering i REST-API-er.
- For REST som kilde kopierer du REST JSON-svaret som det er eller analyserer det ved hjelp av skjematilordning. Bare nyttelasten for svar i JSON støttes.
Støttet konfigurasjon
Hvis du vil ha konfigurasjonen av hver fane under en kopiaktivitet, kan du gå til følgende inndelinger.
Generelt
Hvis du vil ha generell fanekonfigurasjon, kan du gå til Generelt.
Kilde
Følgende egenskaper støttes for REST under Kilde-fanen for en kopiaktivitet.
Følgende tre første egenskaper kreves:
- Datalagertype: Velg Ekstern.
- Tilkobling: Velg en REST-tilkobling fra tilkoblingslisten. Hvis det ikke finnes noen tilkobling, oppretter du en ny REST-tilkobling ved å velge Ny.
- Tilkoblingstype: Velg REST.
- Relativ URL-adresse: En relativ URL-adresse til ressursen som inneholder dataene. Når denne egenskapen ikke er angitt, brukes bare URL-adressen som er angitt i tilkoblingsdefinisjonen. HTTP-koblingen kopierer data fra den kombinerte URL-adressen:
[URL specified in connection]/[relative URL specified].
Under Avansert kan du angi følgende felt:
Forespørselsmetode: HTTP-metoden. Tillatte verdier er GET (standard) og POST.
Tidsavbrudd for forespørsel: Tidsavbruddet (tidsintervallverdien) for HTTP-forespørselen for å få svar. Denne verdien er tidsavbruddet for å få et svar, ikke tidsavbruddet for å lese svardata. Standardverdien er 00:01:40.
Forespørselsintervall (ms): Intervalltiden mellom ulike forespørsler for flere sider i millisekunder. Verdien for forespørselsintervall må være et tall mellom [10, 60000].
Flere overskrifter: Flere HTTP-forespørselshoder.
Pagineringsregler: Pagineringsreglene for å skrive neste sideforespørsler. Se sideformateringsstøttedelen for mer informasjon.
Flere kolonner: Legg til flere datakolonner for å lagre kildefilens relative bane eller statiske verdi. Uttrykket støttes for sistnevnte.
Mål
Følgende egenskaper støttes for REST under Mål-fanen for en kopiaktivitet.
Følgende tre første egenskaper kreves:
- Datalagertype: Velg Ekstern.
- Tilkobling: Velg en REST-tilkobling fra tilkoblingslisten. Hvis det ikke finnes noen tilkobling, oppretter du en ny REST-tilkobling ved å velge Ny.
- Tilkoblingstype: Velg REST.
- Relativ URL-adresse: En relativ URL-adresse til ressursen som inneholder dataene. Når denne egenskapen ikke er angitt, brukes bare URL-adressen som er angitt i tilkoblingsdefinisjonen. HTTP-koblingen kopierer data fra den kombinerte URL-adressen:
[URL specified in connection]/[relative URL specified].
Under Avansert kan du angi følgende felt:
Forespørselsmetode: HTTP-metoden. Tillatte verdier er POST (standard), PUT og PATCH.
Tidsavbrudd for forespørsel: Tidsavbruddet (tidsintervallverdien) for HTTP-forespørselen for å få svar. Denne verdien er tidsavbruddet for å få et svar, ikke tidsavbruddet for å skrive dataene. Standardverdien er 00:01:40.
Forespørselsintervall (ms): Intervalltiden mellom ulike forespørsler for flere sider i millisekunder. Verdien for forespørselsintervall må være et tall mellom [10, 60000].
Skrive bunkestørrelse: Antall poster som skal skrives til REST-målet per bunke. Standardverdien er 10 000.
Http-komprimeringstype: HTTP-komprimeringstype som skal brukes under sending av data med optimalt komprimeringsnivå. Tillatte verdier er Ingen og GZip.
Flere overskrifter: Flere HTTP-forespørselshoder.
Kartlegging
Gå til Konfigurer tilordningene under tilordningsfanen for konfigurasjonen tilordningsfanen. Tilordning støttes ikke når både kilde og mål er hierarkiske data.
Innstillinger
Gå til Konfigurer de andre innstillingene under Innstillinger-fanen for konfigurasjonen av Innstillinger-fanen.
Tabellsammendrag
Tabellene nedenfor inneholder mer informasjon om kopieringsaktiviteten i REST.
Kildeinformasjon
| Navn | Beskrivelse | Verdi | Obligatorisk | JSON-skriptegenskap |
|---|---|---|---|---|
| Datalagertype | Datalagertypen. | • Arbeidsområde • Ekstern • Eksempeldatasett |
Ja | type |
| Tilkobling | Tilkoblingen til kildedatalageret. | <tilkoblingen> | Ja | Tilkobling |
| Tilkoblingstype | Tilkoblingstypen. Velg REST. | RESTEN | Ja | Type: RestResource |
| Relativ nettadresse | En relativ URL-adresse til ressursen som inneholder dataene. Når denne egenskapen ikke er angitt, brukes bare URL-adressen som er angitt i tilkoblingsdefinisjonen. HTTP-koblingen kopierer data fra den kombinerte URL-adressen: [URL specified in connection]/[relative URL specified]. |
<den relative url-adressen> | Nei | relativeUrl |
| Forespørselsmetode | HTTP-metoden. Tillatte verdier er HENT (standard) og POST. | • HENT • POST |
Nei | requestMethod |
| Tidsavbrudd for forespørsel | Tidsavbruddet (tidsintervallverdien) for HTTP-forespørselen for å få svar. Denne verdien er tidsavbruddet for å få et svar, ikke tidsavbruddet for å lese svardata. Standardverdien er 00:01:40. | Tidsrom | Nei | httpRequestTimeout |
| Forespørselsintervall (ms) | Intervalltiden mellom ulike forespørsler for flere sider i millisekunder. Forespørselsintervallverdien må være et tall mellom [10, 60000]. | [10, 60000] | Nei | requestInterval |
| Flere topptekster | Flere HTTP-forespørselshoder. | <de ekstra topptekstene> | Nei | additionalHeaders |
| Pagineringsregler | Sideformateringsreglene for å skrive forespørsler på neste side. Se støttedelen for sideformatering for mer informasjon. | Gå til paginering | Nei | pagineringsrules |
| Flere kolonner | Legg til flere datakolonner i lagerkildefilens relative bane eller statiske verdi. Uttrykket støttes for sistnevnte. | •Navn •Verdi |
Nei | additionalColumns: •navn •Verdi |
Målinformasjon
| Navn | Beskrivelse | Verdi | Obligatorisk | JSON-skriptegenskap |
|---|---|---|---|---|
| Datalagertype | Datalagertypen. | • Arbeidsområde • Ekstern |
Ja | type |
| Tilkobling | Tilkoblingen til kildedatalageret. | <tilkoblingen> | Ja | Tilkobling |
| Tilkoblingstype | Tilkoblingstypen. Velg REST. | RESTEN | Ja | Type: RestResource |
| Relativ nettadresse | En relativ URL-adresse til ressursen som inneholder dataene. Når denne egenskapen ikke er angitt, brukes bare URL-adressen som er angitt i tilkoblingsdefinisjonen. HTTP-koblingen kopierer data fra den kombinerte URL-adressen: [URL specified in connection]/[relative URL specified]. |
<den relative url-adressen> | Nei | relativeUrl |
| Forespørselsmetode | HTTP-metoden. Tillatte verdier er POST (standard), PUT og PATCH. | • POST • HENT • PATCH |
Nei | requestMethod |
| Tidsavbrudd for forespørsel | Tidsavbruddet (tidsintervallverdien) for HTTP-forespørselen for å få svar. Denne verdien er tidsavbruddet for å få et svar, ikke tidsavbruddet for å lese svardata. Standardverdien er 00:01:40. | Tidsrom | Nei | httpRequestTimeout |
| Forespørselsintervall (ms) | Intervalltiden mellom ulike forespørsler for flere sider i millisekunder. Forespørselsintervallverdien må være et tall mellom [10, 60000]. | [10, 60000] | Nei | requestInterval |
| Størrelse på skrivegruppe | Antall poster som skal skrives til REST-målet per bunke. Standardverdien er 10 000. | <antall rader> (heltall) |
Nei | writeBatchSize |
| Http-komprimeringstype | HTTP-komprimeringstype som skal brukes under sending av data med optimalt komprimeringsnivå. Tillatte verdier er Ingen og GZip. | • Ingen • GZip |
Nei | httpCompressionType |
| Flere topptekster | Flere HTTP-forespørselshoder. | <de ekstra topptekstene> | Nei | additionalHeaders |