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

Utilisez les raccourcis OneLake lorsque vous souhaitez exécuter rarement des requêtes sur des données historiques sans partitionner ou indexer les données. Si vous souhaitez exécuter des requêtes fréquemment et accélérer les performances, importez les données directement dans votre base de données KQL.

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

Raccourci OneLake

Prérequis

• Un espace de travail avec une capacité compatible Microsoft Fabric
• Une base de données KQL avec des autorisations de modification
• Un Lakehouse

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.

   

Sélectionner une source

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

   

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

   

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

   

4. 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.

Azure Data Lake Storage Gen2

Prérequis

• Un espace de travail avec une capacité compatible Microsoft Fabric
• Une base de données KQL avec des autorisations de modification
• Un compte Azure Data Lake Storage Gen2.

Créer un raccourci

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

2. Sélectionnez Nouveau>raccourci OneLake.

   

Sélectionner une source

1. Sous Sources externes, sélectionnez Azure Data Lake Storage Gen2.

2. Entrez les paramètres de connexion en fonction du tableau suivant :

   

   Champ	Description	active
   URL	Chaîne de connexion pour votre conteneur delta.	https://StorageAccountName.dfs.core.windows.net
   Connection	Les connexions précédemment définies pour l’emplacement de stockage spécifié apparaissent dans la liste déroulante. Créez une nouvelle connexion s’il n’en existe aucune.	Créer une connexion.
   Nom de connexion	Nom de connexion Azure Data Lake Storage Gen2.	Un nom pour votre connexion.
   Type d'authentification	Le modèle d’autorisation. Les modèles pris en charge sont les suivants : compte professionnel, clé de compte, signature d'accès partagé (SAS) et principal de service. Pour plus d’informations, consultez Raccourcis ADLS.	Dépendant du modèle d’autorisation. Une fois que vous avez sélectionné un type d’authentification, renseignez les informations d’identification requises.

3. Cliquez sur Suivant.

4. Accédez à l'emplacement cible du raccourci.

   

   Si vous venez d'utiliser le compte de stockage dans l'URL de connexion, tous vos conteneurs disponibles apparaissent dans l'affichage de navigation gauche. Si vous avez spécifié un conteneur dans l'URL de connexion, seul le conteneur spécifié et son contenu apparaissent dans la vue de navigation.

   Accédez au compte de stockage en sélectionnant un dossier ou en cliquant sur la carotte d'expansion en regard d'un dossier.

   Dans cette vue, vous pouvez sélectionner un ou plusieurs emplacements cibles de raccourci. Choisissez les emplacements cibles en cliquant sur la case à cocher située en regard d'un dossier dans la vue de navigation de gauche.

5. Sélectionnez Suivant.

   

   La page de révision vous permet de vérifier toutes vos sélections. Ici, vous pouvez voir chaque raccourci créé. Dans la colonne d'action, vous pouvez cliquer sur l'icône en forme de crayon pour modifier le nom du raccourci. Vous pouvez cliquer sur l'icône en forme de corbeille pour supprimer le raccourci.

6. Sélectionnez Créer.

Amazon S3

Prérequis

• Un espace de travail avec une capacité compatible Microsoft Fabric
• Une base de données KQL avec des autorisations de modification
• Un compte Amazon S3. Pour plus d’informations, consultez Qu’est-ce qu’Amazon S3 ?

Créer un raccourci

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

2. Sélectionnez Nouveau>raccourci OneLake.

   

Sélectionner une source

1. Sous Sources externes, sélectionnez Amazon S3.

2. Entrez les paramètres de connexion en fonction du tableau suivant :

   

   Champ	Description	active
   URL	Chaîne de connexion pour votre compartiment Amazon S3.	https://BucketName.s3.RegionCode.amazonaws.com
   Connection	Les connexions précédemment définies pour l’emplacement de stockage spécifié apparaissent dans la liste déroulante. Créez une nouvelle connexion s’il n’en existe aucune.	Créer une connexion
   Nom de connexion	Nom de connexion Amazon S3.	Un nom pour votre connexion.
   Type d'authentification	La politique de gestion des identités et des accès (IAM). La stratégie doit avoir des autorisations de lecture et de liste. Pour plus d’informations, consultez Utilisateurs IAM.	Dépendant de la stratégie de compartiment.
   ID de clé d’accès	La clé utilisateur de gestion des identités et des accès (IAM). Pour plus d’informations, consultez Gérer les clés d’accès pour les utilisateurs IAM.	Votre clé d’accès.
   Clé d’accès secrète	La clé secrète de gestion des identités et des accès (IAM).	Votre clé secrète.

Cliquez sur Suivant.

1. Accédez à l'emplacement cible du raccourci.

   

   Si vous avez utilisé le point de terminaison global dans l'URL de connexion, tous vos compartiments disponibles apparaissent dans la vue de navigation gauche. Si vous avez utilisé un point de terminaison spécifique au compartiment dans l'URL de connexion, seul le compartiment spécifié et son contenu apparaissent dans la vue de navigation.

   Accédez au compte de stockage en sélectionnant un dossier ou en cliquant sur la carotte d'expansion en regard d'un dossier.

   Dans cette vue, vous pouvez sélectionner un ou plusieurs emplacements cibles de raccourci. Choisissez les emplacements cibles en cliquant sur la case à cocher située en regard d'un dossier dans la vue de navigation de gauche.

2. Sélectionnez Suivant.

   

   La page de révision vous permet de vérifier toutes vos sélections. Ici, vous pouvez voir chaque raccourci créé. Dans la colonne d'action, vous pouvez cliquer sur l'icône en forme de crayon pour modifier le nom du raccourci. Vous pouvez cliquer sur l'icône en forme de corbeille pour supprimer le raccourci.

3. Sélectionnez Créer.

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

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.

Mappage de types de données

Mappage des types de données Delta Parquet vers Maison d'événements

Les types de données de Delta primitive sont mappés aux types de données scalaires de Maison d'événements sur la base des règles suivantes. Pour plus d'informations sur les types de données de Maison d'événements, 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

Contenu connexe

• Interroger des données dans un ensemble de requêtes KQL
• Fonction external_table()