Condividi tramite


Eseguire l'analisi dei metadati

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

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

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

Importante

L'app sviluppata per l'analisi può eseguire l'autenticazione usando un token di accesso amministratore delegato 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 necessarie per l'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 aree di lavoro/modificate 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 le aree di lavoro condivise. Se si desidera escludere le aree di lavoro personali dall'analisi, usare il parametro excludePersonalWorkspaces delle aree di lavoro/modificato.

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 più di 16 chiamate possono essere effettuate 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 di aver abilitato tutte le opzioni di amministrazione pertinenti.

Usare l'URI dall'intestazione della posizione ricevuta dalla chiamata di 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 di workspaces/scanStatus/{scan-id} e leggere i dati usando 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 alle aree di lavoro/getInfo .

Passaggio 2: Eseguire un'analisi incrementale

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

Chiamare le aree di lavoro/modificate 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 per una data negli 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 intrapresa una sorta di azione sul modello semantico, ad esempio un utente che crea un report sopra di esso, un utente che visualizza un report basato su di esso e così via.
  • I set di dati in tempo reale, i modelli semantici con sicurezza a livello di oggetto, i modelli semantici con una 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 i 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, incluso quello degli elementi che si trovano in aree di lavoro non Premium.