Partager via


Connectez-vous à votre base de données SQL dans Microsoft Fabric

S'applique à :base de données SQL dans Microsoft Fabric

Vous pouvez vous connecter à votre base de données SQL dans Fabric de toutes les mêmes manières que Azure SQL Database.

Prerequisites

Éditeur de requête dans le portail Fabric

Vous pouvez vous connecter à la base de données SQL à l’aide de l’éditeur web dans le portail Fabric.

L’éditeur web pour la base de données SQL dans Fabric fournit une interface d’explorateur d’objets et d’exécution de requêtes de base. Le menu Explorateur intégré liste tous les objets de base de données.

Une nouvelle base de données SQL dans Fabric s’ouvre automatiquement dans l’éditeur web et une base de données existante peut être ouverte dans l’éditeur web en la sélectionnant dans Fabric.

Rechercher chaîne de connexion SQL

Dans Microsoft Fabric, le point de terminaison d'analyse SQL et la base de données SQL sont accessibles via un flux de données tabulaires ou un point de terminaison TDS, familier à toutes les applications web modernes qui interagissent avec un point de terminaison TDS de SQL Server. C'est la chaîne de connexion SQL dans l'interface utilisateur Microsoft Fabric.

  • Le nom du serveur de la base de données SQL est similaire au nom du serveur de Azure SQL Database, <server-unique-identifier>.database.windows.net.
  • Le nom du serveur de point de terminaison SQL Analytics est similaire au nom du serveur d’un entrepôt. <server-unique-identifier>.<tenant>.fabric.microsoft.com

Pour trouver le nom du serveur pour votre base de données SQL Fabric :

  • Accédez aux paramètres de votre élément de base de données SQL.
  • Ou, dans la liste des éléments, sélectionnez le ... menu. Sélectionnez Paramètres , puis chaînes de connexion. Fabric fournit des chaînes de connexion complètes pour les fournisseurs, notamment ADO.NET, JDBC, ODBC, PHP et Go.
  • Vous pouvez également sélectionner le bouton Open in et sélectionner SQL Server Management Studio ou Visual Studio Code. Le nom du serveur et le nom de la base de données sont affichés.

Pour rechercher le nom du serveur du point de terminaison d’analytique SQL de votre base de données SQL :

  • Accédez aux paramètres de votre élément de base de données SQL, puis sélectionnez Chaînes de connexion.
  • Vous pouvez également sélectionner le menu ..., puis sélectionner SQL endpoint, puis copier le SQL connection string. Il s’agit du nom du serveur.

Bouton Ouvrir dans pour se connecter

Vous pouvez facilement vous connecter à votre base de données SQL avec le bouton Ouvrir dans dans l’éditeur de requête du portail Fabric. Choisissez SQL Server Management Studio ou l’extension MSSQL pour Visual Studio Code.

Capture d’écran de l’éditeur de requête du portail Fabric montrant le bouton Ouvrir dans pour faciliter les connexions avec SSMS ou l’extension MSSQL dans VS Code.

Se connecter avec SQL Server Management Studio manuellement

Si votre version de SSMS est antérieure à 21, la population automatique des détails de connexion n’est pas prise en charge après avoir cliqué sur Ouvrir dans Vous pouvez toujours vous connecter manuellement en fournissant vos informations de serveur, de base de données et d’authentification.

Capture d’écran des paramètres SSMS.

Dans SQL Server Management Studio (SSMS) :

  1. Dans l'espace de travail de la charge de travail Base de données dans Fabric, sélectionnez l'option ... située à côté de votre base de données SQL.
  2. Sélectionnez Paramètres.
  3. Sélectionnez Chaînes de connexion. Recherchez la chaîne de connexion de votre base de données SQL, y compris le Data Source=. Par exemple : tcp:<servername>.database.fabric.microsoft.com,1433. Le Initial Catalog= est le nom de la base de données.
  4. Dans SSMS, ouvrez une Nouvelle connexion.
  5. Dans la boîte de dialogue Fabric, copiez et collez la valeur dans le Server Name.
  6. Choisissez Authentication type : Microsoft Entra ID - Universal with MFA support.
  7. Cliquez sur Options<<.
  8. Copiez et collez la valeur de Database Name dans la zone de texte Se connecter à la base de données.
  9. Sélectionnez Se connecter.
  10. Connectez-vous avec Microsoft Entra ID - Universel avec support pour l'authentification multifacteur.

Se connecter avec l’extension MSSQL pour Visual Studio Code manuellement

Vous pouvez également utiliser l’expérience de navigation Fabric dans l’extension MSSQL pour VS Code. Cette fonctionnalité permet aux développeurs de se connecter en toute transparence à leur base de données SQL dans les points de terminaison Fabric ou SQL Analytics, sans copier manuellement des chaînes de connexion à partir du portail Fabric ou en s’appuyant sur le bouton Ouvrir dans pour se connecter directement à leur base de données dans VS Code.

Capture d’écran des paramètres de connexion VS Code.

Se connecter avec sqlcmd

Vous pouvez vous connecter à votre base de données SQL dans Fabric avec sqlcmd, comme tout autre produit SQL Database Engine. Utilisez l’authentification Microsoft Entra ID avec l’option G. L’authentification Microsoft Entra (-G) nécessite au moins la version 13.1.

Dans l’exemple suivant, remplacez <server name> par la longue chaîne de texte unique qui représente votre base de données SQL dans Fabric.

sqlcmd -S <your_server>.database.fabric.microsoft.com;1433 -G -d <your_database> -i ./script.sql

Se connecter avec l’utilitaire bcp

Vous pouvez vous connecter à votre base de données SQL dans Fabric avec l’utilitaire bcp, tout comme tout autre produit SQL Database Engine. Utilisez Microsoft Entra ID authentification avec l’option -G.

Dans l’exemple suivant, remplacez <server name> par la longue chaîne de texte unique qui représente votre base de données SQL dans Fabric.

bcp bcptest in "c:\temp\sample.dat" -S <your_server>.database.fabric.microsoft.com;1433 -d testdb -G -c

Se connecter avec Python Notebook

Fabric Python Notebooks (préversion) offrent l'abilité d’exécuter du code T-SQL avec la commande magic T-SQL.

Dans les étapes suivantes, connectez-vous à une base de données SQL dans Fabric à l’aide de la %%tsql commande magic :

  1. Créez un bloc-notes dans votre espace de travail en fixant la langue à Python.

  2. Dans une cellule, utilisez la %%tsql commande magique. Le type de cellule passe automatiquement à T-SQL.

    Dans l’exemple suivant, remplacez <databasename> par le nom de votre base de données SQL dans Fabric. Le -type paramètre doit être SQLDatabase.

    %%tsql -artifact <databasename> -type SQLDatabase
    

    Incluez ensuite votre commande T-SQL. Par exemple, pour exécuter une requête à partir d’une base de données nommée Contoso:

    %%tsql -artifact Contoso -type SQLDatabase
    SELECT * FROM SalesLT.Customer;
    
  3. Vous pouvez également lier les résultats à un dataframe avec l’argument -bind :

    %%tsql -artifact Contoso -type SQLDatabase -bind df2
    

Pour plus de possibilités d’interroger vos données avec T-SQL dans Python Notebooks, consultez Exécuter le code T-SQL dans les notebooks Fabric Python. Pour afficher la syntaxe complète, utilisez la %tsql? commande. Cette commande affiche les informations d’aide de la commande magic T-SQL, y compris les paramètres disponibles et leurs descriptions.