Freigeben über

Datasets - Get Datasources

Dienst:
Power BI REST APIs
API-Version:
v1.0

Gibt eine Liste der Datenquellen für das angegebene Dataset aus My workspacezurück.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All 

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
 path True

string

Die Dataset-ID

Antworten

Name Typ Beschreibung
200 OK

Datasources

OKAY

Beispiele

Analysis Services example
Azure Blobs datasource example
Excel example
Extension datasource example
Microsoft Exchange datasource example
OData example
Oracle example
Salesforce datasource example
SAP HANA example
SharePoint example
SQL example

Analysis Services example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "@odata.context": "http://api.powerbi.com/v1.0/myorg/groups/222f0f33-3abc-4a57-9f98-ff01bd2aaabb/$metadata#datasources",
  "value": [
    {
      "datasourceType": "AnalysisServices",
      "connectionDetails": {
        "server": "My-As-Server",
        "database": "My-As-Database"
      },
      "datasourceId": "33cc5222-3fb9-44f7-b19d-ffbff18aaaf5",
      "gatewayId": "0a2dafe6-0e93-4120-8d2c-fae123c111b1"
    }
  ]
}

Azure Blobs datasource example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "datasourceType": "AzureBlobs",
      "datasourceId": "e0315274-90b6-4fc0-abf2-2d60d448cb04",
      "gatewayId": "7f1c4e55-544b-403f-b132-da0d3a024674",
      "connectionDetails": {
        "account": "myAccount",
        "domain": "blob.core.windows.net"
      }
    }
  ]
}

Excel example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "@odata.context": "http://api.powerbi.com/v1.0/myorg/groups/222f0f33-3abc-4a57-9f98-ff01bd2aaabb/$metadata#datasources",
  "value": [
    {
      "datasourceType": "File",
      "connectionDetails": {
        "path": "c:\\users\\username\\documents\\orders1.xlsx"
      },
      "datasourceId": "33cc5222-3fb9-44f7-b19d-ffbff18aaaf5",
      "gatewayId": "0a2dafe6-0e93-4120-8d2c-fae123c111b1"
    }
  ]
}

Extension datasource example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "datasourceType": "Extension",
      "datasourceId": "70540d95-4c8e-41ae-88c6-27a103b12841",
      "gatewayId": "7f1c4e55-544b-403f-b132-da0d3a024674",
      "connectionDetails": {
        "kind": "AzureDataExplorer",
        "path": "https://myserver.kusto.windows.net"
      }
    }
  ]
}

Microsoft Exchange datasource example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "datasourceType": "Exchange",
      "datasourceId": "4d126fc8-1568-46aa-ba16-ccf19b18f012",
      "gatewayId": "7f1c4e55-544b-403f-b132-da0d3a024674",
      "connectionDetails": {
        "emailAddress": "john@contoso.com"
      }
    }
  ]
}

OData example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "@odata.context": "http://api.powerbi.com/v1.0/myorg/groups/222f0f33-3abc-4a57-9f98-ff01bd2aaabb/$metadata#datasources",
  "value": [
    {
      "datasourceType": "OData",
      "connectionDetails": {
        "url": "http://services.odata.org/MyOdata/MyOdata.svc"
      },
      "datasourceId": "33cc5222-3fb9-44f7-b19d-ffbff18aaaf5",
      "gatewayId": "0a2dafe6-0e93-4120-8d2c-fae123c111b1"
    }
  ]
}

Oracle example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "@odata.context": "http://api.powerbi.com/v1.0/myorg/groups/222f0f33-3abc-4a57-9f98-ff01bd2aaabb/$metadata#datasources",
  "value": [
    {
      "datasourceType": "Oracle",
      "connectionDetails": {
        "server": "My-Oracle-Server",
        "database": "My-Oracle-Database"
      },
      "datasourceId": "33cc5222-3fb9-44f7-b19d-ffbff18aaaf5",
      "gatewayId": "0a2dafe6-0e93-4120-8d2c-fae123c111b1"
    }
  ]
}

