다음을 통해 공유

Azure Data Factory 및 Azure Synapse에서 REST 커넥터 문제 해결

  • 아티클

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!

이 문서에서는 Azure Data Factory 및 Azure Synapse의 REST 커넥터와 관련된 일반적인 문제를 해결하기 위한 제안 사항을 제공합니다.

오류 코드: RestSinkCallFailed

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

  • 원인: 이 오류는 데이터 팩터리 또는 Synapse 파이프라인이 HTTP 프로토콜을 통해 REST 엔드포인트와 통신하는데 요청 작업이 실패한 경우 발생합니다.

  • 권장 사항: 오류 메시지에서 HTTP 상태 코드 또는 메시지를 확인하고 원격 서버 문제를 해결합니다.

오류 코드: RestSourceCallFailed

  • 메시지: The HttpStatusCode %statusCode; indicates failure.
Request URL: %requestUri;
Response payload:%payload;

  • 원인: 이 오류는 Azure Data Factory가 HTTP 프로토콜을 통해 REST 엔드포인트와 통신하는데 요청 작업이 실패한 경우 발생합니다.

  • 권장 사항: 오류 메시지에서 HTTP 상태 코드 또는 요청 URL이나 응답 페이로드를 확인하고 원격 서버 문제를 해결합니다.

오류 코드: RestSinkUNSupportedCompressionType

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

  • 권장 사항: REST 싱크에 대해 지원되는 압축 유형을 확인합니다.

REST 커넥터의 예기치 않은 네트워크 응답

  • 증상: 엔드포인트가 REST 커넥터에서 예기치 않은 응답(400, 401, 403, 500)을 수신하는 경우가 있습니다.

  • 원인: REST 원본 커넥터는 HTTP 요청을 생성할 때 연결된 서비스/데이터 세트/복사 원본의 URL 및 HTTP 메서드/헤더/본문을 매개 변수로 사용합니다. 이 문제는 하나 이상의 지정된 매개 변수에서 일부 실수로 인해 발생할 가능성이 높습니다.

  • 해결 방법:

    • 명령 프롬프트 창에서 ‘curl’을 사용하여 매개 변수가 원인인지 확인합니다(Accept 헤더와 User-Agent 헤더는 항상 포함되어야 합니다).

      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>

      명령이 전과 같이 예기치 않은 응답을 반환한다면 예상 응답을 반환할 때까지 앞에 나온 매개 변수를 ‘curl’을 사용하여 수정해 봅니다.

      ‘curl--help’를 사용하면 명령의 고급 사용법을 확인할 수 있습니다.

    • REST 커넥터만 예기치 않은 응답을 반환하는 경우 추가 문제 해결을 위해 Microsoft 지원에 문의하세요.

    • ‘curl’은 SSL 인증서 유효성 검사 문제를 재현하는 데 적합하지 않을 수 있습니다. 일부 시나리오에서는 SSL 인증서 유효성 검사 문제없이 ‘curl’ 명령이 성공적으로 실행됩니다. 하지만 동일한 URL이 브라우저에서 실행될 경우, 클라이언트가 서버와 신뢰를 설정할 수 있도록 하기 위한 SSL 인증서가 반환되지 않습니다.

      이전 사례에는 Fiddler 같은 도구가 권장됩니다.

Azure Key Vault의 서비스 주체 인증서가 올바르지 않음

  • 메시지: "Failed to create certificate from certificate raw data and password. Cannot find the requested object."
  • 원인: REST 커넥터 서비스 주체 인증서 인증을 위해 base64 문자열 서비스 주체 인증서만 지원합니다.
  • 권장 사항: 이 섹션에 따라 Azure Key Vault에 서비스 주체 인증서를 올바르게 저장합니다.

관련 콘텐츠

자세한 문제 해결 도움말은 다음 리소스를 참조하세요.