Arrow Flight SQL 연결

Arrow Flight SQL은 Apache Arrow의 메모리 형식과 Flight RPC로 SQL 결과를 전송하는 프로토콜입니다. Foundry는 이 프로토콜을 구현하여 호환 클라이언트의 표 데이터 조회를 지원합니다. 베타 기능이므로 플랫폼 인스턴스에서 제공되지 않거나 변경될 수 있으며 활성화는 Palantir Support에 요청합니다.

리소스 탐색

Foundry	SQL 클라이언트 표시
Namespace	Catalog
Project	Schema
Dataset	Table
Field	Column

JDBC 드라이버

Arrow Flight SQL JDBC의 JAR을 내려받아 DBeaver, DataGrip 등 클라이언트가 요구하는 드라이버 위치에 설치합니다. 클래스 이름을 명시해야 하면 org.apache.arrow.driver.jdbc.ArrowFlightJdbcDriver를 사용합니다.

드라이버 19.0.0에서는 클라이언트 로컬 시간대가 UTC가 아닐 때 타임스탬프 오프셋을 반대 방향으로 적용하여 표시가 잘못될 수 있습니다. 차이는 로컬 UTC 오프셋의 두 배가 될 수 있으며 UTC+1에서는 실제보다 두 시간 뒤처져 표시되는 예가 있습니다. 클라이언트가 시간대 설정을 지원하면 UTC를 사용하는 것이 권장됩니다.

기본 연결 문자열의 호스트를 실제 Foundry 호스트명으로 바꿉니다.

jdbc:arrow-flight-sql://<FOUNDRY_HOSTNAME>:443

사용자 토큰 인증

Foundry Settings에서 사용자 생성 토큰을 만듭니다. 클라이언트가 별도 자격 증명 입력을 제공하면 사용자 이름은 token, 비밀번호는 토큰 값으로 지정하는 방식이 권장됩니다. 별도 입력란이 없을 때는 다음 URL 매개변수 방식을 사용할 수 있습니다. URL에 포함한 토큰은 비밀이므로 로그나 공유 설정에 노출하지 않습니다.

jdbc:arrow-flight-sql://<FOUNDRY_HOSTNAME>:443/?token=<TOKEN>

OAuth 클라이언트 인증 정보 방식

서비스 간 연결은 등록한 confidential client의 client ID와 client secret을 사용할 수 있습니다. Public client는 지원하지 않습니다.

드라이버 속성	값
`oauth.flow`	`client_credentials`
`oauth.tokenUri`	`https://<FOUNDRY_HOSTNAME>/multipass/api/oauth2/token`
`oauth.clientId`	등록한 외부 앱의 클라이언트 ID.
`oauth.clientSecret`	해당 앱의 클라이언트 비밀값.
`oauth.scope`	`foundry-sql-server:query`

앱에는 조회할 리소스의 SQL 작업과 기반 리소스 접근 권한이 필요합니다. OAuth scope와 역할 작업의 foundry-sql-server:read는 서로 다른 식별자이므로 바꾸어 쓰지 않습니다.

조회 확인

클라이언트가 직접 SQL 실행을 지원하면 다음처럼 제한된 조회를 사용할 수 있습니다. 다른 클라이언트는 프로젝트와 데이터셋 탐색 UI를 제공합니다.

SELECT * FROM `/Path/To/Dataset` LIMIT 10

공통 접근 규칙은 SQL 권한을 적용합니다.