Partager via


Créer des raccourcis OneLake dans une base de données KQL

OneLake est un lac de données logique unique, unifié et permettant à Microsoft Fabric de stocker des lakehouses, des entrepôts, des bases de données KQL et d’autres éléments. Les raccourcis sont des références intégrées dans OneLake qui pointent vers les emplacements de stockage d'autres fichiers sans déplacer les données d'origine. La référence intégrée donne l'impression que les fichiers et les dossiers sont stockés localement mais en réalité ; ils existent dans un autre emplacement de stockage. Les raccourcis peuvent être mis à jour ou supprimés de vos éléments, mais ces modifications n'affectent pas les données d'origine et leur source.

Dans cet article, vous allez apprendre à créer un raccourci OneLake dans une base de données KQL qui pointe vers des sources internes Fabric ou externes. Ce type de raccourci est plus tard accessible pour la requête dans les ensembles de requêtes KQL à l’aide de la fonction external_table(). Les raccourcis créés dans une base de données KQL ne peuvent pas être renommés et un seul raccourci peut être créé à la fois.

Outre la création de raccourcis à partir d’une base de données KQL, les raccourcis peuvent également être créés à partir d’autres éléments Fabric. Ces raccourcis pointent également vers les données stockées dans des sources internes Fabric ou externes, mais ont des limitations différentes et sont accessibles différemment. Pour plus d'informations, consultez Raccourcis OneLake.

Remarque

Pour accélérer les requêtes sur les raccourcis OneLake, consultez Accélérer les requêtes sur les raccourcis OneLake.

Sélectionnez l’onglet qui correspond au raccourci que vous souhaitez créer :

Prérequis

Pour accéder aux données de votre base de données KQL dans d’autres expériences Microsoft Fabric, consultez Une copie logique.

Créer un raccourci

Remarque

Le flux suivant montre comment créer un raccourci qui pointe vers des données dans un Lakehouse dans Fabric. De même, vous pouvez créer des raccourcis qui pointent vers des Data Warehouses ou d’autres bases de données KQL.

  1. Accédez à une base de données KQL existante.

  2. Sélectionnez Nouveau>raccourci OneLake.

    Capture d'écran de l'onglet Accueil montrant la liste déroulante du bouton Nouveau. L'option intitulée Raccourci OneLake est mise en surbrillance.

Sélectionner une source

  1. Sous Sources internes, sélectionnez Microsoft OneLake.

    Capture d'écran de la fenêtre Nouveau raccourci montrant les deux méthodes de création d'un raccourci. L'option intitulée OneLake est mise en surbrillance.

  2. Sélectionnez la source de données à laquelle vous souhaitez vous connecter, puis sélectionnez Suivant.

    Capture d'écran de la fenêtre Sélectionner un type de source de données montrant les sources de données disponibles à utiliser avec le raccourci. Le bouton Suivant est en surbrillance.

  3. Développez Tables, puis sélectionnez une table spécifique à laquelle vous connecter.

    Capture d’écran du nouveau raccourci où les tables sont développées et une table est sélectionnée.

  4. Cliquez sur Suivant.

Remarque

Pour activer l’accélération des requêtes sur un nouveau raccourci, mettez le bouton Accélérer sur On. Pour plus d’informations, consultez Accélérer les requêtes sur les raccourcis OneLake.

Capture d'écran de la fenêtre Nouveau raccourci montrant les données du LakeHouse. Le sous-dossier intitulé StrmSC et le bouton Créer sont mis en évidence.

  1. Sélectionnez Créer.

Remarque

Vous ne pouvez vous connecter qu’à un seul sous-dossier ou table par raccourci. Pour vous connecter à d’autres données, répétez ces étapes et créez des raccourcis supplémentaires.

La base de données s’actualise automatiquement. Le raccourci s'affiche sous Raccourci dans le volet Explorer.

Capture d'écran du volet Explorer montrant le nouveau raccourci.

Le raccourci OneLake a été créé. Vous pouvez maintenant interroger ces données.

Rechercher des données

Pour interroger des données à partir du raccourci OneLake, utilisez la external_table() fonction.

  1. Sur le côté droit de votre base de données, sélectionnez Explorer vos données. La fenêtre s'ouvre avec quelques exemples de requêtes que vous pouvez exécuter pour obtenir un premier aperçu de vos données.
  2. Remplacez l’espace réservé nom de la table par external_table('nom de raccourci').
  3. Sélectionnez Exécuter ou appuyez sur Maj + Entrée pour exécuter une requête sélectionnée.

Capture d’écran de la fenêtre Explorer vos données montrant les résultats d’un exemple de requête.

Mappage de types de données

Mappage des types de données Delta Parquet vers Eventhouse

Les types de données de Delta primitive sont mappés aux types de données scalaires de Eventhouse sur la base des règles suivantes. Pour plus d'informations sur les types de données d’Eventhouse, consultez Types de données scalaires.

Type Delta Type de données scalaire Maison d'événements
string string
long long
integer int
short int
byte real
float real
double real
decimal decimal
boolean bool
binary string
date datetime
timestamp_ntz (sans fuseau horaire) datetime
struct dynamic
array dynamic
map dynamic