Connectivité à l’entrepôt de données dans Microsoft Fabric

S’applique à : point de terminaison d’analytique SQL et entrepôt dans Microsoft Fabric

Dans Microsoft Fabric, un point de terminaison ou un entrepôt SQL Lakehouse est accessible via un flux de données tabulaires (Tabular Data Stream) ou point de terminaison TDS, familier à toutes les applications web modernes qui interagissent avec un point de terminaison d’analytique SQL Server. Il s’agit de la chaîne de connexion SQL dans l’interface utilisateur de Microsoft Fabric.

Cet article décrit comment se connecter à votre entrepôt ou point de terminaison d’analytique SQL.

Pour commencer, vous devez remplir les conditions préalables suivantes :

Authentification auprès des entrepôts dans Fabric

Dans Microsoft Fabric, deux types d’utilisateurs authentifiés sont pris en charge via la chaîne de connexion SQL :

  • Principaux d’utilisateur Microsoft Entra ID (anciennement Azure Active Directory) ou identités d’utilisateur
  • Principaux de service Microsoft Entra ID (anciennement Azure Active Directory)

La chaîne de connexion SQL nécessite l’ouverture du port TCP 1433. TCP 1433 est le numéro de port standard du SQL Server. La chaîne de connexion SQL respecte également le modèle de sécurité de l’entrepôt ou du point de terminaison d’analytique SQL Lakehouse pour l’accès aux données. Les données peuvent être obtenues pour tous les objets auxquels un utilisateur a accès.

Récupérer la chaîne de connexion SQL

Pour récupérer la chaîne de connexion, procédez comme suit :

  1. Accédez à votre espace de travail, sélectionnez l’entrepôt, puis Autres options.

    Capture d’écran d’un article d’espace de travail pour un entrepôt. Le bouton Plus d’options est encadré.

  2. Sélectionnez Copier la chaîne de connexion SQL pour copier la chaîne de connexion dans votre Presse-papiers.

    Capture d’écran de l’espace de travail avec le menu contextuel ouvert.

Prise en main de SQL Server Management Studio (SSMS)

Les étapes suivantes expliquent en détail comment démarrer dans l’espace de travail Microsoft Fabric et connecter un entrepôt à SQL Server Management Studio (SSMS).

  1. Lorsque vous ouvrez SSMS, la fenêtre Se connecter au serveur apparaît. Si elle est déjà ouverte, vous pouvez vous connecter manuellement en sélectionnant Explorateur d’objets SQL Server>Se connecter>Moteur de base de données.

    Capture d’écran montrant où sélectionner Moteur de base de données Microsoft SQL Server dans le menu Se connecter.

  2. Une fois la fenêtre Se connecter au serveur ouverte, collez la chaîne de connexion copiée à partir de la section précédente de cet article dans la zone Nom du serveur. Sélectionnez Se connecter et poursuivez avec les informations d’identification appropriées pour l’authentification. Pour rappel, seule l’authentification multifacteur Microsoft Entra est prise en charge.

    Capture d’écran montrant la fenêtre Se connecter au serveur.

  3. Une fois la connexion établie, Explorateur d’objets SQL Server affiche l’entrepôt connecté à partir de l’espace de travail et ses tables et vues respectives, qui sont toutes prêtes à être interrogées.

    Capture d’écran montrant où le nom du serveur connecté apparaît dans le volet Explorateur d’objets.

Lorsque vous vous connectez via SSMS (ou ADS), vous voyez à la fois un point de terminaison d’analytique SQL et un entrepôt répertoriés en tant qu’entrepôts, et il est difficile de différencier les deux types d’éléments et leurs fonctionnalités. Pour cette raison, nous vous encourageons vivement à adopter une convention d’affectation de noms qui vous permet de faire facilement la distinction entre les deux types d’éléments lorsque vous travaillez dans des outils en dehors de l’expérience du portail Microsoft Fabric.

Se connecter avec Power BI

Un entrepôt ou point de terminaison d’analytique SQL Lakehouse est une source de données native entièrement prise en charge dans Power BI, et il n’est pas nécessaire d’utiliser la chaîne de connexion SQL. Le volet Données expose tous les entrepôts auxquels vous avez accès directement. Cela vous permet de trouver facilement vos entrepôts par espace de travail, et :

  1. Sélectionner l’entrepôt.
  2. Choisir des entités.
  3. Charger des données : choisissez un mode de connectivité des données : importer ou DirectQuery

Pour plus d’informations, consultez Créer des rapports dans Microsoft Fabric.

Se connecter avec OLE DB

