Consultar através do editor de consulta SQL

Aplica-se a:✅Ponto de extremidade de análise de SQL, Warehouse e Banco de dados espelhado no Microsoft Fabric

Este artigo descreve como usar o editor de consulta SQL no portal do Microsoft Fabric para escrever consultas de forma rápida e eficiente e sugestões sobre a melhor maneira de ver as informações necessárias.

• Você também pode consultar os dados em seu armazém de dados usando várias ferramentas com uma string de conexão SQL.
• Você pode criar consultas graficamente usando o editor de consultas visuais.
• Você pode visualizar dados rapidamente na Visualização de dados.

O editor de consultas SQL fornece IntelliSense, preenchimento de código, realce de sintaxe, análise do lado do cliente e validação. Você pode executar instruções de DDL (Linguagem de Definição de Dados), DML (Linguagem de Manipulação de Dados) e DCL (Linguagem de Controle de Dados).

Editor de consulta SQL no portal do Fabric

O editor de consultas SQL fornece um editor de texto para gravar consultas usando T-SQL. Para acessar o editor de consulta SQL integrado:

• Crie uma nova consulta usando o botão Nova consulta SQL na faixa de opções.

  

• Selecione a lista suspensa modelos SQL para criar facilmente objetos T-SQL. Os modelos de código são preenchidos na janela de consulta SQL, conforme mostrado na imagem a seguir.

  

À medida que você trabalha em sua consulta SQL, esta será salva automaticamente a cada poucos segundos. Um indicador de "salvamento" aparece na guia de consulta para indicar que a consulta está sendo salva.

Trabalhe em várias tarefas ao mesmo tempo entre as guias de visualização de dados, consultas e modelagem

A experiência de visualização, consulta e modelagem de dados é aberta como guias individuais, entre as quais você pode alternar no editor. Se você estiver escrevendo uma consulta, poderá alternar entre ver uma visualização dos dados e exibir as relações entre as tabelas para as quais está escrevendo a consulta. Para exibir ou fechar todas as guias, selecione o ícone à direita de todas as guias.

Visualizar resultados da consulta

Depois de escrever a consulta T-SQL, selecione Executar para executar a consulta.

A prévia de Resultados aparece na seção Resultados. Se a consulta retornar mais de 10.000 linhas, a visualização mostrará apenas as primeiras 10.000 linhas. Você pode pesquisar uma cadeia de caracteres dentro da grade de resultados para filtrar linhas que correspondam aos critérios de pesquisa. A guia Mensagens mostra mensagens SQL retornadas quando a consulta SQL é executada.

A barra de status indica o status da consulta, a duração da execução e o número de linhas e colunas retornadas nos resultados.

Para habilitar Salvar como exibição, Salvar como tabela, Abrir no Excel, Explorar esses dados (versão prévia) e visualizar menus de resultados, realce a instrução SQL que contém a SELECT instrução no editor de consultas SQL.

Salvar como exibição

Selecione a consulta e salve a consulta como um modo de exibição usando o botão Salvar como exibição . Selecione um nome de esquema, forneça o nome da exibição e verifique a instrução SQL antes de confirmar a criação da exibição. Quando a visualização é criada com êxito, ela aparece no Explorer.

Salvar como tabela

Use Salvar como tabela para salvar os resultados da consulta em uma tabela. Selecione o warehouse onde você deseja salvar resultados, selecione um esquema e forneça um nome de tabela para carregar resultados na tabela usando a instrução CREATE TABLE AS SELECT . Quando a tabela é criada com êxito, ela aparece no Explorer.

Abrir no Excel

Selecione Abrir no Excel para abrir a consulta T-SQL correspondente no Excel e executar a consulta. Você pode trabalhar com os resultados no Microsoft Excel em seu computador local.

Siga essas etapas para trabalhar com arquivo do Excel localmente:

1. Depois de selecionar o botão Continuar, localize o arquivo Excel baixado no Explorador de Arquivos do Windows, por exemplo, na pasta Downloads do seu navegador.

2. Para visualizar os dados, selecione o botão Habilitar Edição na faixa de opções Exibição Protegida, seguido do botão Habilitar Conteúdo na faixa de opções Aviso de Segurança. Depois que ambos estiverem habilitados, você receberá a caixa de diálogo a seguir para aprovar a execução da consulta listada.

