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. É possível executar consultas T-SQL no banco de dados, bem como editar dados no editor de dados tabulares interno.

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

Há duas opções de autenticação para o editor de consultas: autenticação do SQL ou autenticação com o Microsoft Entra ID (antigo Azure Active Directory).

Autenticação para Banco de Dados SQL do Azure

Para obter exemplos, confira Início rápido: usar o Editor de Consultas no portal do Azure (versão prévia) para consultar o Banco de Dados SQL 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 master do servidor lógico ou um usuário SQL contido no banco de dados do 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>.

Permissões necessárias para acessar o editor de consultas

Os usuários precisam, pelo menos, da permissão de RBAC (controle de acesso baseado em função) do Azure Acesso de leitura ao servidor e ao banco de dados para usar o editor de consultas.

Há quatro seções principais do editor de consultas:

  • Barra de navegação

  • Pesquisador de Objetos

  • Janela de consulta

  • Copilot para o Banco de Dados SQL do Azure

    Captura de tela do portal do Azure mostrando retângulos vermelhos destacando o Editor de Consultas no menu principal e a barra de navegação, o Pesquisador de Objetos e a janela de consultas.

Há quatro tarefas que você pode executar na barra de navegação.

  • Você pode usar Logon para alterar o contexto de autenticação.
  • Você pode usar Nova Consulta para abrir uma janela de consulta em branco.
  • Você pode usar Abrir Consulta para selecionar até 10 arquivos .sql ou .txt do computador local e abri-los na janela de consulta.
  • Você pode fornecer Comentários sobre o editor de consultas do banco de dados SQL do Azure.

Pesquisador de Objetos

O pesquisador de objetos permite visualizar e executar tarefas nas tabelas, exibições e procedimentos armazenados de seu banco de dados.

  • Expanda Tabelas para exibir a lista de tabelas no banco de dados. Expanda a tabela para ver as colunas na tabela. Use as reticências para selecionar as 1.000 primeiras linhas, acessar o Editor de dados ou renomear a tabela. Se você renomear uma tabela, use a seta de atualização para ver as alterações.
  • Expanda Exibições para exibir uma lista de exibições no banco de dados. Expanda a exibição para ver as colunas na exibição. Use as reticências para selecionar as 1.000 linhas principais ou renomear a exibição. Se você renomear uma exibição, use a seta de atualização para ver as alterações.
  • Expanda Procedimentos Armazenados para exibir uma lista de todos os procedimentos armazenados no banco de dados. Expanda um procedimento armazenado para ver a saída do procedimento armazenado. Use as reticências para exibir a definição do procedimento armazenado na janela de consulta.

Janela de consulta

Essa janela permite digitar ou colar uma consulta e executá-la. Os resultados da consulta são mostrados no painel Resultados.

Você pode cancelar sua consulta. Conforme observado em Considerações e limitações, há um período de tempo limite de cinco minutos.

O botão Salvar consulta permite salvar o texto da consulta no computador como um arquivo .sql.

O botão Exportar dados como permite exportar os resultados da consulta para o computador como um arquivo .json, .csvou .xml.

O tempo de execução da consulta, ou erros, são mostrados na barra de status.

Habilidades do Microsoft Copilot no Banco de Dados SQL do Azure (Preview)

O Microsoft Copilot é um assistente com tecnologia de IA desenvolvido para simplificar o design, a operação, a otimização e a integridade de aplicativos baseados no Banco de Dados SQL do Azure. Ele melhora a produtividade no portal do Azure oferecendo linguagem natural para a conversão de SQL e autoajuda para a administração do banco de dados.

A experiência de Linguagem natural para SQL: essa experiência no editor de consultas do portal do Azure para o Banco de Dados SQL do Azure converte as consultas de linguagem natural em SQL, tornando as interações de banco de dados mais intuitivas.

Para obter um tutorial e exemplos de linguagem natural para recursos SQL do Copilot, consulte Linguagem natural para SQL no Editor de consultas do portal do Azure (Preview). Para obter mais informações, consulte as Perguntas frequentes sobre habilidades do Microsoft Copilot no Banco de Dados SQL do Azure (Preview).

Editor de dados

O editor de dados permite modificar dados em uma linha existente, adicionar uma nova linha de dados à tabela ou excluir uma linha de dados. Isso é semelhante à experiência no SSMS (SQL Server Management Studio).

Para acessar o editor de dados, no pesquisador de objetos, expanda Tabelas, selecione as reticências à direita do nome da tabela e selecione Editar Dados (versão prévia).

Para modificar os dados em uma linha existente, selecione o valor que você deseja alterar, faça a alteração e clique em Salvar na parte superior.

  • Se a coluna for uma coluna de identidade, não será possível editar esse valor. Você receberá a mensagem de erro Save failed: Failed to execute query. Error: Cannot update identity column *column_name*.

Para adicionar uma linha, selecione Criar linha e insira os valores que você deseja adicionar. Nesse contexto, há certos tipos de dados que não podem ser adicionados ou usados para trabalhar.

  • Se a coluna for uma coluna de identidade, não será possível adicionar um valor nesse campo. Você receberá a mensagem de erro Save failed: Cannot set value in identity columns *column_name*.
  • As colunas com restrições padrão não são respeitadas. O editor de dados não gera o valor padrão, ele espera você inserir um valor. Não é recomendado usar o editor de dados para tabelas com restrições de coluna padrão.
  • As colunas computadas não são calculadas. Você receberá a mensagem de erro Save failed: Failed to execute query. Error: The column *column_name* cannot be modified because it is either a computed column or is the result of a UNION operator. Não é recomendável usar o editor de dados para tabelas que tenham colunas computadas.

Para excluir uma linha de dados, selecione a linha e clique em Excluir linha.

  • Se a linha tiver uma chave primária e essa chave primária tiver uma relação de chave de referência com outra tabela, quando a linha for excluída, as linhas relacionadas nas outras tabelas também serão excluídas.

Considerações e limitações

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

Limitações do editor de consultas

  • Se a consulta tiver várias instruções, somente os resultados da última instrução serão mostrados na guia Resultados.
  • 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 master, use outras ferramentas para consultar seu Banco de Dados SQL do Azure.
  • O editor de consultas não pode se conectar a um banco de dados de réplica com 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 saber mais, veja Conectar-se a uma réplica somente leitura.
  • O editor de consultas tem um tempo limite de cinco minutos para a execução da consulta. Para executar consultas mais longas, use outras ferramentas para consultar seu Banco de Dados SQL do Azure.
  • 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 tabelas e exibições de banco de dados, mas dá suporte ao preenchimento automático para nomes que já foram digitados. Para obter suporte do IntelliSense, use outras ferramentas para consultar seu Banco de Dados SQL do Azure.
  • Pressionar F5 atualiza a página do editor de consultas e, quando há qualquer consulta atual no editor, ela não é salva.

Outras maneiras de consultar seu Banco de Dados SQL do Azure

Além do editor de consultas do portal do Azure para o Banco de Dados SQL do Azure, considere os seguintes inícios rápidos para obter outras ferramentas:

Considerações sobre a conexão

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

  • Se você 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* Isso indica que o banco de dados sem servidor está pausado no momento. Se isso ocorrer, a seleção 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 logon 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, o usuário não tem acesso ao banco de dados.

Conectividade das portas 443 e 1443

É 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 não consegue se comunicar pelas portas 443 e 1443. É necessário habilitar o tráfego HTTPS de saída nessas portas. 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 e 1443 no Windows Defender Firewall

  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, 1443 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 443 e 1443 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 443 e 1443 no Linux

Execute estes comandos para atualizar iptables:

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

Permitir 443 e 1443 na VM do Azure

Ao usar VMs do Azure, você tem um grupo de segurança de rede do Azure bloqueando 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