Abilitare la federazione del catalogo OneLake

Questo articolo illustra come leggere i dati in OneLake usando la federazione del catalogo. In questo modo, le query del catalogo Unity possono essere eseguite direttamente nell'archiviazione OneLake.

La federazione OneLake ti permette di analizzare i dati memorizzati nel tuo Lakehouse o Warehouse senza copiarli, portando analytics e capacità AI/BI in Azure Databricks direttamente ai tuoi dati OneLake. L'accesso ai dati è di sola lettura.

Requirements

Per eseguire query federate in OneLake, è necessario soddisfare i requisiti seguenti usando la federazione del catalogo:

Requisiti dell'area di lavoro:

  • Area di lavoro attivata per il catalogo Unity.

Requisiti di calcolo:

Note

In Databricks Runtime 19 e superiori, il calcolo di Azure Databricks legge i dati di OneLake tramite l'endpoint specifico di ciascun workspace Fabric, come <workspace-id>.z<xy>.dfs.fabric.microsoft.com, invece dell'endpoint globale onelake.dfs.fabric.microsoft.com. Se hai configurato record DNS personalizzati o regole firewall in uscita per l'endpoint globale, assicurati che coprano anche gli endpoint dello spazio di lavoro. Vedi ulteriori endpoint OneLake nella documentazione di Microsoft Fabric.

Tip

Per ridurre la latenza ed evitare costi di trasferimento dati tra regioni, usa uno spazio di lavoro Azure Databricks nella stessa regione Azure della capacità di Fabric che ospita i tuoi dati.

Autorizzazioni necessarie:

  • Per creare una connessione, è necessario essere un amministratore del metastore o un utente con privilegi CREATE CONNECTION e CREATE STORAGE CREDENTIAL nel metastore del catalogo Unity collegato all'area di lavoro.
  • Per creare un catalogo straniero, è necessario avere il permesso CREATE CATALOG sul metastore ed essere il proprietario della connessione o avere il privilegio CREATE FOREIGN CATALOG sulla connessione.

In ogni sezione basata su attività che segue vengono specificati requisiti di autorizzazione aggiuntivi.

  • È necessario disporre delle autorizzazioni per creare risorse in Azure, configurare l'accesso in Fabric e gestire Unity Catalog in Azure Databricks.
  • Metodi di autenticazione supportati:
    • Identità gestita di Azure tramite un connettore di accesso per Azure Databricks
    • Principale di servizio di Azure

Impostazioni del tenant e dell'area di lavoro del Fabric:

  • Un amministratore di Fabric deve abilitare l'impostazione del tenant Le entità servizio possono chiamare le API pubbliche di Fabric. In questo modo, le identità gestite e i principali del servizio possono autenticarsi con Fabric. Per ulteriori informazioni, vedere Configurazione del principale di servizio tenant.
  • Un amministratore di Infrastruttura deve abilitare l'impostazione Consenti alle app in esecuzione all'esterno di Fabric di accedere ai dati tramite l'impostazione del tenant di OneLake . Ciò consente ad Azure Databricks di connettersi all'archiviazione OneLake. Per altre informazioni, vedere Consentire alle app in esecuzione all'esterno di Fabric di accedere ai dati tramite OneLake.
  • Un amministratore di Fabric deve abilitare l'impostazione del tenant Usare token SAS con delega utente ad durata limitata. Questa impostazione consente a OneLake di rilasciare i token sas di breve durata supportati da Entra che Azure Databricks usano per leggere i dati di OneLake. Per altre informazioni, vedere Firme di accesso condiviso OneLake.
  • Nell'area di lavoro Fabric che contiene i tuoi dati, è necessario abilitare l'autenticazione utilizzando i token SAS delegati dall'utente OneLake. Passare a Impostazioni >dell'area di lavoroImpostazioni delegate > DiOneLake per abilitare questa impostazione.
  • Se il tuo workspace Fabric limita l'accesso in ingresso dalla rete pubblica, la configurazione dipende dal suo tenant. Se lo spazio di lavoro Fabric si trova nello stesso tenant Microsoft Entra del tuo workspace Azure Databricks, un amministratore dello spazio di lavoro Fabric deve aggiungere l'ID risorsa del Connettore Access per Azure Databricks alle regole dell'istanza delle risorse dello spazio di lavoro. Se è in un altro tenant, ti connetti tramite un endpoint privato. Vedi Collegati a uno spazio di lavoro Fabric che blocca l'accesso pubblico.

