Interface do usuário do designer de consulta baseado em texto (Construtor de Relatórios do Power BI)
APLICA-SE A: 
Power BI Report Builder 
Power BI Desktop
Use o designer de consulta baseado em texto para especificar uma consulta usando o idioma de consulta suportado pela fonte de dados, execute a consulta e exiba os resultados no tempo de design. Você pode especificar várias instruções do Transact-SQL, consulta ou sintaxe de comando para as extensões de processamento de dados e consultas que são especificadas como expressões. Como o designer de consulta baseado em texto não processa previamente a consulta e pode acomodar qualquer tipo de sintaxe de consulta, esta é a ferramenta de designer de consulta padrão para muitos tipos de fontes de dados.
Importante
Os usuários acessam fontes de dados quando criam e executam consultas. Você deve conceder permissões mínimas nas fontes de dados, como permissões somente leitura.
O designer de consulta baseado em texto exibe uma barra de ferramentas e os dois painéis a seguir:
Consulta Mostra o texto da consulta, o nome da tabela ou o nome do procedimento armazenado, dependendo do tipo de consulta. Nem todos os tipos de consulta estão disponíveis para todos os tipos de fontes de dados. Por exemplo, nome da tabela tem suporte apenas para o tipo de fonte de dados OLE DB.
Resultado Mostra os resultados da execução da consulta em tempo de design.
Barra de ferramentas do designer de consulta baseado em texto
O designer de consulta baseado em texto fornece uma única barra de ferramentas para todos os tipos de comando. A tabela a seguir lista cada botão da barra de ferramentas e suas respectivas funções.
| Botão | Descrição |
|---|---|
| Editar como Texto | Alterna entre o designer de consulta baseado em texto e o designer de consultas gráficas. Nem todos os tipos de fonte de dados dão suporte aos designers de consultas gráficas. |
| Importaçãoação | Importa uma consulta existente de um arquivo ou relatório. Há suporte apenas para tipos de arquivo sql e rdl |
 |
Executa a consulta e exibe o conjunto de resultados no painel Resultado. |
| Tipo de Comando | Selecione Text, StoredProcedureou TableDirect. Se um procedimento armazenado tiver parâmetros, a caixa de diálogo Definir Parâmetros de Consulta será exibida quando você selecionar Executar na barra de ferramentas e você poderá preencher os valores conforme necessário. O suporte para o tipo de comando varia de acordo com o tipo da fonte de dados. Por exemplo, somente OLE DB e ODBC dão suporte a TableDirect. Observação: Se um procedimento armazenado retornar mais de um conjunto de resultados, somente o primeiro será usado para popular o conjunto de dados. |
Texto do tipo de comando
Quando você cria um conjunto de dados SQL Server , o designer de consulta relacional é aberto por padrão. Para alternar para o designer de consulta baseado em texto, selecione o botão de alternância Editar Como Texto na barra de ferramentas. O designer de consulta baseado em texto apresenta dois painéis: Consulta e Resultado. A imagem a seguir define cada painel.
A tabela a seguir descreve a função de cada painel.
| Painel | Função |
|---|---|
| Consulta | Exibe o texto da consulta do Transact-SQL. Use esse painel para gravar ou editar uma consulta do Transact-SQL. |
| Result | Exibe os resultados da consulta. Para executar a consulta, clique com o botão direito do mouse em qualquer painel e selecione Executarou selecione o botão Executar na barra de ferramentas. |
Exemplo
A consulta a seguir retorna a lista de sobrenomes da tabela ContactType do banco de dados AdventureWorks2014 para o esquema Person.
SELECT Name FROM Person.ContactType
Quando você seleciona Executar na barra de ferramentas, o comando no painel Consulta é executado e os resultados são exibidos no painel resultado. O conjunto de resultados exibe uma lista de 20 tipos de contatos, por exemplo, Proprietário ou Agente de Vendas.
Tipo de comando StoredProcedure
Quando você seleciona o Comando typeStoredProcedure, o designer de consulta baseado em texto apresenta dois painéis: Consulta e Resultado. Insira o nome do procedimento armazenado no painel Consulta e selecione Executar na barra de ferramentas. Se o procedimento armazenado usar parâmetros, a caixa de diálogo Definir Parâmetros de Consulta será aberta. Insira os valores dos parâmetros do procedimento armazenado. Um parâmetro de relatório é criado para cada parâmetro de entrada de procedimento armazenado.
A figura a seguir mostra os painéis Consulta e Resultados quando você executa um procedimento armazenado. Neste caso, os parâmetros de entrada são constantes.
A tabela a seguir descreve a função de cada painel.
| Painel | Função |
|---|---|
| Consulta | Exibe o nome do procedimento armazenado e os parâmetros de entrada. |
| Result | Exibe os resultados da consulta. Para executar a consulta, clique com o botão direito do mouse em qualquer painel e selecione Executarou selecione o botão Executar na barra de ferramentas. |
Exemplo
A consulta a seguir chama o procedimento armazenado uspGetWhereUsedProductIDdo AdventureWorks2014. Você deve inserir um valor para o parâmetro do número de identificação do produto quando executar a consulta.
uspGetWhereUsedProductID
Selecione o botão Executar (!). Quando os parâmetros de consulta forem solicitados, use a seguinte tabela para digitar valores.
| Parâmetro | Valor |
|---|---|
| @StartProductID | 820 |
| @CheckDate | 20010115 |
Para a data especificada, o conjunto de resultados exibe uma lista de 13 identificadores de produtos que usaram o número de componente especificado.
Tipo de comando TableDirect
Quando você seleciona o Comando typeTableDirect, o designer de consulta baseado em texto apresenta dois painéis: Consulta e Resultado. Quando você insere uma tabela e seleciona o botão Executar, todas as colunas dessa tabela são retornadas.
Exemplo
Para um tipo de fonte de dados OLE DB, a seguinte consulta de banco de dados retorna um conjunto de resultados para todos os tipos de contatos no banco de dados AdventureWorks2014.
Person.ContactType
Quando você insere o nome da tabela Person.ContactType, esse procedimento equivale à criação da instrução Transact-SQL do SELECT * FROM Person.ContactType.