Gateways - Create Datasource

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Vytvoří nový zdroj dat v zadané místní bráně.

Přihlašovací údaje místního zdroje dat musí být šifrované. Parametr encryptedConnection musí být nastavený na Encrypted hodnotu a přihlašovací údaje by měly být zašifrované pomocí veřejného klíče brány.

Příklad použití tohoto rozhraní API najdete ve skriptu PowerShellu pro vytvoření zdroje dat brány . Tento skript používá k šifrování přihlašovacích údajů skript PowerShellu uvedený v následující poznámce.

Poznámka

Pokud chcete přihlašovací údaje zašifrovat, přečtěte si téma Konfigurace přihlašovacích údajů pro Power BI prostřednictvím kódu programu a projděte si příklady EncryptCredentials .NET Core, Java, Python a PowerShell .

Oprávnění

Podporuje pouze místní brány a uživatel musí mít oprávnění správce brány.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

Virtuální síť (VNet) a cloudové brány se nepodporují.
OAuth2 jako typ přihlašovacích údajů se nepodporuje.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
gatewayId	path	True	string uuid	ID brány. Pokud používáte cluster bran, ID brány odkazuje na primární (první) bránu v clusteru. V takových případech se ID brány podobá ID clusteru brány.

Text požadavku

Name	Vyžadováno	Typ	Description
connectionDetails	True	string	Podrobnosti o připojení
credentialDetails	True	CredentialDetails	Podrobnosti o přihlašovacích údajích
dataSourceName	True	string	Název zdroje dat
dataSourceType	True	string	Typ zdroje dat

Odpovědi

Name	Typ	Description
201 Created	GatewayDatasource	Vytvořeno

Příklady

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

Definice

Name	Description
CredentialDetails	Podrobnosti o přihlašovacích údajích
credentialType	Typ přihlašovacích údajů ke zdroji dat
encryptedConnection	Určuje, jestli se má šifrovat připojení ke zdroji dat. Volání rozhraní API selže, pokud vyberete šifrování a Power BI nebude moct navázat šifrované připojení ke zdroji dat.
encryptionAlgorithm	Šifrovací algoritmus. Pro cloudový zdroj dat zadejte `None`. V případě místního zdroje dat zadejte `RSA-OAEP` a použijte veřejný klíč brány k šifrování přihlašovacích údajů.
GatewayDatasource	Zdroj dat brány Power BI
GatewayDatasourceCredentialDetails	Podrobnosti o přihlašovacích údajích ke zdroji dat
privacyLevel	Úroveň ochrany osobních údajů, která je relevantní při kombinování dat z více zdrojů.
PublishDatasourceToGatewayRequest	Žádost o publikování zdroje dat do brány

CredentialDetails

Podrobnosti o přihlašovacích údajích

Name	Typ	Description
credentialType	credentialType	Typ přihlašovacích údajů
credentials	string	Přihlašovací údaje, které závisí na hodnotě credentialType. Další informace najdete v tématu Příklady aktualizace zdroje dat .
encryptedConnection	encryptedConnection	Určuje, jestli se má šifrovat připojení ke zdroji dat. Volání rozhraní API selže, pokud vyberete šifrování a Power BI nebude moct navázat šifrované připojení ke zdroji dat.
encryptionAlgorithm	encryptionAlgorithm	Šifrovací algoritmus. Pro cloudový zdroj dat zadejte `None`. V případě místního zdroje dat zadejte `RSA-OAEP` a použijte veřejný klíč brány k šifrování přihlašovacích údajů.
privacyLevel	privacyLevel	Úroveň ochrany osobních údajů, která je relevantní při kombinování dat z více zdrojů.
useCallerAADIdentity	boolean	Jestli se ke konfiguraci přihlašovacích údajů ke zdroji dat (přístupový token OAuth 2.0) použije Azure AD identita (přihlašovací údaje OAuth 2.0) volajícího rozhraní API (který musí být vlastníkem zdroje dat). Obvykle byste použili buď tento příznak, nebo `useEndUserOAuth2Credentials`.
useEndUserOAuth2Credentials	boolean	Určuje, jestli se při připojování ke zdroji dat v režimu DirectQuery používá identita koncového Azure AD uživatele (přihlašovací údaje OAuth 2.0). Používá se se zdroji dat, které podporují jednotné přihlašování (SSO). Obvykle byste použili buď tento příznak, nebo `useCallerAADIdentity`.

