Datasets - Update Datasources
Çalışma alanım'dan 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.
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 Parametreleri Güncelleştir API ç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ı bir parametre olarak tanımlayın ve Parametreleri Güncelleştir API çağrısını kullanın.
- Artımlı yenileme ilkesine sahip veri kümeleri tam olarak desteklenmemektedir; bu API'yi çağırmak beklendiği gibi çalışmayabilir ve kısmi veri kaynakları güncelleştirmesinin sonucu olarak, bunun üstesinden gelmek için bu API'yi çağırmadan önce bir veri kümesi yenilemesi çalıştırmayı deneyebilirsiniz.
Gerekli Kapsam
Dataset.ReadWrite.All
POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.UpdateDatasources
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
dataset
|
path | True |
string |
Veri kümesi kimliği |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
updateDetails | True |
Veri kaynağı bağlantı güncelleştirme istekleri dizisi |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam |
Örnekler
Example
Örnek isteği
POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateDatasources
{
"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"
}
}
]
}
Örnek yanıt
Tanımlar
Name | Description |
---|---|
Datasource |
Power BI veri kaynağı |
Datasource |
Power BI veri kaynağı bağlantı ayrıntıları. Veri Kaynaklarını Alma veya Grup halinde Veri Kaynakları Alma ile ilgili örneklere bakın. |
Update |
Power BI veri kümesi veri kaynağı bağlantı güncelleştirme isteği |
Update |
Power BI veri kümesi veri kaynakları güncelleştirme isteği |
Datasource
Power BI veri kaynağı
Name | Tür | Description |
---|---|---|
connectionDetails |
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 |
Bir 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 |
Güncelleştirilmiş veri kaynağının hedef bağlantı ayrıntıları |
|
datasourceSelector |
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 |
Veri kaynağı bağlantı güncelleştirme istekleri dizisi |