Conectar-se ao Fabric Data Warehouse

Aplica-se a:✅ SQL Analytics Endpoint e Armazém no Microsoft Fabric

Este tutorial aborda a conexão de ferramentas e aplicativos ao endpoint de análise de SQL, a um Armazém de Dados ou ao instantâneo de um Armazém de Dados.

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

Encontrar a cadeia de conexão do armazém

Para encontrar o nome do servidor do item do armazém:

Abra as configurações do seu armazém de dados ou ponto de extremidade de análise SQL.
Na janela Configurações, selecione a página de endpoint SQL.
Copie a string de conexão SQL e use-a para se conectar externamente ao item a partir do Power BI Desktop, aplicativos ou ferramentas de cliente. Esse é o nome do servidor do seu armazém.
Você deve fornecer o nome do item no warehouse como Initial Catalog ou Database name ao se conectar. Se você não fornecer a propriedade de InitialCatalog cadeia de conexão, o contexto inicial da conexão será com o master warehouse.

Conectar-se usando SQL Server Management Studio (SSMS)

As etapas a seguir detalham como começar no workspace Microsoft Fabric e conectar um warehouse 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 Pesquisador de Objetos>Connect>Mecanismo de Banco de Dados.
Depois que a janela Conectar ao Servidor estiver aberta, cole o cadeia de conexão copiado da seção anterior deste artigo na caixa Server name. O nome do servidor é semelhante a <unique identifier>.datawarehouse.fabric.microsoft.com. Selecione Conectar e prossiga com as credenciais apropriadas para autenticação.
Forneça o nome do armazém ao qual você pretende se conectar. O nome válido do warehouse não inclui o <unique identifier>.datawarehouse.fabric.microsoft.com necessário para o nome do servidor. Se o nome do seu armazém estiver NYC Taxi, o catálogo inicial será NYC Taxi.
Depois que a conexão é estabelecida, o Pesquisador de Objetos exibe o armazém conectado do espaço de trabalho e suas respectivas tabelas e visualizações, todas elas prontas para consulta.

Quando você se conecta por meio do SSMS ou do Visual Studio Code, vê um endpoint de análise SQL e o Warehouse aparecendo na lista como warehouses. Adote uma convenção de nomenclatura que você pode distinguir facilmente entre os dois tipos de item quando trabalha em ferramentas fora da experiência do portal Microsoft Fabric. Há suporte apenas para SSMS 19 ou superior.

Conectar usando Power BI

Um endpoint de análise SQL de Warehouse ou Lakehouse é uma fonte de dados nativa e totalmente suportada no Power BI, e não há necessidade de usar a string de conexão SQL. O painel Dados expõe todos os armazéns aos quais você tem acesso diretamente. Isso possibilita 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: 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 endpoint do Warehouse ou do SQL usando OLE DB. Verifique se você está executando o Microsoft Driver do OLE DB para SQL Server mais recente.

Conectar usando ODBC

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

Conectar-se usando o Fabric Python Notebook

Fabric Python Notebooks (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 armazém no Fabric usando o comando mágico %%tsql.

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

No exemplo a seguir, substitua <warehouse> pelo nome do item do estoque. 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 de blocos de anotações Python, consulte Run T-SQL code in Fabric Python notebooks. 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

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

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 armazém de dbt, use o adaptador dbt-fabric. 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 Microsoft Entra ID 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 biblioteca pyodbc é uma implementação ODBC na linguagem Python que usa a Especificação da API de Banco de Dados do Python v2.0. A biblioteca pyodbc passa diretamente a cadeia de conexão para o driver de banco de dados por meio do SQLDriverConnect na estrutura de conexão msodbc para o Microsoft Fabric usando um serviço proxy de TDS (Streaming de Dados Tabulares).

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

Conectar Microsoft Fabric para conectar-se ao dbt Cloud.
Configuração do adaptador dbt para Microsoft Fabric Data Warehouse para a conexão com o 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 ao Microsoft Fabric Warehouse ou a um ponto de extremidade de análise SQL, usando autenticação Microsoft Entra ID. Para obter mais informações e exemplos de cadeias de conexão, consulte Microsoft Entra autenticação como uma alternativa à autenticação do SQL.

Aplicativos personalizados

Em Microsoft Fabric, um warehouse e um Lakehouse fornecem um ponto de extremidade de análise de SQL e uma cadeia de conexão SQL. Os dados são acessíveis a partir de um vasto ecossistema de ferramentas SQL, desde que possam se autenticar usando Microsoft Entra ID. 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 Microsoft Entra autenticação como uma alternativa à autenticação do SQL.

Comentários

Esta página foi útil?

Last updated on 2026-05-14