Início Rápido: Conectar e consultar uma Instância Gerenciada de SQL do Azure usando o SSMS (SQL Server Management Studio)

Aplica-se a:Instância Gerenciada de SQL do Azure

Comece a usar o SSMS (SQL Server Management Studio) para se conectar à Instância Gerenciada de SQL do Azure e executar alguns comandos de Transact-SQL (T-SQL).

O artigo demonstra as seguintes etapas:

Pré-requisitos

• Instalar o SQL Server Management Studio
• Instância Gerenciada de SQL do Azure

Conectar-se a uma Instância Gerenciada de SQL do Azure

1. Inicie o SSMS (SQL Server Management Studio). Na primeira vez que você executar o SSMS, a janela Conectar ao Servidor será aberta. Se ele não abrir, você poderá abri-lo manualmente selecionando Explorador de Objetos>Connect>Mecanismo de Banco de Dados.

   

2. Examine suas regras de segurança de entrada e confirme se você poderá acessar sua Instância Gerenciada de SQL do Azure. Se essa for sua primeira conexão, você precisará criar uma nova regra de segurança de entrada no grupo de segurança de rede no grupo de recursos da Instância Gerenciada de SQL do Azure. Para obter mais informações sobre como configurar o ponto de extremidade público, por exemplo, consulte Configurar pontos de extremidade públicos na Instância Gerenciada de SQL do Azure.

3. A caixa de diálogo Conectar ao Servidor é exibida. Insira as seguintes informações:

   Configurações	Valor sugerido	Detalhes
   Tipo de servidor	Mecanismo de Banco de Dados	Selecione Mecanismo de Banco de Dados (geralmente a opção padrão).
   Nome do servidor	O nome de domínio totalmente qualificado	Insira o nome da Instância Gerenciada de SQL do Azure.
   Autenticação
   	ID do Microsoft Entra1
   	-Senha -Integrado -AMF	Recomendamos a autenticação do Microsoft Entra com autenticação multifator (MFA). Consulte Autenticação multifator no Microsoft Entra.
   	Principal de Serviço	Consulte o principal do serviço do Microsoft Entra com o SQL do Azure.
   	– Identidade Gerenciada	Consulte Identidades Gerenciadas no Microsoft Entra para Azure SQL. Conectar-se a uma instância gerenciada de SQL com o SSMS usando uma identidade gerenciada requer uma VM do Azure. Consulte Usar uma identidade gerenciada atribuída pelo sistema de VM do Windows para acessar o SQL do Azure
   	- Padrão	A opção padrão pode ser usada ao se conectar usando qualquer modo de autenticação do Microsoft Entra sem senha e não interinterativo.
   	Autenticação do SQL Server	Use Autenticação do SQL Server para conectar-se ao Azure SQL.
   Logon	ID do usuário da conta de servidor	A ID do usuário da conta de servidor usada para criar o servidor.
   Senha	Senha da conta do servidor	A senha da conta do servidor usada para criar o servidor.
   Nome do banco de dados	Você pode deixar isso como padrão.
   Criptografia2	Método de criptografia	Selecione o nível de criptografia para a conexão. O valor padrão é Obrigatório.
   Certificado de servidor confiável	Confiar em Certificado do Servidor	Verifique esta opção para ignorar a validação do certificado do servidor. O valor padrão é False (desmarcado), o que promove uma melhor segurança usando certificados confiáveis.
   Nome do host no certificado	Nome do host do servidor	O valor fornecido nessa opção é usado para especificar um CN ou SAN diferente, mas esperado, no certificado do servidor.

   ¹ O método de Autenticação do Windows não tem suporte para o SQL do Azure. Para obter mais informações, consulte a autenticação do SQL do Azure. Recomendamos a autenticação do Microsoft Entra com autenticação multifator (MFA).

   ² O valor padrão é Obrigatório no SSMS (SQL Server Management Studio) 20. A criptografia estrita (SQL Server 2022 e SQL do Azure) deve ser usada para o Banco de Dados SQL do Azure e a Instância Gerenciada de SQL do Azure. A criptografia estrita (SQL Server 2022 e SQL do Azure) pode ser usada para o SQL Server quando a instância tiver Forçar Criptografia Estrita habilitada. No SQL Server Management Studio 21, isso é chamado de Estrito (SQL Server Mínimo 2022 e SQL do Azure).

   Você também pode modificar opções de conexão adicionais selecionando Opções. Exemplos de opções de conexão são o banco de dados ao qual você está se conectando, o valor do tempo limite da conexão e o protocolo de rede. Este artigo usa os valores padrão para todas as opções.

   

4. Depois de concluir todos os campos, selecione Conectar.

5. Para verificar se a conexão da Instância Gerenciada de SQL do Azure foi bem-sucedida, expanda e explore os objetos no Pesquisador de Objetos em que o nome do servidor, a versão do SQL Server e o nome de usuário são exibidos. Esses objetos são diferentes dependendo do tipo de servidor.

   

Solucionar problemas de conectividade

• Se o navegador não se conectar ao usar o Microsoft Entra com MFA, você poderá navegar até Ferramentas>Opções>Azure Services>Azure Cloud e alterar o valor para Usar o navegador padrão do sistema ou Usar o Gerenciador de Contas da Web. Para obter mais informações, consulte Opções (Serviços do Azure).

• Você pode enfrentar problemas de conexão com a Instância Gerenciada de SQL do Azure. Para obter mais informações sobre como solucionar problemas de conexão, visite Solucionar problemas de conectividade e outros erros.

