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