Azure Data Factory 및 Azure Synapse Analytics 커넥터 문제 해결
적용 대상: 
Azure Data Factory Azure Synapse Analytics
팁
기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!
이 문서에서는 Azure Data Factory 및 Azure Synapse Analytics의 커넥터 문제를 해결하는 방법을 설명합니다.
커넥터 관련 문제
각 커넥터에 대한 문제 해결 페이지를 참조하여 관련 문제, 해당 원인의 설명, 해결 권장 사항을 함께 확인할 수 있습니다.
- Azure Blob Storage
- Azure Cosmos DB(Azure Cosmos DB for NoSQL 커넥터 포함)
- Azure Data Lake(Gen1 및 Gen2)
- Azure Database for PostgreSQL
- Azure Files 스토리지
- Azure Synapse Analytics, Azure SQL Database 및 SQL Server
- DB2
- 구분된 텍스트 형식
- Dynamics 365, Dataverse(Common Data Service) 및 Dynamics CRM
- FTP, SFTP 및 HTTP
- Hive
- Oracle
- ORC 형식
- Parquet 형식
- REST
- Salesforce 및 Salesforce 서비스 클라우드
- SharePoint Online 목록
- XML 형식
일반 복사 작업 오류
다음 오류는 복사 작업의 일반적인 오류이며 커넥터에서 발생할 수 있습니다.
오류 코드: 2200 - UserErrorOdbcOperationFailed
메시지:
The underlying connection was closed: An unexpected error occurred on a send.원인: 이는 일반적으로 데이터 전송 작업 중 인증 실패를 나타냅니다. 이 문제는 원격 당사자가 전송 스트림을 닫을 때 발생할 수 있습니다.
재원 계산:
- 원본 연결을 확인하고 테스트하여 제대로 작동하는지 확인합니다.
- 연결에 사용되는 인증 방법을 확인합니다.
- Azure Cosmos DB에 대한 방화벽 구성 설정을 검토하여 필요한 트래픽을 허용하는지 확인합니다.
오류 코드: 20000 - JreNotFound
메시지:
Java Runtime Environment cannot be found on the Self-hosted Integration Runtime machine. It is required for parsing or writing to Parquet/ORC files. Make sure Java Runtime Environment has been installed on the Self-hosted Integration Runtime machine.원인: 자체 호스팅 IR이 Java 런타임을 찾을 수 없습니다. 특정 원본을 읽으려면 Java 런타임이 필요합니다.
권장 사항: 통합 런타임 환경을 확인합니다. 자체 호스팅 통합 런타임 사용을 참조하세요.
오류 코드: 20002
메시지:
An error occurred when invoking Java Native Interface.원인: 오류 메시지에 "JVM을 만들 수 없음: JNI 반환 코드 [-6][JNI 호출 실패: 잘못된 인수입니다.]"가 포함된 경우 일부 잘못된(전역) 인수가 설정되어 JVM을 만들 수 없기 때문일 수 있습니다.
권장 사항: 자체 호스팅 통합 런타임의 각 노드를 호스트하는 컴퓨터에 로그인합니다. 시스템 변수가
_JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G와 같이 올바르게 설정되었는지 확인합니다. 모든 통합 런타임 노드를 다시 시작한 다음, 파이프라인을 다시 실행합니다.
오류 코드: 20020 - WildcardPathSinkNotSupported
메시지:
Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.원인: 싱크 데이터 세트가 와일드카드 값을 지원하지 않습니다.
권장 사항: 싱크 데이터 세트를 확인하고 와일드카드 값을 사용하지 않고 경로를 다시 작성합니다.
FIPS 문제
증상: FIPS 지원 자체 호스팅 IR 머신에서 다음과 같은 오류 메시지와 함께 복사 작업이 실패했습니다.
This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.원인: 이 오류는 Azure Blob, SFTP 등과 같은 커넥터를 사용하여 데이터를 복사하는 경우에 발생할 수 있습니다. FIPS(Federal Information Processing Standards)는 사용이 허용되는 특정 암호화 알고리즘 세트를 정의합니다. 머신에서 FIPS 모드가 사용하도록 설정된 경우, 일부 시나리오에서 복사 작업이 사용하는 일부 암호화 클래스가 차단됩니다.
해결 방법: Microsoft에서 더 이상 “FIPS 모드”를 권장하지 않는 이유를 알아보고 자체 호스팅 IR 컴퓨터에서 FIPS를 비활성화할 수 있는지 평가합니다.
또는 FIPS를 무시하고 작업 실행이 성공하도록 하려면 다음 단계를 따르세요.
자체 호스팅 IR이 설치된 폴더를 엽니다. 경로는 일반적으로 C:\Program Files\Microsoft Integration Runtime <IR version>\Shared입니다.
diawp.exe.config 파일을 열고
<runtime>섹션의 끝에 다음과 같이<enforceFIPSPolicy enabled="false"/>를 추가합니다.
파일을 저장하고 자체 호스팅 IR 머신을 다시 시작합니다.
오류 코드: 20150 - JniException
메시지:
Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.원인: 클라이언트 ID 또는 클라이언트 암호가 잘못되었으며 권한 부여 서버에서 인증이 실패했습니다.
권장 사항: 권한 부여 서버의 OAuth2 클라이언트 자격 증명 흐름 설정을 모두 수정합니다.
오류 코드: 20151 - FailedToGetOAuth2AccessToken
메시지:
Failed to get access token from your token endpoint. Error message: %errorMessage;.원인: OAuth2 클라이언트 자격 증명 흐름 설정이 잘못되었습니다.
권장 사항: 권한 부여 서버의 OAuth2 클라이언트 자격 증명 흐름 설정을 모두 수정합니다.
오류 코드: 20152 - OAuth2AccessTokenTypeNotSupported
메시지:
The token type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.원인: 권한 부여 서버가 지원되지 않습니다.
권장 사항: 지원되는 토큰 형식의 토큰을 반환할 수 있는 권한 부여 서버를 사용합니다.
오류 코드: 20153 - OAuth2ClientIdColonNotAllowed
메시지:
The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.원인: 클라이언트 ID에 잘못된 문자 콜론(
:)이 포함되어 있습니다.권장 사항: 유효한 클라이언트 ID를 사용합니다.
오류 코드: 20523 - ManagedIdentityCredentialObjectNotSupported
메시지:
Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.권장 사항: 지원되는 버전을 확인하고 통합 런타임을 더 높은 버전으로 업그레이드합니다.
오류 코드: 20551 - QueryMissingFormatSettingsInDataset
메시지:
The format settings are missing in dataset %dataSetName;.원인: 데이터 세트 형식은 지원되지 않는 이진입니다.
권장 사항: 대신 DelimitedText, Json, Avro, Orc 또는 Parquet 데이터 세트를 사용합니다.
원인: 파일 스토리지의 경우 데이터 세트에 형식 설정이 없습니다.
권장 사항: 데이터 세트에서 "이진 복사"를 선택 취소하고 올바른 형식 설정으로 지정합니다.
오류 코드: 20552 - QueryUnsupportedCommandBehavior
메시지:
The command behavior "%behavior;" is not supported.권장 사항: 명령 동작을 미리 보기 또는 GetSchema API 요청 URL에 대한 매개 변수로 추가하지 마세요.
오류 코드: 20701 - DataConsistencyFailedToGetSourceFileMetadata
메시지:
Failed to retrieve source file ('%name;') metadata to validate data consistency.원인: 싱크 데이터 저장소에 일시적인 문제가 있거나 싱크 데이터 저장소에서 메타데이터를 검색할 수 없습니다.
오류 코드: 20703 - DataConsistencyFailedToGetSinkFileMetadata
메시지:
Failed to retrieve sink file ('%name;') metadata to validate data consistency.원인: 싱크 데이터 저장소에 일시적인 문제가 있거나 싱크 데이터 저장소에서 메타데이터를 검색할 수 없습니다.
오류 코드: 20704 - DataConsistencyValidationNotSupportedForNonDirectBinaryCopy
메시지:
Data consistency validation is not supported in current copy activity settings.원인: 데이터 일관성 유효성 검사는 직접 이진 복사 시나리오에서만 지원됩니다.
권장 사항: 복사 작업 페이로드에서 'validateDataConsistency' 속성을 제거합니다.
오류 코드: 20705 - DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime
메시지:
'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.권장 사항: 지원되는 통합 런타임 버전을 확인하고 더 높은 버전으로 업그레이드하거나 복사 활동에서 'validateDataConsistency' 속성을 제거합니다.
오류 코드: 20741 - SkipMissingFileNotSupportedForNonDirectBinaryCopy
메시지:
Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.권장 사항: 복사 활동 페이로드에서 skipErrorFile 설정의 'fileMissing'을 제거합니다.
오류 코드: 20742 - SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy
메시지:
Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.권장 사항: 복사 활동 페이로드에서 skipErrorFile 설정의 'dataInconsistency'를 제거합니다.
오류 코드: 20743 - SkipForbiddenFileNotSupportedForNonDirectBinaryCopy
메시지:
Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.권장 사항: 복사 활동 페이로드에서 skipErrorFile 설정의 'fileforbidden'을 제거합니다.
오류 코드: 20744 - SkipForbiddenFileNotSupportedForThisConnector
메시지:
Skip forbidden file is not supported for this connector: ('%connectorName;').권장 사항: 복사 활동 페이로드에서 skipErrorFile 설정의 'fileforbidden'을 제거합니다.
오류 코드: 20745 - SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy
메시지:
Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.권장 사항: 복사 활동 페이로드에서 skipErrorFile 설정의 'invalidFileName'을 제거합니다.
오류 코드: 20746 - SkipInvalidFileNameNotSupportedForSource
메시지:
Skip invalid file name is not supported for '%connectorName;' source.권장 사항: 복사 활동 페이로드에서 skipErrorFile 설정의 'invalidFileName'을 제거합니다.
오류 코드: 20747 - SkipInvalidFileNameNotSupportedForSink
메시지:
Skip invalid file name is not supported for '%connectorName;' sink.권장 사항: 복사 활동 페이로드에서 skipErrorFile 설정의 'invalidFileName'을 제거합니다.
오류 코드: 20748 - SkipAllErrorFileNotSupportedForNonBinaryCopy
메시지:
Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.권장 사항: 복사 활동 페이로드에서 skipErrorFile 설정의 'allErrorFile'을 제거합니다.
오류 코드: 20771 - DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy
메시지:
'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.권장 사항: 'deleteFilesAfterCompletion' 설정을 제거하거나 직접 이진 복사를 사용합니다.
오류 코드: 20772 - DeleteFilesAfterCompletionNotSupportedForThisConnector
메시지:
'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').권장 사항: 복사 활동 페이로드에서 'deleteFilesAfterCompletion' 설정을 제거합니다.
오류 코드: 27002 - FailedToDownloadCustomPlugins
메시지:
Failed to download custom plugins.원인: 잘못된 다운로드 링크 또는 일시적인 연결 문제입니다.
권장 사항: 일시적인 문제라는 메시지가 표시되면 다시 시도합니다. 문제가 지속되면 지원 팀에 문의하세요.
일반 커넥터 오류
오류 코드: 9611 - UserErrorOdbcInvalidQueryString
메시지:
The following ODBC Query is not valid: '%'.원인: 데이터/스키마를 가져오기 위해 잘못되었거나 유효하지 않은 쿼리를 제공했습니다.
권장 사항: 쿼리가 유효하고 데이터/스키마를 반환할 수 있는지 확인합니다. 쿼리가 아닌 스크립트를 실행하려고 하고 데이터 저장소가 지원되는 경우 스크립트 작업을 사용합니다. 또는 더미 결과를 반환하는 저장 프로시저를 사용하여 쿼리가 아닌 스크립트를 실행하는 것이 좋습니다.
오류 코드: 11775 - FailToResolveParametersInExploratoryController
메시지:
Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'원인: 정확한 원인은
'%'에 반환된 텍스트에 따라 달라집니다. 작업 시간이 초과됨인 경우 PostgreSQL 인스턴스가 중지되었거나 인스턴스에 대해 구성된 네트워크 연결 방법이 선택한 Integration Runtime의 연결을 허용하지 않기 때문일 수 있습니다. 제공된 사용자 또는 암호가 잘못되었습니다. 28P01: 사용자 <youruser>에 대한 암호 인증 실패인 경우 제공된 사용자가 인스턴스에 없거나 해당 암호가 올바르지 않은 것입니다. 28000: 호스트 "###.###.###.###", 사용자 "<youruser>", 데이터베이스 "<yourdatabase>"에 대한 pg_hba.conf 항목 없음, 암호화되지 않음인 경우 선택한 암호화 방법이 서버의 구성과 호환되지 않는 것입니다.권장 사항: 제공된 사용자가 PostgreSQL 인스턴스에 존재하는지, 암호가 현재 해당 사용자에게 할당된 암호와 일치하는지 확인합니다. 선택한 암호화 방법이 현재 구성에 따라 PostgreSQL 인스턴스에서 수락되는지 확인합니다. 인스턴스의 네트워크 연결 방법이 프라이빗 액세스(가상 네트워크 통합)로 구성된 경우 자체 호스팅 IR(통합 런타임)을 사용하여 연결합니다. 공용 액세스(허용된 IP 주소)로 구성된 경우 관리되는 가상 네트워크에서 Azure IR을 사용하고 관리형 프라이빗 엔드포인트를 배포하여 인스턴스에 연결하는 것이 좋습니다. 공용 액세스(허용된 IP 주소)로 구성된 경우 사용 중인 Azure IR에서 사용하는 IP 주소에서 시작되는 트래픽을 허용하도록 인스턴스에서 방화벽 규칙을 만드는 것은 권장되지 않습니다.
관련 콘텐츠
자세한 문제 해결 도움말은 다음 리소스를 참조하세요.