Konfigurera REST i en kopieringsaktivitet

Den här artikeln beskriver hur du använder kopieringsaktiviteten i en pipeline 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 as-is 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
• Källa
• Destination
• Kartläggning
• Settings

General

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:

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

  • Ytterligare anslutningsegenskaper: Ange ytterligare anslutningsegenskaper som ska användas i REST-anslutningen för att ange avancerade alternativ. Ytterligare anslutningsegenskaper tillhandahålls som en ordlista med nyckel/värde-par.

    • Inaktivera verifiering av servercertifikat: Ange om du vill verifiera TLS/SSL-certifikat på serversidan när du ansluter till slutpunkten. Det tillåtna värdet är true eller false.

      

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

  

Resmå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:

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

  • Ytterligare anslutningsegenskaper: Ange ytterligare anslutningsegenskaper som ska användas i REST-anslutningen för att ange avancerade alternativ. Ytterligare anslutningsegenskaper tillhandahålls som en ordlista med nyckel/värde-par.

    • Inaktivera verifiering av servercertifikat: Ange om du vill verifiera TLS/SSL-certifikat på serversidan när du ansluter till slutpunkten. Det tillåtna värdet är true eller false.

      

• Anslutningstyp: 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-destinationen 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.

  

Kartläggning

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 flikkonfigurationen Inställningar 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

Namn	Description	Värde	Krävs	JSON-skriptegenskap
Anslutning	Din anslutning till källdatalagret.	<din anslutning>	Yes	connection
Anslutningstyp	Din anslutningstyp. Välj REST.	REST	Yes	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.	timespan	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 fallet.	•Namn •Värde	Nej	ytterligareKolumner: •Namn • värde

Destinationsinformation

Namn	Description	Värde	Krävs	JSON-skriptegenskap
Anslutning	Din anslutning till källdatalagret.	<din anslutning>	Yes	connection
Anslutningstyp	Din anslutningstyp. Välj REST.	REST	Yes	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.	timespan	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