Sono supportati gli elementi di dati di Fabric seguenti:

  • Fabric Lakehouse
  • Magazzino tessuti

Configurare la federazione del catalogo

La procedura seguente illustra come creare la connessione e il catalogo esterno per la federazione onelake.

Passaggio 1: Configurare l'autenticazione di Azure

La federazione di OneLake supporta due metodi di autenticazione.

  • Azure Managed Identity (consigliato): Utilizza un Access Connector per Azure Databricks con un'identità gestita.
  • Entità servizio di Azure: usa un'applicazione Microsoft Entra ID con credenziali client. Questo metodo supporta l'autenticazione cross-tenant, permettendo ad Azure Databricks di accedere agli spazi di lavoro Fabric situati in un altro tenant Azure. Vedi Connettersi a uno spazio di lavoro Fabric in un altro tenant.

Opzione A: Creare un connettore di accesso (identità gestita)

L'Access Connector per Azure Databricks crea un'identità gestita che Azure Databricks utilizza per autenticarsi con OneLake.

  1. Nel portale di Azure cercare e creare un nuovo connettore di accesso per la risorsa Azure Databricks .

  2. Seguire le istruzioni per creare il connettore. Questa risorsa crea un'identità gestita assegnata dal sistema.

  3. Registrare l'ID risorsa del connettore appena creato. Questo ID è necessario quando si creano le credenziali di archiviazione del catalogo Unity.

    L'ID risorsa è nel formato:

    /subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Databricks/accessConnectors/<connector-name>
    

Per altre informazioni sulla creazione di connettori di accesso e sull'uso di identità gestite, vedere Usare le identità gestite di Azure nel catalogo unity per accedere all'archiviazione.

Opzione B: Registrare un principale del servizio

Se preferisci utilizzare un'entità servizio anziché un'identità gestita:

  1. Nel portale di Azure passare aRegistrazioni app > e registrare una nuova applicazione (o usarne una esistente).
  2. Registrare l'ID applicazione (client) e l'ID directory (tenant).
  3. In Certificati e segreti creare un nuovo segreto client e registrare il valore del segreto.

Se lo spazio di lavoro Fabric si trova in un altro tenant Microsoft Entra, l'applicazione deve avere un service principal in quel tenant. Vedi Connettersi a uno spazio di lavoro Fabric in un altro tenant.

Passaggio 2: Concedere le autorizzazioni in Fabric

Concedere all'identità gestita o all'entità servizio l'autorizzazione per la lettura dei dati di Fabric. Puoi concedere un ruolo workspace, che copre ogni elemento dati nello spazio di lavoro, oppure concedere permessi solo sugli elementi dati che vuoi federare.

Opzione A: Assegnare un ruolo nello spazio di lavoro

  1. Nel portale Fabric, naviga allo spazio di lavoro che contiene i tuoi elementi di dati Lakehouse o Warehouse.
  2. Nell'area di lavoro fare clic sull'icona a forma di ingranaggio Impostazioni area di lavoro, quindi fare clic su Gestisci accesso.
  3. Fare clic su Aggiungi persone o gruppi.
  4. Cercare e selezionare l'identità gestita o il principale del servizio. Per Identità gestita, il nome deve corrispondere al connettore di accesso creato in precedenza. Per un'entità servizio, cercare il nome dell'applicazione registrato.
  5. Assegna all'identità almeno il ruolo Collaboratore. Puoi anche assegnare ruoli di Membro o Amministrativo .
  6. Fare clic su Aggiungi.
  7. Verificare che l'identità venga visualizzata nell'elenco di accesso con il ruolo appropriato. Le autorizzazioni per singoli elementi Lakehouse e Warehouse vengono ereditate dal ruolo a livello di area di lavoro.

