Conectar-se ao Fabric Data Warehouse

Aplica-se a:✅ ponto de extremidade de análise SQL e Warehouse do Microsoft Fabric

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

Para começar, você precisa de acesso a um ponto de extremidade de análise de SQL ou a um Warehouse em um workspace com permissões colaborador ou superior.

Localizar a cadeia de conexão do warehouse

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

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

As etapas a seguir detalham como começar no workspace do Microsoft Fabric e conectar um armazém ao SSMS (SQL Server Management Studio).

Quando você abre o SSMS, a janela Conectar ao Servidor é exibida. Se já estiver aberto, você poderá se conectar manualmente selecionando o MecanismodeBanco de Dados do Pesquisador de Objetos >Connect>.
Depois que a janela Conectar ao Servidor estiver aberta, cole a cadeia de conexão copiada da seção anterior deste artigo na caixa de 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 warehouse conectado do workspace e suas respectivas tabelas e exibições, todas prontas para serem consultadas.

Ao se conectar via SSMS (ou ADS), você vê um ponto de extremidade de análise de SQL e o Warehouse listados como warehouses. Adote uma convenção de nomenclatura que permite distinguir facilmente entre os dois tipos de item quando você trabalha em ferramentas fora da experiência do portal do Microsoft Fabric. Há suporte apenas para SSMS 19 ou superior.

Conectar usando o Power BI

Um ponto de extremidade de análise de SQL do Warehouse ou do Lakehouse é uma fonte de dados nativa e totalmente compatível no Power BI e não é necessário 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 workspace e:

Selecione o Warehouse.
Escolha entidades.
Carregar Dados – escolha um modo de conectividade de dados: importação ou DirectQuery.

Para obter mais informações, consulte Criar relatórios sobre data warehousing no Microsoft Fabric.

Conectar usando o OLE DB

Damos suporte à conectividade com o ponto de extremidade de análise do Warehouse ou do SQL usando o OLE DB. Verifique se você está executando o Driver do Microsoft OLE DB mais recente para SQL Server.

Conectar usando ODBC

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

Conectar-se usando o Bloco de Anotações do Python do Fabric

Os Notebooks Python do Fabric (versão prévia) oferecem a capacidade de executar código T-SQL com o comando mágico T-SQL. Nas etapas a seguir, conecte-se a um item de warehouse no Fabric usando o %%tsql comando magic:

Crie um bloco de anotações em seu workspace com o idioma definido como Python.
Em uma célula, use o %%tsql comando magic. O tipo de célula é alterado automaticamente para T-SQL.

No exemplo a seguir, substitua <warehouse> pelo nome do item do warehouse. 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 de um armazém chamado Contoso:
```
%%tsql -artifact Contoso -type Warehouse
SELECT * FROM wh.DimDate;
```
Você também pode associar 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 o T-SQL dentro do Python Notebooks, consulte Executar código T-SQL em notebooks Python do Fabric. Para ver a sintaxe completa, use o %tsql? comando. Esse comando exibe as informações de ajuda para o comando magic T-SQL, incluindo os parâmetros disponíveis e suas descrições.

Conectar usando JDBC

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

Ao estabelecer a conectividade por meio do JDBC, verifique se há as seguintes dependências:

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

Selecione Testar conexão e Concluir.

Captura de tela da guia 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>

Conectar usando o dbt

O dbt adaptador é uma estrutura de transformação de dados que usa as melhores práticas de engenharia de software, como teste e controle de versão, para reduzir o código, automatizar o gerenciamento de dependências 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 escolhido. Para se conectar a um warehouse de dbt, use dbt-fabric o adaptador. Da mesma forma, a fonte de dados do pool de SQL dedicado do Azure Synapse Analytics tem seu próprio adaptador. dbt-synapse

Ambos os adaptadores dão suporte à autenticação da ID do Microsoft Entra e permitem que os desenvolvedores usem az cli authentication. No entanto, a autenticação SQL não tem suporte para dbt-fabric.

O dbt Adaptador DW do Fabric usa a pyodbc biblioteca para estabelecer conectividade com o Warehouse. A pyodbc biblioteca é uma implementação ODBC na linguagem Python que usa a Especificação da API do Banco de Dados Python 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 proxy TDS (Streaming de Dados Tabulares).

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 ponto de extremidade de análise do Microsoft Fabric Warehouse ou SQL usando a autenticação da ID do Microsoft Entra. Para obter mais informações e exemplos de cadeias de conexão, consulte a autenticação do Microsoft Entra como uma alternativa à autenticação do SQL.

Aplicativos personalizados

No Microsoft Fabric, um warehouse e um ponto de extremidade de análise de SQL do 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 ser autenticados usando a ID do Microsoft Entra. Para obter mais informações, consulte Bibliotecas de conexões para o Banco de Dados SQL da Microsoft. Para obter mais informações e exemplos de cadeias de conexão, consulte a autenticação do Microsoft Entra como uma alternativa à autenticação do SQL.

Comentários

Esta página foi útil?

Last updated on 2025-08-28