Query Execution - Execute Query

Serviço:: Dataflow

Versão da API:: v1

Executa uma consulta contra um fluxo de dados e devolve o resultado.
Executa uma consulta especificada contra um fluxo de dados e transmite os resultados no formato especificado pelo Accept cabeçalho. O formato padrão é Apache Arrow. Suporta o uso de documentos mashup personalizados para cenários avançados.

Use o Accept cabeçalho para controlar o formato da resposta:

application/vnd.apache.arrow.stream;pq.arrow.version=1 (por defeito), application/vnd.apache.arrow.stream;pq.arrow.version=2 — Formato de streaming Apache Arrow.

Esta API suporta operações de longa duração (LRO).

Permissions

O chamador deve ter permissões de execução para o fluxo de dados.

Escopos delegados necessários

Dataflow.Execute.All ou Item.Execute.All.

Limitações

As consultas podem correr durante um máximo de 90 segundos.

Identidades suportadas pelo Entra da Microsoft

Esta API suporta as identidades do Microsoft listadas nesta secção.

Identidade	Support
User	Yes
Entidade de serviço e identidades geridas	Yes

Interfaz

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataflows/{dataflowId}/executeQuery

Parâmetros do URI

Name	Em	Obrigatório	Tipo	Descrição
dataflowId	path	True	string (uuid)	O ID do fluxo de dados.
workspaceId	path	True	string (uuid)	O ID do espaço de trabalho.

Cabeçalho do Pedido

Name	Obrigatório	Tipo	Descrição
Accept		string	O tipo de media desejado para a resposta. Valores atualmente suportados: `application/vnd.apache.arrow.stream;pq.arrow.version=1` (por defeito), `application/vnd.apache.arrow.stream;pq.arrow.version=2`.

Corpo do Pedido

Name	Obrigatório	Tipo	Descrição
queryName	True	string	O nome da consulta a executar a partir do fluxo de dados (ou do documento personalizado de mashup, se fornecida).
customMashupDocument		string	Documento de mashup personalizado opcional para sobrepor o mashup padrão do dataflow.

Respostas

Name	Tipo	Descrição
200 OK	file	O resultado da consulta foi transmitido com sucesso. O formato da resposta depende do `Accept` cabeçalho: application/vnd.apache.arrow.stream; pq.arrow.version=1 (padrão), application/vnd.apache.arrow.stream; pq.arrow.version=2 — Os resultados são transmitidos em formato Apache Arrow. Consulte a documentação do Arrow sobre como ler o fluxo em Python e outras linguagens. Para ambas as versões do Arrow, os erros encontrados durante a execução ou streaming da consulta estarão numa coluna adicional chamada 'PQ Arrow Metadata'.
202 Accepted		Pedido aceite, execução da consulta em andamento. Cabeçalhos Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	O limite de tarifa de serviço foi ultrapassado. O servidor devolve um `Retry-After` cabeçalho que indica, em segundos, quanto tempo o cliente deve esperar antes de enviar pedidos adicionais. Cabeçalhos Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de erro comuns: DataflowExecuteQueryError - Falha na execução da consulta. Algumas razões possíveis incluem: o nome da consulta especificado é inválido ou vazio, o documento personalizado de mashup é inválido, ou o nome de consulta especificado não foi encontrado no fluxo de dados (ou no documento personalizado de mashup, se fornecido).

Definições

Name	Descrição
ErrorRelatedResource	O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse	A resposta de erro.
ErrorResponseDetails	Os detalhes da resposta de erro.
ExecuteQueryRequest	Solicite carga útil para executar uma consulta num fluxo de dados.

ErrorRelatedResource

Object

O objeto de detalhes do recurso relacionado ao erro.

Name	Tipo	Descrição
resourceId	string	A ID do recurso envolvida no erro.
resourceType	string	O tipo de recurso envolvido no erro.

ErrorResponse

Object

A resposta de erro.

Name	Tipo	Descrição
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
isRetriable	boolean	Quando confirmado, o pedido pode ser retentado. Use o `Retry-After` cabeçalho de resposta para determinar o atraso, se disponível.
message	string	Uma representação legível por humanos do erro.
moreDetails	ErrorResponseDetails[]	Lista de detalhes de erro adicionais.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.
requestId	string (uuid)	ID da solicitação associada ao erro.

ErrorResponseDetails

Object

Os detalhes da resposta de erro.

Name	Tipo	Descrição
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.

ExecuteQueryRequest

Object

Solicite carga útil para executar uma consulta num fluxo de dados.

Name	Tipo	Descrição
customMashupDocument	string	Documento de mashup personalizado opcional para sobrepor o mashup padrão do dataflow.
queryName	string	O nome da consulta a executar a partir do fluxo de dados (ou do documento personalizado de mashup, se fornecida).