Udostępnij za pośrednictwem

Konfigurowanie interfejsu REST w działaniu kopiowania

  • Artykuł

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

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.

Screenshot showing source tab and the list of properties.

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.

    Screenshot showing request method.

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

    Screenshot showing additional headers.

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

    Screenshot showing pagination rules.

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

    Screenshot showing additional columns.

Element docelowy

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

Screenshot showing destination tab.

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.

    Screenshot showing additional headers.

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