Conectar-se ao Fabric Data Warehouse

Aplica-se a:✅ Endpoint de Análise SQL e Warehouse no Microsoft Fabric

Este tutorial aborda a conexão de ferramentas e aplicativos ao seu ponto de extremidade de análise SQL ou ao Warehouse, ou ao instantâneo de um Warehouse.

Para começar, você precisa ter acesso a um ponto de extremidade de análise SQL ou a um Armazém dentro de um espaço de trabalho com permissões de Colaborador ou superiores.

Localizar a cadeia de conexão do armazém

Abra as Configurações do seu armazém ou ponto de extremidade de análise SQL.
Na janela Configurações , selecione a página Ponto de extremidade SQL .
Copie a cadeia de conexão SQL e use-a para se conectar externamente ao item a partir da área de trabalho, aplicativos ou ferramentas de cliente do Power BI.

Conectar-se usando o SQL Server Management Studio (SSMS)

As etapas a seguir detalham como iniciar no espaço de trabalho do Microsoft Fabric e conectar um depósito ao SQL Server Management Studio (SSMS).

Quando você abre o SSMS, a janela Conectar ao Servidor é exibida. Se já estiver aberto, você poderá se conectar manualmente selecionando Mecanismode Banco de DadosConnect> do Pesquisador> de Objetos.
Quando a janela Conectar ao Servidor estiver aberta, cole a cadeia de conexão copiada da seção anterior deste artigo na caixa Nome do servidor . Selecione Conectar e prossiga com as credenciais apropriadas para autenticação.
Depois que a conexão é estabelecida, o Pesquisador de Objetos exibe o depósito conectado do espaço de trabalho e suas respetivas tabelas e exibições, todas prontas para serem consultadas.

Ao conectar-se via SSMS (ou ADS), você vê um ponto de extremidade de análise SQL e um Armazém listados como depósitos. Adote uma convenção de nomenclatura que permita distinguir facilmente entre os dois tipos de item quando você trabalha em ferramentas fora da experiência do portal do Microsoft Fabric. Apenas o SSMS 19 ou superior é suportado.

Conectar-se usando o Power BI

Um ponto de extremidade de análise SQL do Warehouse ou Lakehouse é uma fonte de dados nativa e totalmente suportada no Power BI, e não há necessidade de usar a cadeia de conexão SQL. O painel Dados expõe todos os armazéns aos quais você tem acesso diretamente. Isso permite que você encontre facilmente seus armazéns por espaço de trabalho e:

Selecione o Armazém.
Escolha entidades.
Carregar dados - escolha um modo de conectividade de dados: importar ou DirectQuery.

Para obter mais informações, consulte Criar relatórios sobre armazenamento de dados no Microsoft Fabric.

Conectar-se usando OLE DB

Suportamos a conectividade com o Warehouse ou o ponto de extremidade de análise SQL usando OLE DB. Verifique se você está executando o driver Microsoft OLE DB mais recente para SQL Server.

Conectar-se usando ODBC

O Microsoft Fabric oferece suporte à conectividade com o ponto de extremidade de análise Warehouse ou SQL usando ODBC. Verifique se você está executando o driver ODBC mais recente para SQL Server. Use a autenticação do Microsoft Entra ID. Apenas ODBC 18 ou versões superiores são suportadas.

Conectar-se usando o Fabric Python Notebook

Os Fabric Python Notebooks (visualização) oferecem a capacidade de executar código T-SQL com o comando T-SQL magic. Nas etapas a seguir, conecte-se a um item de depósito no Fabric usando o %%tsql comando magic:

Crie um bloco de anotações em seu espaço de trabalho com a linguagem definida como Python.
Em uma célula, use o %%tsql comando magic. O tipo de célula muda automaticamente para T-SQL.

No exemplo a seguir, substitua <warehouse> pelo nome do item de depósito. O -type parâmetro deve ser Warehouse.
```
%%tsql -artifact <warehouse> -type Warehouse
```
Em seguida, inclua o comando T-SQL. Por exemplo, para executar uma consulta a partir de um depósito chamado Contoso:
```
%%tsql -artifact Contoso -type Warehouse
SELECT * FROM wh.DimDate;
```
Você também pode vincular os resultados a um dataframe com o -bind argumento:
```
%%tsql -artifact Contoso -type Warehouse -bind df2
```

