Guia de início rápido: conectar e consultar um banco de dados SQL no Fabric usando o SQL Server Management Studio (SSMS)

Aplica-se a:Banco de dados SQL no Microsoft Fabric

Comece a usar o SQL Server Management Studio (SSMS) para se conectar ao seu banco de dados SQL no Microsoft Fabric e executar alguns comandos Transact-SQL (T-SQL).

O artigo demonstra as seguintes etapas:

Pré-requisitos

• Instalar o SQL Server Management Studio
• Você precisa de uma capacidade existente do Fabric. Caso não o faça, inicie uma avaliação dos serviços do Fabric.
• Você pode usar um espaço de trabalho existente ou criar um novo espaço de trabalho de malha.
• Você deve ser membro das funções Administrador ou Membro do espaço de trabalho para criar um banco de dados SQL.
• Crie um banco de dados SQL no Fabric. Comece com um novo banco de dados vazio.

Conectar-se a um banco de dados SQL no Fabric

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

   

2. Localize o nome do servidor e o nome do banco de dados SQL no portal Fabric.

   A cadeia de conexão do banco de dados SQL é semelhante à cadeia de conexão do Banco de Dados SQL do Azure. O nome do servidor se parece com <server-unique-identifer>.database.windows.net e o nome do banco de dados se parece com <database name>-<unique identifier>.

   Para localizar a cadeia de conexão SQL para seu banco de dados SQL no Fabric:

   • Vá para as configurações do item do banco de dados SQL. Selecione Cadeias de conexão. O nome do servidor é o Data source e o nome do banco de dados é o Initial Catalog.

   • Ou, na lista de itens do espaço de trabalho, selecione o ... menu. Selecione Configurações e, em seguida, Cadeias de conexão.

   • Ou selecione o botão Abrir em e o SQL Server Management Studio. As informações de conexão do servidor são exibidas.

     

     

3. A caixa de diálogo Conectar ao servidor é exibida. Insira as seguintes informações, todas as outras configurações podem ser deixadas padrão:

   Configuração	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 do servidor totalmente qualificado	Insira o Nome do Servidor, incluindo .database.fabric.microsoft.com,1433.
   Authentication	Escolha Microsoft Entra MFA.	Para obter mais informações, consulte Autenticação no banco de dados SQL no Microsoft Fabric.
   Nome do banco de dados	Forneça o nome do banco de dados SQL.

   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 de tempo limite de conexão e o protocolo de rede. Este artigo usa os valores padrão para todas as opções.

4. Selecione Conectar.

5. Para verificar se o banco de dados SQL na conexão de malha foi bem-sucedido, expanda e explore os objetos no Pesquisador de Objetos onde 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.

Resolver problemas de conectividade

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

• Se você tiver problemas de conexão com o banco de dados SQL no Fabric, consulte Compreender a segurança de rede no Microsoft Fabric.

Limpar cache de token do Microsoft Entra ID

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

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

Se obteve acesso recente a um servidor, pode limpar o cache de token de ID do Microsoft Entra através de Ajuda>Limpar Cache de Token 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 requer nova autenticação.

Criar uma tabela no novo banco de dados

Nesta seção, você cria uma tabela em seu banco de dados.

1. No Pesquisador de Objetos, na lista Bancos de Dados , clique com o botão direito do mouse no banco de dados e selecione Nova Consulta:

   

2. Cole o seguinte trecho 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.

Após a conclusão da consulta, a nova Customers tabela é 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 trecho 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 visualizar 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 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 onde o texto foi inserido.

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 Visualização de texto, conforme mostrado na imagem na próxima seção.
• O botão do meio exibe os resultados na Visualização em Grade, que é a opção padrão.
• O terceiro botão permite que você salve os resultados em um arquivo cuja extensão é .rpt por padrão.

Verificar as propriedades da 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, revise as propriedades de conexão na parte inferior da janela de consulta.

• Você pode determinar a qual servidor e banco de dados 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.

  

Limpeza de recursos

Remova a tabela de exemplo que criamos neste início rápido. Cole o seguinte código T-SQL e execute:

DROP TABLE dbo.Customers;

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