Datasets - Update Datasources In Group

Başvuru

Service:: Power BI REST APIs

API Version:: v1.0

Belirtilen çalışma alanından belirtilen veri kümesinin veri kaynaklarını Güncelleştirmeler.

Not

Bu API çağrısıyla gelişmiş veri kümesi meta verilerini kullanmanızı öneririz.

Önemli

Özgün veri kaynağı ve yeni veri kaynağı tam olarak aynı şemaya sahip olmalıdır.
Gelişmiş veri kümesi meta verileri kullanıyorsanız yeni veri kaynaklarından veri almak için veri kümesini yenileyin.
Gelişmiş veri kümesi meta verilerini kullanmıyorsanız, veri kaynaklarını güncelleştirme işleminin tamamlanması için 30 dakika bekleyin ve ardından veri kümesini yenileyin.

İzinler

Kullanıcının veri kümesi sahibi olması gerekir.
Bu API çağrısı bir hizmet sorumlusu profili tarafından çağrılabilir. Daha fazla bilgi için bkz. Power BI Embedded hizmet sorumlusu profilleri.

Gerekli Kapsam

Dataset.ReadWrite.All

Sınırlamalar

Genel XMLA uç noktası kullanılarak oluşturulan veya değiştirilen veri kümeleri desteklenmez. Bu veri kaynaklarında değişiklik yapmak için yöneticinin Tablosal Nesne Modeli için Azure Analysis Services istemci kitaplığını kullanması gerekir.
Yalnızca bu veri kaynakları desteklenir: SQL Server, Azure SQL Server, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata ve SAP HANA. Diğer veri kaynakları için Grup API'sindeki Parametreleri Güncelleştir çağrısını kullanın.
Veri kaynağı türünün değiştirilmesi desteklenmez.
bağlantı dizesi parametreleri içeren veri kaynakları desteklenmez.
Birleştirilmiş veya birleştirilmiş tabloların parçası olan veri kaynaklarının güncelleştirilmesi yalnızca gelişmiş veri kümesi meta verileri kullanıyorsanız desteklenir.
Birden çok veri kaynağına başvuran Gelişmiş Sorgu için yalnızca ilk veri kaynağı güncelleştirilir. Bu sınırlamayı aşmak için veri kaynağını parametre olarak tanımlayın ve Grup API'sindeki Parametreleri Güncelleştir çağrısını kullanın.
Artımlı yenileme ilkesine sahip veri kümeleri tam olarak desteklenmez; bu API'yi çağırmak beklendiği gibi çalışmayabilir ve kısmi veri kaynakları güncelleştirmesinin sonucu olabilir. Bunun üstesinden gelmek için bu API'yi çağırmadan önce veri kümesi yenilemesi çalıştırmayı deneyebilirsiniz.

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/Default.UpdateDatasources

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetId	path	True	string
groupId	path	True	string uuid	Çalışma alanı kimliği

İstek Gövdesi

Name	Gerekli	Tür	Description
updateDetails	True	UpdateDatasourceConnectionRequest[]	Veri kaynağı bağlantı güncelleştirme istekleri dizisi

Yanıtlar

Name	Tür	Description
200 OK		Tamam

Örnekler

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateDatasources

Request Body

{
  "updateDetails": [
    {
      "datasourceSelector": {
        "datasourceType": "Sql",
        "connectionDetails": {
          "server": "My-Sql-Server",
          "database": "My-Sql-Database"
        }
      },
      "connectionDetails": {
        "server": "New-Sql-Server",
        "database": "New-Sql-Database"
      }
    },
    {
      "datasourceSelector": {
        "datasourceType": "OData",
        "connectionDetails": {
          "url": "http://services.odata.org/V4/Northwind/Northwind.svc"
        }
      },
      "connectionDetails": {
        "url": "http://services.odata.org/V4/Odata/Northwind.svc"
      }
    }
  ]
}

Sample Response

Status code:: 200

Tanımlar

Name	Description
Datasource	Power BI veri kaynağı
DatasourceConnectionDetails	Power BI veri kaynağı bağlantı ayrıntıları. Veri Kaynaklarını Alma veya Grup halinde Veri Kaynakları Alma ile ilgili örneklere bakın.
UpdateDatasourceConnectionRequest	Power BI veri kümesi veri kaynağı bağlantı güncelleştirme isteği
UpdateDatasourcesRequest	Power BI veri kümesi veri kaynakları güncelleştirme isteği

Datasource

Power BI veri kaynağı

Name	Tür	Description
connectionDetails	DatasourceConnectionDetails	Veri kaynağı bağlantı ayrıntıları
connectionString	string	(Kullanım dışı) Veri kaynağı bağlantı dizesi. Yalnızca DirectQuery için kullanılabilir.
datasourceId	string	Ağ geçidine bağlı olmadığında boş olan bağlı veri kaynağı kimliği
datasourceType	string	Veri kaynağı türü
gatewayId	string	Bir ağ geçidine bağlı olmadığında boş olan bağlı ağ geçidi kimliği. Ağ geçidi kümesi kullanılırken, ağ geçidi kimliği kümedeki birincil (ilk) ağ geçidine başvurur ve ağ geçidi küme kimliğine benzer.
name	string	(Kullanım dışı) Veri kaynağı adı. Yalnızca DirectQuery için kullanılabilir.

DatasourceConnectionDetails

Power BI veri kaynağı bağlantı ayrıntıları. Veri Kaynaklarını Alma veya Grup halinde Veri Kaynakları Alma ile ilgili örneklere bakın.

Name	Tür	Description
account	string	Bağlantı hesabı
classInfo	string	Bağlantı sınıfı bilgileri
database	string	Bağlantı veritabanı
domain	string	Bağlantı etki alanı
emailAddress	string	Bağlantı e-posta adresi
kind	string	Bağlantı türü
loginServer	string	Bağlantı oturum açma sunucusu
path	string	Bağlantı yolu
server	string	Bağlantı sunucusu
url	string	Bağlantı URL'si

UpdateDatasourceConnectionRequest

Power BI veri kümesi veri kaynağı bağlantı güncelleştirme isteği

Name	Tür	Description
connectionDetails	DatasourceConnectionDetails	Güncelleştirilmiş veri kaynağının hedef bağlantı ayrıntıları
datasourceSelector	Datasource	Güncelleştirilmesi gereken veri kaynağının bağlantı ayrıntıları. Bir veri kümesinin birden fazla veri kaynağı olduğunda bu zorunludur.

UpdateDatasourcesRequest

Power BI veri kümesi veri kaynakları güncelleştirme isteği

Name	Tür	Description
updateDetails	UpdateDatasourceConnectionRequest[]	Veri kaynağı bağlantı güncelleştirme istekleri dizisi