Nous prenons en charge la connectivité à l’entrepôt ou au point de terminaison d’analytique SQL à l’aide d’OLE DB. Vérifiez que vous exécutez la dernière version de Microsoft OLE DB Driver pour SQL Server.

Se connecter avec ODBC

Microsoft Fabric prend en charge la connectivité à l’entrepôt ou au point de terminaison d’analytique SQL à l’aide d’ODBC. Vérifiez que vous exécutez le pilote ODBC le plus récent pour SQL Server. Utilisez l’authentification avec des jetons Microsoft Entra ID (anciennement Azure Active Directory).

Se connecter avec JDBC

Microsoft Fabric prend également en charge la connectivité à l’entrepôt ou au point de terminaison d’analytique SQL à l’aide d’un pilote JDBC (Java Database Connectivity).

Lors de l’établissement de la connectivité via JDBC, vérifiez les dépendances suivantes :

  1. Ajouter des artefacts, choisissez Ajouter un artefact et ajoutez les quatre dépendances suivantes dans la fenêtre comme suit, puis sélectionnez Télécharger/Mettre à jour pour charger toutes les dépendances.

    Capture d’écran montrant où sélectionner Télécharger/Mettre à jour.

  2. Sélectionnez Tester la connexion, puis Terminer.

    Capture d’écran de l’onglet Déclaration de dépendance.

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

Se connecter avec dbt

L’adaptateur dbt est une infrastructure de transformation des données qui utilise les meilleures pratiques de génie logiciel, telles que les tests et la gestion de version, pour réduire le code, automatiser la gestion des dépendances et expédier des données plus fiables, le tout avec SQL.

Les dbt plugins d’adaptateur spécifiques à la plateforme de données permettent aux utilisateurs de se connecter au magasin de données de leur choix. Pour vous connecter à Synapse Data Warehouse dans Microsoft Fabric à partir de dbt, utilisez l’adaptateurdbt-fabric. De même, la source de données du pool SQL dédiée à Azure Synapse Analytics dispose de son propre adaptateur, dbt-synapse.

Les deux adaptateurs prennent en charge l’authentification Microsoft Entra ID (anciennement Azure Active Directory) et permettent aux développeurs d’utiliser az cli authentication. Toutefois, l’authentification SQL n’est pas prise en charge pour dbt-fabric

L’adaptateur DBT Fabric DW utilise la bibliothèque pyodbc pour établir la connectivité avec l’entrepôt. La bibliothèque pyodbc est une implémentation ODBC en langage Python qui utilise la spécification de l’API de base de données Python v2.0.  La bibliothèque pyodbc transmet directement la chaîne de connexion au pilote de base de données via SQLDriverConnect dans la structure de connexion msodbc à Microsoft Fabric à l’aide d’un service proxy TDS (Tabular Data Streaming).

Pour plus d’informations, consultez l’installation de l’adaptateur dbt Microsoft Fabric Synapse Data Warehouse et la configuration de l’adaptateur dbt Microsoft Fabric Synapse Data Warehouse.

Connectivité par d’autres moyens

Tout outil tiers peut utiliser la chaîne de connexion SQL via des pilotes ODBC ou OLE DB pour se connecter à un entrepôt Microsoft Fabric ou à un point de terminaison d’analytique SQL, à l’aide de l’authentification Microsoft Entra ID (anciennement Azure Active Directory).

Applications personnalisées

Dans Microsoft Fabric, un entrepôt et un point de terminaison d’analytique SQL Lakehouse fournissent une chaîne de connexion SQL. Les données sont accessibles à partir d’un vaste écosystème d’outils SQL, à condition qu’elles puissent s’authentifier à l’aide de Microsoft Entra ID (anciennement Azure Active Directory). Pour plus d’informations, consultez Bibliothèques de connexions pour Microsoft SQL Database.

Considérations et limitations

  • L’authentification SQL n’est pas prise en charge.
  • MARS (Multiple Active Result Set) n’est pas pris en charge pour l’entrepôt Microsoft Fabric. MARS est désactivé par défaut, mais si MultipleActiveResultSets est inclus dans la chaîne de connexion, il doit être supprimé ou défini sur false.
  • Lors de la connexion à un entrepôt, vous pourriez recevoir une erreur indiquant que « La taille du jeton a dépassé la taille de charge utile maximale autorisée ». Cela est dû au fait d’avoir un grand nombre d’entrepôts dans l’espace de travail ou d’être membre d’un grand nombre de groupes Microsoft Entra. Si vous obtenez cette erreur, contactez l’administrateur de l’espace de travail pour qu’il supprime les entrepôts inutilisés et réessayez de vous connecter, ou contactez l’assistance si le problème persiste.
  • Les connexions de serveur lié à partir de SQL Server ne sont pas prises en charge.