credentialType

Typ přihlašovacích údajů ke zdroji dat

Name	Typ	Description
Anonymous	string
Basic	string
Key	string
OAuth2	string
SAS	string
Windows	string

encryptedConnection

Určuje, jestli se má šifrovat připojení ke zdroji dat. Volání rozhraní API selže, pokud vyberete šifrování a Power BI nebude moct navázat šifrované připojení ke zdroji dat.

Name	Typ	Description
Encrypted	string
NotEncrypted	string

encryptionAlgorithm

Šifrovací algoritmus. Pro cloudový zdroj dat zadejte None. V případě místního zdroje dat zadejte RSA-OAEP a použijte veřejný klíč brány k šifrování přihlašovacích údajů.

Name	Typ	Description
None	string
RSA-OAEP	string

GatewayDatasource

Zdroj dat brány Power BI

Name

Typ

Description

connectionDetails

string

Podrobnosti o připojení ve formátu JSON

credentialDetails

GatewayDatasourceCredentialDetails

Podrobnosti o připojení ke zdroji dat, který je potřeba aktualizovat. Podrobnosti o připojení jsou povinné, pokud datová sada obsahuje více než jeden zdroj dat.

credentialType

Typ přihlašovacích údajů ke zdroji dat

datasourceName

string

Název zdroje dat

datasourceType

string

Typ zdroje dat.

Název rozhraní API pro zdroj dat
ActiveDirectory	AdobeAnalytics	AdoDotNet
AnalysisServices	AzureBlobs	AzureDataLakeStorage
AzureMarketplace	AzureTables	BizTalk
CDPA	CustomConnector	CustomHttpApi
DB2	Essbase	Centrum událostí
Excel	Výměna	Rozšíření
Facebook	File	Složka
GoogleAnalytics	Hdfs	HDInsight
Informix	MQ	MySQL
OData	ODBC	OleDb
Oracle	PostgreSQL	PowerQueryMashup
PubNub	Salesforce	SAPBW
SAPBWMessageServer	SapErp	SAPHana
SharePoint	SharePointDocLib	Seznam SharePointu
Sql	Sybase	Teradata
Tok uživatelského rozhraní	Web

gatewayId

string

ID přidružené brány. Při použití clusteru brány odkazuje ID brány na primární (první) bránu v clusteru a je podobné ID clusteru brány.

string

Jedinečné ID zdroje dat

GatewayDatasourceCredentialDetails

Podrobnosti o přihlašovacích údajích ke zdroji dat

Name	Typ	Description
useEndUserOAuth2Credentials	boolean	Určuje, jestli se při připojování ke zdroji dat v režimu DirectQuery používá identita koncového Azure AD uživatele (přihlašovací údaje OAuth 2.0). Používá se se zdroji dat, které podporují jednotné přihlašování (SSO).

privacyLevel

Úroveň ochrany osobních údajů, která je relevantní při kombinování dat z více zdrojů.

Name	Typ	Description
None	string
Organizational	string
Private	string
Public	string

PublishDatasourceToGatewayRequest

Žádost o publikování zdroje dat do brány

Name	Typ	Description
connectionDetails	string	Podrobnosti o připojení
credentialDetails	CredentialDetails	Podrobnosti o přihlašovacích údajích
dataSourceName	string	Název zdroje dat
dataSourceType	string	Typ zdroje dat

Sdílet prostřednictvím

Gateways - Create Datasource

Oprávnění

Požadovaný obor

Omezení

Parametry identifikátoru URI

Text požadavku

Odpovědi

Příklady

Azure Analysis Services example

Sample Request

Sample Response

SQL example

Sample Request

Sample Response

Definice

CredentialDetails

credentialType

encryptedConnection

encryptionAlgorithm

GatewayDatasource

GatewayDatasourceCredentialDetails

privacyLevel

PublishDatasourceToGatewayRequest

Další materiály