Fabric SQL (T-SQL)
Eine Fabric SQL-Quelle stellt eine Verbindung zu einem Warehouse oder einem SQL-Analyseendpunkt her, auch dem eines Lakehouse, und lässt Fabric T-SQL für Sie ausführen, und zwar als die Person, die die Karte ansieht. Es muss kein Proxy oder Gateway eingerichtet werden. Wählen Sie für eine SQL-Datenbank deren SQL-Analyseendpunkt: Die Abfrage läuft auf diesem Endpunkt, der Kopie, die Fabric nach OneLake spiegelt, es sei denn, Sie wählen die Live-Verbindung über Eventhouse.
Fabric SQL oder Warehouse & SQL?
| Fabric SQL | Warehouse & SQL | |
|---|---|---|
| Abfragesprache | T-SQL | DuckDB SQL |
| Ausführungsort der Abfragen | In Fabric, auf Ihrer Kapazität | Im Browser, über OneLake |
| Ansichten | Ja | Nein |
| Live-Daten und räumliche Spalten aus einer SQL-Datenbank | Ja, mit der Live-Verbindung | Nein |
Verbindung auswählen
Eine SQL-Datenbank bietet zwei Verbindungen. Ein Warehouse wird immer direkt gelesen.
| SQL-Analyseendpunkt | Live-Datenbank über Eventhouse | |
|---|---|---|
| Einrichtung | Keine | KQL-Datenbank auswählen |
| Was gelesen wird | Die Kopie, die Fabric in OneLake spiegelt | Die Datenbank selbst |
| Neue Daten erscheinen | Mit der neuen Metadatensynchronisierung in etwa einer Minute; sonst in etwa 30 Sekunden, wenn Sie den Arbeitsbereich bearbeiten können, und für alle anderen nach mehreren Minuten oder länger | Sofort |
| Geografie- und Geometriespalten | Nicht verfügbar | Verfügbar |
| Ansichten der Datenbank | Nicht verfügbar | Verfügbar |
| Sicherheit auf Zeilenebene und Maskierung der Datenbank | Nicht angewendet | Angewendet |
SQL-Analyseendpunkt. Fabric spiegelt neue Daten in etwa 20 Sekunden nach OneLake. Wann der Endpunkt sie zeigt, hängt davon ab, welche Metadatensynchronisierung er verwendet:
- Neue Metadatensynchronisierung. Aktivieren Sie in den Einstellungen des Arbeitsbereichs unter Warehouse-Einstellungen die neue Metadatensynchronisierung, bevor Sie die Datenbank erstellen. Ihr Endpunkt zeigt neue Daten dann in etwa einer Minute, für alle. Bereits vorhandene Endpunkte behalten die ursprüngliche Synchronisierung. Die Einstellung ist in Fabric eine Vorschau.
- Die ursprüngliche Synchronisierung kann viele Minuten dauern und stoppt nach 15 Minuten ohne Abfragen. Deshalb bittet Icon Map den Endpunkt vor dem Lesen, sich zu aktualisieren. Das können nur Personen mit der Rolle „Mitwirkender“ oder höher im Arbeitsbereich; für alle anderen zeigt die Karte, was der Endpunkt gerade hat.
Der Sicherheitsunterschied ist wichtig: Wenn Sie sich auf Sicherheit auf Zeilenebene oder Maskierung in der Datenbank verlassen, sehen alle, die den Endpunkt lesen können, die Zeilen und Werte, die sonst verborgen wären. Verwenden Sie die Live-Verbindung, oder definieren Sie die Sicherheit auf dem Endpunkt.
Live-Datenbank über Eventhouse. Ein Browser kann keine direkte Verbindung zu einer SQL-Datenbank herstellen. Daher wird Ihre Abfrage über eine KQL-Datenbank mit sql_request von Eventhouse ausgeführt. Jede KQL-Datenbank ist geeignet, und sie speichert keine Ihrer Daten. Alle, die die Karte ansehen, benötigen Zugriff auf diese KQL-Datenbank und auf die SQL-Datenbank und werden beim ersten Mal möglicherweise gebeten, den Zugriff auf Azure Data Explorer zu genehmigen.
Das Öffnen einer Karte kann eine pausierte SQL-Datenbank aufwecken.
Tabellen, Ansichten und Abfragen
- Wählen Sie eine Tabelle oder Ansicht aus, oder
- schreiben Sie eine T-SQL-Abfrage. Sie muss ein einzelnes schreibgeschütztes
SELECTsein, das mitWITHbeginnen darf.
Eine Abfrage muss jede Spalte benennen. Schreibvorgänge und gespeicherte Prozeduren sind nicht zulässig: Eine gespeicherte Abfrage wird mit den Berechtigungen der Person ausgeführt, die die Karte öffnet, deshalb lehnt Icon Map alles andere vor dem Senden ab. Um Logik aus einer gespeicherten Prozedur wiederzuverwenden, legen Sie sie in einer Ansicht ab. Wenn eine Spalte wie ein T-SQL-Schlüsselwort heißt, setzen Sie sie in eckige Klammern, z. B. [update].
Räumliche Spalten
Wenn Sie eine Tabelle oder Ansicht auswählen, kommen Spalten vom Typ geography und geometry als WKT an. Wählen Sie unter Standort ist gespeichert als die Option Eine Geometriespalte, dann die Spalte und die Codierung WKT.
Wandeln Sie sie in einer eigenen Abfrage in Text um:
SELECT id, name, geom.STAsText() AS wkt
FROM dbo.sites
Wenn der SQL-Analyseendpunkt nur Längen- und Breitengradspalten enthält, können Sie die Geometrie trotzdem in der Abfrage berechnen, z. B. geography::Point(lat, lon, 4326).STAsText() AS wkt.
Grenzwerte
- Eine Abfrage kann bis zu 100 Sekunden laufen.
- Ein Ladevorgang kann etwa 20 MB Daten vom SQL-Analyseendpunkt und etwa 64 MB über die Live-Verbindung zurückgeben. Darüber hinaus behält Icon Map die vollständig angekommenen Zeilen. Verwenden Sie bei größeren Tabellen das Zeilenlimit, einen Filter oder Nur Daten im aktuellen Kartenausschnitt laden.
- Abfragen nutzen Ihre Fabric-Kapazität, daher senken Aggregation an der Quelle und Ansichtsfilterung auch die Kosten.
- Diagramme fassen die in die Karte geladenen Zeilen zusammen.
- Veröffentlichte Karten enthalten diese Quelle als Momentaufnahme vom Zeitpunkt der Veröffentlichung, da anonyme Leser keine Fabric-Identität haben, unter der Abfragen laufen könnten.
Nächste Schritte
- Übersicht über Datenquellen - gemeinsame Konfiguration.
- Sicherheit und Berechtigungen - der Zugriff, den Ihre Quellen benötigen.