Gateways - Create Datasource

Odwołanie

Service:: Power BI REST APIs

API Version:: v1.0

Tworzy nowe źródło danych w określonej bramie lokalnej.

Poświadczenia lokalnego źródła danych muszą być szyfrowane. Parametr encryptedConnection musi być ustawiony na Encrypted , a poświadczenia powinny być szyfrowane przy użyciu klucza publicznego bramy.

Zobacz skrypt Create Gateway DataSource PowerShell (Tworzenie źródła danych bramy programu PowerShell), aby zapoznać się z przykładem użycia tego interfejsu API, ten skrypt używa skryptu programu PowerShell wymienionego w poniższej notatce w celu szyfrowania poświadczeń.

Uwaga

Aby zaszyfrować poświadczenia, zobacz Konfigurowanie poświadczeń programowo dla usługi Power BI i zapoznaj się z przykładami encryptCredentials .NET Core, Java, Python i PowerShell .

Uprawnienia

Obsługuje tylko bramy lokalne i użytkownik musi mieć uprawnienia administratora bramy

Wymagany zakres

Dataset.ReadWrite.All

Ograniczenia

Bramy sieci wirtualnej i chmury nie są obsługiwane.
Protokół OAuth2 jako typ poświadczeń nie jest obsługiwany.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
gatewayId	path	True	string uuid	Identyfikator bramy. W przypadku korzystania z klastra bramy identyfikator bramy odnosi się do bramy podstawowej (pierwszej) w klastrze. W takich przypadkach identyfikator bramy jest podobny do identyfikatora klastra bramy.

Treść żądania

Nazwa	Wymagane	Typ	Opis
connectionDetails	True	string	Szczegóły połączenia
credentialDetails	True	CredentialDetails	Szczegóły poświadczeń
dataSourceName	True	string	Nazwa źródła danych
dataSourceType	True	string	Typ źródła danych

Odpowiedzi

Nazwa	Typ	Opis
201 Created	GatewayDatasource	Utworzone

Przykłady

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

Definicje

Nazwa	Opis
CredentialDetails	Szczegóły poświadczeń
credentialType	Typ poświadczeń źródła danych
encryptedConnection	Czy chcesz zaszyfrować połączenie ze źródłem danych. Wywołanie interfejsu API zakończy się niepowodzeniem, jeśli wybierzesz szyfrowanie, a usługa Power BI nie może nawiązać zaszyfrowanego połączenia ze źródłem danych.
encryptionAlgorithm	Algorytm szyfrowania. W przypadku źródła danych w chmurze określ wartość `None`. W przypadku lokalnego źródła danych określ `RSA-OAEP` i użyj klucza publicznego bramy do zaszyfrowania poświadczeń.
GatewayDatasource	Źródło danych bramy usługi Power BI
GatewayDatasourceCredentialDetails	Szczegóły poświadczeń źródła danych
privacyLevel	Poziom prywatności, który jest istotny podczas łączenia danych z wielu źródeł.
PublishDatasourceToGatewayRequest	Żądanie publikowania źródła danych do bramy

CredentialDetails

Szczegóły poświadczeń

Nazwa	Typ	Opis
credentialType	credentialType	Typ poświadczeń
credentials	string	Poświadczenia, które zależą od wartości "credentialType". Aby uzyskać więcej informacji, zobacz Aktualizowanie przykładów źródła danych .
encryptedConnection	encryptedConnection	Czy chcesz zaszyfrować połączenie ze źródłem danych. Wywołanie interfejsu API zakończy się niepowodzeniem, jeśli wybierzesz szyfrowanie, a usługa Power BI nie może nawiązać zaszyfrowanego połączenia ze źródłem danych.
encryptionAlgorithm	encryptionAlgorithm	Algorytm szyfrowania. W przypadku źródła danych w chmurze określ wartość `None`. W przypadku lokalnego źródła danych określ `RSA-OAEP` i użyj klucza publicznego bramy do zaszyfrowania poświadczeń.
privacyLevel	privacyLevel	Poziom prywatności, który jest istotny podczas łączenia danych z wielu źródeł.
useCallerAADIdentity	boolean	Czy tożsamość Azure AD (poświadczenia OAuth 2.0) obiektu wywołującego interfejs API (który musi być właścicielem źródła danych) będzie używana do konfigurowania poświadczeń źródła danych (tokenu dostępu właściciela protokołu OAuth). Zazwyczaj należy użyć tej flagi lub `useEndUserOAuth2Credentials`.
useEndUserOAuth2Credentials	boolean	Czy tożsamość Azure AD użytkownika końcowego (poświadczenia OAuth 2.0) jest używana podczas nawiązywania połączenia ze źródłem danych w trybie DirectQuery. Użyj z źródłami danych, które obsługują logowanie jednokrotne (SSO). Zazwyczaj należy użyć tej flagi lub `useCallerAADIdentity`.

