Concetti e funzionalità chiave

Il toolkit di estensibilità introduce una suite di funzionalità progettate per portare la tua applicazione dati su una piattaforma nel modo più semplice possibile. Queste funzionalità consentono agli sviluppatori di creare esperienze avanzate e integrate con un minimo sforzo. Con Extensibility Toolkit è possibile accedere facilmente alle API di Infrastruttura direttamente dal front-end, rendere persistente la definizione dell'elemento (stato) all'interno di Fabric, usare un flusso di creazione di elementi standardizzato e sfruttare la sicurezza e l'interoperabilità migliorate tramite il relax iFrame e il supporto dell'API pubblica. Semplifica inoltre il ciclo di vita di sviluppo con il supporto CI/CD predefinito, semplificando l'automazione della distribuzione e dei test. Le sezioni seguenti forniscono una panoramica delle funzionalità principali e indicazioni su come incorporarle nei carichi di lavoro.

Esperienza di creazione di elementi standard

La creazione di elementi viene standardizzata tramite un controllo Fabric dedicato che guida gli utenti attraverso il processo. Questo controllo consente agli utenti di selezionare l'area di lavoro in cui viene creato l'elemento, assegnare etichette di riservatezza e configurare altre impostazioni pertinenti. Usando questa esperienza standardizzata, non è più necessario gestire le complessità della creazione di elementi manualmente o preoccuparsi delle modifiche future apportate al processo. Questo approccio consente inoltre di visualizzare la creazione di elementi direttamente all'interno della pagina del carico di lavoro, offrendo un'esperienza utente perfetta e integrata.

Usare la guida Come creare un elemento per comprendere come può essere implementata.

Supporto dell'API front-end

Con Extensibility Toolkit, è possibile ottenere un token di Microsoft Entra On-Behalf-Of (OBO) direttamente all'interno dell'applicazione front-end, abilitando l'accesso sicuro a qualsiasi API protetta da Entra. Questa funzionalità consente di integrare in modo approfondito i servizi di Microsoft Fabric, ad esempio è possibile leggere e archiviare i dati in OneLake, creare e interagire con altri elementi di Fabric o usare Spark come motore di elaborazione tramite le API Livey. Per altre informazioni, vedere la documentazione di Microsoft Entra, la documentazione di OneLake, le API REST di Fabric e Spark in Fabric.

Usare la guida Come acquisire il token Microsoft Entra per comprendere come può essere implementato. Usare anche la guida Come accedere alle API di Infrastruttura per comprendere come interagire con Fabric.

Archiviazione della definizione dell'elemento (stato) in Fabric

Questa funzionalità consente di archiviare i metadati dell'elemento, ad esempio la configurazione degli elementi e altre informazioni rilevanti, direttamente in OneLake all'interno di una cartella nascosta che non è visibile agli utenti finali. I dati vengono archiviati usando lo stesso formato applicato dalle API pubbliche e dai processi CI/CD, garantendo coerenza e interoperabilità tra diversi punti di integrazione. I dettagli sul formato e sul relativo uso con LE API pubbliche e CI/CD sono illustrati nelle sezioni seguenti.

