Datasets - Execute Queries

Ejecuta consultas de expresiones de análisis de datos (DAX) en el conjunto de datos proporcionado. El conjunto de datos debe residir en Mi área de trabajo u otra área de trabajo.

Los errores de consulta DAX producirán lo siguiente:

  • Un error de respuesta, como DAX query failure.
  • Código de estado HTTP de error (400).

Una consulta que solicite más de una tabla, o más del número permitido de filas de tabla, dará como resultado:

  • Datos limitados que se devuelven.
  • Un error de respuesta, como More than one result table in a query o More than {allowed number} rows in a query result.
  • Un código de estado HTTP correcto (200).

Las columnas que están completas en la consulta se devolverán con un nombre completo, por ejemplo, MyTable[MyColumn]. Las columnas cuyo nombre se cambia o se crean en la consulta se devolverán entre corchetes, por ejemplo, [MyNewColumn].

Permisos

La configuración de inquilino conjunto de datos Ejecutar consultas rest, que se encuentra en Configuración de integración, debe estar habilitada.

El usuario debe tener permisos de lectura y compilación del conjunto de datos. Para obtener más información, consulte Administración de permisos de acceso al conjunto de datos.

Ámbito requerido

Dataset.ReadWrite.All o Dataset.Read.All

Limitaciones

  • No se admiten los conjuntos de datos hospedados en Azure Analysis Services o que tienen una conexión dinámica a un modelo de Azure Analysis Services local.
  • Una consulta por llamada API.
  • Una solicitud de tabla por consulta.
  • Máximo de 100 000 filas o 1000 000 000 valores por consulta (lo que se alcanza primero). Por ejemplo, si consulta 5 columnas, puede obtener un máximo de 100 000 filas. Si consulta 20 columnas, puede obtener un máximo de 50 000 filas (1 millón divididos por 20).
  • Máximo de 15 MB de datos por consulta. Una vez superados los 15 MB, se completará la fila actual, pero no se escribirán filas adicionales.
  • Hay un límite de 120 solicitudes de consulta por minuto por usuario, independientemente del conjunto de datos que se consulte.
  • Para usar entidades de servicio, asegúrese de que la configuración del inquilino de administrador Permitir que las entidades de servicio usen las API de Power BI en configuración del desarrollador está habilitada. Sin embargo, independientemente de la configuración del inquilino de administrador, las entidades de servicio no se admiten para conjuntos de datos con RLS por limitaciones de RLS o conjuntos de datos con SSO habilitado.
  • Solo se admiten consultas DAX en este momento. No se admiten las funciones MDX, las funciones INFO y las consultas DMV.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
datasetId
path True

string

Identificador del conjunto de datos

Cuerpo de la solicitud

Nombre Requerido Tipo Description
queries True

DatasetExecuteQueriesQuery[]

Lista de consultas de conjunto de datos que se van a ejecutar

impersonatedUserName

string

UpN de un usuario que se va a suplantar. Si el modelo no está habilitado para RLS, se omitirá.

serializerSettings

DatasetExecuteQueriesSerializationSettings

La configuración de serialización del conjunto de resultados

Respuestas

Nombre Tipo Description
200 OK

DatasetExecuteQueriesResponse

De acuerdo

Ejemplos

Execute queries example

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
DatasetExecuteQueriesError

Detalles de un error, si está presente.

DatasetExecuteQueriesInformationProtectionLabel

Detalles de la etiqueta de protección de información, si existe, asociada al conjunto de datos.

DatasetExecuteQueriesQuery

Una consulta de conjunto de datos

DatasetExecuteQueriesQueryResult

Resultados de una sola consulta de conjunto de datos

DatasetExecuteQueriesRequest

Solicitud para ejecutar consultas en un conjunto de datos

DatasetExecuteQueriesResponse

La respuesta a una solicitud de ejecución de consultas de conjunto de datos

DatasetExecuteQueriesSerializationSettings

Configuración de serialización para los resultados de una consulta de conjunto de datos

DatasetExecuteQueriesTableResult

Una tabla de datos

DatasetExecuteQueriesError

Detalles de un error, si está presente.

Nombre Tipo Description
code

string

Código asociado al error

message

string

Mensaje del error. Si no está presente aquí, esta información también se encuentra en el objeto de detalles anidado bajo el objeto de error.

DatasetExecuteQueriesInformationProtectionLabel

Detalles de la etiqueta de protección de información, si existe, asociada al conjunto de datos.

Nombre Tipo Description
id

string

Identificador (guid) de la etiqueta de protección de la información

name

string

Nombre para mostrar de la etiqueta de protección de información

DatasetExecuteQueriesQuery

Una consulta de conjunto de datos

Nombre Tipo Description
query

string

Consulta DAX que se va a ejecutar

DatasetExecuteQueriesQueryResult

Resultados de una sola consulta de conjunto de datos

Nombre Tipo Description
error

DatasetExecuteQueriesError

Detalles de un error, si está presente.

tables

DatasetExecuteQueriesTableResult[]

Lista de datos de tablas para una consulta

DatasetExecuteQueriesRequest

Solicitud para ejecutar consultas en un conjunto de datos

Nombre Tipo Description
impersonatedUserName

string

UpN de un usuario que se va a suplantar. Si el modelo no está habilitado para RLS, se omitirá.

queries

DatasetExecuteQueriesQuery[]

Lista de consultas de conjunto de datos que se van a ejecutar

serializerSettings

DatasetExecuteQueriesSerializationSettings

La configuración de serialización del conjunto de resultados

DatasetExecuteQueriesResponse

La respuesta a una solicitud de ejecución de consultas de conjunto de datos

Nombre Tipo Description
error

DatasetExecuteQueriesError

Detalles de un error, si está presente.

informationProtectionLabel

DatasetExecuteQueriesInformationProtectionLabel

Detalles de la etiqueta de protección de información, si existe, asociada al conjunto de datos.

results

DatasetExecuteQueriesQueryResult[]

La lista de resultados, una por consulta de entrada.

DatasetExecuteQueriesSerializationSettings

Configuración de serialización para los resultados de una consulta de conjunto de datos

Nombre Tipo Description
includeNulls

boolean

Si los valores NULL (en blanco) deben incluirse en el conjunto de resultados. Si no se especifica, el valor predeterminado es false.

DatasetExecuteQueriesTableResult

Una tabla de datos

Nombre Tipo Description
error

DatasetExecuteQueriesError

Detalles de un error, si está presente.

rows

object[]

Lista de filas