Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les raccourcis OneLake dans une base de données KQL vous permettent d’interroger des données dans des éléments de Fabric internes et un stockage externe sans déplacer les données. Dans une base de données KQL, chaque raccourci apparaît sous Raccourcis et est interrogé en tant que table externe dans un ensemble de requêtes KQL à l’aide de la external_table() fonction.
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. Vous ne pouvez pas renommer les raccourcis créés dans une base de données KQL, et vous ne pouvez créer qu’un seul raccourci à la fois.
Pour obtenir des informations générales sur les types de raccourcis, les instructions spécifiques à la source et les limitations plus larges, consultez raccourcis OneLake.
Remarque
Pour améliorer les performances des requêtes pour les raccourcis pris en charge, consultez Accélération des requêtes sur les raccourcis OneLake.
Prérequis
- Un espace de travail avec une capacité compatible avec 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
Accédez à une base de données KQL existante.
Sélectionnez +>le raccourci New>OneLake.
Sélectionner une source
Les bases de données KQL prennent en charge les raccourcis vers des ressources OneLake internes, telles que les bases de données KQL, les lakehouses et les entrepôts, et vers des ressources externes, telles que Azure Data Lake Storage, Amazon S3 et Google Cloud Storage. Pour obtenir la liste complète des types de raccourcis pris en charge et des instructions de configuration spécifiques à la source, consultez Types de raccourcis.
- Dans la fenêtre Nouveau raccourci , choisissez le type de source auquel vous souhaitez vous connecter.
- Renseignez les détails de connexion requis pour la source, puis sélectionnez le dossier ou la table à exposer dans la base de données KQL.
- Facultatif : pour activer l’accélération des requêtes sur le nouveau raccourci, définissez Accélérationsur Activé.
- Cliquez sur Créer.
Pour connaître les scénarios et limitations pris en charge, consultez Accélération des requêtes pour les raccourcis OneLake : vue d’ensemble.
Remarque
- Vous ne pouvez vous connecter qu’à un seul sous-dossier ou tableau par raccourci. Pour vous connecter à d’autres données, créez des raccourcis supplémentaires.
- Vous ne pouvez pas créer de raccourci sur une table qui a un astérisque (
*) dans un nom de colonne. Renommez les colonnes avant de créer le raccourci.
Après avoir créé le raccourci, la base de données s’actualise automatiquement. Le raccourci s'affiche sous Raccourci dans le volet Explorer. Vous pouvez maintenant interroger les données.
Organiser les raccourcis avec des dossiers
Pour créer un sous-dossier ou passer à un dossier existant :
- Dans le volet Explorateur, effectuez l’une des opérations suivantes :
- Cliquez avec le bouton droit sur le raccourci, puis sélectionnez Déplacer vers le dossier>+ Nouveau dossier.
- Vous pouvez également sélectionner les points de suspension (...) en regard du raccourci spécifique, puis sélectionner Déplacer vers le dossier>+ Nouveau dossier ou choisir un dossier existant.
- Cliquez avec le bouton droit sur le raccourci, puis sélectionnez Déplacer vers le dossier>+ Nouveau dossier.
- Pour créer un dossier, entrez un nom pour le dossier, puis sélectionnez Créer. Le raccourci est déplacé vers le nouveau dossier.
- Pour déplacer plusieurs raccourcis, entrez un autre nom de dossier ou sélectionnez le menu déroulant et cochez les cases en regard des raccourcis que vous souhaitez déplacer vers le même dossier.
- Vous pouvez également déplacer des raccourcis vers un dossier existant. Pour ce faire, sélectionnez Déplacer vers le dossier , puis sélectionnez le dossier vers lequel vous souhaitez déplacer le raccourci, ou faites glisser et déposez le raccourci dans le dossier.
Remarque
- Si vous supprimez un sous-dossier, les raccourcis dans le dossier ne sont pas supprimés, mais sont déplacés vers le dossier parent.
- Un sous-dossier est automatiquement supprimé lorsqu’il n’existe aucun raccourci dans le dossier.
- Les dossiers peuvent être créés par type de ressource et le nom doit être unique par type de ressource. Par exemple, vous pouvez avoir un dossier de table et un dossier de raccourcis portant le même nom, mais vous ne pouvez pas avoir deux dossiers de raccourcis portant le même nom.
Rechercher des données
Pour interroger des données à partir du raccourci OneLake, utilisez la external_table() fonction.
- 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.
- Remplacez l’espace réservé du nom de table par
external_table('<shortcut-name>'). - 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 de type de données Delta Parquet vers Eventhouse
Les types de données primitifs Delta correspondent aux types de données scalaires Eventhouse, comme indiqué dans le tableau suivant. Pour plus d’informations, consultez les types de données Scalar.
| Type Delta | Type de données scalaire Eventhouse |
|---|---|
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 |
Synchronisation automatique du schéma
Les schémas de table pour un raccourci se synchronisent automatiquement, de sorte que les ajouts, suppressions, renoms et changements de type de colonnes dans la table source sont reflétés dans le raccourci sans nécessiter de mises à jour manuelles. Ce comportement est activé par défaut. Pour le désactiver, exécutez la commande suivante dans la base de données source :
.create-or-alter external table ExternalTable
kind=delta
(
h@'https://storageaccount.blob.core.windows.net/container1;secretKey'
) with (AutoUpdateSchema=false)
Pour plus d’informations sur le comportement de la synchronisation de schéma, voir Synchronisation automatique de schéma.