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

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