credentialType

Typ poświadczeń źródła danych

Nazwa	Typ	Opis
Anonymous	string
Basic	string
Key	string
OAuth2	string
SAS	string
Windows	string

encryptedConnection

Czy chcesz zaszyfrować połączenie ze źródłem danych. Wywołanie interfejsu API zakończy się niepowodzeniem, jeśli wybierzesz szyfrowanie, a usługa Power BI nie może nawiązać zaszyfrowanego połączenia ze źródłem danych.

Nazwa	Typ	Opis
Encrypted	string
NotEncrypted	string

encryptionAlgorithm

Algorytm szyfrowania. W przypadku źródła danych w chmurze określ wartość None. W przypadku lokalnego źródła danych określ RSA-OAEP i użyj klucza publicznego bramy do zaszyfrowania poświadczeń.

Nazwa	Typ	Opis
None	string
RSA-OAEP	string

GatewayDatasource

Źródło danych bramy usługi Power BI

Nazwa

Typ

Opis

connectionDetails

string

Szczegóły połączenia w formacie JSON

credentialDetails

GatewayDatasourceCredentialDetails

Szczegóły połączenia dla źródła danych, które wymaga aktualizacji. Szczegóły połączenia są obowiązkowe, gdy zestaw danych ma więcej niż jedno źródło danych.

credentialType

Typ poświadczeń źródła danych

datasourceName

string

Nazwa źródła danych

datasourceType

string

Typ źródła danych.

Nazwa interfejsu API dla źródła danych
ActiveDirectory	AdobeAnalytics	AdoDotNet
AnalysisServices	AzureBlobs	AzureDataLakeStorage
AzureMarketplace	AzureTables	BizTalk
CDPA	CustomConnector	CustomHttpApi
DB2	Essbase	EventHub
Excel	Exchange	Rozszerzenie
Facebook	File	Folder
GoogleAnalytics	Hdfs	HDInsight
Informix	MQ	MySql
OData	ODBC	OleDb
Oracle	PostgreSQL	PowerQueryMashup
PubNub	SalesForce	SAPBW
SAPBWMessageServer	SapErp	SAPHana
SharePoint	SharePointDocLib	Lista programu SharePoint
Sql	Sybase	Teradata
UIFlow	Internet

gatewayId

string

Skojarzony identyfikator bramy. W przypadku korzystania z klastra bramy identyfikator bramy odwołuje się do podstawowej (pierwszej) bramy w klastrze i jest podobny do identyfikatora klastra bramy.

string

Unikatowy identyfikator źródła danych

GatewayDatasourceCredentialDetails

Szczegóły poświadczeń źródła danych

Nazwa	Typ	Opis
useEndUserOAuth2Credentials	boolean	Czy tożsamość Azure AD użytkownika końcowego (poświadczenia OAuth 2.0) jest używana podczas nawiązywania połączenia ze źródłem danych w trybie DirectQuery. Użyj z źródłami danych, które obsługują logowanie jednokrotne (SSO).

privacyLevel

Poziom prywatności, który jest istotny podczas łączenia danych z wielu źródeł.

Nazwa	Typ	Opis
None	string
Organizational	string
Private	string
Public	string

PublishDatasourceToGatewayRequest

Żądanie publikowania źródła danych do bramy

Nazwa	Typ	Opis
connectionDetails	string	Szczegóły połączenia
credentialDetails	CredentialDetails	Szczegóły poświadczeń
dataSourceName	string	Nazwa źródła danych
dataSourceType	string	Typ źródła danych

Udostępnij za pośrednictwem

Gateways - Create Datasource

Uprawnienia

Wymagany zakres

Ograniczenia

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

Azure Analysis Services example

Sample Request

Sample Response

SQL example

Sample Request

Sample Response

Definicje

CredentialDetails

credentialType

encryptedConnection

encryptionAlgorithm

GatewayDatasource

GatewayDatasourceCredentialDetails

privacyLevel

PublishDatasourceToGatewayRequest

Dodatkowe zasoby