Konfigurowanie interfejsu REST w działaniu kopiowania

W tym artykule opisano sposób używania działania kopiowania w potoku danych do kopiowania danych z i do punktu końcowego REST.

W szczególności ten ogólny łącznik REST obsługuje następujące elementy:

• Kopiowanie danych z punktu końcowego REST przy użyciu metod GET lub POST i kopiowanie danych do punktu końcowego REST przy użyciu metod POST, PUT lub PATCH .
• Stronicowanie w interfejsach API REST.
• W przypadku interfejsu REST jako źródła skopiuj odpowiedź REST JSON zgodnie z rzeczywistym użyciem lub przeanalizuj ją przy użyciu mapowania schematu. Obsługiwany jest tylko ładunek odpowiedzi w formacie JSON .

Obsługiwana konfiguracja

W przypadku konfiguracji każdej karty w działaniu kopiowania przejdź odpowiednio do poniższych sekcji.

• Ogólne
• Source
• Lokalizacja docelowa
• Mapowania
• Ustawienia

Ogólne

W obszarze Konfiguracja karty Ogólne przejdź do pozycji Ogólne.

Źródło

Następujące właściwości są obsługiwane w przypadku architektury REST na karcie Źródło działania kopiowania.

Wymagane są następujące trzy pierwsze właściwości:

• Typ magazynu danych: wybierz pozycję Zewnętrzne.
• Połączenie ion: wybierz połączenie REST z listy połączeń. Jeśli połączenie nie istnieje, utwórz nowe połączenie REST, wybierając pozycję Nowy.
• typ Połączenie ion: wybierz pozycję REST.
• Względny adres URL: względny adres URL zasobu, który zawiera dane. Jeśli ta właściwość nie jest określona, używany jest tylko adres URL określony w definicji połączenia. Łącznik HTTP kopiuje dane z połączonego adresu URL: [URL specified in connection]/[relative URL specified].

W obszarze Zaawansowane można określić następujące pola:

• Metoda żądania: metoda HTTP. Dozwolone wartości to GET (wartość domyślna) i POST.

  

• Limit czasu żądania: limit czasu (wartość przedziału czasu) żądania HTTP w celu uzyskania odpowiedzi. Ta wartość to limit czasu pobierania odpowiedzi, a nie limit czasu odczytu danych odpowiedzi. Wartość domyślna to 00:01:40.

• Interwał żądania (ms): czas interwału między różnymi żądaniami dla wielu stron w milisekundach. Wartość interwału żądania powinna być liczbą z zakresu od [10, 60000].

• Dodatkowe nagłówki: dodatkowe nagłówki żądań HTTP.

  

• Reguły stronicowania: reguły stronicowania do tworzenia żądań następnej strony. Aby uzyskać szczegółowe informacje, zapoznaj się z sekcją pomocy technicznej dotyczącej stronicowania .

  

• Dodatkowe kolumny: dodaj więcej kolumn danych, aby przechowywać ścieżkę względną plików źródłowych lub wartość statyczną. Jeśli używasz wartości statycznej, możesz użyć wyrażeń niestandardowych , aby je wygenerować.

  

Element docelowy

Następujące właściwości są obsługiwane w przypadku interfejsu REST na karcie Miejsce docelowe działania kopiowania.

Wymagane są następujące trzy pierwsze właściwości:

• Typ magazynu danych: wybierz pozycję Zewnętrzne.
• Połączenie ion: wybierz połączenie REST z listy połączeń. Jeśli połączenie nie istnieje, utwórz nowe połączenie REST, wybierając pozycję Nowy.
• typ Połączenie ion: wybierz pozycję REST.
• Względny adres URL: względny adres URL zasobu, który zawiera dane. Jeśli ta właściwość nie jest określona, używany jest tylko adres URL określony w definicji połączenia. Łącznik HTTP kopiuje dane z połączonego adresu URL: [URL specified in connection]/[relative URL specified].

W obszarze Zaawansowane można określić następujące pola:

• Metoda żądania: metoda HTTP. Dozwolone wartości to POST (wartość domyślna), PUT i PATCH.

• Limit czasu żądania: limit czasu (wartość przedziału czasu) żądania HTTP w celu uzyskania odpowiedzi. Ta wartość to limit czasu pobierania odpowiedzi, a nie limit czasu zapisu danych. Wartość domyślna to 00:01:40.

• Interwał żądania (ms): czas interwału między różnymi żądaniami dla wielu stron w milisekundach. Wartość interwału żądania powinna być liczbą z zakresu od [10, 60000].

• Rozmiar partii zapisu: liczba rekordów do zapisu w miejscu docelowym REST na partię. Wartość domyślna to 10000.

• Typ kompresji HTTP: typ kompresji HTTP do użycia podczas wysyłania danych z optymalnym poziomem kompresji. Dozwolone wartości to None i GZip.

• Dodatkowe nagłówki: dodatkowe nagłówki żądań HTTP.

  

Mapowanie

