Power BI 연결 운영과 문제 해결

Foundry 데이터를 Power Query로 읽는 연결의 운영 조건입니다. 데이터 통합용 Power BI XMLA 커넥터와 구분합니다.

Import와 DirectQuery 선택

Import 및 DirectQuery 선택

모드	동작	적합한 경우와 제약
Import	선택한 표와 열을 Power BI에 가져오고 시각화는 가져온 데이터로 계산	빠르고 상호작용이 많은 보고서, 작은 규모부터 중간 규모 데이터. 최신 변경은 수동 또는 예약 새로 고침 필요
DirectQuery	데이터를 로드할 때 전체를 가져오지 않고 시각화 및 상호작용에서 Foundry로 쿼리	매우 큰 데이터 위의 단순한 보고서. 원천 계산 및 전송 지연이 있어 쿼리 수와 상호작용을 적게 유지

두 모드 모두 Power BI로 반환하는 결과가 Foundry 실행 경로의 크기 제한 안에 들어가야 합니다. DirectQuery는 더 큰 원천 데이터에서 계산할 수 있지만 반환 결과 한도를 없애지 않습니다. DirectQuery의 시각화와 타일도 캐시를 사용할 수 있으므로 항상 즉시 최신 상태라고 가정하지 않습니다. 다시 쿼리하는 동작이나 새로 고침이 필요하며 세부 동작은 Microsoft DirectQuery 안내를 따릅니다.

가능하면 Import를 사용합니다. 큰 데이터는 Foundry 변환이나 Contour에서 불필요한 행과 열을 줄이고 사전 집계한 뒤 자동 빌드를 구성할 수 있습니다. 연도별 데이터셋처럼 가져오기를 작은 단위로 나누는 방법도 있습니다.

Composite model은 한 보고서에 Import와 DirectQuery를 함께 사용합니다. 개요 및 핵심 통계는 사전 집계해 Import하고 상세 탐색은 DirectQuery로 구성할 수 있습니다. 복합 모델의 제품 조건도 확인합니다.

크기 한도와 성능

Foundry의 기존 Spark 실행 경로는 결과를 드라이버 메모리로 모으므로 행 수와 바이트 수 제약을 받습니다. Direct Read 조건에 맞는 조회는 다른 전달 경로를 사용합니다. 현재 환경의 SQL 엔진 구조에 맞게 판단합니다.

Power BI 구독과 용량에도 한도가 있습니다. 공유 용량의 가져온 의미 모델에는 1GB 제한이 적용될 수 있으며 압축 모델의 크기와 원천 파일의 크기는 같지 않습니다. Premium에는 다른 조건을 적용하므로 Microsoft 새로 고침 제한을 확인합니다. 큰 표의 가져오기가 느리거나 실패하면 원천을 줄이거나 위 모드 선택 방법을 적용합니다.

Foundry 권한과 게시된 보고서

Desktop 보고서를 만드는 사람은 자신의 Foundry 권한으로 접근할 수 있는 데이터셋과 제한 뷰만 사용할 수 있습니다.

게시한 보고서의 새로 고침은 Gateway 데이터 원천에 구성한 자격 증명을 사용합니다. 보고서 소비자의 Foundry 자격 증명을 자동으로 이어받지 않습니다. 서비스 사용자에게 부여한 데이터 범위와 Power BI 보고서의 배포 및 접근 설정을 함께 관리합니다.

Power BI Service와 Gateway

Power BI Service의 보고서에는 Foundry 커넥터와 ODBC 드라이버를 설치한 Gateway를 사용합니다. Power BI 관리자와 설치 및 연결 설정을 준비합니다.

서비스 사용자 기반 구성에는 Foundry Client Credentials 흐름을 사용합니다. Confidential client와 Client credentials grant를 구성하고 Ontology SDK는 켜지 않으며, 서비스 사용자에게 필요한 데이터 접근 권한을 부여합니다.

기존 토큰 기반 Gateway 연결도 사용할 수 있습니다. Foundry 연결 유형에서 Authentication Method를 Key로 선택하고 서비스 계정용 Foundry 토큰을 제공합니다. 이 자격 증명은 토큰의 유효기간을 관리해야 합니다.

