Del via

Konfigurer REST i en kopiaktivitet

  • Artikkel

Denne artikkelen beskriver hvordan du bruker kopieringsaktiviteten i datasamlebåndet til å kopiere data fra og til et REST-endepunkt.

Spesielt 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-ene.
  • 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 konfigurasjon av fanen Generelt , kan du gå til Generelt.

Source

Følgende egenskaper støttes for REST under Kilde-fanen for en kopiaktivitet.

Screenshot showing source tab and the list of properties.

Følgende tre første egenskaper kreves:

  • Datalagertype: Velg ekstern.
  • Koble til ion: Velg en REST-tilkobling fra tilkoblingslisten. Hvis det ikke finnes noen tilkobling, oppretter du en ny REST-tilkobling ved å velge Ny.
  • Koble til iontype: 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.

    Screenshot showing request method.

  • Tidsavbrudd for forespørsel: Tidsavbruddet (tidsintervallverdien) for HTTP-forespørselen for å få svar. Denne verdien er tidsavbruddet for å få svar, ikke tidsavbruddet for å lese svardata. Standardverdien er 00:01:40.

  • Forespørselsintervall (ms): Intervalltiden mellom ulike forespørsler for flere sider i millisekunder. Forespørselsintervallverdien må være et tall mellom [10, 60000].

  • Flere overskrifter: Flere HTTP-forespørselshoder.

    Screenshot showing additional headers.

  • Pagineringsregler: Pagineringsreglene for å skrive neste sideforespørsler. Se sideformateringsstøttedelen for mer informasjon.

    Screenshot showing pagination rules.

  • Flere kolonner: Legg til flere datakolonner for å lagre kildefilens relative bane eller statiske verdi. Hvis du bruker en statisk verdi, kan du bruke egendefinerte uttrykk til å generere den.

    Screenshot showing additional columns.

Mål

Følgende egenskaper støttes for REST under Mål-fanen for en kopiaktivitet.

Screenshot showing destination tab.

Følgende tre første egenskaper kreves:

  • Datalagertype: Velg ekstern.
  • Koble til ion: Velg en REST-tilkobling fra tilkoblingslisten. Hvis det ikke finnes noen tilkobling, oppretter du en ny REST-tilkobling ved å velge Ny.
  • Koble til iontype: 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å svar, ikke tidsavbruddet for å skrive dataene. Standardverdien er 00:01:40.

  • Forespørselsintervall (ms): Intervalltiden mellom ulike forespørsler for flere sider i millisekunder. Forespørselsintervallverdien må være et tall mellom [10, 60000].

  • Skrive bunkestørrelse: Antall poster som skal skrives til REST-målet per bunke. Standardverdien er 10000.

  • 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.

    Screenshot showing additional headers.

Tilordning

Gå til Konfigurer tilordningene under tilordningsfanen for fanen Tilordning. 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 konfigurasjon av Innstillinger-fanen.

Tabellsammendrag

Tabellene nedenfor inneholder mer informasjon om kopieringsaktiviteten i REST.

Kildeinformasjon

Name Beskrivelse Verdi Kreves JSON-skriptegenskap
Datalagertype Datalagertypen. • Arbeidsområde
• Ekstern
• Eksempel på datasett
 Ja type
Koble til ion Tilkoblingen til kildedatalageret. <tilkoblingen> Ja Tilkobling
Koble til iontype Tilkoblingstypen. Velg REST. RESTEN Ja Type:
RestResource
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]. <din relative url-adresse> No relativeUrl
Forespørselsmetode HTTP-metoden. Tillatte verdier er GET (standard) og POST. • HENT
• POST		 No requestMethod
Tidsavbrudd for forespørsel Tidsavbruddet (tidsintervallverdien) for HTTP-forespørselen for å få svar. Denne verdien er tidsavbruddet for å få svar, ikke tidsavbruddet for å lese svardata. Standardverdien er 00:01:40. Tidsrom No 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] No requestInterval
Flere topptekster Flere HTTP-forespørselshoder. <de ekstra topptekstene> No additionalHeaders
Pagineringsregler Pagineringsreglene for å skrive neste sideforespørsler. Se sideformateringsstøttedelen for mer informasjon. Gå til paginering No pagineringsregler
Flere kolonner Legg til flere datakolonner i lagerkildefilens relative bane eller statiske verdi. Uttrykket støttes for sistnevnte. • Navn
•Verdi		 No additionalColumns:
•navn
•Verdi

Målinformasjon

Name Beskrivelse Verdi Kreves JSON-skriptegenskap
Datalagertype Datalagertypen. • Arbeidsområde
• Ekstern		 Ja type
Koble til ion Tilkoblingen til kildedatalageret. <tilkoblingen> Ja Tilkobling
Koble til iontype Tilkoblingstypen. Velg REST. RESTEN Ja Type:
RestResource
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]. <din relative url-adresse> No relativeUrl
Forespørselsmetode HTTP-metoden. Tillatte verdier er POST (standard), PUT og PATCH. • POST
• HENT
• PATCH 		No requestMethod
Tidsavbrudd for forespørsel Tidsavbruddet (tidsintervallverdien) for HTTP-forespørselen for å få svar. Denne verdien er tidsavbruddet for å få svar, ikke tidsavbruddet for å lese svardata. Standardverdien er 00:01:40. Tidsrom No 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] No requestInterval
Skrive bunkestørrelse Antall poster som skal skrives til REST-målet per bunke. Standardverdien er 10000. <antall rader>
(heltall)		 No writeBatchSize
Http-komprimeringstype HTTP-komprimeringstype som skal brukes under sending av data med optimalt komprimeringsnivå. Tillatte verdier er Ingen og GZip. • Ingen
• GZip		 No httpCompressionType
Flere topptekster Flere HTTP-forespørselshoder. <de ekstra topptekstene> No additionalHeaders

Relatert innhold