Microsoft Power BI XMLA 데이터 수집
Microsoft Power BI XMLA 커넥터는 Power BI의 데이터를 Foundry에 수집하는 JDBC 연결입니다. Power Query에서 Foundry 리소스를 읽도록 하는 Power BI 분석 도구 연결과는 데이터 이동 방향과 용도가 다릅니다.
원천 탐색, 배치 동기화, 증분 수집과 OAuth 2.0 인증을 일반 제공(GA)합니다. Data Connection의 +New Source에서 Microsoft Power BI XMLA를 선택하고 워커, JDBC URL과 속성을 구성합니다. 동기화마다 테이블을 반환하는 SQL 질의 하나를 실행하고 그 결과를 Foundry 데이터셋에 저장합니다.
연결 속성
| 속성 | 요구 수준 | 의미 | 기본값 |
|---|---|---|---|
AuthScheme | 권장 | Power BI XMLA 인증 방식입니다. | AzureServicePrincipal |
AzureTenant | 권장 | 데이터 접근에 사용할 테넌트의 도메인 이름 또는 디렉터리 ID입니다. 예: contoso.onmicrosoft.com. | 미지정 |
InitiateOAuth | 권장 | OAuth 액세스 토큰을 발급하거나 갱신하는 절차입니다. | GETANDREFRESH |
OAuthClientId | 권장 | 사용자 정의 OAuth 애플리케이션의 client ID, 즉 consumer key입니다. 인증 서버에 앱을 식별합니다. | 미지정 |
OAuthClientSecret | 권장 | 사용자 정의 OAuth 애플리케이션을 인증하는 기밀 값입니다. 사용자 정의 앱에만 적용합니다. | 미지정 |
PowerBIEnvironment | 권장 | API 요청에 사용할 Power BI 환경입니다. | NONE |
Workspace | 권장 | 연결할 Premium Power BI 작업 공간 이름을 쉼표로 구분한 목록입니다. | 미지정 |
외부 통신 대상
실제 사용하는 환경과 클러스터에 대한 외부 통신 정책을 구성합니다. Foundry에서 직접 도달하지 못하는 대상은 에이전트 프록시로 연결하고 에이전트 호스트의 접근 경로도 확보합니다.
| 대상 | 필요 조건 |
|---|---|
api.powerbi.com | AzureEnvironment=GLOBAL일 때 필요합니다. GLOBAL이 기본 환경입니다. |
*.pbidedicated.windows.net | GLOBAL 환경의 전용 클러스터입니다. 실제 * 위치의 클러스터는 api.powerbi.com 호출로 결정합니다. |
login.microsoftonline.com | GLOBAL 환경에서 AzureAD, AzureServicePrincipal, AzureServicePrincipalCert 인증을 사용할 때 필요합니다. |
login.chinacloudapi.cn | CHINA 환경에서 위 세 인증 방식을 사용할 때 필요합니다. |
login.microsoftonline.us | USGOVT, USGOVTHIGH, USGOVTDOD 환경에서 위 세 인증 방식을 사용할 때 필요합니다. |
api.powerbigov.us | AzureEnvironment=USGOVT일 때 필요합니다. |
api.high.powerbigov.us | AzureEnvironment=USGOVTHIGH일 때 필요합니다. |
api.mil.powerbigov.us | AzureEnvironment=USGOVTDOD일 때 필요합니다. |
*.pbidedicated.usgovcloudapi.net | USGOVT, USGOVTHIGH, USGOVTDOD 환경의 전용 클러스터입니다. |
PowerBIEnvironment 속성과 네트워크 조건의 AzureEnvironment 식별자는 구분해 설정합니다. 실제 인증 방식과 서비스 환경이 일치해야 필요한 인증 및 데이터 엔드포인트를 함께 허용할 수 있습니다.
OAuth 2.0 승인
사용자 인증 코드 흐름은 Foundry 워커에서만 지원합니다. CallbackUrl에 자동 입력되는 Foundry 콜백 URL을 외부 앱에 등록하고 client ID와 secret을 구성합니다. 저장 후 소스 개요에서 Authorize를 선택합니다. 인증 갱신과 철회는 오른쪽 패널에서 수행합니다.
이러한 소스 승인 관리에는 기본적으로 Owner 역할이 필요합니다. Viewer와 Editor만으로는 수행할 수 없습니다. 인증 코드 흐름에서는 ConnectOnOpen=true를 함께 사용하지 않습니다.