Datasets - Execute Queries

Başvuru

Service:: Power BI REST APIs

API Version:: v1.0

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

DAX sorgu hataları şu sonuçlara neden olur:

gibi DAX query failurebir yanıt hatası.
Hata HTTP durum kodu (400).

Birden fazla tablo veya izin verilen tablo satırı sayısından daha fazlasını isteyen bir sorgu şu sonucu verir:

Sınırlı veri döndürülüyor.
veya More than {allowed number} rows in a query resultgibi More than one result table in a query 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'sinin 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ırlamalar

Azure Analysis Services barındırılan veya şirket içi Azure Analysis Services modeline 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ütunu sorgularsanız, en fazla 50.000 satır (1 milyon bölü 20) alabilirsiniz.
Sorgu başına en fazla 15 MB veri. 15 MB aşıldığında geçerli satır tamamlanır ancak başka 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 Geliştirici ayarları altındaki Hizmet sorumlularının Power BI API'lerini kullanmasına izin ver yönetici kiracı ayarının etkinleştirildiğinden emin olun. Ancak, yönetici kiracı ayarından bağımsız olarak Hizmet Sorumluları RLS başına RLS sınırlamaları olan veri kümeleri veya SSO'nun etkinleştirildiği veri kümeleri için desteklenmez.
Şu anda yalnızca DAX sorguları desteklenmektedir. MDX 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'i. 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

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"
            }
          ]
        }
      ]
    }
  ]
}

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

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

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

Veri kümesi sorgusu

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

DatasetExecuteQueriesQueryResult

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

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'i. 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

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

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

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

DatasetExecuteQueriesTableResult

Veri tablosu

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

Aracılığıyla paylaş