Gateways - Create Datasource

Service:

Power BI REST APIs

API Version:

v1.0

지정된 온-프레미스 게이트웨이에 새 데이터 원본을 만듭니다.

온-프레미스 데이터 원본 자격 증명을 암호화해야 합니다. 매개 변수를 encryptedConnection 로 Encrypted 설정해야 하며 게이트웨이 공개 키를 사용하여 자격 증명을 암호화해야 합니다.

이 API를 사용하는 예제는 게이트웨이 DataSource PowerShell 스크립트 만들기를 참조하세요. 이 스크립트는 자격 증명 암호화를 위해 아래 참고 사항에 설명된 PowerShell 스크립트를 사용합니다.

참고

자격 증명을 암호화하려면 Power BI에 대해 프로그래밍 방식으로 자격 증명 구성 을 참조하고 EncryptCredentials .NET Core, Java, Python 및 PowerShell 예제를 검토합니다.

사용 권한

온-프레미스 게이트웨이만 지원하며 사용자에게 게이트웨이 관리자 권한이 있어야 합니다.

필수 범위

Dataset.ReadWrite.All

제한 사항

• VNet(가상 네트워크) 및 클라우드 게이트웨이는 지원되지 않습니다.
• 자격 증명 형식인 OAuth2는 지원되지 않습니다.
  
  

POST https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
gatewayId	path	True	string uuid	게이트웨이 ID입니다. 게이트웨이 클러스터를 사용하는 경우 게이트웨이 ID는 클러스터의 기본(첫 번째) 게이트웨이를 참조합니다. 이러한 경우 게이트웨이 ID는 게이트웨이 클러스터 ID와 유사합니다.

요청 본문

Name	필수	형식	Description
connectionDetails	True	string	연결 세부 정보
credentialDetails	True	CredentialDetails	자격 증명 세부 정보
dataSourceName	True	string	데이터 원본 이름
dataSourceType	True	string	데이터 원본 형식

응답

Name	형식	Description
201 Created	GatewayDatasource	생성일

예제

Azure Analysis Services example

SQL example

Azure Analysis Services example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources

Request Body

{
  "dataSourceType": "AnalysisServices",
  "connectionDetails": "{\"server\":\"MyServer\",\"database\":\"MyDatabase\"}",
  "datasourceName": "Sample Datasource",
  "credentialDetails": {
    "credentialType": "Windows",
    "credentials": "AB....EF==",
    "encryptedConnection": "Encrypted",
    "encryptionAlgorithm": "RSA-OAEP",
    "privacyLevel": "None"
  }
}

Sample Response

Status code:

200

SQL example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources

Request Body

{
  "dataSourceType": "SQL",
  "connectionDetails": "{\"server\":\"MyServer\",\"database\":\"MyDatabase\"}",
  "datasourceName": "Sample Datasource",
  "credentialDetails": {
    "credentialType": "Windows",
    "credentials": "AB....EF==",
    "encryptedConnection": "Encrypted",
    "encryptionAlgorithm": "RSA-OAEP",
    "privacyLevel": "None"
  }
}

Sample Response

Status code:

200

정의

Name	Description
CredentialDetails	자격 증명 세부 정보
credentialType	데이터 원본 자격 증명의 형식
encryptedConnection	데이터 원본 연결을 암호화할지 여부입니다. 암호화를 선택하고 Power BI가 데이터 원본과 암호화된 연결을 설정할 수 없는 경우 API 호출이 실패합니다.
encryptionAlgorithm	암호화 알고리즘입니다. 클라우드 데이터 원본의 경우 를 지정합니다 None. 온-프레미스 데이터 원본의 경우 게이트웨이 공개 키를 지정 RSA-OAEP 하고 사용하여 자격 증명을 암호화합니다.
GatewayDatasource	Power BI 게이트웨이 데이터 원본
GatewayDatasourceCredentialDetails	데이터 원본 자격 증명 세부 정보
privacyLevel	여러 원본의 데이터를 결합할 때 관련된 개인 정보 수준입니다.
PublishDatasourceToGatewayRequest	게이트웨이 요청에 데이터 원본 게시

CredentialDetails

자격 증명 세부 정보

