Início Rápido: Usar o editor de consultas do portal do Azure para consultar o Banco de Dados SQL do Azure

Aplica-se a: Banco de Dados SQL do Azure

O Editor de Consultas (versão prévia) do Banco de Dados SQL do Azure é uma ferramenta para executar consultas SQL no Banco de Dados SQL do Azure por meio do portal do Azure. Neste início rápido, você se conecta a um Banco de Dados SQL do Azure no portal do Azure e usa o editor de consultas para executar consultas T-SQL (Transact-SQL).

• Se você ainda não tem um Banco de Dados SQL do Azure criado, visite o Início Rápido: criar um único banco de dados. Procure a opção de usar sua oferta para experimentar o Banco de Dados SQL do Azure gratuitamente (Preview).

Pré-requisitos

Autenticação

É necessário ter uma conta de usuário com permissões para se conectar ao banco de dados e ao editor de consultas. Você pode usar a autenticação do SQL ou a autenticação do Microsoft Entra ID) (recomendado). Para obter mais informações sobre como criar e gerenciar logons no banco de dados SQL do Azure, acesse Autorizar acesso ao banco de dados.

Para obter mais informações sobre acesso à rede pública, configurações de versão TLS e política de conexão, consulte Configurações de conectividade do SQL do Azure.

Regra de Firewall

Para conexões públicas com o editor de consultas, é necessário adicionar seu endereço IP de saída às regras de firewall permitidas do servidor a fim de acessar seus bancos de dados.

Caso receba esse erro, siga as seguintes etapas para resolvê-lo:

Cannot open server 'server-name' requested by the login. Client with IP address 'xx.xx.xx.xx' is not allowed to access the server. To enable access, use the Azure Management Portal or run sp_set_firewall_rule on the master database to create a firewall rule for this IP address or address range. It may take up to five minutes for this change to take effect.

Siga as etapas rápidas abaixo ou, para obter mais informações, consulte Adicionar seu endereço IP de saída às regras de firewall permitidas do servidor.

1. Retorne à página de Visão geral do banco de dados SQL.
2. Selecione o link para o servidor lógico SQL do Azure ao lado de Nome do servidor.
3. No menu de Recursos, em Segurança, selecione Rede.
4. Verifique em Acesso à rede pública se a opção Redes selecionadas está selecionada.
   • Se este for um ambiente de teste ou temporário, defina a opção como Redes selecionadas.
   • Caso contrário, o acesso deve ser concedido por outros meios que não os abordados neste início rápido, provavelmente por meio de pontos de extremidade privados (usando o Link Privado do Azure), conforme descrito na visão geral de acesso à rede.
5. Em Regras de firewall, selecione Adicionar o endereço IPv4 do cliente.
   • Se necessário, identifique seu endereço IPv4 e forneça-o nos campos Início e Fim.
6. Selecione Salvar.

Para solução de problemas, consulte Solução de problemas de erro de conexão.

Conecte-se ao editor de consultas

Conecte-se ao banco de dados no editor de consultas.

1. Navegue até o servidor do banco de dados SQL no portal do Azure. Por exemplo, visite seu painel do SQL do Azure.

2. Na página Visão geral do banco de dados SQL, selecione Editor de Consultas (versão prévia) no menu de recursos.

   

3. Na tela de entrada, forneça credenciais para se conectar ao banco de dados.

   • Você pode se conectar usando a autenticação do SQL ou do Microsoft Entra.

     • Para se conectar com a autenticação SQL, em Autenticação do servidor SQL, insira um Logon e uma Senha para um usuário que tenha acesso ao banco de dados e clique em OK. É sempre possível usar o logon e a senha para o administrador do servidor.

     • Para se conectar usando o Microsoft Entra ID, se você for o administrador do servidor do Microsoft Entra, selecione Continuar como <usuario@dominio>. Se o logon não for bem-sucedido, tente atualizar a página.

       

Conexão com outras ferramentas

