Report Builder 연결과 SQL 조회

Foundry ODBC 드라이버를 설치한 컴퓨터에서 Report Builder를 엽니다. 사용할 Foundry 환경의 HTTPS 기본 URL, 사용자 생성 토큰과 접근할 데이터셋을 준비합니다.

데이터 원천 추가

1. Report Data 창의 도구 모음에서 New > Data Source를 선택합니다.
2. Data Source Properties의 Name에 사용할 이름을 입력합니다. 이후 절차에서는 FoundrySqlServer라는 이름을 사용합니다.
3. Use a connection embedded in my report를 선택합니다.
4. Select connection type에서 ODBC를 선택합니다.

연결 문자열과 인증

Connection string에 다음 형식의 문자열을 입력합니다.

DSN=FoundrySql;BaseUrl=<FOUNDRY_BASE_URL>;PWD=<FOUNDRY_TOKEN>

FOUNDRY_BASE_URL에는 https://example.palantirfoundry.com처럼 Foundry 환경의 실제 HTTPS 기본 URL을 입력합니다. 자체 도메인도 같은 방식으로 입력합니다. FOUNDRY_TOKEN에는 Foundry Settings에서 생성한 비공개 사용자 토큰을 넣습니다. 꺾쇠 부분은 실제 값으로 교체합니다. DSN은 설치한 FoundrySql 데이터 원천을 가리킵니다.

이 연결 문자열에는 토큰이 포함되므로 보고서 파일, 연결 설정과 화면을 공유할 때 자격 증명이 노출되지 않도록 관리합니다. Microsoft는 ODBC 자격 증명 안내에서 비밀번호를 연결 문자열에 넣는 방식의 위험과 별도 Credentials 입력란을 설명합니다.

Test Connection을 선택해 연결을 확인합니다. 오류가 나면 드라이버 설치, DSN, URL과 토큰을 확인합니다. 설정을 마치면 OK를 선택합니다. Desktop에 저장한 토큰은 유효한 동안 다시 입력하지 않고 사용할 수 있으며, 만료되거나 폐기되면 새 토큰으로 갱신합니다.

데이터셋과 쿼리

1. Report Data 창에서 New > Add Dataset을 선택합니다.
2. 보고서 데이터셋의 이름을 입력하고 Use a dataset embedded in my report를 선택합니다.
3. Data source에서 앞서 만든 FoundrySqlServer를 선택합니다.
4. Foundry 데이터셋의 About에서 see more를 열고 RID 또는 Location을 복사합니다. RID와 경로 확인에 자세한 위치가 나와 있습니다.
5. Query에 복사한 식별자를 사용하는 SQL을 작성합니다.

다음은 가상 데이터셋 경로를 사용하는 예시입니다. 실제 데이터셋 경로로 바꾸고 ODBC 기본 SQL 방언에 맞게 식별자를 큰따옴표로 감쌉니다.

SELECT * FROM "/FoundryDataset"

조회한 필드를 사용하여 보고서를 작성합니다. 이 연결 절차는 Desktop에서 사용하는 토큰 기반 연결에 해당합니다.