Compartilhar via


Início Rápido: Conectar e consultar um Banco de Dados SQL do Azure usando o SSMS (SQL Server Management Studio)

Aplica-se a:Banco de Dados SQL do Azure

Comece a usar o SSMS (SQL Server Management Studio) para se conectar ao Banco de Dados SQL do Azure e executar alguns comandos de Transact-SQL (T-SQL).

Observação

Embora o Microsoft Entra ID seja o novo nome do Azure Active Directory (Azure AD), para evitar a interrupção de ambientes existentes, o Azure AD ainda permanecerá em alguns elementos codificados, como campos de interface do usuário, provedores de conexão, códigos de erro e cmdlets. Neste artigo, os dois nomes são intercambiáveis.

O artigo demonstra as seguintes etapas:

  • Conectar-se a um servidor lógico do Banco de Dados SQL do Azure
  • Criar um banco de dados
  • Criar uma tabela em seu novo banco de dados
  • Inserir linhas em sua nova tabela
  • Consultar a nova tabela e exibir os resultados
  • Use a tabela da janela de consulta para verificar suas propriedades de conexão
  • Remover banco de dados

Pré-requisitos

Conectar-se a um Banco de Dados SQL do Azure

Observação

As versões do SSMS anteriores à 18.6 não se autenticam nos Mecanismos de Banco de Dados por meio da MFA (autenticação multifator) do Microsoft Entra. Para continuar usando a MFA, você precisa do SSMS 18.6 ou de uma versão posterior.

  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.

    Captura de tela do link Conectar no Pesquisador de Objetos.

  2. 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 do servidor lógico do Banco de Dados 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 os service principals do Microsoft Entra com o SQL do Azure.
    – Identidade Gerenciada Consulte Identidades Gerenciadas no Microsoft Entra para Azure SQL.

    Conectar-se ao 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 Forneça o nome do banco de dados do Banco de Dados SQL do Azure.
    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.

    1 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).

    2 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.

    Captura de tela da caixa de diálogo de conexão do SQL do Azure.

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

    Se o firewall não estiver configurado, um prompt será exibido para configurar o firewall. Depois de entrar, preencha as informações de entrada da sua conta do Azure e continue definindo a regra de firewall. Em seguida, selecione OK. Este comando é uma ação única. Depois de configurar o firewall, o prompt de firewall não deverá aparecer.

    Captura de tela da caixa de diálogo Criar nova regra de firewall no SSMS.

  4. Para verificar se a conexão do Banco de Dados 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.

    Captura de tela de uma conexão com o Banco de Dados SQL do Azure no Pesquisador de Objetos.

Solucionar problemas de conectividade

  • ** Se o navegador não se conectar ao Banco de Dados SQL 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 da Web 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 o Banco de Dados 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 prevenir, solucionar problemas, diagnosticar e atenuar a conexão e erros transitórios encontrados ao interagir com o Banco de Dados 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.

Captura de tela do menu Ajuda, com a opção Limpar Cache de Token de ID de Entrada realçada em vermelho.

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.

Captura de tela da caixa de diálogo solicitando confirmação para limpar o cache de token de usuário da ID do Microsoft Entra.

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:

    Captura de tela mostrando o link

  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:

    Captura de tela mostrando como alterar o contexto do banco de dados.

  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.

Captura de tela mostrando a nova tabela.

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.

Captura de tela mostrando a lista Resultados.

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

Captura de tela de três opções para exibir os resultados da consulta.

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

    Captura de tela das propriedades de conexão.

Limpar os recursos

O TutorialDB banco de dados que você criou neste início rápido não é um banco de dados de oferta gratuita. Vamos removê-lo. Cole o seguinte código T-SQL e execute:

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