Usare la definizione How to store Item (Come archiviare l'elemento ) per comprendere come può essere implementata.

Cosa archiviare nella definizione

Considerare lo stato come un elemento che contiene tutte le informazioni necessarie per ripristinare un elemento se viene eliminato o copiato altrove. Ciò non include i dati stessi, archiviati in OneLake (vedere Archiviazione dei dati degli elementi in OneLake).

Ecco alcuni esempi pratici:

• Elemento notebook: lo stato memorizza il codice e i metadati del notebook come l'ordine delle celle e il motore di esecuzione (ad esempio Spark, SQL). I dati effettivi elaborati dal notebook non vengono archiviati nello stato del sistema.
• Elemento dell'editor di file: lo stato non archivia il contenuto del file stesso, ma archivia la configurazione dell'editor, ad esempio combinazione di colori, impostazioni di completamento automatico, dimensioni del carattere e altre preferenze utente.
• Elemento del programma di installazione o dell'agente di orchestrazione: se l'elemento installa o effettua il provisioning di altri componenti (ad esempio database o risorse di calcolo), lo stato deve contenere riferimenti (ID, URI) agli elementi creati. In questo modo il carico di lavoro può controllarne lo stato o gestirlo in un secondo momento.

Concentrandosi sulla configurazione, sui metadati e sui riferimenti, si garantisce che lo stato dell'elemento sia portatile, leggero e facile da ripristinare o migrare.

Archiviazione dei dati degli elementi in OneLake

Ogni elemento include una propria cartella di elementi Onelake in cui gli sviluppatori possono archiviare dati strutturati e non strutturati. Analogamente a una Lakehouse , l'elemento ha una cartella Table in cui è possibile archiviare i dati in formato Delta o Iceberg e una cartella Files in cui è possibile archiviare i dati non strutturati.

Usare How to store data in Item (Come archiviare i dati in Item) per comprendere come può essere implementato.

Dati di scorciatoia

Poiché ogni elemento ha la propria cartella Onelake, può essere utilizzato anche con Shortcuts. Gli sviluppatori possono utilizzare il carico di lavoro dell'API pubblica Scorciatoia per creare diversi tipi di scorciatoie dai o verso i loro elementi per partecipare all'unica garanzia di copia da OneLake.

Usare il comando How to create shortcuts (Come creare collegamenti ) per comprendere come può essere implementato.

Supporto dell'API degli elementi CRUD

Gli utenti possono creare, aggiornare ed eliminare elementi con contenuto usando le API REST degli elementi Fabric standard. Questa abilitazione automatica semplifica notevolmente l'integrazione con gli elementi del carico di lavoro nello stesso modo degli elementi principali di Fabric, semplificando l'interoperabilità e riducendo il lavoro necessario per creare integrazioni affidabili.

Supporto CI/CD

Annotazioni

Il supporto CI/CD per Extensibility Toolkit è attualmente in fase di sviluppo. Le funzionalità descritte di seguito sono funzionalità pianificate e possono cambiare prima del rilascio.

Il supporto per CI/CD per tutti gli elementi è una delle richieste più elevate dai clienti. Con questa funzionalità, tutti gli elementi partecipano a CICD di default, senza la necessità di implementare logiche o operazioni specifiche. Ciò significa che è possibile automatizzare la distribuzione, i test e gli aggiornamenti per i carichi di lavoro usando Azure Pipelines e strumenti standard. Il formato e le API degli elementi sono progettati per essere completamente compatibili con i processi CI/CD, garantendo un'esperienza coerente e affidabile in tutti gli ambienti. Per altre informazioni sull'integrazione con CI/CD, vedere la documentazione di CiCD di Fabric.

API di notifica CRUD degli oggetti

Annotazioni

Il supporto dell'API di notifica CRUD per Extensibility Toolkit è attualmente in fase di sviluppo. Le funzionalità descritte di seguito sono funzionalità pianificate e possono cambiare prima del rilascio.

In alcuni casi il carico di lavoro deve partecipare agli eventi CRUD sugli elementi. Man mano che gli elementi vengono creati sulla piattaforma direttamente tramite l'esperienza utente, le API pubbliche o i proprietari del carico di lavoro CI/CD non sono in controllo quando viene creato un nuovo elemento su tali punti di ingresso. Per impostazione predefinita, gli elementi archiviano lo stato in Fabric e non devono essere informati sulla modifica dell'elemento. Esistono tuttavia alcuni casi in cui i carichi di lavoro devono partecipare al flusso CRUD. Questo è principalmente il caso se è necessario eseguire il provisioning o configurare l'infrastruttura per gli elementi, come i database, ad esempio. Per questi scenari, i partner possono implementare un'API di notifica Crud che Fabric chiama per ogni evento. In questo scenario, lo sviluppatore del carico di lavoro deve assicurarsi che l'API sia raggiungibile, in caso contrario le operazioni del Fabric hanno esito negativo.

Pianificatore di rete

Annotazioni

Il supporto della scheduler del Fabric per Extensibility Toolkit è attualmente in fase di sviluppo. Le funzionalità descritte di seguito sono funzionalità pianificate e possono cambiare prima del rilascio.

Fabric supporta la schedulazione dei job per i carichi di lavoro. Questa funzionalità consente agli sviluppatori di compilare carichi di lavoro che ricevono una notifica anche se l'utente non è davanti all'esperienza utente e agisce in base al processo che deve essere eseguito( ad esempio, copiare i dati in Onelake). I partner devono implementare un'API e configurare il carico di lavoro per partecipare a questa funzionalità.

Rilassamento delle impostazioni di iFrame

Gli sviluppatori possono richiedere più attributi iFrame per abilitare scenari avanzati, ad esempio download di file o apertura di siti Web esterni. Questa funzionalità consente al carico di lavoro di richiedere agli utenti il consenso esplicito prima di eseguire azioni che richiedono funzionalità più ampie del browser, ad esempio l'avvio di download o la connessione degli utenti alle API esterne usando le credenziali correnti di Fabric. Specificando questi requisiti nella configurazione del carico di lavoro, assicurarsi che gli utenti siano informati e possano concedere le autorizzazioni necessarie, abilitando l'integrazione senza problemi con sistemi esterni mantenendo al tempo stesso la sicurezza e l'attendibilità degli utenti.

Usare Come rilassare l'iFrame per capire come implementarlo.

Annotazioni

L'abilitazione di questa funzionalità richiede agli utenti di concedere un maggiore consenso a Microsoft Entra per l'ambito di allentamento, oltre all'ambito standard di Fabric necessario per la funzionalità di base dei carichi di lavoro.

Limitazioni delle funzionalità

Collegamento privato

Tutti i carichi di lavoro vengono bloccati per l'utilizzo e lo sviluppo se il collegamento privato è abilitato a livello di tenant o area di lavoro.