Datasets - Execute Queries

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Menjalankan kueri Data Analysis Expressions (DAX) terhadap himpunan data yang disediakan. Himpunan data harus berada di Ruang kerja saya atau ruang kerja lain.

Kesalahan kueri DAX akan mengakibatkan:

Kesalahan respons, seperti DAX query failure.
Kode status HTTP yang gagal (400).

Kueri yang meminta lebih dari satu tabel, atau lebih dari jumlah baris tabel yang diizinkan, akan menghasilkan:

Data terbatas dikembalikan.
Kesalahan respons, seperti More than one result table in a query atau More than {allowed number} rows in a query result.
Kode status HTTP yang berhasil (200).

Kolom yang sepenuhnya memenuhi syarat dalam kueri akan dikembalikan dengan nama yang sepenuhnya memenuhi syarat, misalnya, MyTable[MyColumn]. Kolom yang diganti namanya atau dibuat dalam kueri akan dikembalikan dalam kurung siku, misalnya, [MyNewColumn].

Izin

Pengaturan penyewa Dataset Execute Queries REST API, yang ditemukan di bawah Pengaturan integrasi, harus diaktifkan.

Pengguna harus memiliki izin baca dan bangun himpunan data. Untuk informasi selengkapnya, lihat Mengelola izin akses himpunan data.

Cakupan yang Diperlukan

Dataset.ReadWrite.All atau Dataset.Read.All

Batasan

Himpunan data yang dihosting di Azure Analysis Services atau yang memiliki koneksi langsung ke model Azure Analysis Services lokal tidak didukung.
Satu kueri per panggilan API.
Satu permintaan tabel per kueri.
Maksimum 100.000 baris atau 1.000.000 nilai per kueri (mana pun yang dipukul terlebih dahulu). Misalnya jika Anda mengkueri untuk 5 kolom, Anda bisa mendapatkan kembali maksimal 100.000 baris. Jika Anda mengkueri untuk 20 kolom, Anda bisa mendapatkan kembali maksimal 50.000 baris (1 juta dibagi 20).
Maksimum 15MB data per kueri. Setelah 15MB terlampaui, baris saat ini akan selesai tetapi tidak ada baris tambahan yang akan ditulis.
Ada batas 120 permintaan kueri per menit per pengguna, terlepas dari himpunan data yang dikueri.
Untuk menggunakan Perwakilan Layanan, pastikan pengaturan penyewa admin Izinkan perwakilan layanan untuk menggunakan API Power BI di bawah Pengaturan pengembang diaktifkan. Namun, terlepas dari pengaturan penyewa admin, Perwakilan Layanan tidak didukung untuk himpunan data dengan batasan RLS per RLS atau himpunan data dengan SSO diaktifkan.
Hanya kueri DAX yang didukung saat ini. Kueri MDX dan DMV tidak didukung.

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

Parameter URI

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

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
queries	True	DatasetExecuteQueriesQuery[]	Daftar kueri himpunan data yang akan dijalankan
impersonatedUserName		string	UPN pengguna yang akan ditiru. Jika model tidak diaktifkan RLS, ini akan diabaikan.
serializerSettings		DatasetExecuteQueriesSerializationSettings	Pengaturan serialisasi untuk kumpulan hasil

Respons

Nama	Jenis	Deskripsi
200 OK	DatasetExecuteQueriesResponse	OK

Contoh

Execute queries example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/executeQueries

Request Body

{
  "queries": [
    {
      "query": "EVALUATE VALUES(MyTable)"
    }
  ],
  "serializerSettings": {
    "includeNulls": true
  },
  "impersonatedUserName": "someuser@mycompany.com"
}

Sample Response

Status code:: 200

{
  "results": [
    {
      "tables": [
        {
          "rows": [
            {
              "MyTable[Year]": 2010,
              "MyTable[Quarter]": "Q1"
            },
            {
              "MyTable[Year]": 2010,
              "MyTable[Quarter]": "Q2"
            },
            {
              "MyTable[Year]": 2011,
              "MyTable[Quarter]": "Q1"
            }
          ]
        }
      ]
    }
  ]
}

Definisi

Nama	Deskripsi
DatasetExecuteQueriesError	Detail kesalahan, jika ada.
DatasetExecuteQueriesInformationProtectionLabel	Detail label perlindungan informasi, jika ada, terkait dengan himpunan data.
DatasetExecuteQueriesQuery	Kueri himpunan data
DatasetExecuteQueriesQueryResult	Hasil dari satu kueri himpunan data
DatasetExecuteQueriesRequest	Permintaan untuk menjalankan kueri terhadap himpunan data
DatasetExecuteQueriesResponse	Respons terhadap permintaan kueri eksekusi himpunan data
DatasetExecuteQueriesSerializationSettings	Pengaturan serialisasi untuk hasil kueri himpunan data
DatasetExecuteQueriesTableResult	Tabel data

DatasetExecuteQueriesError

Detail kesalahan, jika ada.

Nama	Jenis	Deskripsi
code	string	Kode yang terkait dengan kesalahan
message	string	Pesan kesalahan. Jika tidak ada di sini, informasi ini juga ditemukan di objek detail yang ditumpuk di bawah objek kesalahan.

DatasetExecuteQueriesInformationProtectionLabel

Detail label perlindungan informasi, jika ada, terkait dengan himpunan data.

Nama	Jenis	Deskripsi
id	string	Pengidentifikasi (guid) label perlindungan informasi
name	string	Nama tampilan label perlindungan informasi

DatasetExecuteQueriesQuery

Kueri himpunan data

Nama	Jenis	Deskripsi
query	string	Kueri DAX yang akan dijalankan

DatasetExecuteQueriesQueryResult

Hasil dari satu kueri himpunan data

Nama	Jenis	Deskripsi
error	DatasetExecuteQueriesError	Detail kesalahan, jika ada.
tables	DatasetExecuteQueriesTableResult[]	Daftar data tabel untuk kueri

DatasetExecuteQueriesRequest

Permintaan untuk menjalankan kueri terhadap himpunan data

Nama	Jenis	Deskripsi
impersonatedUserName	string	UPN pengguna yang akan ditiru. Jika model tidak diaktifkan RLS, ini akan diabaikan.
queries	DatasetExecuteQueriesQuery[]	Daftar kueri himpunan data yang akan dijalankan
serializerSettings	DatasetExecuteQueriesSerializationSettings	Pengaturan serialisasi untuk kumpulan hasil

DatasetExecuteQueriesResponse

Respons terhadap permintaan kueri eksekusi himpunan data

Nama	Jenis	Deskripsi
error	DatasetExecuteQueriesError	Detail kesalahan, jika ada.
informationProtectionLabel	DatasetExecuteQueriesInformationProtectionLabel	Detail label perlindungan informasi, jika ada, terkait dengan himpunan data.
results	DatasetExecuteQueriesQueryResult[]	Daftar hasil, satu per kueri input.

DatasetExecuteQueriesSerializationSettings

Pengaturan serialisasi untuk hasil kueri himpunan data

Nama	Jenis	Deskripsi
includeNulls	boolean	Apakah nilai null (kosong) harus disertakan dalam tataan hasil. Jika tidak ditentukan, nilai defaultnya adalah `false`.

DatasetExecuteQueriesTableResult

Tabel data

Nama	Jenis	Deskripsi
error	DatasetExecuteQueriesError	Detail kesalahan, jika ada.
rows	object[]	Daftar baris

Bagikan melalui