Condividi tramite

Eseguire l’analisi dei metadati

  • Articolo

La procedura dettagliata seguente illustra come usare le API scanner per recuperare i metadati dagli elementi di Fabric dell'organizzazione. Si presuppone che un amministratore di Fabric abbia configurato l'analisi dei metadati nell'organizzazione.

Per l’elenco degli artefatti e dei metadati subartifact restituiti dall'analisi dei metadati, vedere la documentazione relativa all'API GetScanResult WorkspaceInfo - amministratore.

Di seguito sono riportate le API scanner. Supportano cloud pubblici e sovrani.

Importante

L'app sviluppata per l'analisi può eseguire l'autenticazione usando un token di accesso amministratore con delega standard o un'entità servizio. I due percorsi di autenticazione si escludono a vicenda. Durante l'esecuzione in un'entità servizio, nell'app non devono essere impostate autorizzazioni che necessitano del consenso dell’amministratore di Power BI. Per altre informazioni, vedere Abilitare l'autenticazione dell'entità servizio per le API di amministrazione di sola lettura.

Passaggio 1: Eseguire un'analisi completa

Chiamare workspaces/modified senza il parametro modifiedSince per ottenere l'elenco completo degli ID dell'area di lavoro nel tenant. Questa analisi recupera tutte le aree di lavoro nel tenant, incluse le aree di lavoro personali e quelle condivise. Se si desidera escludere le aree di lavoro personali dall'analisi, usare il parametro workspaces/modified excludePersonalWorkspaces.

Dividere l'elenco in blocchi di 100 aree di lavoro al massimo.

Per ogni blocco di 100 aree di lavoro:

Chiamare aree di lavoro/getInfo per attivare una chiamata di analisi per queste 100 aree di lavoro. Si riceverà il valore scanId nella risposta da usare nei passaggi successivi. Nell'intestazione della posizione si riceverà anche l'URI (Uniform Resource Identifier) da chiamare per il passaggio successivo.

Nota

Non è possibile effettuare più di 16 chiamate contemporaneamente. Il chiamante deve attendere una risposta di esito positivo/negativo dell'analisi dall'API scanStatus prima di richiamare un'altra chiamata.

Se alcuni metadati che si prevede di ricevere non vengono restituiti, rivolgersi all'amministratore di Fabric per assicurarsi che siano abilitate tutte le opzioni di amministrazione pertinenti.

Usare l'URI dall'intestazione della posizione ricevuta dalla chiamata aree di lavoro/getInfo ed eseguire il polling su aree di lavoro/scanStatus/{scan_id} fino a quando lo stato restituito non è "Succeeded". Questo stato indica che il risultato dell'analisi è pronto. È consigliabile usare un intervallo di polling di 30-60 secondi. Nell'intestazione della posizione si riceve anche l'URI da chiamare nel passaggio successivo. Usarlo solo dopo che lo stato è "Succeeded".

Usare l'URI dall'intestazione della posizione ricevuta dalla chiamata aree di lavoro/scanStatus/{scan_id} e leggere i dati tramite workspaces/scanResult/{scan_id}. I dati contengono l'elenco di aree di lavoro, informazioni sugli elementi e altri metadati in base ai parametri passati nella chiamata workspaces/getInfo.

Passaggio 2: Eseguire un'analisi incrementale

Ora che sono disponibili tutte le aree di lavoro, i metadati e la derivazione degli asset, è consigliabile eseguire solo analisi incrementali che fanno riferimento all'analisi eseguita in precedenza.

Chiamare workspaces/modified con il parametro modifiedSince impostato sull'ora di inizio dell'ultima analisi per ottenere le aree di lavoro modificate e che richiedono quindi un'altra analisi. Il parametro modifiedSince deve essere impostato con una data relativa agli ultimi 30 giorni.

Dividere questo elenco in blocchi di un massimo di 100 aree di lavoro e ottenere i dati per queste aree di lavoro modificate usando le tre chiamate API, workspaces/getInfo, workspaces/scanStatus/{scan_id} e workspaces/scanResult/{scan_id}, come descritto nel passaggio 1.

Considerazioni e limitazioni

  • I modelli semantici che non sono stati aggiornati o ripubblicati verranno restituiti nelle risposte API, ma senza le relative informazioni ed espressioni subartifact. Ad esempio, il nome del modello semantico e la derivazione sono inclusi nella risposta, ma non i nomi di tabella e colonna del modello semantico.
  • I modelli semantici contenenti solo le tabelle DirectQuery restituiscono metadati subartifact solo se è stata eseguita una sorta di azione sul modello semantico, ad esempio se un utente crea un report su di esso, se un utente visualizza un report basato su di esso e così via.
  • I set di dati in tempo reale, i modelli semantici con protezione a livello di oggetto, i modelli semantici con connessione dinamica ad AS-Azure e AS in locale e i set di dati con fedeltà completa di Excel non sono supportati per i metadati subartifact. Per i set di dati non supportati, la risposta restituisce il motivo per cui non si ottengono metadati subartifact dal set di dati. Si trova in un campo denominato schemaRetrievalError, ad esempio schemaRetrievalError: richiesta non supportata. Il set di dati RealTime non è supportato.
  • L'API non restituisce metadati subartifact per i modelli semantici di dimensioni superiori a 1 GB nelle aree di lavoro condivise. Nelle aree di lavoro Premium non esiste alcuna limitazione delle dimensioni per i modelli semantici.

Licenze

L'analisi dei metadati non richiede alcuna licenza speciale. Funziona per tutti i metadati del tenant, inclusi quelli degli elementi che si trovano in aree di lavoro non Premium.

Contenuto correlato