Konfigurera REST i en kopieringsaktivitet

Den här artikeln beskriver hur du använder kopieringsaktiviteten i datapipelinen för att kopiera data från och till en REST-slutpunkt.

Mer specifikt stöder den här allmänna REST-anslutningsappen:

• Kopiera data från en REST-slutpunkt med hjälp av GET - eller POST-metoderna och kopiera data till en REST-slutpunkt med hjälp av METODERNA POST, PUT eller PATCH .
• Sidnumrering i REST-API:erna.
• För REST som källa kopierar du REST JSON-svaret som det är eller parsar det med hjälp av schemamappning. Endast svarsnyttolasten i JSON stöds.

Konfiguration som stöds

För konfigurationen av varje flik under en kopieringsaktivitet går du till följande avsnitt.

• Allmänt
• Source
• Mål
• Mappning
• Inställningar

Allmänt

För Konfiguration av fliken Allmänt går du till Allmänt.

Källa

Följande egenskaper stöds för REST under fliken Källa i en kopieringsaktivitet.

Följande tre första egenskaper krävs:

• Datalagertyp: Välj Extern.
• Anslut ion: Välj en REST-anslutning i anslutningslistan. Om det inte finns någon anslutning skapar du en ny REST-anslutning genom att välja Ny.
• Anslut ionstyp: Välj REST.
• Relativ URL: En relativ URL till resursen som innehåller data. När den här egenskapen inte har angetts används endast den URL som anges i anslutningsdefinitionen. HTTP-anslutningsappen kopierar data från den kombinerade URL:en: [URL specified in connection]/[relative URL specified].

Under Avancerat kan du ange följande fält:

• Begärandemetod: HTTP-metoden. Tillåtna värden är GET (standard) och POST.

  

• Tidsgräns för begäran: Tidsgränsen (tidsintervallvärdet) för HTTP-begäran för att få ett svar. Det här värdet är tidsgränsen för att få ett svar, inte tidsgränsen för att läsa svarsdata. Standardvärdet är 00:01:40.

• Begärandeintervall (ms): Intervalltiden mellan olika begäranden för flera sidor i millisekunder. Värdet för begärandeintervallet ska vara ett tal mellan [10, 60000].

• Ytterligare rubriker: Ytterligare HTTP-begärandehuvuden.

  

• Sidnumreringsregler: Sidnumreringsreglerna för att skapa nästa sidbegäranden. Mer information finns i avsnittet om sidnumreringsstöd .

  

• Ytterligare kolumner: Lägg till fler datakolumner för att lagra källfilernas relativa sökväg eller statiska värde. Om du använder ett statiskt värde kan du använda anpassade uttryck för att generera det.

  

Mål

Följande egenskaper stöds för REST under fliken Mål för en kopieringsaktivitet.

Följande tre första egenskaper krävs:

• Datalagertyp: Välj Extern.
• Anslut ion: Välj en REST-anslutning i anslutningslistan. Om det inte finns någon anslutning skapar du en ny REST-anslutning genom att välja Ny.
• Anslut ionstyp: Välj REST.
• Relativ URL: En relativ URL till resursen som innehåller data. När den här egenskapen inte har angetts används endast den URL som anges i anslutningsdefinitionen. HTTP-anslutningsappen kopierar data från den kombinerade URL:en: [URL specified in connection]/[relative URL specified].

Under Avancerat kan du ange följande fält:

• Begärandemetod: HTTP-metoden. Tillåtna värden är POST (standard), PUT och PATCH.

• Tidsgräns för begäran: Tidsgränsen (tidsintervallvärdet) för HTTP-begäran för att få ett svar. Det här värdet är tidsgränsen för att få ett svar, inte tidsgränsen för att skriva data. Standardvärdet är 00:01:40.

• Begärandeintervall (ms): Intervalltiden mellan olika begäranden för flera sidor i millisekunder. Värdet för begärandeintervallet ska vara ett tal mellan [10, 60000].

• Skriv batchstorlek: Antal poster som ska skrivas till REST-målet per batch. Standardvärdet är 10000.

• Http-komprimeringstyp: HTTP-komprimeringstyp som ska användas när data skickas med optimal komprimeringsnivå. Tillåtna värden är None och GZip.

• Ytterligare rubriker: Ytterligare HTTP-begärandehuvuden.

  

Mappning