Desktop의 대화형 OAuth 로그인을 그대로 게시 보고서 소비자별 인증으로 간주하지 않습니다. 서비스 자동 새로 고침은 Gateway에 저장한 연결과 자격 증명을 사용하도록 구성합니다.

Power BI Dataflows

Power Query Online으로 Foundry 데이터에서 Dataflow를 만들 수 있습니다. 시작 전에 Foundry 연결이 이미 구성된 on-premises Gateway에 접근할 수 있어야 합니다. Dataflow 설정 도중 새 Gateway 연결을 만드는 경로에는 서비스 문제가 있으므로 연결을 먼저 준비합니다.

호스트와 용량별 지원 조건이 다릅니다. Premium 작업 공간의 Dataflow에는 Foundry를 포함한 Gateway 기반 커넥터의 미지원 문제가 있으므로 제품별 지원 조건을 확인합니다. 다른 Power Query 제품의 호환성이 이 용량 조합까지 보장하는 것은 아닙니다.

Power BI 작업 공간에서 New > Dataflow를 선택합니다.
Add new tables를 선택합니다.
Choose data source에서 Palantir Foundry를 선택합니다.
Connect to data source의 Base URL에 Gateway의 기존 Foundry 연결과 같은 URL을 입력합니다. Dataset RID와 Branch는 필요하면 지정합니다.
Connection에 on-premises Gateway 이름이 나타나는지 확인합니다. 나타나지 않으면 끝 슬래시까지 Base URL이 정확히 일치하는지 확인합니다.
Next를 선택합니다.
Choose data에서 필요한 테이블을 선택하고 Transform data를 선택합니다.
Power Query 편집기에서 Dataflow를 작성하고 저장합니다.

새 Gateway 연결의 Unexpected error

Unexpected error (Session ID: <UUID>, Region: <REGION>)

Dataflow 설정 화면에서 새 Gateway 연결을 만들 때 발생할 수 있습니다. 먼저 Power BI Service의 Settings > Manage connections and gateways > Connections > New에서 Foundry 연결을 구성합니다. 그다음 Dataflow 설정에 동일한 Base URL을 입력하면 기존 연결을 선택할 수 있습니다.

추가 ODBC 설정

ODBC 드라이버 설치 시 Windows System DSN인 FoundrySql이 생성됩니다. 여기서 구성한 추가 드라이버 옵션은 Power BI 커넥터에도 적용됩니다. 단, 서버 이름과 인증 설정은 커넥터에서 별도로 정하므로 DSN의 해당 항목은 적용 대상에서 제외됩니다.

프록시 같은 추가 설정은 Windows ODBC Data Sources Administrator에서 FoundrySql을 구성합니다. 키와 동작은 ODBC/JDBC 매개변수를 따릅니다.

인증 토큰과 OAuth 오류

토큰은 Power BI가 사용자를 대신해 Foundry 데이터에 접근하도록 허용하는 비공개 자격 증명입니다. Foundry의 Account > Settings > Tokens에서 만들고 관리합니다.

Foundry 토큰 관리

OAuth 인증 오류가 발생하면 Power BI 타사 애플리케이션이 활성화되었는지 Foundry 관리자에게 확인합니다. 활성화 전에는 토큰 인증을 사용할 수 있습니다.

Power BI 권한 부여 오류

토큰에서 OAuth로 전환

기존 자격 증명을 지운 뒤 같은 데이터 원천을 다시 구성하고 Foundry OAuth를 선택합니다. 아래의 Clear permissions 절차를 사용합니다.

Unable to connect

자격 증명이 만료되었을 때 발생할 수 있습니다.

Power BI의 File > Options and Settings > Data Source Settings를 엽니다.
Palantir Foundry 연결에서 Clear permissions를 선택합니다. Foundry 연결이 여러 개라면 해당 연결들을 모두 지웁니다.
데이터 원천과 인증을 다시 구성합니다. 토큰 인증이면 새 토큰이 필요합니다.

팔란티어 플랫폼 한국어 해설