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 darán lugar a:

• 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.
• 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 del inquilino Conjunto de datos Ejecutar consultas REST API, 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 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 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 alcance 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 dividido entre 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 consultado.
• Para usar entidades de servicio, asegúrese de que la configuración del inquilino de administrador Permita 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 limitaciones de RLS por RLS o conjuntos de datos con SSO habilitado.
• Solo se admiten consultas DAX en este momento. No se admiten consultas MDX y DMV.
  
  

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

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

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

Definiciones

DatasetExecuteQueriesError

Detalles de un error, si está presente.

DatasetExecuteQueriesInformationProtectionLabel

Detalles de la etiqueta de protección de la 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

Una solicitud para ejecutar consultas en un conjunto de datos

DatasetExecuteQueriesResponse

Respuesta a una solicitud de ejecución de consultas de conjunto de datos

DatasetExecuteQueriesSerializationSettings

La configuración de serialización para los resultados de una consulta de conjunto de datos

DatasetExecuteQueriesTableResult

Una tabla de datos