Você também pode se conectar ao seu banco de dados SQL do Azure usando outras ferramentas, incluindo:

• Início Rápido: Usar o Azure Data Studio para conectar-se e consultar o Banco de Dados SQL do Azure
• Início Rápido: Usar o SSMS para se conectar e consultar um Banco de Dados SQL do Azure ou uma Instância Gerenciada de SQL do Azure
• Início Rápido: Usar o Visual Studio Code para se conectar e consultar

Consultar o banco de dados

Em qualquer banco de dados, execute a seguinte consulta no Editor de consultas para retornar a hora em UTC, o nome do banco de dados e seu nome de logon autenticado.

SELECT SYSDATETIMEOFFSET(), DB_NAME(), ORIGINAL_LOGIN();

Consulte o banco de dados de exemplo AdventureWorksLT

Esta parte do início rápido usa o banco de dados de exemplo AdventureWorksLT em um banco de dados SQL do Azure. Se você ainda não tiver um, poderá criar um banco de dados usando dados de exemplo no Banco de Dados SQL do Azure. Procure a opção de usar sua oferta para experimentar o Banco de Dados SQL do Azure gratuitamente (Preview).

Na página Editor de consultas (versão prévia), execute as consultas de exemplo a seguir no banco de dados de exemplo AdventureWorksLT.

Para obter mais informações sobre o T-SQL no Banco de Dados SQL do Azure, acesse Diferenças do T-SQL entre o SQL Server e o Banco de Dados SQL do Azure.

Executar uma consulta SELECT

1. Para consultar os 20 principais produtos no banco de dados, cole a seguinte consulta SELECT no editor de consultas:

    SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName
    FROM SalesLT.ProductCategory pc
    JOIN SalesLT.Product p
    ON pc.productcategoryid = p.productcategoryid;
   

2. Selecione Executar e analise a saída no painel Resultados.

   

3. Opcionalmente, é possível selecionar Salvar consulta a fim de salvar a consulta como um arquivo .sql ou Exportar dados como para exportar os resultados como um arquivo .json, .csv ou .xml.

Executar uma consulta INSERT

Para adicionar um produto à tabela SalesLT.Product, execute a seguinte instrução T-SQL INSERT.

1. No editor de consultas, substitua a consulta anterior pela seguinte:

   INSERT INTO [SalesLT].[Product]
          ( [Name]
          , [ProductNumber]
          , [Color]
          , [ProductCategoryID]
          , [StandardCost]
          , [ListPrice]
          , [SellStartDate]
          )
   VALUES
          ('myNewProduct'
          ,123456789
          ,'NewColor'
          ,1
          ,100
          ,100
          ,GETDATE() );
   

2. Selecione Executar para adicionar o produto. Após a execução da consulta, o painel Mensagens exibe Consulta bem-sucedida ─ linhas afetadas: 1.

Executar uma consulta UPDATE

Execute a instrução T-SQL UPDATE a seguir para atualizar o preço do novo produto.

1. No editor de consultas, substitua a consulta anterior pela seguinte:

   UPDATE [SalesLT].[Product]
   SET [ListPrice] = 125
   WHERE Name = 'myNewProduct';
   

2. Selecione Executar para atualizar a linha especificada na tabela Product. O painel Mensagens exibe Êxito na consulta: Linhas afetadas: 1.

Executar uma consulta DELETE

Execute a instrução T-SQL DELETE a seguir para remover o novo produto.

1. No editor de consultas, substitua a consulta anterior pela seguinte:

   DELETE FROM [SalesLT].[Product]
   WHERE Name = 'myNewProduct';
   

2. Selecione Executar para excluir a linha especificada da tabela Product. O painel Mensagens exibe Êxito na consulta: Linhas afetadas: 1.

Conteúdo relacionado

• Editor de consultas (versão prévia)
• Guia de início rápido: criar um banco de dados individual
• Configurações de conectividade do SQL do Azure