Opzione B: concedere permessi su singoli elementi dati

Azure Databricks legge i dati OneLake tramite le API OneLake, quindi l'identità necessita di un permesso che conceda accesso alla lettura OneLake. Il permesso per il solo SQL (Leggere tutto con endpoint di analisi SQL) non è sufficiente.

Prima di assegnare permessi su singoli elementi dati, assegna all'identità il ruolo Viewer a livello di spazio di lavoro Fabric. Segui i passaggi nell'Opzione A, selezionando Visualizzatore invece che Contributore.

  1. Nel portale Fabric, naviga fino allo spazio di lavoro che contiene i tuoi dati.
  2. Accanto all'elemento dati che vuoi federare, clicca sull'ellissi (...), poi clicca su Gestione permessi.
  3. Clicca su Aggiungi utente, poi cerca e seleziona l'Identità Gestita o il principale del servizio.
  4. Seleziona l'autorizzazione Leggi tutto che concede l'accesso in lettura a OneLake. A seconda del tipo di articolo e della tua versione Fabric, questa autorizzazione è etichettata come Leggi tutto con Apache Spark o Leggi tutti i dati OneLake. Per ulteriori informazioni, consulta Autorizzazioni degli elementi nella documentazione di Microsoft Fabric.
  5. Fare clic su "Concedi".
  6. Ripeti questi passaggi per ogni elemento dati che vuoi federare.

Passaggio 3: Creare credenziali di archiviazione

Creare credenziali di archiviazione nel catalogo unity che faccia riferimento all'identità configurata nel passaggio 1.

  1. Nell'area di lavoro di Azure Databricks fare clic sull'icona Dati.Catalogo.
  2. Nella parte superiore del riquadro Catalogo, fare clic sull'icona Aggiungi o più e selezionare Crea una credenziale dal menu.

Se si usa un'identità gestita:

  1. In Crea una nuova credenziale modale scegliere Identità gestita di Azure per Tipo di credenziale.
  2. Per Nome credenziale immettere un nome per le credenziali di archiviazione, ad esempio onelake_storage_cred.
  3. Per ID del connettore di accesso inserire l'ID risorsa del connettore di accesso creato in precedenza.
  4. (Facoltativo) Aggiungere un commento.
  5. Clicca su Crea.

Se stai utilizzando un principale del servizio:

Non è possibile creare una credenziale di archiviazione per il principale del servizio usando Catalog Explorer. È necessario essere un amministratore dell'account Azure Databricks e usare l'API Credenziali di archiviazione. Per esempio:

curl -X POST -n \
https://<databricks-instance>/api/2.1/unity-catalog/storage-credentials \
-d '{
   "name": "<storage-credential-name>",
   "read_only": true,
   "azure_service_principal": {
      "directory_id": "<directory-id>",
      "application_id": "<application-id>",
      "client_secret": "<client-secret>"
   },
   "skip_validation": "false"
   }'

È anche possibile creare credenziali di archiviazione usando il provider Databricks Terraform e databricks_storage_credential.

Se lo spazio di lavoro Fabric si trova in un altro tenant Microsoft Entra, imposta directory_id sull'ID della directory del tenant Fabric. Vedi Connettersi a uno spazio di lavoro Fabric in un altro tenant.

Passaggio 4: Creare una connessione al catalogo Unity

Creare una connessione al catalogo Unity che usa le credenziali di archiviazione per accedere a OneLake.

Esploratore di cataloghi

  1. Nell'area di lavoro di Azure Databricks fare clic sull'icona Dati.Catalogo.
  2. Nella parte superiore del riquadro Catalogo, fare clic sull'icona Aggiungi o più e selezionare Crea una connessione dal menu.
  3. Nella pagina Informazioni di base sulla connessione immettere un nome di connessione , ad esempio onelake_connection.
  4. Selezionare un tipo di connessione di OneLake.
  5. (Facoltativo) Aggiungere un commento.
  6. Fare clic su Avanti.
  7. Nella pagina Dettagli connessione selezionare le credenziali di archiviazione create nel passaggio precedente, ad esempio onelake_storage_cred.
  8. In Area di lavoro, immettere l'ID area di lavoro del proprio Fabric workspace.
  9. Fai clic su Crea connessione.

