Datasets - Execute Queries

Ссылка

Служба:: Power BI REST APIs

Версия API:: v1.0

Выполняет запросы выражений анализа данных (DAX) к предоставленному набору данных. Набор данных должен находиться в моя рабочая область или другую рабочую область.

Ошибки запросов DAX приводят к следующим ошибкам:

Ошибка ответа, например DAX query failure.
Код состояния HTTP сбоя (400).

Запрос, запрашивающий несколько таблиц или более допустимого количества строк таблицы, приведет к следующему:

Возвращаемые ограниченные данные.
Ошибка ответа, например More than one result table in a query или More than {allowed number} rows in a query result.
Успешный код состояния HTTP (200).

Столбцы, полные в запросе, будут возвращены с полным именем, например, MyTable[MyColumn]. Столбцы, переименованные или созданные в запросе, будут возвращены в квадратной скобке, например [MyNewColumn].

Разрешения

Параметр клиента REST API выполнения запросов набора данных, который находится в разделе Параметры интеграции, должны быть включены.

Пользователь должен иметь разрешения на чтение и сборку набора данных. Дополнительные сведения см. в статье Управление разрешениями доступа к набору данных.

Требуемая область

Dataset.ReadWrite.All или Dataset.Read.All

Ограничения

Наборы данных, размещенные в Службах Azure Analysis Services или имеющие динамическое подключение к локальной модели Служб Azure Analysis Services, не поддерживаются.
Один запрос на вызов API.
Один запрос таблицы на запрос.
Не более 100 000 строк или 1 000 000 значений для каждого запроса (в зависимости от того, какой из них сначала достигается). Например, если запрашивать 5 столбцов, можно вернуть максимум 100 000 строк. Если вы запрашиваете 20 столбцов, можно вернуть максимум 50 000 строк (1 миллион, разделенный на 20).
Не более 15 МБ данных на запрос. После превышения 15 МБ текущая строка будет завершена, но дополнительные строки не будут записаны.
Существует ограничение в 120 запросов в минуту на пользователя, независимо от набора данных, который запрашивается.
Чтобы использовать субъекты-службы, убедитесь, что параметр клиента администратора Разрешить субъектам-службам использовать API Power BI в параметрах разработчика. Однако независимо от параметра клиента администратора субъекты-службы не поддерживаются для наборов данных с RLS на ограничения RLS или наборы данных с включенным единым входом.
В настоящее время поддерживаются только запросы DAX. Многомерные выражения, функции INFO и запросы dmV не поддерживаются.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
datasetId	path	True	string	Идентификатор набора данных

Текст запроса

Имя	Обязательно	Тип	Описание
queries	True	DatasetExecuteQueriesQuery[]	Список запросов набора данных для выполнения
impersonatedUserName		string	Имя участника-пользователя для олицетворения. Если модель не включена, это будет игнорироваться.
serializerSettings		DatasetExecuteQueriesSerializationSettings	Параметры сериализации для результирующий набор

Ответы

Имя	Тип	Описание
200 OK	DatasetExecuteQueriesResponse	ХОРОШО

Примеры

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

Пример ответа

Код состояния:: 200

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

Определения

Имя	Описание
DatasetExecuteQueriesError	Сведения об ошибке, если они присутствуют.
DatasetExecuteQueriesInformationProtectionLabel	Сведения о метки защиты информации, связанной с набором данных.
DatasetExecuteQueriesQuery	Запрос набора данных
DatasetExecuteQueriesQueryResult	Результаты из одного запроса набора данных
DatasetExecuteQueriesRequest	Запрос на выполнение запросов к набору данных
DatasetExecuteQueriesResponse	Ответ на запросы к набору данных
DatasetExecuteQueriesSerializationSettings	Параметры сериализации для результатов запроса набора данных
DatasetExecuteQueriesTableResult	Таблица данных

DatasetExecuteQueriesError

Object

Сведения об ошибке, если они присутствуют.

Имя	Тип	Описание
code	string	Код, связанный с ошибкой
message	string	Сообщение об ошибке. Если здесь нет, эти сведения также находятся в объекте details, вложенном в объект ошибки.

DatasetExecuteQueriesInformationProtectionLabel

Object

Сведения о метки защиты информации, связанной с набором данных.

Имя	Тип	Описание
id	string	Идентификатор (guid) метки защиты информации
name	string	Отображаемое имя метки защиты информации

DatasetExecuteQueriesQuery

Object

Запрос набора данных

Имя	Тип	Описание
query	string	Выполняемый запрос DAX

DatasetExecuteQueriesQueryResult

Object

Результаты из одного запроса набора данных

Имя	Тип	Описание
error	DatasetExecuteQueriesError	Сведения об ошибке, если они присутствуют.
tables	DatasetExecuteQueriesTableResult[]	Список данных таблиц для запроса

DatasetExecuteQueriesRequest

Object

Запрос на выполнение запросов к набору данных

Имя	Тип	Описание
impersonatedUserName	string	Имя участника-пользователя для олицетворения. Если модель не включена, это будет игнорироваться.
queries	DatasetExecuteQueriesQuery[]	Список запросов набора данных для выполнения
serializerSettings	DatasetExecuteQueriesSerializationSettings	Параметры сериализации для результирующий набор

DatasetExecuteQueriesResponse

Object

Ответ на запросы к набору данных

Имя	Тип	Описание
error	DatasetExecuteQueriesError	Сведения об ошибке, если они присутствуют.
informationProtectionLabel	DatasetExecuteQueriesInformationProtectionLabel	Сведения о метки защиты информации, связанной с набором данных.
results	DatasetExecuteQueriesQueryResult[]	Список результатов, по одному на входной запрос.

DatasetExecuteQueriesSerializationSettings

Object

Параметры сериализации для результатов запроса набора данных

Имя	Тип	Описание
includeNulls	boolean	Следует ли включать значения NULL (пустые) в результирующий набор. Если не указано, значение по умолчанию `false`.

DatasetExecuteQueriesTableResult

Object

Таблица данных

Имя	Тип	Описание
error	DatasetExecuteQueriesError	Сведения об ошибке, если они присутствуют.
rows	object[]	Список строк

Поделиться через

Datasets - Execute Queries

Разрешения

Требуемая область

Ограничения

Параметры URI

Текст запроса

Ответы

Примеры

Execute queries example

Образец запроса

Пример ответа

Определения

DatasetExecuteQueriesError

DatasetExecuteQueriesInformationProtectionLabel

DatasetExecuteQueriesQuery

DatasetExecuteQueriesQueryResult

DatasetExecuteQueriesRequest

DatasetExecuteQueriesResponse

DatasetExecuteQueriesSerializationSettings

DatasetExecuteQueriesTableResult

Дополнительные ресурсы