Partilhar via


Consulta usando o editor de consultas SQL

Aplica-se a:Ponto de extremidade de análise SQL, Armazém e Banco de Dados Espelhado no Microsoft Fabric

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

O editor de consultas SQL fornece IntelliSense, completamento de código, realce de sintaxe, análise sintáctica do lado do cliente e validação. Você pode executar instruções DDL (Data Definition Language), DML (Data Manipulation Language) e DCL (Data Control Language).

Editor de consultas SQL no portal Fabric

O editor de consultas SQL fornece um editor de texto para escrever consultas usando T-SQL. Para acessar o editor de consultas SQL interno:

  • Crie uma nova consulta usando o botão de nova consulta SQL na fita.

    Captura de ecrã a mostrar onde encontrar o menu Nova consulta no friso.

  • Selecione a lista de templates SQL para criar facilmente objetos T-SQL. Os modelos de código aparecem na sua janela de consulta SQL, como mostrado na imagem seguinte.

    Captura de ecrã a mostrar onde encontrar os modelos SQL no friso.

À medida que você trabalha em sua consulta SQL, as consultas são salvas automaticamente a cada poucos segundos. Um indicador "salvar" aparece na guia de consulta para indicar que a consulta está sendo salva.

Multitarefa entre guias para visualização, consulta e modelagem de dados

A experiência de pré-visualização, consulta e modelação de dados abre-se em separadores individuais que lhe permitem realizar várias tarefas em simultâneo no editor. Se estiver a escrever uma consulta, pode alternar entre ver uma pré-visualização dos dados e visualizar as relações entre as tabelas para as quais está a escrever a consulta. Para ver ou fechar todos os separadores, selecione o ícone à direita de todos os separadores.

Captura de ecrã a mostrar onde mostrar os separadores para pré-visualização, consulta e modelação de dados.

Ver resultados da consulta

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

A pré-visualização de Resultados aparece na secção de Resultados . Se a consulta devolver mais de 10.000 linhas, a pré-visualização mostra apenas as primeiras 10.000 linhas. Pode procurar uma cadeia dentro da grelha de resultados para filtrar linhas que correspondam aos critérios de pesquisa. O separador de Mensagens mostra as mensagens SQL retornadas quando a consulta SQL é executada.

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

Para ativar os menus Guardar como visualização, Guardar como tabela, Abrir no Excel, Explorar estes dados (pré-visualização) e Visualizar resultados , destaque a instrução SQL que contém a SELECT instrução no editor de consultas SQL.

Captura de ecrã da janela do editor de consultas. Os botões de comando estão inseridos em vermelho.

Guardar como vista

Selecione a consulta e guarde a sua consulta como vista usando o botão Guardar como visualização . Selecione o nome de um esquema, forneça o nome da vista e verifique a instrução SQL antes de confirmar a criação da vista. Quando a vista é criada com sucesso, ela aparece no Explorador.

Captura de tela mostrando como usar o menu Salvar como exibição.

Guardar como tabela

Use Guardar como tabela para guardar os resultados da sua consulta numa tabela. Selecione o armazém onde quer guardar resultados, selecione um esquema e forneça um nome de tabela para carregar os resultados na tabela usando a instrução CREATE TABLE AS SELECT . Quando a tabela é criada com sucesso, aparece no Explorador.

Captura de ecrã a mostrar como utilizar o menu Guardar como tabela.

Abrir no Excel

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

Captura de tela mostrando como usar o menu Abrir no arquivo do Excel.

Siga estas etapas para trabalhar com o arquivo do Excel localmente:

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

  2. Para ver os dados, selecione o botão Ativar Edição na faixa de opções Modo de Exibição Protegido, seguido pelo botão Habilitar Conteúdo na faixa de opções Aviso de Segurança . Depois de ambos estarem ativados, é apresentado o seguinte diálogo para aprovar a execução da consulta listada. Captura de tela do Microsoft Excel mostrando a caixa de diálogo Consulta de Banco de Dados Nativo.

  3. Selecione Executar.

  4. Autentique a sua conta usando a opção de conta Microsoft. Selecione Ligar. Captura de tela do Microsoft Excel mostrando a caixa de diálogo do banco de dados do SQL Server.

Depois de iniciar sessão com sucesso, vê os dados apresentados na folha de cálculo.

Explore estes dados (pré-visualização)

Explorar esses dados (visualização) fornece a capacidade de executar a exploração ad hoc dos resultados da sua consulta. Ao utilizar esta funcionalidade, pode lançar uma matriz lado a lado e uma vista visual para compreender melhor quaisquer tendências ou padrões por detrás dos resultados da sua consulta antes de começar a construir um relatório completo de Power BI. Para obter mais informações, consulte Explorar seus dados no serviço do Power BI.

Visualizar resultados

Visualizar resultados permite criar relatórios a partir dos resultados da consulta no editor de consultas SQL.

Captura de tela mostrando como usar o menu Visualizar resultados.

Copiar

A lista suspensa Copiar permite que copie os resultados e os nomes das colunas na grelha de dados. Pode optar por copiar os resultados com os nomes das colunas, simplesmente copiar os resultados ou simplesmente copiar os nomes das colunas.

Captura de ecrã a mostrar as opções no menu pendente Copiar.

Vários conjuntos de resultados

Quando executa várias consultas e essas consultas retornam vários resultados, pode selecionar o menu suspenso de Resultados para ver resultados individuais.