SQL

Eseguire il seguente comando in un notebook o nell'editor di query SQL di Databricks. Sostituisci i valori segnaposto:

  • <connection-name>: nome della connessione.
  • <workspace-id>: GUID dell'area di lavoro di OneLake.
  • <storage-credential-name>: nome delle credenziali di archiviazione create nel passaggio 3.
CREATE CONNECTION <connection-name> TYPE onelake
OPTIONS (
  workspace '<workspace-id>',
  credential '<storage-credential-name>'
);

Passaggio 5: Creare un catalogo esterno

Un catalogo esterno collega un elemento di dati di Fabric specifico a un catalogo in Unity Catalog.

Ottenere l'ID dell'elemento di dati Fabric

  1. Nel portale Fabric, vai al Lakehouse o Warehouse di destinazione.

  2. Copiare l'ID dell'elemento di dati, ovvero un GUID , ad esempio f089354e-8366-4e18-aea3-4cb4a3a50b48.

    È possibile trovare questo GUID nell'interfaccia utente di Fabric o copiandolo dall'URL del browser quando si accede a Lakehouse o Warehouse.

    https://app.fabric.microsoft.com/groups/<workspace-id>/lakehouses/<data-item-id>?experience=power-bi
    

Creare il catalogo

Esploratore di cataloghi
  1. Nell'area di lavoro di Databricks fare clic sull'icona Dati.Catalogo.
  2. Nella parte superiore del riquadro Catalogo, fare clic sull'icona Aggiungi o Più e selezionare Crea un catalogo dal menu.
  3. Nella finestra di dialogo Crea un nuovo catalogo immettere un nome per il catalogo , ad esempio fabric_sales.
  4. Selezionare un tipo di straniero.
  5. Selezionare la connessione creata nel passaggio 4 , ad esempio onelake_connection.
  6. Per Elemento dati immettere l'ID elemento di dati copiato dal portale di Fabric.
  7. Per Tipo di elemento selezionare il tipo corrispondente all'elemento di dati nell'elenco a discesa.
  8. (Facoltativo) Fare clic su Test connessione per convalidare la configurazione.
  9. Clicca su Crea.
SQL

Eseguire il comando SQL seguente in un notebook o nell'editor di query SQL di Databricks. Gli elementi tra parentesi quadrate sono opzionali. Sostituisci i valori segnaposto:

  • <catalog-name>: Nome per il catalogo in Azure Databricks.
  • <connection-name>: connessione creata nel passaggio 4.
  • <data-item-id>: GUID del Fabric Lakehouse o del Data Warehouse.
  • <item-type>: Lakehouse o Warehouse.
CREATE FOREIGN CATALOG [IF NOT EXISTS] <catalog-name> USING CONNECTION <connection-name>
OPTIONS (
  data_item '<data-item-id>',
  item_type '<item-type>'
);

È anche possibile specificare i parametri facoltativi seguenti:

CREATE FOREIGN CATALOG <catalog-name> USING CONNECTION <connection-name>
OPTIONS (
  data_item '<data-item-id>',
  item_type 'Lakehouse',
  create_volume_for_lakehouse_files 'true'
);
  • create_volume_for_lakehouse_files: true (impostazione predefinita) o false. Quando true crea un volume per la cartella /Files del Lakehouse. Si applica solo agli elementi Lakehouse. Vedere Accedere a dati non strutturati.

Il catalogo viene sincronizzato automaticamente, rendendo immediatamente disponibili le tabelle di Fabric.

Collegati a uno spazio di lavoro Fabric in un altro tenant

Lo spazio di lavoro Fabric che federi può trovarsi in un tenant Microsoft Entra diverso rispetto al tuo workspace Azure Databricks. L'accesso cross-tenant richiede un service principal nel tenant che contiene lo spazio di lavoro Fabric, perché le identità gestite non possono autenticarsi in un altro tenant.