Name	형식	Description
credentialType	credentialType	자격 증명 형식
credentials	string	'credentialType' 값에 따라 달라지는 자격 증명입니다. 자세한 내용은 데이터 원본 예제 업데이트를 참조하세요.
encryptedConnection	encryptedConnection	데이터 원본 연결을 암호화할지 여부입니다. 암호화를 선택하고 Power BI가 데이터 원본과 암호화된 연결을 설정할 수 없는 경우 API 호출이 실패합니다.
encryptionAlgorithm	encryptionAlgorithm	암호화 알고리즘입니다. 클라우드 데이터 원본의 경우 를 지정합니다 None. 온-프레미스 데이터 원본의 경우 게이트웨이 공개 키를 지정 RSA-OAEP 하고 사용하여 자격 증명을 암호화합니다.
privacyLevel	privacyLevel	여러 원본의 데이터를 결합할 때 관련된 개인 정보 수준입니다.
useCallerAADIdentity	boolean	데이터 원본 소유자여야 하는 API 호출자의 Azure AD ID(OAuth 2.0 자격 증명)를 사용하여 데이터 원본 자격 증명(소유자 OAuth 액세스 토큰)을 구성할지 여부입니다. 일반적으로 이 플래그 또는 useEndUserOAuth2Credentials를 사용합니다.
useEndUserOAuth2Credentials	boolean	DirectQuery 모드에서 데이터 원본에 연결할 때 최종 사용자 Azure AD ID(OAuth 2.0 자격 증명)가 사용되는지 여부입니다. SSO(Single Sign-On)를 지원하는 데이터 원본과 함께 사용합니다. 일반적으로 이 플래그 또는 useCallerAADIdentity를 사용합니다.

credentialType

데이터 원본 자격 증명의 형식

Name	형식	Description
Anonymous	string
Basic	string
Key	string
OAuth2	string
SAS	string
Windows	string

encryptedConnection

데이터 원본 연결을 암호화할지 여부입니다. 암호화를 선택하고 Power BI가 데이터 원본과 암호화된 연결을 설정할 수 없는 경우 API 호출이 실패합니다.

Name	형식	Description
Encrypted	string
NotEncrypted	string

encryptionAlgorithm

암호화 알고리즘입니다. 클라우드 데이터 원본의 경우 를 지정합니다 None. 온-프레미스 데이터 원본의 경우 게이트웨이 공개 키를 지정 RSA-OAEP 하고 사용하여 자격 증명을 암호화합니다.

Name	형식	Description
None	string
RSA-OAEP	string

GatewayDatasource

Power BI 게이트웨이 데이터 원본

Name	형식	Description
connectionDetails	string	JSON 형식의 연결 세부 정보
credentialDetails	GatewayDatasourceCredentialDetails	업데이트가 필요한 데이터 원본에 대한 연결 세부 정보입니다. 데이터 세트에 둘 이상의 데이터 원본이 있는 경우 연결 세부 정보는 필수입니다.
credentialType	credentialType	데이터 원본 자격 증명의 형식
datasourceName	string	데이터 원본의 이름입니다.
datasourceType	string	데이터 원본의 형식입니다. 데이터 원본의 API 이름 ActiveDirectory AdobeAnalytics AdoDotNet AnalysisServices AzureBlobs AzureDataLakeStorage AzureMarketplace AzureTables BizTalk CDPA CustomConnector CustomHttpApi DB2 Essbase EventHub Excel Exchange 내선 번호 Facebook 파일 폴더 GoogleAnalytics Hdfs HDInsight Informix MQ MySql OData ODBC OleDb Oracle PostgreSql PowerQueryMashup PubNub Salesforce SAPBW SAPBWMessageServer SapErp SAPHana SharePoint SharePointDocLib SharePointList Sql Sybase Teradata UIFlow 웹
gatewayId	string	연결된 게이트웨이 ID입니다. 게이트웨이 클러스터를 사용하는 경우 게이트웨이 ID는 클러스터의 기본(첫 번째) 게이트웨이를 참조하며 게이트웨이 클러스터 ID와 유사합니다.
id	string	데이터 원본의 고유 ID

GatewayDatasourceCredentialDetails

데이터 원본 자격 증명 세부 정보

Name	형식	Description
useEndUserOAuth2Credentials	boolean	DirectQuery 모드에서 데이터 원본에 연결할 때 최종 사용자 Azure AD ID(OAuth 2.0 자격 증명)가 사용되는지 여부입니다. SSO(Single Sign-On)를 지원하는 데이터 원본과 함께 사용합니다.

privacyLevel

여러 원본의 데이터를 결합할 때 관련된 개인 정보 수준입니다.

Name	형식	Description
None	string
Organizational	string
Private	string
Public	string

PublishDatasourceToGatewayRequest

게이트웨이 요청에 데이터 원본 게시

Name	형식	Description
connectionDetails	string	연결 세부 정보
credentialDetails	CredentialDetails	자격 증명 세부 정보
dataSourceName	string	데이터 원본 이름
dataSourceType	string	데이터 원본 형식