Captura de ecrã da janela do editor de consultas com os resultados.

Consulta entre armazéns

Para obter mais informações sobre consultas entre depósitos, consulte Consulta entre depósitos.

Pode escrever uma consulta T-SQL com a convenção de nomes em 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;

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

Quando uma consulta ainda está a correr e fecha o separador do editor de consultas, pode decidir se a consulta deve continuar a correr em segundo plano ou ser cancelada.

  • Sim, continua a executar a consulta: A consulta continua a ser executada em segundo plano, com uma notificação a indicar que está em execução. Quando a consulta termina, uma notificação avisa-o para que possa voltar à consulta e visualizar os resultados.

  • Não, cancele a consulta: A consulta é terminada imediatamente. Esta opção é útil para libertar recursos ou impedir consultas de que já não precisa.

  • Lembra-te da minha preferência e não voltes a mostrar: Guarda a tua escolha localmente nos cookies do teu navegador.

Atalhos de teclado

Os atalhos de teclado fornecem uma forma rápida de navegar e trabalhar de forma mais eficiente no editor de consultas SQL. A tabela seguinte lista todos os atalhos disponíveis no Windows e macOS, no navegador Edge, para o editor de consultas SQL no portal Microsoft Fabric:

Função Atalho do Windows Atalho do macOS
Ações do editor de consultas
Executar todas as instruções SQL no separador de consulta ativa Ctrl + Enter / Shift + Enter Comando + Enter / Shift + Enter
Fechar separador atual Ctrl + Shift + F4 Comando + Shift + F4
Cancelar a execução de script SQL Ctrl + . Comando + .
Cadeia de pesquisa Ctrl + F Comando + F
Substituir cadeia de caracteres Ctrl + H Comando + Opção + F
Anular Ctrl + Z Comando + Z
Refazer Ctrl + Y Comando + Shift + Z
Vá uma palavra para a esquerda Ctrl + tecla de seta para a esquerda Comando + Tecla de seta esquerda
Vá uma palavra certa Ctrl + tecla de seta para a direita Comando + Tecla de seta direita
Aumento de recuo Separador Separador
Diminuição de recuo Shift + Tab Shift + Tab
Comentário Ctrl + K, Ctrl + C Comando + K, Comando + C
Cancelar comentário Ctrl + K, Ctrl + U Comando + K, Comando + U
Mover o cursor para cima Seta para Cima Seta para Cima
Mover o cursor para baixo Seta para Baixo Seta para Baixo
Selecionar Tudo Ctrl + A Comando + A
Explica a consulta (Copilot) Ctrl + Alt + E Comando + Opção + E
Correção de 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 definições Ctrl + Shift + X Cmd + Shift + X
Copiar cadeia de ligação SQL Ctrl + Shift + C Tecla de Comando + Shift + C
Atividade de consulta aberta Ctrl + Shift + A Comando + Shift + A
Abrir o painel de chat do Copilot Ctrl + Shift + I Cmd + Shift + I
Novo modelo semântico Ctrl + Shift + M Cmd + 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 o painel do explorador Ctrl + B Comando + B
Ações de resultados de consulta
Expandir resultados Ctrl + R Comando + R
Resultados do colapso Ctrl + R Comando + R

Limitações

  • No editor de consultas SQL, toda vez que você executa a consulta, ele abre uma sessão separada e a fecha no final da execução. Este comportamento significa que, se configurar o contexto da sessão para múltiplas execuções de consultas, o contexto não é mantido para execução independente de consultas.

  • Você pode executar instruções DDL (Data Definition Language), DML (Data Manipulation Language) e DCL (Data Control Language), mas há limitações para instruções TCL (Transaction Control Language). No editor de consultas SQL, ao selecionar o botão Executar , você está enviando uma solicitação em lote independente para ser executada. Cada ação Executar no editor de consultas 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 sessão diferentes.

    • Por exemplo, quando executa instruções de transação de forma independente, o contexto da sessão não é mantido. Na captura de ecrã seguinte, BEGIN TRAN é executado no primeiro pedido, mas como o segundo pedido corre numa sessão diferente, não há transação a comprometer. A operação de commit ou de rollback falha. Se o lote SQL não incluir um COMMIT TRAN, as alterações aplicadas depois de BEGIN TRAN não são confirmadas.

    Captura de tela mostrando a execução independente de transações falhou no editor de consultas SQL.

    • O editor de consultas SQL não suporta sp_set_session_context.

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

  • Quando executa uma consulta SQL com USE, precisa submeter a consulta SQL USE como um único pedido.

  • O Visualize results atualmente não suporta consultas SQL com uma ORDER BY cláusula.

  • As instruções T-SQL que utilizam a sintaxe T-SQL OPTION não são atualmente suportadas nas opções Explorar estes 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 seguinte resume o comportamento esperado que não corresponde ao SQL Server Management Studio ou à extensão mssql com Visual Studio Code:

    Cenário Suportado em SSMS/ADS Suportado no editor de consultas SQL no portal Fabric
    Usando instruções SET (Transact-SQL) para definir propriedades para sessão Sim No
    O uso do sp_set_session_context (Transact-SQL) para várias instruções em lote é executado Sim No
    Transações (Transact-SQL) (a menos que executadas como uma solicitação de lote único) Sim No

Próximo passo