Completa i passaggi in Configura la federazione del catalogo con queste modifiche:

  1. Nel Passo 1, usa un'applicazione Microsoft Entra che abbia un service principal nel tenant Fabric. L'applicazione può essere un'applicazione a singolo tenant registrata nel tenant Fabric, oppure un'applicazione multi-tenant a cui un amministratore Microsoft Entra ID nel tenant Fabric ha concesso il consenso. Vedi gli oggetti applicazione e entità servizio in Microsoft Entra ID.
  2. Nel Passaggio 2, l'amministratore dello spazio di lavoro Fabric concede a tale entità servizio l'accesso allo spazio di lavoro o ai singoli elementi di dati. Un amministratore del tenant Fabric deve anche abilitare il tenant Fabric e le impostazioni del tenant e dell'area di lavoro elencate nei Requisiti. L'applicazione non ha bisogno di alcun permesso API in Microsoft Entra ID.
  3. Nel Passo 3, imposta directory_id su l'ID della directory (tenant) del tenant Fabric, non il tuo tenant personale. Unity Catalog utilizza il service principal per richiedere token al tenant che contiene lo spazio di lavoro Fabric.

Se lo spazio di lavoro Fabric blocca l'accesso pubblico a internet, configura un endpoint privato prima di creare la connessione nel Passo 4. Vedi endpoint privato per uno spazio di lavoro Fabric in un altro tenant.

Collegati a uno spazio di lavoro Fabric che blocca l'accesso pubblico

Uno spazio di lavoro Fabric può bloccare l'accesso pubblico a OneLake da Internet. Come ti connetti dipende dal fatto che lo spazio di lavoro Fabric sia nello stesso tenant Microsoft Entra del tuo workspace Azure Databricks:

Fabric workspace nello stesso tenant

Quando lo spazio di lavoro Fabric si trova nello stesso tenant del tuo workspace Azure Databricks, autenticati con un'identità gestita e consenti il connettore di accesso tramite una regola di resource instance sullo spazio di lavoro Fabric. Le regole delle istanze di risorse non si applicano tra i tenant.

  1. In Configura federazione del catalogo, usa l'Opzione A nel Passo 1 per creare un connettore di accesso e registra il suo ID risorsa. Ha il formato /subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Databricks/accessConnectors/<connector-name>.
  2. Chiedi all'amministratore dello spazio di lavoro Fabric di aggiungere l'ID risorsa del connettore di accesso come regola di istanza di risorsa. Nell'area di lavoro Fabric, l'amministratore seleziona Impostazioni dell'area di lavoro>Inbound networking, limita l'accesso a reti selezionate e risorse approvate e aggiunge l'ID della risorsa. Un amministratore di Fabric deve prima abilitare l'impostazione tenant che consente la protezione di rete in entrata a livello di workspace. Vedi Gestire l'accesso in entrata a OneLake con le regole di istanza delle risorse nella documentazione di Microsoft Fabric.
  3. Completa i passaggi rimanenti nella configurazione della federazione del catalogo.

Endpoint privato per uno spazio di lavoro Fabric in un altro tenant

Quando lo spazio di lavoro Fabric si trova in un altro tenant, Azure Databricks compute si collega a OneLake tramite un endpoint privato al servizio collegamento privato dello spazio di lavoro, utilizzando un private link a livello di workspace. Segui le connessioni cross-tenant utilizzando collegamenti privati a livello di workspace nella documentazione Microsoft Fabric. Un amministratore del tenant Fabric crea il servizio collegamento privato, e tu crei l'endpoint privato come descritto nelle sezioni seguenti.

Requisiti:

  • Il calcolo classico deve utilizzare Databricks Runtime 19 o superiore.
  • Ti serve l'ID della risorsa del servizio collegamento privato dello spazio di lavoro Fabric, che l'amministratore dello spazio di lavoro Fabric può fornirti. Ha il formato /subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Fabric/privateLinkServicesForFabric/<name>.

Ogni workspace Fabric ha il proprio servizio collegamento privato, quindi crei un endpoint privato per ogni workspace Fabric che federi. Crea l'endpoint privato prima di creare la connessione e il catalogo estero in Configura la federazione del catalogo.

