Creare collegamenti OneLake in un database KQL

I tasti di scelta rapida di OneLake in un database KQL consentono di eseguire query sui dati negli elementi interni Fabric e nell'archiviazione esterna senza spostare i dati. In un database KQL, ogni scelta rapida compare in Scelte rapide e viene interrogata come tabella esterna in un set di query KQL usando la funzione external_table().

In questo articolo si apprende come creare un collegamento OneLake in un database KQL che punta a origini interne di Fabric o esterne. Non è possibile rinominare i collegamenti creati in un database KQL ed è possibile creare un solo collegamento alla volta.

Per informazioni generali sui tipi di collegamento, sulle istruzioni specifiche per l'origine e sulle limitazioni generali, vedere Collegamenti a OneLake.

Nota

Per migliorare le prestazioni delle query sui collegamenti supportati, vedere Accelerazione delle query sui collegamenti OneLake.

Prerequisiti

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

Crea un collegamento

  1. Passare a un database KQL esistente.

  2. Selezionare +>Nuovo>collegamento a OneLake.

    Schermata della scheda Home che mostra il menu a discesa del pulsante Nuovo. L'opzione denominata

Selezionare un'origine

I database KQL supportano collegamenti a risorse OneLake interne, ad esempio database KQL, lakehouse e warehouse e a risorse esterne, ad esempio Azure Data Lake Storage, Amazon S3 e Google Cloud Storage. Per un elenco completo dei tipi di collegamento supportati e indicazioni sulla configurazione specifiche dell'origine, vedere Tipi di collegamenti.

  1. Nella finestra Nuovo collegamento scegliere il tipo di origine a cui connettersi.
  2. Completare i dettagli di connessione necessari per l'origine e quindi selezionare la cartella o la tabella da esporre nel database KQL.
  3. Facoltativo: per abilitare l'accelerazione delle query nella nuova scorciatoia, impostare Accelerate su On.
  4. Fare clic su Crea.

Per gli scenari supportati e le limitazioni, vedi Accelerazione delle query per gli shortcut di OneLake - panoramica.

Screenshot della finestra nuovo collegamento che mostra i dettagli del collegamento. L'opzione Accelerate è evidenziata.

Nota

  1. È possibile connettersi solo a una sottocartella o a una tabella per ogni collegamento. Per connettersi a ulteriori dati, creare scorciatoie aggiuntive.
  2. Non è possibile creare un collegamento su una tabella con un asterisco (*) in qualsiasi nome di colonna. Rinominare le colonne prima di creare il collegamento.

Dopo aver creato il collegamento, il database viene aggiornato automaticamente. Il collegamento viene visualizzato in Collegamenti nel riquadro Esplora. È ora possibile eseguire query sui dati.

Screenshot del riquadro Explorer che mostra il nuovo collegamento.

Organizzare i collegamenti con le cartelle

Per creare una sottocartella o spostarsi in una cartella esistente:

  1. Nel riquadro di Esplora file, effettuare una delle seguenti operazioni:
    • Fare clic con il pulsante destro del mouse sul collegamento e scegliere Sposta nella cartella>.
      Schermata del menu contestuale con l'opzione per creare una nuova cartella per il collegamento.
    • In alternativa, selezionare i puntini di sospensione (...) accanto al collegamento specifico e selezionare Sposta nella cartella> o scegliere una cartella esistente.
      Screenshot del menu a comparsa che mostra l'opzione per spostare il collegamento in una cartella esistente o crearne una nuova.
  2. Per creare una cartella, immettere un nome per la cartella e selezionare Crea. Il collegamento viene spostato nella nuova cartella.
    Screenshot della nuova cartella da creare.
  3. Per spostare più collegamenti, immettere un altro nome di cartella o selezionare il menu a discesa e selezionare le caselle accanto ai collegamenti da spostare nella stessa cartella.
    Schermata del menu a comparsa con l'opzione per spostare più collegamenti nella stessa cartella.
  4. È anche possibile spostare i collegamenti in una cartella esistente. A tale scopo, selezionare Sposta nella cartella e quindi selezionare la cartella in cui spostare il collegamento oppure trascinare e rilasciare il collegamento nella cartella.

Nota

  • Se si elimina una sottocartella, i collegamenti all'interno della cartella non vengono eliminati ma vengono spostati nuovamente nella cartella padre.
  • Una sottocartella viene eliminata automaticamente quando non sono presenti collegamenti all'interno della cartella.
  • Le cartelle possono essere create per tipo di asset e il nome deve essere univoco per ogni tipo di asset. Ad esempio, è possibile avere una cartella tabella e una cartella collegamenti con lo stesso nome, ma non è possibile avere due cartelle di scelta rapida con lo stesso nome.

Eseguire query sui dati

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

  1. Sul lato destro 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.
  2. Sostituire il segnaposto del nome della tabella con external_table('<shortcut-name>').
  3. Selezionare Esegui o premere Maiusc + Invio per eseguire una query selezionata.

Screenshot della finestra Esplora i dati che mostra i risultati di una query di esempio.

Mappatura del tipo di dati

Mapping dei tipi di dati da Delta Parquet a Eventhouse

I tipi di dati primitivi Delta corrispondono ai tipi di dati scalari di Eventhouse, come illustrato nella tabella seguente. Per altre informazioni, vedere Tipi di dati scalari.

Tipo delta Tipo di dato scalare di 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

Sincronizzazione automatica dello schema

Gli schemi di tabella per una tabella scorciatoia si sincronizzano automaticamente, quindi aggiunte, cancellazioni, rinomi e cambiamenti di tipo nella tabella sorgente vengono riflessi nella scorciatoia senza richiedere aggiornamenti manuali. Questo comportamento è attivato di default. Per disabilitarla, esegui il seguente comando nel database sorgente:

.create-or-alter external table ExternalTable
kind=delta
(
   h@'https://storageaccount.blob.core.windows.net/container1;secretKey'
) with (AutoUpdateSchema=false)

Per maggiori informazioni sul comportamento della sincronizzazione dello schema, vedi Sincronizzazione automatica dello schema.

Contenuto correlato

  • Last updated on