Salesforce datasource example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "datasourceType": "Salesforce",
      "datasourceId": "e8a6e0f5-b244-402a-ba5a-4d578609ede3",
      "gatewayId": "7f1c4e55-544b-403f-b132-da0d3a024674",
      "connectionDetails": {
        "classInfo": "report-detail",
        "loginServer": "https://login.salesforce.com/"
      }
    }
  ]
}

SAP HANA example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "@odata.context": "http://api.powerbi.com/v1.0/myorg/groups/222f0f33-3abc-4a57-9f98-ff01bd2aaabb/$metadata#datasources",
  "value": [
    {
      "datasourceType": "SAPHana",
      "connectionDetails": {
        "server": "My-SapHana-Server",
        "database": "My-SapHana-Database"
      },
      "datasourceId": "33cc5222-3fb9-44f7-b19d-ffbff18aaaf5",
      "gatewayId": "0a2dafe6-0e93-4120-8d2c-fae123c111b1"
    }
  ]
}

SharePoint example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "@odata.context": "http://api.powerbi.com/v1.0/myorg/groups/222f0f33-3abc-4a57-9f98-ff01bd2aaabb/$metadata#datasources",
  "value": [
    {
      "datasourceType": "SharePointList",
      "connectionDetails": {
        "url": "https://microsoft.sharepoint.com/hello/myproj/"
      },
      "datasourceId": "33cc5222-3fb9-44f7-b19d-ffbff18aaaf5",
      "gatewayId": "0a2dafe6-0e93-4120-8d2c-fae123c111b1"
    }
  ]
}

SQL example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/datasources

Beispiel für eine Antwort

Statuscode:
200 
{
  "@odata.context": "http://api.powerbi.com/v1.0/myorg/groups/222f0f33-3abc-4a57-9f98-ff01bd2aaabb/$metadata#datasources",
  "value": [
    {
      "datasourceType": "Sql",
      "connectionDetails": {
        "server": "My-As-Server",
        "database": "My-As-Database"
      },
      "datasourceId": "33cc5222-3fb9-44f7-b19d-ffbff18aaaf5",
      "gatewayId": "0a2dafe6-0e93-4120-8d2c-fae123c111b1"
    }
  ]
}

Definitionen

Name Beschreibung
Datasource

Eine Power BI-Datenquelle
DatasourceConnectionDetails

Die Power BI-Datenquellenverbindungsdetails. Beispiele finden Sie in Get Datasources oder Get Datasources In Group.
Datasources

Der OData-Antwortwrapper für eine Power BI-Datenquellensammlung

Datasource

Objekt

Eine Power BI-Datenquelle

Name Typ Beschreibung
connectionDetails

DatasourceConnectionDetails

Details zur Datenquellenverbindung
connectionString

string

(Veraltet) Die Verbindungszeichenfolge der Datenquelle. Nur für DirectQuery verfügbar.
datasourceId

string (uuid)

Die gebundene Datenquellen-ID, die leer ist, wenn sie nicht an ein Gateway gebunden ist
datasourceType

string

Der Datenquellentyp
gatewayId

string (uuid)

Die gebundene Gateway-ID, die leer ist, wenn sie nicht an ein Gateway gebunden ist. Bei Verwendung eines Gatewayclusters bezieht sich die Gateway-ID auf das primäre (erste) Gateway im Cluster und ähnelt der Gatewaycluster-ID.
name

string

(Veraltet) Der Name der Datenquelle. Nur für DirectQuery verfügbar.

DatasourceConnectionDetails

Objekt

Die Power BI-Datenquellenverbindungsdetails. Beispiele finden Sie in Get Datasources oder Get Datasources In Group.

Name Typ Beschreibung
account

string

Das Verbindungskonto
classInfo

string

Die Verbindungsklasseninformationen
database

string

Die Verbindungsdatenbank
domain

string

Die Verbindungsdomäne
emailAddress

string

Die E-Mail-Adresse der Verbindung
kind

string

Die Verbindungsart
loginServer

string

Der Verbindungsanmeldungsserver
path

string

Der Verbindungspfad
server

string

Der Verbindungsserver
url

string

Die Verbindungs-URL

Datasources

Objekt

Der OData-Antwortwrapper für eine Power BI-Datenquellensammlung

Name Typ Beschreibung
@odata.context

string

OData-Kontext
value

Datasource[]

Die Datenquellenauflistung