Datasets - Update Datasources

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Updates sumber data himpunan data yang ditentukan dari Ruang kerja saya.

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 hingga operasi perbarui sumber data selesai, lalu refresh himpunan data.

Izin

Pengguna harus menjadi pemilik himpunan data.

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 API Parameter Pembaruan .
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 API Update Parameters .
Himpunan data dengan kebijakan refresh inkremental tidak sepenuhnya didukung, memanggil API ini mungkin tidak berfungsi seperti yang diharapkan dan hasil pembaruan sumber data parsial, untuk mengatasinya, Anda dapat mencoba menjalankan refresh himpunan data sebelum memanggil API ini.

Cakupan yang Diperlukan

Dataset.ReadWrite.All

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
datasetId	path	True	string	ID himpunan data

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/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 perlu diperbarui. 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

Share via