Su un endpoint privato, la federazione OneLake supporta tabelle negli elementi Lakehouse e Warehouse. L'accesso ai file di Lakehouse non è supportato. Vedere Accedere a dati non strutturati.

Calcolo serverless

Databricks consiglia il calcolo serverless per questa configurazione, perché Azure Databricks crea l'endpoint privato e ne gestisce il DNS per te.

  1. Crea una configurazione di connettività di rete (NCC) e collegala al tuo spazio di lavoro. Vedi Creare una configurazione di connettività di rete e Collegare un NCC a uno spazio di lavoro.
  2. Aggiungi una regola di endpoint privato all'NCC. Per Azure resource ID, inserisci l'ID di risorsa del servizio collegamento privato. Per il tipo di sottorisorsa Azure, inserisci workspace. Vedi Creare regole per endpoint privati.
  3. Chiedi a un amministratore nel tenant Fabric di approvare la connessione dell'endpoint privato in sospeso.
  4. Aggiorna la pagina NCC finché lo stato della regola non è ESTABLISHED, quindi riavvia qualsiasi istanza di elaborazione serverless in esecuzione. Vedi Riavvia risorse del piano di calcolo serverless e testa la connessione.

Calcolo classico

Classic compute richiede un'area di lavoro distribuita nella propria rete virtuale personalizzata. Vedere Implementare Azure Databricks nella rete virtuale di Azure (VNet Injection).

I passaggi seguenti adattano i passaggi da 5 a 7 di connessioni cross-tenant utilizzando collegamenti privati a livello di workspace nella documentazione Microsoft Fabric. Usa la rete virtuale dello spazio di lavoro invece di creare una nuova rete virtuale e una nuova macchina virtuale.

  1. Nel portale Azure, crea un endpoint privato in una subnet della rete virtuale dello spazio di lavoro. Seleziona Connetti a una risorsa di Azure tramite ID risorsa o alias, inserisci l'ID risorsa del servizio collegamento privato e seleziona workspace come sottorisorsa di destinazione. Il Microsoft.Fabric fornitore di risorse deve essere registrato nell'abbonamento Azure dove si crea l'endpoint privato.
  2. Chiedi a un amministratore nel tenant Fabric di approvare la connessione dell'endpoint privato in sospeso.
  3. Crea una zona DNS privata chiamata privatelink.fabric.microsoft.com e collegala alla rete virtuale dello spazio di lavoro. Assicurati che ogni record elencato nella pagina di configurazione DNS dell'endpoint privato sia incluso in questa zona DNS, inclusi gli endpoint OneLake come <workspace-id>.z<xy>.dfs.fabric.microsoft.com. In questi nomi, <workspace-id> compare l'ID dello spazio di lavoro Fabric senza trattini e <xy> è i suoi primi due caratteri.
  4. Se le regole del gruppo di sicurezza di rete limitano il traffico in uscita dalle subnet dello spazio di lavoro, consenti la porta 443 verso l'endpoint privato.

Verifica la connettività privata

Dopo aver creato il catalogo estero, consulta una tabella al suo interno. Una query riuscita conferma che il traffico utilizza l'endpoint privato.

Puoi anche testare la connessione e consultare gli schemi e le tabelle del catalogo estero in Catalog Explorer.

Accedere ai dati non strutturati

La federazione di OneLake supporta l'accesso in sola lettura ai dati non strutturati archiviati nella /Files cartella di un Lakehouse. Questo viene ottenuto tramite i volumi di Unity Catalog.

Note

L'accesso ai file Lakehouse non è supportato per gli spazi di lavoro Fabric in un altro tenant a cui ti connetti tramite un endpoint privato. Vedi endpoint privato per uno spazio di lavoro Fabric in un altro tenant. Quando crei il catalogo esterno per uno di questi workspace, puoi impostare create_volume_for_lakehouse_files su false per saltare la creazione del volume.

Quando si crea un catalogo esterno con create_volume_for_lakehouse_files impostato su true (impostazione predefinita), viene creato automaticamente un volume nello onelake-folders schema. Questo volume indirizza alla /Files cartella di Lakehouse e fornisce accesso in sola lettura ai file archiviati in tale posizione.

