Erstellen Sie OneLake-Verknüpfungen in einer KQL-Datenbank

Mit OneLake-Verknüpfungen in einer KQL-Datenbank können Sie Daten in internen Fabric Elementen und externem Speicher abfragen, ohne die Daten zu verschieben. In einer KQL-Datenbank erscheint jede Verknüpfung unter Verknüpfungen und wird in einem KQL-Abfragesatz als externe Tabelle abgefragt, indem die external_table() Funktion verwendet wird.

In diesem Artikel erfahren Sie, wie Sie eine OneLake-Verknüpfung in einer KQL-Datenbank erstellen, die auf interne Fabric-Quellen oder externe Quellen verweist. Verknüpfungen, die in einer KQL-Datenbank erstellt wurden, können nicht umbenannt werden, und Sie können jeweils nur eine Verknüpfung erstellen.

Allgemeine Informationen zu Verknüpfungstypen, quellspezifischen Anweisungen und umfassenderen Einschränkungen finden Sie unter OneLake-Tastenkombinationen.

Hinweis

Informationen zur Verbesserung der Abfrageleistung gegenüber unterstützten Tastenkombinationen finden Sie unter Abfragebeschleunigung über OneLake-Tastenkombinationen.

Voraussetzungen

Informationen zum Zugriff auf die Daten in Ihrer KQL-Datenbank in anderen Microsoft Fabric-Bereichen finden Sie unter Eine logische Kopie.

Erstellen einer Verknüpfung

  1. Navigieren Sie zu einer vorhandenen KQL-Datenbank.

  2. Wählen Sie +>Neu>OneLake-Verknüpfung aus.

    Screenshot: Registerkarte „Start“ mit Dropdownliste der Schaltfläche „Neu“, die Option „OneLake-Verknüpfung“ ist hervorgehoben.

Auswählen einer Quelle

KQL-Datenbanken unterstützen Verknüpfungen zu internen OneLake-Ressourcen, z. B. KQL-Datenbanken, Lakehouses und Warehouses, und externen Ressourcen wie Azure Data Lake Storage, Amazon S3 und Google Cloud Storage. Eine vollständige Liste der unterstützten Verknüpfungstypen und quellspezifischen Konfigurationsanleitungen finden Sie unter "Tastenkombinationstypen".

  1. Wählen Sie im Fenster Neue Verknüpfung den Quelltyp aus, mit dem Sie eine Verbindung herstellen möchten.
  2. Schließen Sie die erforderlichen Verbindungsdetails für die Quelle ab, und wählen Sie dann den Ordner oder die Tabelle aus, den Sie in der KQL-Datenbank verfügbar machen möchten.
  3. Optional: Um die Abfragebeschleunigung für die neue Verknüpfung zu aktivieren, setzen Sie Beschleunigen auf Ein.
  4. Wählen Sie "Erstellen" aus.

Unterstützte Szenarien und Einschränkungen finden Sie unter Abfragebeschleunigung für OneLake-Tastenkombinationen – Übersicht.

Screenshot des Fensters „Neue Verknüpfung“ mit den Verknüpfungsdetails. Die Umschaltfläche „Beschleunigen“ ist hervorgehoben.

Hinweis

  1. Sie können nur eine Verbindung mit einem Unterordner oder einer Tabelle pro Verknüpfung herstellen. Um auf mehr Daten zuzugreifen, erstellen Sie weitere Verknüpfungen.
  2. Sie können keine Verknüpfung über einer Tabelle erstellen, die ein Sternchen (*) in einem beliebigen Spaltennamen enthält. Benennen Sie die Spalten um, bevor Sie die Verknüpfung erstellen.

Nachdem Sie die Verknüpfung erstellt haben, wird die Datenbank automatisch aktualisiert. Die Verknüpfung wird im Bereich Explorer unter Verknüpfungen angezeigt. Sie können die Daten jetzt abfragen.

Screenshot des Explorer-Bereichs mit der neuen Verknüpfung.

