OneLake è un data lake singolo, unificato e logico per Microsoft Fabric per archiviare lakehouse, warehouse, database KQL e altri elementi. I collegamenti sono riferimenti incorporati all'interno di OneLake che puntano ai percorsi di archivio di altri file senza spostare i dati originali. Il riferimento incorporato lo rende come se i file e le cartelle vengano archiviati localmente ma in realtà; esistono in un'altra posizione di archiviazione. I collegamenti possono essere aggiornati o rimossi dagli elementi, ma queste modifiche non influiscono sui dati originali e sulla relativa origine.
Questo articolo illustra come creare un collegamento OneLake in un database KQL che punta a origini esterne o interne di Fabric. Questo tipo di collegamento viene eseguito successivamente per la query nei set di query KQL usando la external_table()funzione. I collegamenti creati in un database KQL non possono essere rinominati ed è possibile creare un solo collegamento alla volta.
Oltre a creare collegamenti da un database KQL, è anche possibile creare collegamenti da altri elementi di Fabric. Questi collegamenti puntano anche a dati archiviati in origini esterne o interne di Fabric, ma presentano limiti diversi e sono accessibili in modo diverso. Per ulteriori informazioni, vedere Collegamenti OneLake.
Per accedere ai dati nel database KQL in altre esperienze di Microsoft Fabric, vedere Una copia logica.
Creare un collegamento
Nota
Il flusso seguente illustra come creare un collegamento che punta ai dati in una Lakehouse in Fabric. Analogamente, è possibile creare collegamenti che puntano a data warehouse o ad altri database KQL.
Passare a un database KQL esistente.
Selezionare Nuovo>Collegamento OneLake.
Selezionare un'origine
In Origini interne selezionare Microsoft OneLake.
Selezionare l’origine dati a cui ci si vuole connettere, quindi selezionare Avanti.
Espandere Tabelle e selezionare una tabella specifica a cui connettersi.
Seleziona Avanti.
Nota
Per abilitare l'accelerazione delle query su un nuovo collegamento, attivare o disattivare il pulsante Accelera su Sì. Per altre informazioni, vedere Accelerare le query sui collegamenti OneLake.
Seleziona Crea.
Nota
È possibile connettersi a una sola sottocartella o tabella per collegamento. Per connettersi a più dati, ripetere questi passaggi e creare collegamenti aggiuntivi.
I collegamenti definiti in precedenza per il percorso di archiviazione specificato vengono visualizzati nell'elenco a tendina. Se non esistono collegamenti, crearne uno nuovo.
Crea nuovo collegamento.
Nome connessione
Seleziona il collegamento Azure Data Lake Storage Gen2.
Un nome per il collegamento.
Tipo di autenticazione
Modello di autorizzazione. I modelli supportati sono: account aziendale, chiave dell'account, firma di accesso condiviso (SAS), entità servizio e identità dell'area di lavoro. Per ulteriori informazioni, vedere collegamenti ADLS.
Dipendente dal modello di autorizzazione. Dopo aver selezionato un tipo di autenticazione, immettere le credenziali necessarie.
Selezionare Avanti.
Passare alla posizione di destinazione per il collegamento.
Se è stato usato l'account di archiviazione nel collegamento URL, tutti i contenitori disponibili compaiono nella vista di navigazione a sinistra. Se è stato specificato un contenitore nel collegamento URL, nella vista di navigazione verranno visualizzati solo il contenitore specificato e il relativo contenuto.
Spostarsi nell'account di archiviazione selezionando una cartella o cliccando sulla freccia di espansione accanto a una cartella.
In questa visualizzazione è possibile selezionare una o più posizioni di destinazione del collegamento. Scegliere le posizioni di destinazione facendo clic sulla casella di controllo accanto a una cartella nella visualizzazione di spostamento a sinistra.
Selezionare Avanti
La pagina di revisione consente di verificare tutte le selezioni. Qui è possibile visualizzare ogni collegamento che verrà creato. Nella colonna azione è possibile fare clic sull'icona a forma di matita per modificare il nome del collegamento. È possibile fare clic sull'icona del cestino per eliminare il collegamento.
Account Amazon S3. Per ulteriori informazioni, vedi Cos'è Amazon S3?
Creare un collegamento
Passare a un database KQL esistente.
Selezionare Nuovo>Collegamento OneLake.
Selezionare un'origine
In Origini esterne selezionare Amazon S3.
Immettere le Impostazioni di connessione in base alla tabella seguente:
Campo
Descrizione
valore
URL
Stringa di connessione per il bucket Amazon S3.
https://NomeBucket.s3.CodiceRegione.amazonaws.com
Connessione
I collegamenti definiti in precedenza per il percorso di archiviazione specificato vengono visualizzati nell'elenco a tendina. Se non esistono collegamenti, crearne uno nuovo.
Creare nuovo collegamento
Nome connessione
Nome del collegamento Amazon S3.
Un nome per il collegamento.
Tipo di autenticazione
Criteri di Gestione delle Identità e degli Accessi (IAM). I criteri devono disporre delle autorizzazioni di lettura ed elenco. Per altre informazioni, vedi Utenti IAM.
Chiave privata Gestione delle Identità e degli Accessi (IAM).
Chiave privata.
Selezionare Avanti.
Passare alla posizione di destinazione per il collegamento.
Se è stato usato l'endpoint globale nell'URL di collegamento, tutti i bucket disponibili compaiono nella vista di navigazione a sinistra. Se è stato usato un endpoint specifico del bucket nell'URL di collegamento, nella vista di navigazione compaiono solo il bucket specifico e il relativo contenuto.
Spostarsi nell'account di archiviazione selezionando una cartella o cliccando sulla freccia di espansione accanto a una cartella.
In questa visualizzazione è possibile selezionare una o più posizioni di destinazione del collegamento. Scegliere le posizioni di destinazione facendo clic sulla casella di controllo accanto a una cartella nella visualizzazione di spostamento a sinistra.
Selezionare Avanti
La pagina di revisione consente di verificare tutte le selezioni. Qui è possibile visualizzare ogni collegamento che verrà creato. Nella colonna azione è possibile fare clic sull'icona a forma di matita per modificare il nome del collegamento. È possibile fare clic sull'icona del cestino per eliminare il collegamento.
Seleziona Crea.
Il database viene aggiornato automaticamente. Il collegamento viene visualizzato in Collegamenti nel riquadro Esplora.
Il collegamento OneLake è stato creato. È ora possibile eseguire una query su questi dati.
Sul lato più a destra del database selezionare Esplora i dati. La finestra si apre con alcune query di esempio che è possibile eseguire per dare un primo sguardo ai dati.
Sostituire il segnaposto nome tabella con external_table('nome collegamento').
Selezionare Esegui o premere Maiusc + Invio per eseguire una query selezionata.
Mapping dei tipi di dati
Mapping dei tipi di dati delta parquet a Eventhouse
I tipi di dati primitivi delta vengono mappati ai tipi di dati scalari di Eventhouse usando le regole seguenti. Per altre informazioni sui tipi di dati di Eventhouse, vedere Tipi di dati scalari.