Para obter mais possibilidades de consultar seus dados com T-SQL dentro de blocos de anotações Python, consulte Executar código T-SQL em blocos de anotações Python de malha. Para ver a sintaxe completa, use o %tsql? comando. Este comando exibe as informações de ajuda para o comando mágico T-SQL, incluindo os parâmetros disponíveis e suas descrições.

Conectar-se usando JDBC

O Microsoft Fabric também oferece suporte à conectividade com o ponto de extremidade de análise Warehouse ou SQL usando um driver JDBC (conectividade de banco de dados Java).

Ao estabelecer conectividade via JDBC, verifique as seguintes dependências:

Adicione artefatos. Escolha Adicionar Artefato e adicione as quatro dependências a seguir e, em seguida, selecione Baixar/Atualizar para carregar todas as dependências. Por exemplo:

Selecione Testar conexão e Concluir.

Captura de ecrã do separador Declaração de Dependência.

<dependency>
   <groupId>com.microsoft.azure</groupId>
   <artifactId>msal4j</artifactId>
   <version>1.13.3</version>
</dependency>

<dependency>
   <groupId>com.microsoft.sqlserver</groupId>
   <artifactId>mssql-jdbc_auth</artifactId>
   <version>11.2.1.x86</version>
</dependency>

 <dependency>
   <groupId>com.microsoft.sqlserver</groupId>
   <artifactId>mssql-jdbc</artifactId>
   <version>12.1.0.jre11-preview</version>
</dependency>

 <dependency>
   <groupId>com.microsoft.aad</groupId>
   <artifactId>adal</artifactId>
   <version>4.2.2</version>
</dependency>

Conecte-se usando dbt

O dbt adaptador é uma estrutura de transformação de dados que usa práticas recomendadas de engenharia de software, como teste e controle de versão, para reduzir o código, automatizar o gerenciamento de dependência e enviar dados mais confiáveis — tudo com SQL.

Os dbt plug-ins de adaptador específicos da plataforma de dados permitem que os usuários se conectem ao armazenamento de dados de sua escolha. Para se conectar a um depósito a partir do dbt, use dbt-fabric o adaptador. Da mesma forma, a fonte de dados dedicada do pool SQL do Azure Synapse Analytics tem seu próprio adaptador, dbt-synapse.

Ambos os adaptadores suportam a autenticação Microsoft Entra ID e permitem que os desenvolvedores usem az cli authenticationo . No entanto, a autenticação SQL não é suportada para dbt-fabrico .

O dbt adaptador Fabric DW usa a pyodbc biblioteca para estabelecer conectividade com o Warehouse. A pyodbc biblioteca é uma implementação ODBC em linguagem Python que usa Python Database API Specification v2.0. A pyodbc biblioteca passa diretamente a cadeia de conexão para o driver de banco de dados por meio do SQLDriverConnect na estrutura de conexão com o msodbc Microsoft Fabric usando um serviço de proxy TDS (Tabular Data Streaming).

Para obter mais informações, consulte os seguintes recursos:

Conecte o Microsoft Fabric para se conectar no dbt Cloud.
Configuração do adaptador dbt do Microsoft Fabric Data Warehouse para se conectar ao dbt Core.
Configuração do adaptador dbt do Microsoft Fabric Data Warehouse para obter detalhes adicionais de configuração.

Conectividade por outros meios

Qualquer ferramenta que não seja da Microsoft também pode usar a cadeia de conexão SQL por meio de drivers ODBC ou OLE DB para se conectar a um Microsoft Fabric Warehouse ou ponto de extremidade de análise SQL, usando a autenticação de ID do Microsoft Entra. Para obter mais informações e exemplos de cadeias de conexão, consulte Autenticação do Microsoft Entra como alternativa à autenticação SQL.

Aplicações personalizadas

No Microsoft Fabric, um Warehouse e um ponto de extremidade de análise SQL Lakehouse fornecem uma cadeia de conexão SQL. Os dados são acessíveis a partir de um vasto ecossistema de ferramentas SQL, desde que possam autenticar usando o Microsoft Entra ID. Para obter mais informações, consulte Bibliotecas de conexão para o Banco de dados Microsoft SQL. Para obter mais informações e exemplos de cadeias de conexão, consulte Autenticação do Microsoft Entra como alternativa à autenticação SQL.

Feedback

Esta página foi útil?

Last updated on 2025-08-28