W przypadku konfiguracji karty Mapowanie przejdź do tematu Konfigurowanie mapowań na karcie mapowania. Mapowanie nie jest obsługiwane, gdy zarówno źródło, jak i miejsce docelowe są danymi hierarchicznymi.

Ustawienia

W przypadku konfiguracji karty Ustawienia przejdź do sekcji Konfigurowanie innych ustawień na karcie ustawienia.

Podsumowanie tabeli

Poniższe tabele zawierają więcej informacji na temat działania kopiowania w architekturze REST.

Informacje źródłowe

Nazwa/nazwisko	Opis	Wartość	Wymagania	Właściwość skryptu JSON
Typ magazynu danych	Typ magazynu danych.	• Obszar roboczy • Zewnętrzne • Przykładowy zestaw danych	Tak	type
Połączenie	Połączenie ze źródłowym magazynem danych.	<połączenie>	Tak	połączenie
Connection type (Typ połączenia)	Typ połączenia. Wybierz pozycję REST.	REST	Tak	type: RestResource
Względny adres URL	Względny adres URL zasobu, który zawiera dane. Jeśli ta właściwość nie jest określona, używany jest tylko adres URL określony w definicji połączenia. Łącznik HTTP kopiuje dane z połączonego adresu URL: [URL specified in connection]/[relative URL specified].	<względny adres URL>	Nie.	relativeUrl
Metoda żądania	Metoda HTTP. Dozwolone wartości to GET (wartość domyślna) i POST.	• GET • POST	Nie.	requestMethod
Limit czasu żądania	Limit czasu (wartość przedziału czasu) żądania HTTP w celu uzyskania odpowiedzi. Ta wartość to limit czasu pobierania odpowiedzi, a nie limit czasu odczytu danych odpowiedzi. Wartość domyślna to 00:01:40.	zakres czasu	Nie.	httpRequestTimeout
Interwał żądania (ms)	Czas interwału między różnymi żądaniami dla wielu stron w milisekundach. Wartość interwału żądania powinna być liczbą z zakresu od [10, 60000].	[10, 60000]	Nie.	requestInterval
Dodatkowe nagłówki	Dodatkowe nagłówki żądań HTTP.	<dodatkowe nagłówki>	Nie.	dodatkowe ściągniki
Reguły stronicowania	Reguły stronicowania do tworzenia żądań następnej strony. Aby uzyskać szczegółowe informacje, zapoznaj się z sekcją pomocy technicznej dotyczącej stronicowania .	Przejdź do stronicowania	Nie.	paginationRules
Dodatkowe kolumny	Dodaj więcej kolumn danych do ścieżki względnej lub wartości statycznej plików źródłowych. Wyrażenie jest obsługiwane w przypadku tych ostatnich.	• Nazwa •Wartość	Nie.	additionalColumns: •Nazwa •Wartość

Informacje o lokalizacji docelowej

Nazwa/nazwisko	Opis	Wartość	Wymagania	Właściwość skryptu JSON
Typ magazynu danych	Typ magazynu danych.	• Obszar roboczy • Zewnętrzne	Tak	type
Połączenie	Połączenie ze źródłowym magazynem danych.	<połączenie>	Tak	połączenie
Connection type (Typ połączenia)	Typ połączenia. Wybierz pozycję REST.	REST	Tak	type: RestResource
Względny adres URL	Względny adres URL zasobu, który zawiera dane. Jeśli ta właściwość nie jest określona, używany jest tylko adres URL określony w definicji połączenia. Łącznik HTTP kopiuje dane z połączonego adresu URL: [URL specified in connection]/[relative URL specified].	<względny adres URL>	Nie.	relativeUrl
Metoda żądania	Metoda HTTP. Dozwolone wartości to POST (wartość domyślna), PUT i PATCH.	• POST • GET • PATCH	Nie.	requestMethod
Limit czasu żądania	Limit czasu (wartość przedziału czasu) żądania HTTP w celu uzyskania odpowiedzi. Ta wartość to limit czasu pobierania odpowiedzi, a nie limit czasu odczytu danych odpowiedzi. Wartość domyślna to 00:01:40.	zakres czasu	Nie.	httpRequestTimeout
Interwał żądania (ms)	Czas interwału między różnymi żądaniami dla wielu stron w milisekundach. Wartość interwału żądania powinna być liczbą z zakresu od [10, 60000].	[10, 60000]	Nie.	requestInterval
Rozmiar partii zapisu	Liczba rekordów do zapisu w miejscu docelowym REST na partię. Wartość domyślna to 10000.	<liczba wierszy> (liczba całkowita)	Nie.	writeBatchSize
Typ kompresji HTTP	Typ kompresji HTTP do użycia podczas wysyłania danych z optymalnym poziomem kompresji. Dozwolone wartości to None i GZip.	• Brak • GZip	Nie.	httpCompressionType
Dodatkowe nagłówki	Dodatkowe nagłówki żądań HTTP.	<dodatkowe nagłówki>	Nie.	dodatkowe ściągniki

Powiązana zawartość

• Jak utworzyć połączenie REST