Compartilhar via

Editor de consultas do portal do Azure para Banco de Dados SQL do Azure

Aplica-se a:Banco de Dados SQL do Azure

O Editor de consultas (versão prévia) é uma ferramenta para executar consultas T-SQL no portal do Azure no navegador no Banco de Dados SQL do Azure.

Consulte seu Banco de Dados SQL do Azure do portal do Azure

O Editor de consultas foi projetado para consultas leves e exploração de objetos em seu banco de dados SQL do Azure, tudo de dentro do navegador no portal do Azure.

Semelhante à experiência de consulta no SQL Server Management Studio, use o editor de consultas para consultas simples ou consultas T-SQL maiores. Você pode executar consultas DML (Linguagem de Manipulação de Dados) e DDL (Linguagem de Definição de Dados).

Dica

O Banco de Dados SQL do Azure é novo para você? Atualize-se com o conteúdo de treinamento gratuito detalhado: Fundamentos do SQL do Azure.

Conexão via editor de consultas

Você pode autenticar no editor de consultas usando a autenticação SQL ou a autenticação do Microsoft Entra.

Autenticação para Banco de Dados SQL do Azure

Para obter exemplos, consulte Início Rápido: Use o editor de consultas do portal do Azure.

  • Para usar a autenticação SQL para se conectar a um banco de dados SQL do Azure por meio do editor de consultas, você deve ter um logon no banco de dados do master servidor lógico ou um usuário SQL contido no banco de dados de usuário desejado. Para obter mais informações, consulte Logons.
    • Insira seu nome de usuário e senha e selecione OK.
  • Para usar a autenticação do Microsoft Entra para se conectar a um banco de dados SQL do Azure por meio do editor de consultas, seu banco de dados deve ser configurado com a autenticação do Microsoft Entra e você deve ter um usuário do Microsoft Entra criado no banco de dados.
    • Selecione Continuar como <usuario@dominio>.

Depois de conectado à experiência do editor de consultas, você pode usar o Explorer para exibir objetos de banco de dados ou a janela Consulta para executar consultas T-SQL.

Captura de tela do portal do Azure mostrando retângulos vermelhos realçando o editor de Consultas no menu principal e a barra de navegação, o Explorer, a barra de ferramentas e a janela de consulta.

Dicas úteis:

Janela de consulta

Essa janela consulta permite digitar ou colar uma consulta e executá-la. O painel Resultados mostra os resultados da consulta.

  • Há um tempo limite de consulta de cinco minutos.
  • Use os botões Baixar como para exportar os resultados da consulta para o computador como um arquivo .csv, .jsonou .xlsx .
  • A barra de status mostra o tempo de execução da consulta ou os erros.
  • Você pode copiar ou filtrar os conjuntos de resultados na barra de ferramentas Resultados .

Considerações e limitações

As considerações e limitações a seguir se aplicam ao se conectar e consultar o Banco de Dados SQL do Azure usando o editor de consultas do portal do Azure.

Limitações do editor de consultas

  • Se a consulta tiver várias instruções, a guia Resultados mostrará apenas os resultados da última instrução.
  • O editor de consultas não oferece suporte à conexão com o banco de dados master do servidor lógico. Para se conectar ao banco de dados, use o masterSSMS (SQL Server Management Studio) ou a extensão mssql para Visual Studio Code.
  • O editor de consultas não pode se conectar a um banco de dados de réplica usando ApplicationIntent=ReadOnly. Para se conectar dessa maneira, use o SSMS e especifique ApplicationIntent=ReadOnly na guia Parâmetros de conexão adicionais nas opções de conexão. Para mais informações, consulte Conectar-se a uma réplica de apenas leitura.
  • O editor de consultas tem um tempo limite de cinco minutos para a execução da consulta. Para executar consultas mais longas, use o SSMS (SQL Server Management Studio) ou a extensão mssql para Visual Studio Code.
  • O editor de consultas só dá suporte à projeção cilíndrica para tipos de dados geográficos.
  • O editor de consultas não dá suporte ao IntelliSense para colunas, mas dá suporte a tabelas e exibições. Para obter suporte completo do IntelliSense, use o SSMS (SQL Server Management Studio) ou a extensão mssql para Visual Studio Code.
  • Na mesma sessão do navegador, você pode navegar livremente pelo portal do Azure e suas consultas serão mantidas. Se você atualizar a página (pressionando F5) ou fechar o navegador, perderá suas consultas.

Considerações sobre a conexão

Solução de problemas de erro de conexão

  • Se a mensagem de erro The X-CSRF-Signature header could not be validated for exibida, execute as seguintes ações para resolver o problema:

    • Verifique se o relógio do computador está ajustado para a hora e o fuso horário corretos. É possível tentar corresponder o fuso horário do computador com o do Azure pesquisando o fuso horário do local do banco de dados, como Leste dos EUA.
    • Se você estiver em uma rede proxy, verifique se o cabeçalho da solicitação X-CSRF-Signature não está sendo modificado ou removido.

  • Se o banco de dados estiver sem servidor e você receber a mensagem de erro: Database *name* on server *name.database.windows.net* is not currently available. Please retry the connection later. If the problem persists, contact customer support, and provide them the session tracing ID *ID* Esta mensagem de erro indica que o banco de dados sem servidor está em pausa no momento. Se essa mensagem de erro for exibida, selecionar Continue as <user@domain> enviará uma solicitação ao banco de dados para retomar. Aguarde aproximadamente um minuto, atualize a página e tente novamente.

  • Se você vir a mensagem de erro "Falha no login para o usuário <token-identified principal>. No momento, o servidor não está configurado para aceitar esse token." quando você tenta usar a autenticação do AD, seu usuário não tem acesso ao banco de dados.

Conectividade da porta 443

A partir de março de 2026, o editor de consultas SQL do Azure usa apenas a porta TCP 443.

É possível receber um dos seguintes erros no editor de consultas:

  • Your local network settings might be preventing the Query Editor from issuing queries. Please click here for instructions on how to configure your network settings.
  • A connection to the server could not be established. This might indicate an issue with your local firewall configuration or your network proxy settings.

Esses erros ocorrem porque o editor de consultas precisa se comunicar por meio da porta 443, mas não pode. Você precisa habilitar o tráfego HTTPS de saída nesta porta. As instruções a seguir explicam o processo, de acordo com o sistema operacional. Pode ser necessário que o seu departamento de TI corporativo conceda aprovação para abrir essa conexão na rede local.

Permitir 443 no Firewall do Windows Defender

  1. Abra o Windows Defender Firewall.
  2. No menu à esquerda, selecione Configurações avançadas.
  3. Em Windows Defender Firewall com Segurança Avançada, selecione Regras de saída no menu esquerdo.
  4. Selecione Nova regra no menu à direita.
  5. No Assistente de nova regra de saída, siga estas etapas:
    1. Selecione porta como o tipo de regra que você deseja criar e clique em Avançar.
    2. selecione TCP.
    3. Selecione Portas remotas específicas, insira 443 e clique em Avançar.
    4. Selecione Permitir a conexão se ela for segura, clique em Avançar e, novamente, em Avançar.
    5. Mantenha Domínio, Privado e Público selecionados.
    6. Dê um nome à regra, por exemplo, Acessar o editor de consultas do SQL do Azure e, opcionalmente, forneça uma descrição. Em seguida, selecione Concluir.

Permitir porta 443 no macOS

  1. No menu da Apple, abra Preferências do sistema.
  2. Selecione Segurança e Privacidade e, em seguida, Firewall.
  3. Se o Firewall estiver desativado, selecione Clicar no cadeado para fazer alterações e selecione Ativar firewall.
  4. Selecione Opções de Firewall.
  5. Na janela Segurança e Privacidade, selecione Permitir automaticamente que o software assinado receba conexões de entrada.

Permitir a porta 443 no Linux

Execute estes comandos para atualizar iptables:

sudo iptables -A OUTPUT -p tcp --dport 443 -j ACCEPT

Permitir 443 na VM do Azure

Quando você usa VMs do Azure, um grupo de segurança de rede do Azure bloqueia a conectividade. Um grupo de segurança de rede pode ser usado para filtrar o tráfego de rede de entrada e saída dos recursos do Azure em uma rede virtual do Azure. Você precisa adicionar uma regra de segurança de saída ao grupo de segurança de rede. Para ver um exemplo, consulte Criar regras de segurança.

Próxima etapa

Início Rápido: Usar o editor de consultas do portal do Azure

Conteúdo relacionado

  • Last updated on