Datasets - Execute Queries

Hizmet:: Power BI REST APIs

API Sürümü:: v1.0

Sağlanan veri kümesinde Veri Çözümleme İfadeleri (DAX) sorguları yürütür. Veri kümesinin çalışma alanım veya başka bir çalışma alanında bulunması gerekir.

DAX sorgu hataları aşağıdakilere neden olur:

DAX query failuregibi bir yanıt hatası.
Hata HTTP durum kodu (400).

Birden fazla tablo veya izin verilen tablo satırı sayısından daha fazla istekte bulunan bir sorgu şu şekilde sonuçlanır:

Sınırlı veri döndürülüyor.
More than one result table in a query veya More than {allowed number} rows in a query resultgibi bir yanıt hatası.
Başarılı bir HTTP durum kodu (200).

Sorguda tam olarak nitelenmiş sütunlar, örneğin MyTable[MyColumn]tam adla döndürülür. Sorguda yeniden adlandırılan veya oluşturulan sütunlar köşeli ayraç içinde döndürülür, örneğin [MyNewColumn].

İzinler

Tümleştirme ayarlarıaltında bulunan Veri Kümesi Yürütme Sorguları REST API kiracı ayarı etkinleştirilmelidir.

Kullanıcının veri kümesi okuma ve derleme izinlerine sahip olması gerekir. Daha fazla bilgi için bkz. veri kümesi erişim izinlerini yönetme.

Gerekli Kapsam

Dataset.ReadWrite.All veya Dataset.Read.All

Sınırlama

Azure Analysis Services'te barındırılan veya şirket içi Azure Analysis Services modeliyle canlı bağlantısı olan veri kümeleri desteklenmez.
API çağrısı başına bir sorgu.
Sorgu başına bir tablo isteği.
Sorgu başına en fazla 100.000 satır veya 1.000.000 değer (hangisi önce isabet edilirse). Örneğin, 5 sütun için sorgu yaparsanız en fazla 100.000 satır geri alabilirsiniz. 20 sütun sorgularsanız en fazla 50.000 satır (1 milyon satır 20'ye bölünür) geri alabilirsiniz.
Sorgu başına en fazla 15 MB veri. 15 MB aşıldıktan sonra geçerli satır tamamlanır ancak ek satır yazılamaz.
Sorgulanan veri kümesinden bağımsız olarak kullanıcı başına dakikada 120 sorgu isteği sınırı vardır.
Hizmet Sorumlularını kullanmak için, hizmet sorumlularının Geliştirici ayarları altındaPower BI API'lerini kullanmasına izin veryönetici kiracı ayarının etkinleştirildiğinden emin olun. Ancak, yönetici kiracı ayarından bağımsız olarak Hizmet Sorumluları, RLS sınırlamaları veya SSO etkin veri kümeleri başına RLS içeren veri kümeleri için desteklenmez.
Şu anda yalnızca DAX sorguları desteklenir. MDX, BİlGİ işlevleri ve DMV sorguları desteklenmez.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetId	path	True	string	Veri kümesi kimliği

İstek Gövdesi

Name	Gerekli	Tür	Description
queries	True	DatasetExecuteQueriesQuery[]	Yürütülecek veri kümesi sorgularının listesi
impersonatedUserName		string	Kimliğine bürünülecek kullanıcının UPN'sini. Model RLS etkin değilse, bu yoksayılır.
serializerSettings		DatasetExecuteQueriesSerializationSettings	Sonuç kümesi için serileştirme ayarları

Yanıtlar

Name	Tür	Description
200 OK	DatasetExecuteQueriesResponse	TAMAM

Örnekler

Execute queries example

Örnek isteği

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

İstek Gövdesi

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

Örnek yanıt

Durum kodu:: 200

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

Tanımlar

Name	Description
DatasetExecuteQueriesError	Varsa hatanın ayrıntıları.
DatasetExecuteQueriesInformationProtectionLabel	Varsa, veri kümesiyle ilişkili bilgi koruma etiketinin ayrıntıları.
DatasetExecuteQueriesQuery	Veri kümesi sorgusu
DatasetExecuteQueriesQueryResult	Tek bir veri kümesi sorgusunun sonuçları
DatasetExecuteQueriesRequest	Bir veri kümesinde sorgu yürütme isteği
DatasetExecuteQueriesResponse	Veri kümesi yürütme sorguları isteğine verilen yanıt
DatasetExecuteQueriesSerializationSettings	Veri kümesi sorgusunun sonuçları için serileştirme ayarları
DatasetExecuteQueriesTableResult	Veri tablosu

DatasetExecuteQueriesError

Object

Varsa hatanın ayrıntıları.

Name	Tür	Description
code	string	Hatayla ilişkili kod
message	string	Hata iletisi. Burada yoksa, bu bilgilerim hata nesnesinin altında iç içe yerleştirilmiş ayrıntılar nesnesinde de bulunur.

DatasetExecuteQueriesInformationProtectionLabel

Object

Varsa, veri kümesiyle ilişkili bilgi koruma etiketinin ayrıntıları.

Name	Tür	Description
id	string	Bilgi koruma etiketinin tanımlayıcısı (guid)
name	string	Bilgi koruma etiketinin görünen adı

DatasetExecuteQueriesQuery

Object

Veri kümesi sorgusu

Name	Tür	Description
query	string	Yürütülecek DAX sorgusu

DatasetExecuteQueriesQueryResult

Object

Tek bir veri kümesi sorgusunun sonuçları

Name	Tür	Description
error	DatasetExecuteQueriesError	Varsa hatanın ayrıntıları.
tables	DatasetExecuteQueriesTableResult[]	Sorgu için tablo verilerinin listesi

DatasetExecuteQueriesRequest

Object

Bir veri kümesinde sorgu yürütme isteği

Name	Tür	Description
impersonatedUserName	string	Kimliğine bürünülecek kullanıcının UPN'sini. Model RLS etkin değilse, bu yoksayılır.
queries	DatasetExecuteQueriesQuery[]	Yürütülecek veri kümesi sorgularının listesi
serializerSettings	DatasetExecuteQueriesSerializationSettings	Sonuç kümesi için serileştirme ayarları

DatasetExecuteQueriesResponse

Object

Veri kümesi yürütme sorguları isteğine verilen yanıt

Name	Tür	Description
error	DatasetExecuteQueriesError	Varsa hatanın ayrıntıları.
informationProtectionLabel	DatasetExecuteQueriesInformationProtectionLabel	Varsa, veri kümesiyle ilişkili bilgi koruma etiketinin ayrıntıları.
results	DatasetExecuteQueriesQueryResult[]	Giriş sorgusu başına bir sonuç listesi.

DatasetExecuteQueriesSerializationSettings

Object

Veri kümesi sorgusunun sonuçları için serileştirme ayarları

Name	Tür	Description
includeNulls	boolean	Sonuç kümesine null (boş) değerlerin eklenip eklenmeyeceği. Belirtilmezse, varsayılan değer `false`olur.

DatasetExecuteQueriesTableResult

Object

Veri tablosu

Name	Tür	Description
error	DatasetExecuteQueriesError	Varsa hatanın ayrıntıları.
rows	object[]	Satır listesi