Datasets - Execute Queries

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

İstek Gövdesi

Yanıtlar

Örnekler

Execute queries example

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

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

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

Tanımlar

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