Datasets - Update Datasources In Group

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Updates sumber data himpunan data yang ditentukan dari ruang kerja yang ditentukan.

Catatan

Sebaiknya gunakan metadata himpunan data yang disempurnakan dengan panggilan API ini.

Penting

Sumber data asli dan sumber data baru harus memiliki skema yang sama persis.
Jika Anda menggunakan metadata himpunan data yang disempurnakan, refresh himpunan data untuk mendapatkan data dari sumber data baru.
Jika Anda tidak menggunakan metadata himpunan data yang disempurnakan, tunggu 30 menit agar operasi sumber data pembaruan selesai, lalu refresh himpunan data.

Izin

Pengguna harus menjadi pemilik himpunan data.
Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: Profil perwakilan layanan di Power BI Embedded.

Cakupan yang Diperlukan

Dataset.ReadWrite.All

Batasan

Himpunan data yang dibuat atau dimodifikasi menggunakan titik akhir XMLA publik tidak didukung. Untuk membuat perubahan pada sumber data tersebut, admin harus menggunakan pustaka klien Azure Analysis Services untuk Model Objek Tabular.
Hanya sumber data ini yang didukung: SQL Server, Azure SQL Server, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata, dan SAP Hana. Untuk sumber data lainnya, gunakan panggilan Perbarui Parameter Dalam API Grup .
Mengubah jenis sumber data tidak didukung.
Sumber data yang berisi parameter dalam string koneksi tidak didukung.
Memperbarui sumber data yang merupakan bagian dari tabel gabungan atau gabungan hanya didukung jika Anda menggunakan metadata himpunan data yang disempurnakan.
Untuk Kueri Tingkat Lanjut yang mereferensikan beberapa sumber data, hanya sumber data pertama yang akan diperbarui. Untuk mengatasi batasan ini, tentukan sumber data sebagai parameter dan gunakan panggilan Update Parameters In Group API.
Himpunan data dengan kebijakan refresh inkremental tidak didukung sepenuhnya, memanggil API ini mungkin tidak berfungsi seperti yang diharapkan dan hasil dari pembaruan sumber data parsial, untuk mengatasinya, Anda dapat mencoba menjalankan refresh himpunan data sebelum memanggil API ini.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
datasetId	path	True	string
groupId	path	True	string uuid	ID ruang kerja

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
updateDetails	True	UpdateDatasourceConnectionRequest[]	Array permintaan pembaruan koneksi sumber data

Respons

Nama	Jenis	Deskripsi
200 OK		OK

Contoh

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

Definisi

Nama	Deskripsi
Datasource	Sumber data Power BI
DatasourceConnectionDetails	Detail koneksi sumber data Power BI. Lihat contoh di Dapatkan Sumber Data atau Dapatkan Sumber Data Dalam Grup.
UpdateDatasourceConnectionRequest	Permintaan pembaruan koneksi sumber data himpunan data Power BI
UpdateDatasourcesRequest	Permintaan pembaruan sumber data himpunan data Power BI

Datasource

Sumber data Power BI

Nama	Jenis	Deskripsi
connectionDetails	DatasourceConnectionDetails	Detail koneksi sumber data
connectionString	string	(Tidak digunakan lagi) Sumber data string koneksi. Hanya tersedia untuk DirectQuery.
datasourceId	string	ID sumber data terikat, yang kosong saat tidak terikat ke gateway
datasourceType	string	Jenis sumber data
gatewayId	string	ID gateway terikat, yang kosong saat tidak terikat ke gateway. Saat menggunakan kluster gateway, ID gateway mengacu pada gateway utama (pertama) di kluster dan mirip dengan ID kluster gateway.
name	string	(Tidak digunakan lagi) Nama sumber data. Hanya tersedia untuk DirectQuery.

DatasourceConnectionDetails

Detail koneksi sumber data Power BI. Lihat contoh di Dapatkan Sumber Data atau Dapatkan Sumber Data Dalam Grup.

Nama	Jenis	Deskripsi
account	string	Akun koneksi
classInfo	string	Informasi kelas koneksi
database	string	Database koneksi
domain	string	Domain koneksi
emailAddress	string	Alamat email koneksi
kind	string	Jenis koneksi
loginServer	string	Server masuk koneksi
path	string	Jalur koneksi
server	string	Server koneksi
url	string	URL koneksi

UpdateDatasourceConnectionRequest

Permintaan pembaruan koneksi sumber data himpunan data Power BI

Nama	Jenis	Deskripsi
connectionDetails	DatasourceConnectionDetails	Detail koneksi target dari sumber data yang diperbarui
datasourceSelector	Datasource	Detail koneksi sumber data yang memerlukan pembaruan. Ini wajib ketika himpunan data memiliki lebih dari satu sumber data.

UpdateDatasourcesRequest

Permintaan pembaruan sumber data himpunan data Power BI

Nama	Jenis	Deskripsi
updateDetails	UpdateDatasourceConnectionRequest[]	Array permintaan pembaruan koneksi sumber data

Bagikan melalui