• Você pode evitar, solucionar problemas, diagnosticar e atenuar a conexão e erros transitórios encontrados ao interagir com a Instância Gerenciada de SQL do Azure. Para obter mais informações, visite Solucionar problemas de erros de conexão transitórios.

Limpar o cache de token da ID do Microsoft Entra

O SSMS (SQL Server Management Studio) armazena em cache tokens de ID do Microsoft Entra brevemente. Quando um usuário é adicionado a um grupo de ID do Microsoft Entra e tenta se autenticar imediatamente do SSMS, a seguinte mensagem de erro é gerada:

Login failed for user '<token-identified principal>'.
(Microsoft SQL Server, Error: 18456)

Se você obteve recentemente acesso a um servidor, poderá limpar o cache de token do Microsoft Entra ID em Ajuda>Limpar o Cache de Token de ID do Entra.

A caixa de diálogo a seguir descreve por que essa opção é útil se você recebeu recentemente acesso a um servidor e precisa de autenticação nova.

Criar um banco de dados

Agora, vamos criar um banco de dados nomeado TutorialDB seguindo estas etapas:

1. Clique com o botão direito do mouse na instância do servidor no Pesquisador de Objetos e selecione Nova Consulta:

   

2. Cole o seguinte snippet de código T-SQL na janela de consulta para criar um novo banco de dados com configurações padrão:

   IF NOT EXISTS (SELECT name
                  FROM sys.databases
                  WHERE name = N'TutorialDB')
       CREATE DATABASE [TutorialDB];
   GO
   

3. Execute a consulta selecionando Executar ou selecionando F5 no teclado.

   Depois que a consulta for concluída, o novo TutorialDB banco de dados aparecerá na lista de bancos de dados no Pesquisador de Objetos. Se ele não for exibido, clique com o botão direito do mouse no nó Bancos de Dados e selecione Atualizar.

Criar uma tabela no novo banco de dados

Nesta seção, você criará uma tabela no banco de dados recém-criado TutorialDB . Como o editor de consultas ainda está no contexto do banco de master dados, alterne o contexto de conexão para o TutorialDB banco de dados executando as seguintes etapas:

1. Na lista suspensa do banco de dados, selecione o banco de dados desejado, conforme mostrado aqui:

   

2. Cole o seguinte snippet de código T-SQL na janela de consulta:

   -- Create a new table called 'Customers' in schema 'dbo'
   -- Drop the table if it already exists
   IF OBJECT_ID('dbo.Customers', 'U') IS NOT NULL
       DROP TABLE dbo.Customers;
   GO
   
   -- Create the table in the specified schema
   CREATE TABLE dbo.Customers
   (
       CustomerId INT NOT NULL PRIMARY KEY, -- primary key column
       Name NVARCHAR (50) NOT NULL,
       Location NVARCHAR (50) NOT NULL,
       Email NVARCHAR (50) NOT NULL
   );
   GO
   

3. Execute a consulta selecionando Executar ou selecionando F5 no teclado.

Depois que a consulta for concluída, a nova Customers tabela será exibida na lista de tabelas no Pesquisador de Objetos. Se a tabela não for exibida, clique com o botão direito do mouse no nó TutorialDB>Tabelas, no Explorador de Objetos, e selecione Atualizar.

Inserir linhas na nova tabela

Agora, vamos inserir algumas linhas na Customers tabela que você criou. Cole o seguinte snippet de código T-SQL na janela de consulta e selecione Executar:

-- Insert rows into table 'Customers'
INSERT INTO dbo.Customers (
    [CustomerId],
    [Name],
    [Location],
    [Email]
)
VALUES
    (1, N'Orlando', N'Australia', N''),
    (2, N'Keith', N'India', N'keith0@adventure-works.com'),
    (3, N'Donna', N'Germany', N'donna0@adventure-works.com'),
    (4, N'Janet', N'United States', N'janet1@adventure-works.com');
GO

Consultar a tabela e exibir os resultados

Os resultados de uma consulta são visíveis abaixo da janela de texto da consulta. Para consultar a Customers tabela e exibir as linhas que foram inseridas, cole o seguinte snippet de código T-SQL na janela de consulta e selecione Executar:

-- Select rows from table 'Customers'
SELECT * FROM dbo.Customers;

Os resultados da consulta são exibidos na área em que o texto foi inserido.

Você também pode modificar a forma como os resultados são apresentados selecionando uma das seguintes opções:

• O primeiro botão exibe os resultados na Exibição de Texto, conforme mostrado na imagem na próxima seção.
• O botão do meio exibe os resultados em Exibição em Grade, que é a opção padrão.
• O terceiro botão permite salvar os resultados em um arquivo cuja extensão é .rpt por padrão.

Verificar suas propriedades de conexão usando a tabela da janela de consulta

Você pode encontrar informações sobre as propriedades de conexão nos resultados da consulta. Depois de executar a consulta mencionada anteriormente na etapa anterior, examine as propriedades de conexão na parte inferior da janela de consulta.

• Você pode determinar a qual servidor e banco de dados você está conectado e seu nome de usuário.

• Você também pode exibir a duração da consulta e o número de linhas retornadas pela consulta executada anteriormente.

  

Limpar os recursos

Vamos remover o banco de dados de exemplo TutorialDB . Cole o seguinte código T-SQL e execute:

IF EXISTS (SELECT name
           FROM sys.databases
           WHERE name = N'TutorialDB')
    DROP DATABASE [TutorialDB];
GO

Conteúdo relacionado

• Editor de Consultas (SQL Server Management Studio)
• Objetos de script no SQL Server Management Studio
• Usar modelos no SQL Server Management Studio
• Componentes e configuração do SQL Server Management Studio
• Dicas e truques para usar o SSMS (SQL Server Management Studio)