È possibile esplorare e leggere i file usando il percorso del volume:

LIST '/Volumes/<catalog-name>/onelake-folders/files/';
df = spark.read.format("binaryFile").load("/Volumes/<catalog-name>/onelake-folders/files/")

È anche possibile eseguire query sui file strutturati direttamente:

SELECT * FROM parquet.`/Volumes/<catalog-name>/onelake-folders/files/table.parquet`

Concedere le autorizzazioni per le tabelle federate

Dopo aver configurato la federazione del catalogo, gli utenti devono disporre delle autorizzazioni appropriate per il catalogo Unity per accedere alle tabelle federate:

  • Tutti gli utenti necessitano delle autorizzazioni USE CATALOG per il catalogo e USE SCHEMA per lo schema, rispettivamente.
  • Per leggere dalla tabella federata, gli utenti devono disporre dell'autorizzazione SELECT .

Per altre informazioni sui privilegi del catalogo Unity e su come concederli, vedere Gestire i privilegi in Unity Catalog.

Eseguire query sui dati di OneLake

Al termine dell'installazione, è possibile trovare ed eseguire query sui dati di OneLake in Unity Catalog.

Esplorare il catalogo

  1. Nell'area di lavoro di Databricks passare a Esplora cataloghi.
  2. Individuare il catalogo creato, ad esempio fabric_sales.
  3. Espandere il catalogo per visualizzare gli schemi e le tabelle sincronizzati da Fabric Lakehouse o Warehouse.

Esegui le query

Usare la convenzione di denominazione in tre parti (catalog.schema.table) in Databricks SQL o notebook:

SELECT COUNT(*)
FROM fabric_sales.silver.customer_details;
SELECT
  customer_id,
  customer_name,
  total_purchases
FROM fabric_sales.silver.customer_details
WHERE total_purchases > 1000
ORDER BY total_purchases DESC
LIMIT 10;

Sincronizza i commenti delle tabelle e delle colonne

Azure Databricks supporta la sincronizzazione dei commenti di tabelle e colonne dalla sorgente dati esterna. La sincronizzazione dei commenti richiede Databricks Runtime 18 LTS o superiore, oppure un SQL warehouse che esegue Databricks SQL 2026.15 o superiore. Vedere Canali di SQL Warehouse.

Azure Databricks recupera i commenti quando risolve i metadati di tabelle esterne. I commenti sincronizzati appaiono in Esplora catalogo e nell'output di DESCRIBE e di DESCRIBE EXTENDED. Quando i commenti cambiano nella sorgente esterna, Azure Databricks sincronizza le modifiche la volta successiva che risolve i metadati della tabella foreign. Per aggiornare i commenti senza interrogare i dati della tabella, esegui:

DESCRIBE EXTENDED <catalog-name>.<schema-name>.<table-name>;

Le pipeline di Lakeflow non recuperano commenti dalla fonte esterna quando si risolvono i metadati delle tabelle esterne.

Limitazioni

La federazione di OneLake presenta le limitazioni seguenti:

  • Accesso in sola lettura: Solo le query SELECT sono supportate. Le operazioni di scrittura non sono disponibili.
  • Autenticazione: Identità Gestita di Azure e Principal di Servizio di Azure sono i metodi di autenticazione supportati.
  • Elementi di dati supportati: sono supportati solo gli elementi Fabric Lakehouse e Warehouse.
  • Requisiti di calcolo: la modalità di accesso dedicato non è supportata.
  • I tipi di dati complessi (matrici, mappe, struct) non sono supportati.
  • Le viste e le viste materializzate non sono supportate.
  • Non è possibile aggiornare le opzioni di connessione( ad esempio workspace) dopo la creazione della connessione.
  • Le tabelle con colonne che differiscono solo nel caso (ad esempio, id e ID) non sono supportate.
  • I file Lakehouse non sono supportati per gli spazi di lavoro Fabric in un altro tenant a cui si connette tramite un endpoint privato. Vedere Accedere a dati non strutturati.