Connectivité de l’entrepôt

S’applique à :✅ point de terminaison pour les analyses SQL et entrepôt de données dans Microsoft Fabric

Dans Microsoft Fabric, les utilisateurs accèdent à un point de terminaison d’analytique SQL ou à un entrepôt via un point de terminaison TDS (Tabular Data Stream). Les applications web modernes interagissent avec un point de terminaison TDS SQL Server. Dans les paramètres Microsoft Fabric, ce point de terminaison est étiqueté comme chaîne de connexion SQL.

Conseil / Astuce

Pour obtenir un didacticiel sur la connexion avec les outils courants, consultez Se connecter à Fabric Data Warehouse.

Authentification auprès des entrepôts dans Fabric

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

  • Principaux utilisateurs de Microsoft Entra ID, ou identités d'utilisateur
  • Principaux du service Microsoft Entra ID

Pour plus d'informations sur l'authentification Microsoft Entra en tant qu’alternative à l'authentification SQL dans Microsoft Fabric.

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 utilisateurs peuvent accéder aux données pour tous les objets auxquels ils disposent d’autorisations.

Pour plus d’informations sur la sécurité dans le point de terminaison d’analytique SQL, consultez La sécurité OneLake pour les points de terminaison d’analytique SQL.

Meilleures pratiques

Ajoutez des réessais à vos applications et travaux ETL pour les rendre plus résilients. Pour plus d’informations, consultez la documentation suivante :

Autoriser les étiquettes de service Azure par le biais du pare-feu

Pour activer la connectivité via le pare-feu, vous devez autoriser les balises de service Power BI et les balises de service SQL. Pour plus d’informations, consultez Étiquettes de service Power BI et balises de service.

Vous ne pouvez pas utiliser le nom de domaine complet (FQDN) du point de terminaison TDS seul.

Observations et limitations

  • L’authentification SQL n’est pas prise en charge.
  • Les ensembles de résultats actifs multiples (MARS, Multiple Active Result Sets) ne sont pas pris en charge pour Microsoft Fabric Warehouse. MARS est désactivé par défaut. Si MultipleActiveResultSets est incluse dans la chaîne de connexion, supprimez-la ou définissez-la sur faux.
  • Si vous recevez le code d’erreur 24804 avec le message « Impossible de terminer l’opération en raison d’une mise à jour système. Fermez cette connexion, reconnectez-vous et réessayez l’opération » ou le code d’erreur 6005 avec le message « ARRÊT en cours. Échec de l’exécution sur SQL Server. Contactez l’équipe SQL Server si vous avez besoin d’un support supplémentaire. », cela est lié à une perte de connexion temporaire, probablement en raison d’un déploiement ou d’une reconfiguration du système. Pour résoudre ce problème, connectez-vous à nouveau et réessayez. Pour savoir comment générer la résilience et les nouvelles tentatives dans votre application, consultez les Meilleures pratiques.
  • Les connexions de serveurs liés à partir de SQL Server ne sont pas prises en charge.

Comportement de connexion pour InitialCatalog

En mai 2026, Microsoft a mis à jour le comportement de connexion pour Fabric Data Warehouse et le point de terminaison d’analytique SQL afin de rendre la propriété InitialCatalog de chaîne de connexion facultative. Actuellement, les utilisateurs se connectent à la master base de données système lorsque la InitialCatalog propriété n’est pas fournie. Dans Fabric Data Warehouse, vous pouvez uniquement vous connecter à la base de données master, vous ne pouvez pas modifier la base de données master et vous ne pouvez pas créer, modifier ou supprimer des objets utilisateur dans la base de données master.

Vous pouvez utiliser la syntaxe USE Transact-SQL pour modifier le contexte de votre entrepôt de connexions une fois connecté à master, et la fonction DB_NAME() pour déterminer votre entrepôt actuel. Par exemple:

SELECT DB_NAME(); --returns name of current warehouse context
GO
USE [ContosoWarehouse];
GO
SELECT DB_NAME(); --returns name of current warehouse context
GO

Le tableau suivant décrit le comportement de connexion mis à jour pour Fabric Data Warehouse et le point de terminaison d’analyse SQL lorsque vous spécifiez ou omettez la propriété InitialCatalog dans les chaînes de connexion.

Scénario d’entrée Avant mai 2026 Comportement actuel
Nom de l’entrepôt existant fourni Se connecte à l’entrepôt spécifié Aucune modification : se connecte à l’entrepôt spécifié
ID d’entrepôt existant fourni Se connecte à l’entrepôt spécifié Aucune modification : se connecte à l’entrepôt spécifié
InitialCatalog propriété non fournie Se connecte à un entrepôt non déterminant dans l’espace de travail Se connecte à master
InitialCatalog = master Se connecte à un entrepôt non déterminant dans l’espace de travail Se connecte à master
L’entrepôt dans la InitialCatalog propriété n’existe pas Se connecte à un entrepôt non déterminant dans l’espace de travail Génère une erreur indiquant qu’aucun entrepôt n’existe

Gestion des erreurs

Si aucun entrepôt n’existe dans l’espace de travail et qu’une connexion est tentée sans spécifier d’entrepôt valide, les utilisateurs voient l’erreur suivante : « Échec de la connexion pour l’utilisateur «< principal> identifié par jeton ». Motif : L’authentification a réussi, mais la base de données n’a pas été trouvée ou vous avez des autorisations insuffisantes pour se connecter à celle-ci. »

La capture d’écran suivante montre l’erreur telle qu’elle apparaît dans SSMS lorsqu’un nom d’entrepôt non valide est fourni comme suit InitialCatalog:

Capture d’écran du message d’erreur SSMS lorsqu’un catalogue initial valide n’est pas fourni.

Étape suivante