3. Selecione Executar.

4. Autentique sua conta usando a opção de conta da Microsoft. Selecione Conectar.

Depois de entrar com êxito, você verá os dados apresentados na planilha.

Explorar esses dados (preview)

Explorar esses dados (versão prévia) fornece a capacidade de executar a exploração ad hoc dos resultados da consulta. Usando esse recurso, você pode iniciar uma matriz lado a lado e uma exibição visual para entender melhor quaisquer tendências ou padrões por trás dos resultados da consulta antes de se aprofundar na criação de um relatório completo do Power BI. Para obter mais informações, consulte Explorar seus dados no serviço Power BI.

Visualizar os resultados

O menu Visualizar resultados permite criar relatórios com base nos resultados da consulta no editor de consulta SQL.

Copiar

O menu suspenso Copiar permite copiar os resultados e os nomes das colunas na grade de dados. Você pode optar por copiar resultados com nomes de coluna, copiar apenas os resultados ou copiar apenas os nomes de coluna.

Vários conjuntos de resultados

Quando você executa várias consultas e essas consultas retornam vários resultados, você pode selecionar a lista suspensa Resultados para ver resultados individuais.

Consulta entre warehouses

Para obter mais informações sobre consultas entre warehouses, consulte Consulta entre warehouses.

Você pode escrever uma consulta T-SQL com a convenção de nomenclatura de três partes para se referir a objetos e juntá-los entre armazéns, por exemplo:

SELECT
   emp.Employee
   ,SUM(Profit) AS TotalProfit
   ,SUM(Quantity) AS TotalQuantitySold
FROM
   [SampleWarehouse].[dbo].[DimEmployee] as emp
JOIN
   [WWI_Sample].[dbo].[FactSale] as sale
ON
   emp.EmployeeKey = sale.SalespersonKey
WHERE
   emp.IsSalesperson = 'TRUE'
GROUP BY
   emp.Employee
ORDER BY
   TotalProfit DESC;

Gerenciar consultas em execução ao fechar o editor de consultas

Quando uma consulta ainda estiver em execução e você fechar a guia editor de consultas, você poderá decidir se a consulta deve continuar em execução em segundo plano ou ser cancelada.

• Sim, continue executando a consulta: a consulta continua a ser executada em segundo plano, com uma notificação do tipo toast indicando que ela está em execução. Quando a consulta for concluída, uma notificação alertará você para que você possa retornar à consulta para exibir os resultados.

• Não, cancele a consulta: a consulta é encerrada imediatamente. Essa opção é útil para liberar recursos ou parar consultas que você não precisa mais.

• Lembre-se da minha preferência e não mostre novamente: salva sua escolha localmente nos cookies do navegador.

Atalhos do teclado

Os atalhos de teclado fornecem uma maneira rápida de navegar e trabalhar com mais eficiência no editor de consultas SQL. A tabela a seguir lista todos os atalhos disponíveis no Windows e no macOS, no navegador Edge, para o editor de consultas SQL no portal do Microsoft Fabric:

Função	Atalho do Windows	Atalho do macOS
Ações do editor de consultas
Executar todas as instruções SQL na guia de consulta ativa	Ctrl + Enter / Shift + Enter	Comando + Enter/Shift + Enter
Fechar guia atual	Ctrl + Shift + F4	Tecla Comando + Tecla Shift + F4
Cancelar a execução do script SQL	Ctrl + .	Command + .
Pesquisar cadeia de caracteres	Ctrl +F	Comando + F
Substituir cadeia de caracteres	CTRL + H	Comando + Opção + F
Desfazer	CTRL+Z	Comando + Z
Refaz	Ctrl+Y	Comando + Shift + Z
Ir uma palavra para a esquerda	Ctrl + Seta para esquerda	Comando + tecla de seta para a esquerda
Ir uma palavra para a direita	Ctrl + Tecla de direção para a direita	Comando + tecla de seta para a direita
Aumento de recuo	Guia	Guia
Diminuição do recuo	Shift + Tab	Shift + Tab
Comentar	Ctrl + K, Ctrl + C	Comando + K, Comando + C
Remover marca de comentário	Ctrl + K, Ctrl + U	Comando + K, Comando + U
Mover cursor para cima	Seta para Cima	Seta para Cima
Mover cursor para baixo	Seta para Baixo	Seta para Baixo
Selecionar tudo	CTRL+A	Comando + A
Explicar a consulta (Copilot)	Ctrl + Alt + E	Comando + Opção + E
Corrigir consulta (Copilot)	Ctrl + Alt + F	Comando + Opção + X
Ações da faixa de opções
Atualizar metadados	Ctrl + Shift + R	Comando + Shift + R
Abrir configurações	Ctrl + Shift + X	Comando + Shift + X
Copiar cadeia de conexão SQL	Ctrl + Shift + C	Cmd + Shift + C
Abrir atividade de consulta	Ctrl + Shift + A	Comando + Shift + A
Abrir painel de chat do Copilot	Ctrl + Shift + I	Comando + Shift + I
Novo modelo semântico	Ctrl + Shift + M	Comando + Shift + M
Nova consulta SQL	Ctrl + J	Comando + J
Nova consulta visual	Ctrl + Shift + J	Comando + Shift + J
Ações do Explorer
Expandir painel do Explorador	Ctrl + B	Comando + B
Recolher painel do explorador	Ctrl + B	Comando + B
Ações de resultados da consulta
Expandir resultados	Ctrl + R	Comando + R
Resultados do recolhimento	Ctrl + R	Comando + R

Limitações

• No editor de consulta SQL, sempre que você executa a consulta, ela abre uma sessão separada e a fecha no final da execução. Esse comportamento significa que, se você configurar o contexto de sessão para várias execuções de consulta, o contexto não será mantido para execução independente de consultas.

• Você pode executar instruções DDL (Linguagem de Definição de Dados), DML (Linguagem de Manipulação de Dados) e DCL (Linguagem de Controle de Dados), mas há limitações para instruções TCL (Linguagem de Controle de Transação). No editor de consultas SQL, quando você seleciona o botão Executar, está enviando uma solicitação de lote independente para execução. Cada ação Executar no editor de consulta SQL é uma solicitação em lote e uma sessão só existe por lote. Cada execução de código na mesma janela de consulta é executada em um lote e uma sessão diferentes.

  • Por exemplo, quando você executa instruções de transação de forma independente, o contexto da sessão não é mantido. Na captura de tela a seguir, BEGIN TRAN é executada na primeira solicitação, mas como a segunda solicitação é executada em uma sessão diferente, não há nenhuma transação a ser confirmada. A operação de confirmação ou reversão falha. Se o lote do SQL não incluir um COMMIT TRAN, as alterações aplicadas depois de BEGIN TRAN não serão confirmadas.

  

  • O editor de consultas SQL não dá suporte sp_set_session_context.

  • No editor de consulta SQL, o comando SQL GO cria um novo lote independente em uma nova sessão.

• Ao executar uma consulta SQL com USE, você precisa enviar a consulta SQL com USE uma única solicitação.

• Atualmente, a visualização de resultados não dá suporte a consultas SQL com uma ORDER BY cláusula.

• No momento, não há suporte para instruções T-SQL que usam a sintaxe T-SQL OPTION nas opções Explorar esses dados ou Visualizar resultados com o modo DirectQuery. A solução alternativa é criar visualizações no Power BI Desktop usando o modo de Importação.

• A tabela a seguir resume o comportamento esperado que não corresponde ao SQL Server Management Studio ou à extensão mssql com o Visual Studio Code:

  Cenário	Com suporte no SSMS/ADS	Com suporte no editor de consulta SQL no portal do Fabric
  Usando instruções SET (Transact-SQL) para definir propriedades para a sessão	Sim	Não
  Usando sp_set_session_context (Transact-SQL) para várias execuções de instruções em lote	Sim	Não
  Transações (Transact-SQL) (a menos que executadas como uma única solicitação em lote)	Sim	Não

Conteúdo relacionado

• Gerenciar objetos em seu data warehouse
• Consultar com o editor de consultas visuais
• Tutorial: como criar consultas entre warehouses com o editor de consultas SQL

Próxima etapa

Tutorial: Como consultar o warehouse