För konfigurationen av fliken Mappning går du till Konfigurera dina mappningar under mappningsfliken. Mappning stöds inte när både källa och mål är hierarkiska data.

Inställningar

För Inställningar flikkonfiguration går du till Konfigurera dina andra inställningar under fliken Inställningar.

Tabellsammanfattning

Följande tabeller innehåller mer information om kopieringsaktiviteten i REST.

Källinformation

Name	Beskrivning	Värde	Obligatoriskt	JSON-skriptegenskap
Typ av datalager	Din datalagertyp.	• Arbetsyta • Extern • Exempeldatauppsättning	Ja	type
Anslutning	Din anslutning till källdatalagret.	<din anslutning>	Ja	anslutning
Anslutningstyp	Din anslutningstyp. Välj REST.	REST	Ja	typ: RestResource
Relativ URL	En relativ URL till resursen som innehåller data. När den här egenskapen inte har angetts används endast den URL som anges i anslutningsdefinitionen. HTTP-anslutningsappen kopierar data från den kombinerade URL:en: [URL specified in connection]/[relative URL specified].	<din relativa URL>	Nej	relativeUrl
Begärandemetod	HTTP-metoden. Tillåtna värden är GET (standard) och POST.	• GET • POST	Nej	requestMethod
Tidsgräns för begäran	Tidsgränsen (tidsintervallvärdet) för HTTP-begäran för att få ett svar. Det här värdet är tidsgränsen för att få ett svar, inte tidsgränsen för att läsa svarsdata. Standardvärdet är 00:01:40.	tidsintervall	Nej	httpRequestTimeout
Begärandeintervall (ms)	Intervalltiden mellan olika begäranden för flera sidor i millisekunder. Värdet för begärandeintervallet ska vara ett tal mellan [10, 60000].	[10, 60000]	Nej	requestInterval
Ytterligare rubriker	Ytterligare HTTP-begärandehuvuden.	<dina ytterligare rubriker>	Nej	additionalHeaders
Sidnumreringsregler	Sidnumreringsreglerna för att skapa nästa sidbegäranden. Mer information finns i avsnittet om sidnumreringsstöd .	Gå till sidnumrering	Nej	paginationRules
Ytterligare kolumner	Lägg till fler datakolumner i lagringskällans relativa sökväg eller statiska värde. Uttrycket stöds för det senare.	• Namn •Värde	Nej	additionalColumns: •Namn •Värde

Målinformation

Name	Beskrivning	Värde	Obligatoriskt	JSON-skriptegenskap
Typ av datalager	Din datalagertyp.	• Arbetsyta • Extern	Ja	type
Anslutning	Din anslutning till källdatalagret.	<din anslutning>	Ja	anslutning
Anslutningstyp	Din anslutningstyp. Välj REST.	REST	Ja	typ: RestResource
Relativ URL	En relativ URL till resursen som innehåller data. När den här egenskapen inte har angetts används endast den URL som anges i anslutningsdefinitionen. HTTP-anslutningsappen kopierar data från den kombinerade URL:en: [URL specified in connection]/[relative URL specified].	<din relativa URL>	Nej	relativeUrl
Begärandemetod	HTTP-metoden. Tillåtna värden är POST (standard), PUT och PATCH.	• POST • GET • PATCH	Nej	requestMethod
Tidsgräns för begäran	Tidsgränsen (tidsintervallvärdet) för HTTP-begäran för att få ett svar. Det här värdet är tidsgränsen för att få ett svar, inte tidsgränsen för att läsa svarsdata. Standardvärdet är 00:01:40.	tidsintervall	Nej	httpRequestTimeout
Begärandeintervall (ms)	Intervalltiden mellan olika begäranden för flera sidor i millisekunder. Värdet för begärandeintervallet ska vara ett tal mellan [10, 60000].	[10, 60000]	Nej	requestInterval
Skriv batchstorlek	Antal poster som ska skrivas till REST-målet per batch. Standardvärdet är 10000.	<antal rader> (heltal)	Nej	writeBatchSize
Http-komprimeringstyp	HTTP-komprimeringstyp som ska användas när data skickas med optimal komprimeringsnivå. Tillåtna värden är None och GZip.	• Ingen • GZip	Nej	httpCompressionType
Ytterligare rubriker	Ytterligare HTTP-begärandehuvuden.	<dina ytterligare rubriker>	Nej	additionalHeaders

Relaterat innehåll

• Så här skapar du en REST-anslutning