Share via


Conectividade com data warehousing no Microsoft Fabric

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

No Microsoft Microsoft Fabric, um ponto de extremidade ou armazém de análise SQL Lakehouse pode ser acessado por meio de um fluxo de dados tabular, ou ponto de extremidade TDS, familiar a todos os aplicativos Web modernos que interagem com um ponto de extremidade do SQL Server. Isso é conhecido como a Cadeia de Conexão SQL na interface do usuário do Microsoft Fabric.

Este artigo fornece instruções sobre como se conectar ao seu ponto de extremidade de análise SQL ou ao Warehouse.

Para começar, você deve preencher os seguintes pré-requisitos:

Autenticação em armazéns no Fabric

No Microsoft Fabric, dois tipos de usuários autenticados são suportados por meio da cadeia de conexão SQL:

  • Entidades de usuário ou identidades de usuário do Microsoft Entra ID (anteriormente Azure Ative Directory)
  • Entidades de serviço Microsoft Entra ID (anteriormente Azure Ative Directory)

A cadeia de conexão SQL requer que a porta TCP 1433 esteja aberta. TCP 1433 é o número de porta padrão do SQL Server. A cadeia de conexão SQL também respeita o modelo de segurança de ponto de extremidade de análise SQL do Warehouse ou Lakehouse para acesso a dados. Os dados podem ser obtidos para todos os objetos aos quais um usuário tem acesso.

Recuperar a cadeia de conexão SQL

Para recuperar a cadeia de conexão, execute estas etapas:

  1. Navegue até o espaço de trabalho, selecione o Depósito e selecione Mais opções.

    Captura de ecrã de um item da área de trabalho de um armazém. O botão Mais opções está encaixotado.

  2. Selecione Copiar cadeia de conexão SQL para copiar a cadeia de conexão para a área de transferência.

    Captura de ecrã do ecrã da área de trabalho com o menu de contexto aberto.

Introdução ao 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).

  1. Quando você abre o SSMS, a janela Conectar ao Servidor é exibida. Se já estiver aberto, você poderá se conectar manualmente selecionando Mecanismo de Banco de Dados Connect>do Pesquisador>de Objetos.

    Captura de tela mostrando onde selecionar Mecanismo de Banco de Dados no menu Conectar.

  2. 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. Lembre-se de que apenas a autenticação multifator (MFA) do Microsoft Entra é suportada.

    Captura de ecrã a mostrar a janela Ligar ao servidor.

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

    Captura de tela mostrando onde o nome do servidor conectado aparece no painel Pesquisador de Objetos.

Ao se conectar via SSMS (ou ADS), você vê um ponto de extremidade de análise SQL e um Warehouse listados como armazéns, e é difícil diferenciar entre os dois tipos de item e sua funcionalidade. Por esse motivo, recomendamos que você 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.

Ligar com 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:

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

Para obter mais informações, consulte Criar relatórios 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 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 (anteriormente Azure Ative Directory).

Conectar-se usando JDBC

O Microsoft 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:

  1. Adicione artefatos, escolha Adicionar artefato e adicione as quatro dependências a seguir na janela como esta, em seguida, selecione Download/Update para carregar todas as dependências.

    Captura de ecrã a mostrar onde selecionar Transferir/Atualizar.

  2. 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 conectar-se ao Synapse Data Warehouse no Microsoft Microsoft Fabric a partir do adaptador de dbt uso dbt-fabric . 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 oferecem suporte à autenticação Microsoft Entra ID (anteriormente Azure Ative Directory) e permitem que os desenvolvedores usem az cli authenticationo . No entanto, a autenticação SQL não é suportada para dbt-fabric

O DBT Fabric DW Adapter 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 a configuração do adaptador dbt do Microsoft Fabric Synapse Data Warehouse e a configuração do adaptador dbt do Microsoft Fabric Synapse Data Warehouse.

Conectividade por outros meios

Qualquer ferramenta de terceiros 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 Microsoft Entra ID (anteriormente Azure Ative Directory).

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 (anteriormente Azure Ative Directory). Para obter mais informações, consulte Bibliotecas de conexão para o Banco de dados Microsoft SQL.

Considerações e limitações

  • Não há suporte para Autenticação SQL.
  • Vários conjuntos de resultados ativos (MARS) não são suportados para o Microsoft Fabric Warehouse. O MARS está desativado por padrão, no entanto, se MultipleActiveResultSets estiver incluído na cadeia de conexão, ele deve ser removido ou definido como false.
  • Na conexão com um depósito, você pode receber um erro dizendo que "O tamanho do token excedeu o tamanho máximo de carga útil permitido". Isso se deve a ter um grande número de armazéns dentro do espaço de trabalho ou ser membro de um grande número de grupos do Microsoft Entra. Em caso de erro, trabalhe com o administrador do espaço de trabalho para limpar armazéns não utilizados e tente novamente a conexão, ou entre em contato com o suporte se o problema persistir.
  • Não há suporte para conexões de servidor vinculado do SQL Server.