Organisieren von Verknüpfungen mit Ordnern

So erstellen Sie einen Unterordner oder wechseln zu einem vorhandenen Ordner:

  1. Gehen Sie im Explorerbereich wie folgt vor:
    • Klicken Sie mit der rechten Maustaste auf die Verknüpfung, und wählen Sie In Ordner verschieben>+ Neuer Ordner aus.
      Screenshot des Popupmenüs mit der Option zum Erstellen eines neuen Ordners für die Verknüpfung.
    • Oder wählen Sie die Auslassungszeichen (...) neben der entsprechenden Verknüpfung aus und dann In Ordner verschieben>+ Neuer Ordner aus, oder wählen Sie einen vorhandenen Ordner.
      Bildschirmfoto des Pop-up-Menüs mit der Option, die Verknüpfung in einen vorhandenen Ordner zu verschieben oder einen neuen zu erstellen.
  2. Um einen Ordner zu erstellen, geben Sie einen Namen für den Ordner ein, und wählen Sie "Erstellen" aus. Die Verknüpfung wird in den neuen Ordner verschoben.
    Screenshot des neuen Ordners, der erstellt wird.
  3. Wenn Sie mehrere Tastenkombinationen verschieben möchten, geben Sie entweder einen anderen Ordnernamen ein, oder aktivieren Sie das Dropdownmenü, und aktivieren Sie die Kontrollkästchen neben den Tastenkombinationen, die Sie in denselben Ordner verschieben möchten.
    Screenshot des Popupmenüs mit der Option zum Verschieben mehrerer Verknüpfungen in denselben Ordner.
  4. Sie können auch Verknüpfungen in einen vorhandenen Ordner verschieben. Wählen Sie dazu "In Ordner verschieben " aus, und wählen Sie dann den Ordner aus, in den Sie die Verknüpfung verschieben möchten, oder ziehen Sie die Verknüpfung in den Ordner.

Hinweis

  • Wenn Sie einen Unterordner löschen, werden die Verknüpfungen innerhalb des Ordners nicht gelöscht, sondern zurück in den übergeordneten Ordner verschoben.
  • Ein Unterordner wird automatisch gelöscht, wenn im Ordner keine Verknüpfungen vorhanden sind.
  • Ordner können pro Objekttyp erstellt werden, und der Name muss pro Objekttyp eindeutig sein. Sie können z. B. einen Tabellenordner und einen Verknüpfungsordner mit demselben Namen haben, sie können jedoch nicht über zwei Verknüpfungsordner mit demselben Namen verfügen.

Daten abfragen

Um Daten aus der OneLake-Verknüpfung abzufragen, verwenden Sie die Funktion external_table().

  1. Wählen Sie auf der rechten Seite Der Datenbank die Option "Daten durchsuchen" aus. Das Fenster wird mit einigen Beispielabfragen geöffnet, die Sie ausführen können, um einen ersten Blick auf Ihre Daten zu erhalten.
  2. Ersetzen Sie den Tabellennamenplatzhalter durch external_table('<shortcut-name>').
  3. Sie können auch Ausführen auswählen oder UMSCHALT+EINGABE drücken, um eine ausgewählte Abfrage auszuführen.

Screenshot: Fenster „Untersuchen Ihrer Daten“ mit den Ergebnissen einer Beispielabfrage.

Datentypzuordnung

Zuordnung der Datentypen von Delta Parquet zu Eventhouse

Primitive Delta-Datentypen werden den skalaren Datentypen von Eventhouse zugeordnet, wie in der folgenden Tabelle dargestellt. Weitere Informationen finden Sie unter Skalar-Datentypen.

Delta-Typ Eventhouse skalarer Datentyp
string string
long long
integer int
short int
byte real
float real
double real
decimal decimal
boolean bool
binary string
date datetime
timestamp_ntz (ohne Zeitzone) datetime
struct dynamic
array dynamic
map dynamic