Compartilhar via

Início Rápido: conectar e consultar um pool de SQL dedicado (anteriormente SQL DW) no Azure Synapse Analytics com o SSMS (SQL Server Management Studio)

Aplica-se a:Azure Synapse Analytics

Neste guia de início rápido, você pode começar a usar o SQL Server Management Studio (SSMS) para estabelecer conexão com o pool de SQL dedicado (anteriormente SQL DW) no Azure Synapse Analytics e executar alguns comandos T-SQL (Transact-SQL).

  • Conecte-se a um pool de SQL dedicado (anteriormente SQL DW) no Azure Synapse Analytics
  • 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

Pré-requisitos

Para concluir este artigo, você precisa do SQL Server Management Studio (SSMS) e de acesso a uma fonte de dados.

Conecte-se a um pool de SQL dedicado (anteriormente SQL DW) no Azure Synapse Analytics

Observação

Para autenticar em mecanismos de banco de dados com a MFA (autenticação multifator) do Microsoft Entra, incluindo o Azure Analysis Services, instale a versão mais recente do SSMS (SQL Server Management Studio).

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

    Captura de tela do link de conexão no Pesquisador de Objetos.

  2. Na janela Conectar ao servidor, use a seguinte lista para orientação:

    Configurações Valores sugeridos Descrição
    Tipo de servidor Mecanismo de banco de dados Para o tipo de servidor , selecione Mecanismo de Banco de Dados (geralmente a opção padrão).
    Nome do servidor O nome do servidor totalmente qualificado Para Nome do servidor, digite o nome do servidor do seu pool de SQL dedicado (anteriormente SQL DW).
    Autenticação Autenticação do SQL Server Use a Autenticação do SQL Server para se conectar a um pool de SQL dedicado (antigo SQL DW).

    Não há suporte para o método de Autenticação do Windows no SQL do Azure. Para obter mais informações, confira Autenticação do SQL do Azure.
    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.
    criptografia 1 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 no 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 valor padrão é Obrigatório no SSMS (SQL Server Management Studio) 20. A criptografia estrita (SQL Server 2022 e Azure SQL) deve ser usada para o Banco de Dados SQL do Azure e o Azure SQL Managed Instance. Criptografia estrita (SQL Server 2022 e SQL do Azure) pode ser usada no SQL Server quando a opção Forçar Criptografia Estrita está habilitada. No SQL Server Management Studio 21, isso é chamado Estrito (no mínimo SQL Server 2022 e Azure SQL).

    Captura de tela do diálogo de conexão do Azure Synapse Analytics.

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

    Você também pode modificar outras opções de conexão 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.

    Se o firewall ainda não estiver configurado, um aviso será mostrado solicitando sua configuração. Depois de se conectar, preencha as informações de entrada da conta do Azure e prossiga para definir a regra de firewall. Em seguida, selecione OK. Essa solicitação é uma ação que será realizada uma vez. Depois que você configurar o firewall, o aviso de firewall não será exibido.

  4. Para verificar se a conexão do pool de SQL dedicado (anteriormente SQL DW) foi bem-sucedida, expanda e explore os objetos dentro do 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 como se conectar a um banco de dados do Azure Synapse Analytics. Captura de tela de como se conectar a um banco de dados do Azure Synapse Analytics.

Solucionar problemas de conectividade

Você pode enfrentar problemas de conexão com o pool de SQL dedicado (anteriormente SQL DW). Para obter mais informações sobre como solucionar problemas de conexão, visite Solucionar problemas de conectividade e outros erros.

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 uma tabela

Nesta seção, você criará uma tabela em seu pool de SQL dedicado (anteriormente SQL DW).

  1. No Pesquisador de Objetos, clique com o botão direito do mouse no pool de SQL dedicado (antigo SQL DW) e selecione Nova consulta.

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

Após a conclusão da consulta, a nova tabela Clientes é 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ó Tabelas do pool de SQL dedicado (anteriormente SQL DW) no Pesquisador de Objetos e selecione Atualizar.

Captura de tela da nova tabela.

Inserir linhas na nova tabela

Agora, vamos inserir algumas linhas na tabela Clientes 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 VALUES (1, N'Orlando', N'Australia', N'');
INSERT INTO dbo.Customers VALUES (2, N'Keith', N'India', N'keith0@adventure-works.com');
INSERT INTO dbo.Customers VALUES (3, N'Donna', N'Germany', N'donna0@adventure-works.com');
INSERT INTO dbo.Customers VALUES (4, N'Janet', N'United States', N'janet1@adventure-works.com');

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 tabela Customers e exibir as linhas que foram inseridas, cole o seguinte trecho 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 da lista de 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 na Exibição de 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.

  • Também é possível exibir a duração da consulta e o número de linhas retornadas pela consulta executada anteriormente.

    Captura de tela das propriedades da conexão.

Conteúdo relacionado

  • Last updated on