Creare collegamenti OneLake in un database KQL

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 dell'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 un'infrastruttura interna o a origini esterne. 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 e è 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 ai dati archiviati in un'infrastruttura interna o in origini esterne, ma presentano limitazioni diverse e sono accessibili in modo diverso. Per altre informazioni, vedere Collegamenti a OneLake.

Nota

Usare i collegamenti OneLake quando si desidera eseguire raramente query sui dati cronologici senza partizionare o indicizzare i dati. Se si vogliono eseguire spesso query e accelerare le prestazioni, importare i dati direttamente nel database KQL.

Selezionare la scheda corrispondente al collegamento da creare:

Collegamento a OneLake

Prerequisiti

• Un'area di lavoro con capacità abilitata per Microsoft Fabric
• Un database KQL con autorizzazioni di modifica
• Una lakehouse

Per accedere ai dati nel database KQL in altre esperienze di Microsoft Fabric, vedere Una copia logica.

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

1. Passare a un database KQL esistente.

2. Selezionare Nuovo>collegamento a OneLake.

   

Seleziona un'origine

1. In Origini interne selezionare Microsoft OneLake.

   

2. Selezionare l'origine dati a cui connettersi e quindi selezionare Avanti.

   

3. Espandere Tabelle e selezionare una tabella specifica a cui connettersi.

   

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

Azure Data Lake Storage Gen2

Prerequisiti

• Un'area di lavoro con capacità abilitata per Microsoft Fabric
• Un database KQL con autorizzazioni di modifica
• Un account Azure Data Lake Archiviazione Gen2.

Crea collegamento

1. Passare a un database KQL esistente.

2. Selezionare Nuovo>collegamento a OneLake.

   

Seleziona un'origine

1. In Origini esterne selezionare Azure Data Lake Archiviazione Gen2.

2. Immettere le impostazioni di Connessione ion in base alla tabella seguente:

   

   Campo	Descrizione	Valore
   URL	Il stringa di connessione per il contenitore delta.	https://Archiviazione AccountName.dfs.core.windows.net
   Connessione	Le connessioni definite in precedenza per il percorso di archiviazione specificato vengono visualizzate nell'elenco a discesa. Se non esistono connessioni, creare una nuova connessione.	Creare una nuova connessione.
   Nome connessione	Nome della connessione di Azure Data Lake Archiviazione Gen2.	Nome della connessione.
   Tipo di autenticazione	Modello di autorizzazione. I modelli supportati sono: account aziendale, chiave dell'account, firma di accesso condiviso e entità servizio. Per altre informazioni, vedere Collegamenti ADLS.	Dipendente dal modello di autorizzazione. Dopo aver selezionato un tipo di autenticazione, immettere le credenziali necessarie.

3. Selezionare Avanti.

4. Passare alla posizione di destinazione per il collegamento.

   

   Se è stato appena usato l'account di archiviazione nell'URL di connessione, tutti i contenitori disponibili vengono visualizzati nella visualizzazione di spostamento a sinistra. Se è stato specificato un contenitore nell'URL di connessione, nella visualizzazione di spostamento vengono visualizzati solo il contenitore specificato e il relativo contenuto.

   Spostarsi nell'account di archiviazione selezionando una cartella o facendo clic sulla carota di espansione accanto a una cartella.

   In questa visualizzazione è possibile selezionare una o più posizioni di destinazione dei collegamenti. Scegliere i percorsi di destinazione facendo clic sulla casella di controllo accanto a una cartella nella visualizzazione di spostamento a sinistra.

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

6. Seleziona Crea.

Amazon S3

Prerequisiti

• Un'area di lavoro con capacità abilitata per Microsoft Fabric
• Un database KQL con autorizzazioni di modifica
• Un account Amazon S3. Per altre informazioni, vedere Che cos'è Amazon S3?

Crea collegamento

1. Passare a un database KQL esistente.

2. Selezionare Nuovo>collegamento a OneLake.

   

Seleziona un'origine

1. In Origini esterne selezionare Amazon S3.

2. Immettere le impostazioni di Connessione ion in base alla tabella seguente:

   

   Campo	Descrizione	Valore
   URL	Il stringa di connessione per il bucket Amazon S3.	https://BucketName.s3.RegionCode.amazonaws.com
   Connessione	Le connessioni definite in precedenza per il percorso di archiviazione specificato vengono visualizzate nell'elenco a discesa. Se non esistono connessioni, creare una nuova connessione.	Creare una nuova connessione
   Nome connessione	Nome della connessione Amazon S3.	Nome della connessione.
   Tipo di autenticazione	Criteri IAM (Identity and Access Management). I criteri devono disporre delle autorizzazioni di lettura ed elenco. Per altre informazioni, vedere Utenti IAM.	Dipendente dai criteri del bucket.
   ID chiave di accesso	Chiave utente IAM (Identity and Access Management). Per altre informazioni, vedere Gestire le chiavi di accesso per gli utenti IAM.	La chiave di accesso.
   Chiave di accesso segreta	Chiave privata IAM (Identity and Access Management).	Chiave privata.

Selezionare Avanti.

1. Passare alla posizione di destinazione per il collegamento.

   

   Se è stato usato l'endpoint globale nell'URL di connessione, tutti i bucket disponibili vengono visualizzati nella visualizzazione di spostamento a sinistra. Se è stato usato un endpoint specifico del bucket nell'URL di connessione, nella visualizzazione di spostamento vengono visualizzati solo il bucket specificato e il relativo contenuto.

   Spostarsi nell'account di archiviazione selezionando una cartella o facendo clic sulla carota di espansione accanto a una cartella.

   In questa visualizzazione è possibile selezionare una o più posizioni di destinazione dei collegamenti. Scegliere i percorsi di destinazione facendo clic sulla casella di controllo accanto a una cartella nella visualizzazione di spostamento a sinistra.

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

3. Seleziona Crea.

Il database viene aggiornato automaticamente. Il collegamento viene visualizzato in Collegamenti nel riquadro Esplora risorse .

Il collegamento OneLake è stato creato. È ora possibile eseguire query su questi dati.

Eseguire query sui dati

Per eseguire query sui dati dal collegamento OneLake, usare la external_table() funzione .

1. Sul lato più a destra del database selezionare Esplora i dati. La finestra si apre con alcune query di esempio che è possibile eseguire per ottenere un'analisi iniziale dei dati.
2. Sostituire il segnaposto nome tabella con external_table('nome') collegamento.
3. Selezionare Esegui o premere MAIUSC + INVIO per eseguire una query selezionata.

Mapping dei tipi di dati

Mapping dei tipi di dati delta parquet a Casa eventi

I tipi di dati primitivi delta vengono mappati ai tipi di dati scalari casa eventi usando le regole seguenti. Per altre informazioni sui tipi di dati casa eventi, vedere Tipi di dati scalari.

Tipo Delta	Tipo di dati Scalare dell'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 (senza fuso orario)	datetime
struct	dynamic
array	dynamic
map	dynamic

Contenuto correlato

• Eseguire query sui dati in un set di query KQL
• Funzione external_table()