ODBC와 JDBC 연결 문제 해결
연결 오류는 드라이버 로드, 데이터셋 식별 및 권한, 쿼리 규모 또는 인증서 신뢰 문제로 구분합니다. 드라이버의 연결 매개변수는 ODBC/JDBC 설정을 따릅니다.
IM003: 드라이버를 불러올 수 없음
Windows에서 다음과 같은 오류가 발생할 수 있습니다.
ODBC: ERROR [IM003] Specified driver could not be loaded due to system error 126: The specified module could not be found. (FoundrySqlDriver, C:\Program Files\Palantir\Foundry ODBC Driver\bin64\<ModuleName>.dll)
호스트에 최신 Microsoft Visual C++ Redistributable이 설치되어 있는지 확인합니다.
InvalidDatasetCannotAccess
FoundrySqlServer:InvalidDatasetCannotAccess
쿼리가 참조하는 데이터셋이나 브랜치가 없거나, 연결에 구성한 사용자가 그 데이터셋을 볼 권한이 없을 수 있습니다. FoundrySqlServer:NotAuthorizedToReadInputs는 쿼리 입력에 대한 권한 실패를 나타내는 별도 오류입니다.
연결에 사용한 계정으로 Foundry에 로그인하여 같은 데이터셋의 데이터를 읽을 수 있는지 확인합니다. 충분한 권한이 있는 관리자는 해당 계정의 접근 권한을 대신 확인할 수 있습니다. RID 또는 경로뿐 아니라 연결의 Branch 설정도 확인합니다.
TooManyRows
FoundrySqlServer:TooManyRows
일부 SQL 실행 경로는 성능 때문에 결과 행 수를 제한합니다. SQL 연결 구조에서 기존 Spark 엔진의 메모리 수집 제약과 Direct Read의 적용 조건을 구분합니다. Furnace로 전환된 환경에서는 해당 엔진의 계약을 적용하며, 기존 실행 경로의 제한을 모든 연결에 같은 수치로 가정하지 않습니다.
사용자 지정 인증서의 신뢰 실패
대표적인 오류 문구는 다음과 같습니다.
Dialogue transport failure; PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
드라이버가 Foundry 서버 인증서를 신뢰하는 인증 기관(CA)의 서명으로 검증하지 못했음을 뜻합니다. CA가 운영체제의 기본 신뢰 저장소에 없거나 드라이버가 그 저장소에 접근할 수 없는 경우에 발생할 수 있습니다.
예를 들어 Foundry URL에 조직의 자체 도메인을 사용하거나, 네트워크의 TLS 복호화 및 검사가 Foundry가 처음 제시한 인증서와 다른 인증서를 드라이버에 보여 주는 환경을 확인합니다.
운영체제 신뢰 저장소 사용
기본적으로 드라이버는 운영체제의 기본 신뢰 저장소를 사용합니다. 조직의 IT 담당자에게 사용자 지정 인증서 체인을 신뢰 저장소에 추가할 수 있는지 확인합니다. 이 경로를 사용할 수 있으면 별도의 드라이버 인증서 설정 없이 검증할 수 있습니다.
PEM 인증서 체인 직접 지정
운영체제 신뢰 저장소에 추가할 수 없다면 인증서 체인을 PEM 형식으로 확보하고 TrustStorePath에 그 파일의 전체 경로를 지정합니다.
- 이미 신뢰할 수 있는 연결에서 인증서 체인을 얻습니다. 예를 들어 Chrome에서 Foundry URL을 엽니다.
- 주소 표시줄의 사이트 연결 정보에서 Connection is secure, 이어서 Certificate is valid를 선택합니다.
- Details 탭에서
Export...를 선택합니다. - 내보내기 형식을 Base64-encoded ASCII, certificate chain으로 선택하고 파일 위치를 지정한 뒤 Save를 선택합니다.
- 드라이버의 TrustStorePath에 저장한 파일의 전체 경로를 지정합니다.
다른 브라우저를 사용한다면 해당 브라우저의 인증서 체인 내보내기 절차를 따릅니다. Chrome에서도 연결이 안전하지 않거나 인증서가 유효하지 않다고 표시하면 그 연결을 신뢰하는 근거로 사용하지 않습니다. 컴퓨터의 전반적인 인증서 신뢰 문제일 수 있으므로 조직의 IT 담당자와 Palantir 지원팀에 문의합니다.