Datasets - Execute Queries In Group

Referência

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Executa consultas DAX (Expressões de Análise de Dados) no conjunto de dados fornecido.

Os erros de consulta DAX resultarão em:

Um erro de resposta, como DAX query failure.
Um código de status HTTP de falha (400).

Uma consulta que solicita mais de uma tabela ou mais do que o número permitido de linhas de tabela resultará em:

Dados limitados sendo retornados.
Um erro de resposta, como More than one result table in a query ou More than {allowed number} rows in a query result.
Um código de status HTTP bem-sucedido (200).

As colunas totalmente qualificadas na consulta serão retornadas com um nome totalmente qualificado, por exemplo, MyTable[MyColumn]. As colunas renomeadas ou criadas na consulta serão retornadas dentro do colchete, por exemplo, [MyNewColumn].

Permissões

A configuração do locatário a API REST executar consultas do conjunto de dados, encontrada nas configurações de integração , deve estar habilitada.

O usuário deve ter acesso ao workspace e permissões de leitura e compilação do conjunto de dados. Para obter mais informações, consulte Gerenciar permissões de acesso do conjunto de dados.

Escopo necessário

Dataset.ReadWrite.All ou Dataset.Read.All

Limitações

Não há suporte para conjuntos de dados hospedados no Azure Analysis Services ou que têm uma conexão dinâmica com um modelo local do Azure Analysis Services.
Uma consulta por chamada à API.
Uma solicitação de tabela por consulta.
Máximo de 100.000 linhas ou 1.000.000 valores por consulta (o que for atingido primeiro). Por exemplo, se você consultar cinco colunas, poderá recuperar o máximo de 100.000 linhas. Se você consultar 20 colunas, poderá recuperar o máximo de 50.000 linhas (1 milhão dividido por 20).
Máximo de 15 MB de dados por consulta. Depois que 15 MB for excedido, a linha atual será concluída, mas nenhuma linha adicional será gravada.
Há um limite de 120 solicitações de consulta por minuto por usuário, independentemente do conjunto de dados consultado.
Para usar as Entidades de Serviço, verifique se a configuração do locatário do administrador Permitir que as entidades de serviço usem as APIs do Power BI em configurações do Desenvolvedor está habilitada. No entanto, independentemente da configuração do locatário do administrador, não há suporte para entidades de serviço para conjuntos de dados com RLS por limitações de RLS ou conjuntos de dados com SSO habilitado.
No momento, há suporte apenas para consultas DAX. Não há suporte para MDX, funções INFO e consultas DMV.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
datasetId	path	True	string	A ID do conjunto de dados
groupId	path	True	string uuid	A ID do workspace

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
queries	True	DatasetExecuteQueriesQuery[]	A lista de consultas de conjunto de dados a serem executadas
impersonatedUserName		string	O UPN de um usuário a ser representado. Se o modelo não estiver habilitado para RLS, isso será ignorado.
serializerSettings		DatasetExecuteQueriesSerializationSettings	As configurações de serialização do conjunto de resultados

Respostas

Nome	Tipo	Description
200 OK	DatasetExecuteQueriesResponse	OKEY

Exemplos

Execute queries example

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/executeQueries

Corpo da solicitação

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

Resposta de exemplo

Código de status:: 200

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

Definições

Nome	Description
DatasetExecuteQueriesError	Os detalhes de um erro, se estiverem presentes.
DatasetExecuteQueriesInformationProtectionLabel	Os detalhes do rótulo de proteção de informações, se houver, associados ao conjunto de dados.
DatasetExecuteQueriesQuery	Uma consulta de conjunto de dados
DatasetExecuteQueriesQueryResult	Os resultados de uma única consulta de conjunto de dados
DatasetExecuteQueriesRequest	Uma solicitação para executar consultas em um conjunto de dados
DatasetExecuteQueriesResponse	A resposta a uma solicitação de consultas de execução de conjunto de dados
DatasetExecuteQueriesSerializationSettings	As configurações de serialização para os resultados de uma consulta de conjunto de dados
DatasetExecuteQueriesTableResult	Uma tabela de dados

DatasetExecuteQueriesError

Os detalhes de um erro, se estiverem presentes.

Nome	Tipo	Description
code	string	O código associado ao erro
message	string	A mensagem do erro. Se não estiver presente aqui, essas informações também serão encontradas no objeto de detalhes aninhado sob o objeto de erro.

DatasetExecuteQueriesInformationProtectionLabel

Os detalhes do rótulo de proteção de informações, se houver, associados ao conjunto de dados.

Nome	Tipo	Description
id	string	O identificador (guid) do rótulo de proteção de informações
name	string	O nome de exibição do rótulo de proteção de informações

DatasetExecuteQueriesQuery

Uma consulta de conjunto de dados

Nome	Tipo	Description
query	string	A consulta DAX a ser executada

DatasetExecuteQueriesQueryResult

Os resultados de uma única consulta de conjunto de dados

Nome	Tipo	Description
error	DatasetExecuteQueriesError	Os detalhes de um erro, se estiverem presentes.
tables	DatasetExecuteQueriesTableResult[]	Uma lista de dados de tabelas para uma consulta

DatasetExecuteQueriesRequest

Uma solicitação para executar consultas em um conjunto de dados

Nome	Tipo	Description
impersonatedUserName	string	O UPN de um usuário a ser representado. Se o modelo não estiver habilitado para RLS, isso será ignorado.
queries	DatasetExecuteQueriesQuery[]	A lista de consultas de conjunto de dados a serem executadas
serializerSettings	DatasetExecuteQueriesSerializationSettings	As configurações de serialização do conjunto de resultados

DatasetExecuteQueriesResponse

A resposta a uma solicitação de consultas de execução de conjunto de dados

Nome	Tipo	Description
error	DatasetExecuteQueriesError	Os detalhes de um erro, se estiverem presentes.
informationProtectionLabel	DatasetExecuteQueriesInformationProtectionLabel	Os detalhes do rótulo de proteção de informações, se houver, associados ao conjunto de dados.
results	DatasetExecuteQueriesQueryResult[]	A lista de resultados, uma por consulta de entrada.

DatasetExecuteQueriesSerializationSettings

As configurações de serialização para os resultados de uma consulta de conjunto de dados

Nome	Tipo	Description
includeNulls	boolean	Se valores nulos (em branco) devem ser incluídos no conjunto de resultados. Se não for especificado, o valor padrão será `false`.

DatasetExecuteQueriesTableResult

Uma tabela de dados

Nome	Tipo	Description
error	DatasetExecuteQueriesError	Os detalhes de um erro, se estiverem presentes.
rows	object[]	Uma lista de linhas

Partilhar via