Udostępnij za pośrednictwem

Rozwiązywanie problemów z łącznikiem REST w usługach Azure Data Factory i Azure Synapse

  • Artykuł

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

Ten artykuł zawiera sugestie dotyczące rozwiązywania typowych problemów z łącznikiem REST w usłudze Azure Data Factory i usłudze Azure Synapse.

Kod błędu: RestSinkCallFailed

  • Komunikat: Rest Endpoint responded with Failure from server. Check the error from server:%message;

  • Przyczyna: Ten błąd występuje, gdy fabryka danych lub potok usługi Synapse rozmawia z punktem końcowym REST za pośrednictwem protokołu HTTP, a operacja żądania kończy się niepowodzeniem.

  • Zalecenie: Sprawdź kod stanu HTTP lub komunikat w komunikacie o błędzie i rozwiąż problem z serwerem zdalnym.

Kod błędu: RestSourceCallFailed

  • Komunikat: The HttpStatusCode %statusCode; indicates failure.
Request URL: %requestUri;
Response payload:%payload;

  • Przyczyna: Ten błąd występuje, gdy usługa Azure Data Factory komunikuje się z punktem końcowym REST za pośrednictwem protokołu HTTP, a operacja żądania kończy się niepowodzeniem.

  • Zalecenie: Sprawdź kod stanu HTTP lub adres URL żądania lub ładunek odpowiedzi w komunikacie o błędzie i rozwiąż problem z serwerem zdalnym.

Kod błędu: RestSinkUNSupportedCompressionType

  • Komunikat: User Configured CompressionType is Not Supported By Azure Data Factory：%message;

  • Zalecenie: Sprawdź obsługiwane typy kompresji dla ujścia REST.

Nieoczekiwana odpowiedź sieci z łącznika REST

  • Objawy: Punkt końcowy czasami otrzymuje nieoczekiwaną odpowiedź (400, 401, 403, 500) z łącznika REST.

  • Przyczyna: Łącznik źródła REST używa adresu URL i metody HTTP/nagłówka/treści z połączonej usługi/zestawu danych/źródła kopii jako parametrów podczas konstruowania żądania HTTP. Problem jest najprawdopodobniej spowodowany nieprawidłowościami w co najmniej jednym określonym parametrze.

  • Rozwiązanie:

    • Użyj polecenia "curl" w oknie wiersza polecenia, aby sprawdzić, czy parametr jest przyczyną (nagłówki Accept i User-Agent powinny być zawsze dołączone):

      curl -i -X <HTTP method> -H <HTTP header1> -H <HTTP header2> -H "Accept: application/json" -H "User-Agent: azure-data-factory/2.0" -d '<HTTP body>' <URL>

      Jeśli polecenie zwróci tę samą nieoczekiwaną odpowiedź, napraw powyższe parametry z wartością "curl", dopóki nie zwróci oczekiwanej odpowiedzi.

      Możesz również użyć polecenia "curl--help", aby uzyskać bardziej zaawansowane użycie polecenia.

    • Jeśli tylko łącznik REST zwróci nieoczekiwaną odpowiedź, skontaktuj się z pomocą techniczną firmy Microsoft, aby podjąć dalsze działania w celu rozwiązania problemu.

    • Należy pamiętać, że polecenie "curl" może nie być odpowiednie do odtworzenia problemu z weryfikacją certyfikatu SSL. W niektórych scenariuszach polecenie "curl" zostało wykonane pomyślnie bez napotkania problemów z walidacją certyfikatu SSL. Ale gdy ten sam adres URL jest wykonywany w przeglądarce, żaden certyfikat SSL nie jest rzeczywiście zwracany dla klienta w celu ustanowienia zaufania z serwerem.

      W poprzednim przypadku zalecane są narzędzia takie jak Fiddler .

Certyfikat jednostki usługi w usłudze Azure Key Vault nie jest poprawny

  • Komunikat: "Failed to create certificate from certificate raw data and password. Cannot find the requested object."
  • Przyczyna: Tylko obsługa certyfikatu jednostki usługi ciągu base64 dla uwierzytelniania certyfikatu jednostki usługi łącznika REST.
  • Zalecenie: postępuj zgodnie z tą sekcją , aby poprawnie zapisać certyfikat jednostki usługi w usłudze Azure Key Vault.

Powiązana zawartość

Aby uzyskać pomoc dotyczącą rozwiązywania problemów, wypróbuj następujące zasoby: