Partilhar via

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

  • Artigo

Aplica-se a: do Banco de Dados SQL do Azure

O Editor de Consultas (visualização) é uma ferramenta para executar consultas T-SQL no portal do Azure a partir do navegador numa Base de Dados SQL do Azure.

Consultar a Base de Dados SQL do Azure a partir 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 a partir do navegador no portal do Azure. Você pode executar consultas T-SQL no seu banco de dados, assim como editar dados no editor de dados tabular incorporado .

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 (Data Manipulation Language) e DDL (Data Definition Language).

Dica

Novo no Banco de Dados SQL do Azure? Atualize-se com conteúdo de treinamento gratuito detalhado: Azure SQL Fundamentals.

Conecte-se através do editor de consultas

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

Autenticação no Banco de Dados SQL do Azure

Para obter exemplos, consulte Guia de início rápido: usar o editor de consultas do portal do Azure (visualização) 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 de usuário desejado. Para obter mais informações, consulte Logins.
    • Introduza o seu nome de utilizador e palavra-passe e, em seguida, 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 Microsoft Entra criado no banco de dados.
    • Selecione Continuar como <user@domain>.

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

Os utilizadores precisam de pelo menos da permissão RBAC (controle de acesso baseado em função) do Azure para ler o acesso 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

  • Copiloto 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 Consulta.

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

  • Você pode usar o Login para alterar o contexto de autenticação.
  • Você pode usar Nova Consulta para abrir uma janela de consulta em branco.
  • Você pode usar Open Query para selecionar até 10 arquivos .sql ou .txt do seu computador local e abri-los na janela de consulta.
  • Você pode fornecer feedback no editor de consultas do Banco de Dados SQL do Azure.

Pesquisador de objetos

O pesquisador de objetos permite que você exiba e execute tarefas em tabelas, exibições e procedimentos armazenados do banco de dados.

  • Expanda Tabelas para exibir a lista de tabelas em seu banco de dados. Expanda a tabela para ver as colunas da tabela. Use o menu de opções para selecionar as 1.000 principais linhas, aceder ao Editor de Dadosou renomear a tabela. Se você renomear uma tabela, use a seta de atualização para ver as alterações.
  • Expanda Modos de Exibição para exibir uma lista de modos de exibição em seu banco de dados. Expanda a visualização para ver as colunas. Use as reticências para selecionar as 1.000 linhas superiores ou renomeie a exibição. Se você renomear um modo de exibição, use a seta de atualização para ver as alterações.
  • Expanda Stored Procedures para exibir uma lista de todos os procedimentos armazenados em seu 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

Esta janela permite-lhe escrever ou colar uma consulta e, em seguida, executá-la. Os resultados da consulta são mostrados no painel Resultados.

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

O botão Guardar consulta permite-lhe guardar o texto da consulta no seu computador como um ficheiro .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 na Base de Dados SQL do Azure (pré-visualização)

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

A funcionalidade de linguagem natural para SQL no editor de consultas do portal do Azure para o Banco de Dados SQL do Azure traduz consultas feitas em linguagem natural para SQL, tornando as interações com o banco de dados mais intuitivas.

Para obter um tutorial e exemplos de recursos de linguagem natural para SQL do Copilot, consulte Linguagem natural para SQL no editor de consultas do portal do Azure (visualização). Para obter mais informações, consulte Perguntas frequentes sobre as competências do Microsoft Copilot na Base de Dados SQL do Azure (visualização).

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 SQL Server Management Studio (SSMS).

Para aceder ao editor de dados, no explorador de objetos expanda Tabelase, em seguida, selecione as reticências à direita do nome da tabela e selecione Editar Dados (Pré-visualização).

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

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

Para adicionar uma nova linha, selecione Criar Nova Linha e insira os valores que deseja adicionar. Há certos tipos de dados que você não pode adicionar ou trabalhar com esse contexto.

  • Se a coluna for uma coluna de identidade, não será possível adicionar um valor nesse campo. Você verá 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 gerará o valor padrão, ele espera que você insira um valor. Não é recomendável usar o editor de dados para tabelas com restrições de coluna padrão.
  • As colunas computadas não são calculadas. Você verá 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 selecione Excluir linha.

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

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 com o editor de consultas do portal do Azure.

Limitações do editor de consultas

  • Se a sua consulta tiver várias instruções, somente os resultados da última instrução serão mostrados na aba Resultados.
  • O editor de consultas não suporta a 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 o Banco de Dados SQL do Azure.
  • O editor de consultas não pode ligar-se a uma réplica de base de dados 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 obter mais informações, consulte Conectar-se a uma réplica de leitura.
  • O editor de consultas tem um tempo limite de 5 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 suporta apenas projeção cilíndrica para tipos de dados geográficos.
  • O editor de consultas não suporta IntelliSense para tabelas e exibições de banco de dados, mas suporta preenchimento automático para nomes que já foram digitados. Para obter suporte ao IntelliSense, use outras ferramentas para consultar seu Banco de Dados SQL do Azure.
  • Pressionar F5 atualiza a página do editor de consultas e qualquer consulta atualmente no editor 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 guias de início rápido relativos a outras ferramentas:

Considerações sobre conexão

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

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

    • Verifique se o relógio do computador está definido para a hora e o fuso horário corretos. Pode tentar fazer corresponder o fuso horário do seu computador ao Azure procurando o fuso horário da sua localização da base de dados, como o 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 descartado.

  • Se o banco de dados estiver sem servidor e você vir 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 seu banco de dados sem servidor está pausado no momento. Se isso ocorrer, selecionar Continue as <user@domain> envia uma solicitação ao banco de dados para retomar. Aguarde aproximadamente um minuto, atualize a página e tente novamente.

  • Se vir a mensagem de erro "Falha ao iniciar sessão para o utilizador <token-identified principal>. O servidor não está configurado atualmente 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

Você pode obter 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 através das portas 443 e 1443. Você precisa habilitar o tráfego HTTPS de saída nessas portas. As instruções a seguir orientam você através desse processo, dependendo do seu sistema operacional. O departamento de TI corporativo pode precisar conceder aprovação para abrir essa conexão em sua rede local.

Permitir 443 e 1443 no Firewall do Windows Defender

  1. Abra Firewall do Windows Defender.
  2. No menu à esquerda, selecione Configurações avançadas.
  3. Em Firewall do Windows Defender com Segurança Avançada, selecione Regras de saída no menu à esquerda.
  4. Selecione Nova Regra no menu à direita.
  5. No assistente Nova regra de encaminhamento, siga estas etapas:
    1. Selecione porta como o tipo de regra que pretende criar e, em seguida, selecione Seguinte.
    2. Selecione TCP.
    3. Selecione Portas remotas específicas, introduza 443, 1443e, em seguida, selecione Seguinte.
    4. Selecione Permitir a ligação se for segura, selecione Seguintee, em seguida, selecione Seguinte novamente.
    5. Mantenha Domínio, Privado, e Público selecionados.
    6. Dê um nome à regra, por exemplo, editor de consultas SQL do Access Azuree, opcionalmente, forneça uma descrição. Em seguida, selecione Concluir.

Permitir 443 e 1443 no macOS

  1. No menu Apple, abra Preferências do Sistema.
  2. Selecione Security & Privacye, em seguida, selecione Firewall.
  3. Se Firewall estiver desativado, selecione Clique no cadeado para fazer alteraçõese selecione Ativar Firewall.
  4. Selecione Opções de firewall.
  5. Na janela Segurança & 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, tem um grupo de segurança de rede do Azure a bloquear a conectividade. Um grupo de segurança de rede pode filtrar o tráfego de rede de entrada e saída de e para 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 obter um exemplo, consulte Criar regras de segurança.

Próximo passo

Guia de início rápido: usar o editor de consultas do portal do Azure para consultar o Banco de Dados SQL do Azure

Conteúdo relacionado