Fabric SQL (T-SQL)

Une source Fabric SQL se connecte à un Warehouse ou à un point de terminaison d'analytique SQL, y compris celui d'un lakehouse, et fait exécuter le T-SQL par Fabric, en tant que personne qui consulte la carte. Aucun proxy ni passerelle à configurer. Pour une base de données SQL, choisissez son point de terminaison d'analytique SQL : la requête s'exécute sur ce point de terminaison, la copie que Fabric met en miroir dans OneLake, sauf si vous choisissez la connexion en direct via Eventhouse.

Fabric SQL ou Warehouse et SQL ?

Fabric SQL Warehouse et SQL
Langage de requête T-SQL DuckDB SQL
Exécution des requêtes Dans Fabric, sur votre capacité Dans le navigateur, sur OneLake
Vues Oui Non
Données en direct et colonnes spatiales d'une base de données SQL Oui, avec la connexion en direct Non

Choisir une connexion

Une base de données SQL propose deux connexions. Un Warehouse est toujours lu directement.

Point de terminaison d'analytique SQL Base de données en direct via Eventhouse
Configuration Aucune Choisir une base de données KQL
Ce qui est lu La copie que Fabric met en miroir dans OneLake La base de données elle-même
Apparition des nouvelles données En une minute environ avec la nouvelle synchronisation des métadonnées ; sinon en 30 secondes environ si vous pouvez modifier l'espace de travail, et en plusieurs minutes ou plus pour les autres Immédiate
Colonnes de géographie et de géométrie Non disponibles Disponibles
Vues de la base de données Non disponibles Disponibles
Sécurité au niveau des lignes et masquage de la base de données Non appliqués Appliqués

Point de terminaison d'analytique SQL. Fabric met les nouvelles données en miroir dans OneLake en 20 secondes environ. Le délai avant que le point de terminaison les affiche dépend de la synchronisation des métadonnées qu'il utilise :

  • Nouvelle synchronisation des métadonnées. Activez la nouvelle synchronisation des métadonnées dans les paramètres de l'espace de travail, sous Paramètres d'entrepôt, avant de créer la base de données. Son point de terminaison affiche alors les nouvelles données en une minute environ, pour tout le monde. Les points de terminaison existants conservent la synchronisation d'origine. Ce paramètre est en préversion dans Fabric.
  • La synchronisation d'origine peut prendre de nombreuses minutes, et elle s'arrête après 15 minutes sans requête. Avant de lire, Icon Map demande donc au point de terminaison de s'actualiser. Seules les personnes ayant le rôle Contributeur ou supérieur sur l'espace de travail peuvent le faire ; pour les autres, la carte affiche ce que le point de terminaison contient à ce moment-là.

La différence de sécurité est importante : si vous comptez sur la sécurité au niveau des lignes ou le masquage de la base de données, toutes les personnes pouvant lire le point de terminaison voient les lignes et les valeurs qui auraient été masquées. Utilisez la connexion en direct ou définissez la sécurité sur le point de terminaison.

Base de données en direct via Eventhouse. Un navigateur ne peut pas se connecter directement à une base de données SQL : votre requête passe donc par une base de données KQL, avec sql_request d'Eventhouse. N'importe quelle base de données KQL convient, et elle ne stocke aucune de vos données. Toutes les personnes qui consultent la carte doivent avoir accès à cette base de données KQL et à la base de données SQL, et peuvent être invitées à approuver l'accès à Azure Data Explorer la première fois.

L'ouverture d'une carte peut réveiller une base de données SQL en pause.

Tables, vues et requêtes

  • Choisissez une table ou une vue, ou
  • Écrivez une requête T-SQL. Il doit s'agir d'un seul SELECT en lecture seule, qui peut commencer par WITH.

Une requête doit nommer chaque colonne. Les écritures et les procédures stockées ne sont pas autorisées : une requête enregistrée s'exécute avec les autorisations de la personne qui ouvre la carte, Icon Map refuse donc tout le reste avant l'envoi. Pour réutiliser la logique d'une procédure stockée, placez-la dans une vue. Si une colonne porte le nom d'un mot clé T-SQL, mettez-la entre crochets, comme [update].

Colonnes spatiales

Lorsque vous choisissez une table ou une vue, les colonnes geography et geometry arrivent au format WKT. Sous La localisation est stockée sous forme de, choisissez Une colonne de géométrie, puis la colonne et l'encodage WKT.

Dans votre propre requête, convertissez-les en texte :

SELECT id, name, geom.STAsText() AS wkt
FROM dbo.sites

Si le point de terminaison d'analytique SQL ne contient que des colonnes de longitude et de latitude, vous pouvez tout de même calculer la géométrie dans la requête, comme geography::Point(lat, lon, 4326).STAsText() AS wkt.

Limites

  • Une requête peut s'exécuter jusqu'à 100 secondes.
  • Un chargement peut renvoyer environ 20 Mo de données sur le point de terminaison d'analytique SQL et environ 64 Mo sur la connexion en direct. Au-delà, Icon Map conserve les lignes arrivées complètes. Sur les tables plus volumineuses, utilisez la limite de lignes, un filtre ou Charger uniquement les données de la vue actuelle de la carte.
  • Les requêtes utilisent votre capacité Fabric : l'agrégation à la source et le filtrage par vue réduisent donc aussi les coûts.
  • Les graphiques résument les lignes chargées dans la carte.
  • Les cartes publiées contiennent cette source sous forme d'instantané pris à la publication, car un lecteur anonyme n'a pas d'identité Fabric pour exécuter des requêtes.

Étapes suivantes