Datasets - Execute Queries

Layanan:: Power BI REST APIs

Versi API:: 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 gagal (400).

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

Data terbatas yang 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

Keterbatasan

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 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 menggunakan API Power BI di bawah pengaturan pengembang diaktifkan. Namun, terlepas dari pengaturan penyewa admin, Perwakilan Layanan tidak didukung untuk himpunan data dengan RLS per batasan RLS atau himpunan data dengan SSO diaktifkan.
Hanya kueri DAX yang didukung saat ini. Fungsi MDX, INFO, dan kueri 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 tataan hasil

Respons

Nama	Jenis	Deskripsi
200 OK	DatasetExecuteQueriesResponse	OKE

Contoh

Execute queries example

Permintaan sampel

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

Isi Permintaan

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

Respon sampel

Kode status:: 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, yang 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

Objek

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 saya temukan di objek detail yang disarangkan di bawah objek kesalahan.

DatasetExecuteQueriesInformationProtectionLabel

Objek

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

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

DatasetExecuteQueriesQuery

Objek

Kueri himpunan data

Nama	Jenis	Deskripsi
query	string	Kueri DAX yang akan dijalankan

DatasetExecuteQueriesQueryResult

Objek

Hasil dari satu kueri himpunan data

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

DatasetExecuteQueriesRequest

Objek

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 tataan hasil

DatasetExecuteQueriesResponse

Objek

Respons terhadap permintaan kueri eksekusi himpunan data

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

DatasetExecuteQueriesSerializationSettings

Objek

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

Objek

Tabel data

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