Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
OneLake fornisce API per lavorare con i metadati delle tabelle e leggere le righe delle tabelle in Fabric. Le API di metadati del catalogo lavorano con client e librerie compatibili con lo standard aperto dell'API Iceberg REST Catalog (IRC) o con lo standard aperto Unity Catalog API. Una comune API REST legge e scrive descrizioni e tag aggiuntivi per tabelle e colonne. L'API di lettura di tabella indipendente dal formato restituisce le righe delle tabelle come dati di Apache Arrow, pur facendo rispettare la sicurezza OneLake.
Lavorare con i metadati della tabella
Usa le API di metadati per scoprire schemi, tabelle e metadati di tabelle. Le operazioni di lettura e scrittura supportate variano a seconda del protocollo.
Usa l'API aggiuntiva di metadati delle tabelle (preview) per leggere e scrivere descrizioni e tag di tabelle e colonne senza utilizzare un'API catalog specifica per il formato.
| API | Protocol | Formati di tabella |
|---|---|---|
| API di metadati Iceberg | API del catalogo REST di Iceberg | Metadati Iceberg per le tabelle OneLake supportate |
| Delta metadata API | API REST compatibile con Unity Catalog | Metadati differenziali |
Leggi i dati della tabella
Usa l'API di lettura delle tabelle per recuperare righe sicure dalle tabelle OneLake supportate.
| API | Protocollo e flusso di lavoro | Formati di tabella |
|---|---|---|
| API per lettura di tabelle (anteprima) | Alloca i flussi con POST /read, e recupera ogni flusso con GET /readStream/{streamId} |
Tabelle valide per Delta Lake e Apache Iceberg |
Prerequisiti
Prima di utilizzare queste API, individua alcune informazioni e seleziona il flusso di autenticazione Microsoft Entra ID che preferisci.
Raccogli informazioni di base
Raccogliere le seguenti informazioni:
ID del tenant di Fabric.
L'ID inquilino è un GUID. Trovalo nella scheda profilo o in Help>About Fabric.
L'area di lavoro e l'ID dell'elemento di dati (come una lakehouse) con una directory Tables al livello superiore.
Questi ID sono GUID (Globally Unique Identifiers). Sono disponibili all'interno dell'URL di OneLake di qualunque tabella in OneLake. In alternativa, possono essere trovati all'interno dell'URL visualizzato nel browser quando si dispone di un elemento di dati aperto in Fabric.
Il nome dello schema e il nome della tabella per la tabella a cui vuoi accedere. Per l'API di lettura della tabella, la tabella deve essere valida come tabella Delta Lake o Apache Iceberg.
Un'identità utente o dell'entità servizio in Microsoft Entra ID che abbia i permessi necessari per le operazioni che intendi utilizzare.
- Le operazioni di lettura richiedono il permesso per leggere le tabelle target. L'API di lettura di tabella utilizza i permessi e le politiche di sicurezza dei dati per questa identità quando restituisce righe e colonne.
- Le operazioni di scrittura richiedono l'accesso in scrittura all'elemento dati di destinazione e alla posizione OneLake. A seconda del tipo di elemento e del modello di accesso, concedere un ruolo di elemento o spazio di lavoro che consenta scritture, oppure concedere ReadWrite tramite un ruolo di accesso ai dati OneLake. Per altre informazioni, vedere Introduzione alla sicurezza di OneLake.
Prepararsi all'autenticazione
Fai un piano su come vuoi autenticarti con l'API.
Decidere come eseguire l'autenticazione con Microsoft Entra ID per ottenere un token di accesso per l'identità Microsoft Entra scelta.
È possibile consultare questa guida per informazioni sui diversi modi per ottenere un token di accesso con Microsoft Entra ID. Microsoft offre librerie di autenticazione utili in diverse lingue.
Se si sviluppa una nuova applicazione che consentirà agli utenti di accedere o accedere come applicazione autonoma, registrare l'applicazione con Microsoft Entra ID.
Concedere l'autorizzazione API per il gruppo di destinatari del token di Archiviazione di Azure (
https://storage.azure.com/) all'applicazione Microsoft Entra ID. La concessione di questa autorizzazione garantisce che l'applicazione possa ottenere token da usare con l'endpoint della tabella OneLake.Annotazioni
L'endpoint dell'API tabella OneLake accetta lo stesso gruppo di destinatari del token degli endpoint del file system OneLake.
Se stai sviluppando un'applicazione, potresti già sapere come autenticarti con Microsoft Entra ID per interagire con le API REST del filesystem OneLake. Se sì, puoi usare lo stesso approccio per autenticare con l'endpoint della tabella OneLake.
Contenuti correlati
- Scopri di più sui metadati aggiuntivi delle tabelle.
- Scopri di più sull'API dei metadati Iceberg.
- Scopri di più sull'API dei metadati Delta.
- Scopri di più sulla lettura dei dati delle tabelle OneLake.
- Configurare la conversione automatica del formato da Delta Lake a Iceberg.