Guida di Tableau Server su Windows

Dopo aver abilitato l’API dei metadati di Tableau tramite il comando tsm maintenance metadata-services, puoi usare l’API di backfill per monitorare lo stato di avanzamento dell’inserimento iniziale e ottenere informazioni sullo stato per i backfill del contenuto e della derivazione.

La procedura descritta di seguito deve essere eseguita da un amministratore del server ed è consigliabile utilizzarla in combinazione con le informazioni fornite nell’argomento Fase 7. Monitorare l’avanzamento dell’inserimento iniziale e convalidarne lo stato.

Fase 1: eseguire l’autenticazione tramite l’API REST

Per accedere all’API di backfill, è innanzitutto necessario eseguire l’autenticazione in Tableau Server e ottenere un token. Puoi eseguire questa operazione usando l’API REST di Tableau. Per maggiori informazioni, consulta Accesso e disconnessione (autenticazione)(Il collegamento viene aperto in una nuova finestra) nella Guida dell’API REST.

In alternativa, puoi accedere a Tableau Server tramite le tue credenziali di amministrazione.

Fase 2: eseguire una richiesta GET

Esegui la seguente richiesta GET o incolla l’URL nel browser:

http://my_tableau_server/api/metadata/v1/control/backfill/status

La richiesta inizialmente restituisce le informazioni sul backfill del contenuto. Al termine del backfill del contenuto, vengono restituite le informazioni sul backfill della derivazione.

• Per il backfill del contenuto, la richiesta restituisce un riepilogo dello stato e informazioni aggiuntive sullo stato per ogni tipo di contenuto, a seconda del contenuto disponibile in Tableau Server. L’indicizzazione per ogni tipo di contenuto viene eseguita contemporaneamente.
• Per il backfill della derivazione, la richiesta restituisce un riepilogo dello stato.

Valori di stato nella risposta

I valori seguenti vengono restituiti dall’API di backfill.

• contentBackfillTotalDurationSeconds e lineageBackfillTotalDurationSeconds indicano quanto tempo è trascorso, in secondi, per il rispettivo tipo di backfill. Quando backfillComplete è true, contentBackfillTotalDurationSeconds e lineageBackfillTotalDurationSeconds indicano il tempo totale impiegato per completare il rispettivo backfill.

Per il backfill del contenuto: 

• contentType può visualizzare i seguenti tipi di contenuto: PublishedDatasource, Database, DatabaseTable, Metric, Workbook e Flow.
• contentId è l’identificatore dell’ultimo elemento indicizzato.
• successfullyIngestedCount è il numero di elementi indicizzati correttamente.
• failedIngestedCount è il numero di elementi che non è stato possibile indicizzare.
• durationSeconds è il tempo impiegato, in secondi, per indicizzare gli elementi per il tipo di contenuto.
• totalCount è il numero totale di elementi da indicizzare.
• checkpointCreatedTime è l’ora dell’ultima registrazione, in UTC, dell’indicizzazione di un elemento. L’API di backfill controlla l’ultimo elemento indicizzato ogni cinque minuti.
• backfillComplete è true quando l’indicizzazione è completa per tutti gli elementi del tipo di contenuto.
  

Per il backfill della derivazione:

• totalCount è il numero totale di relazioni di derivazione da indicizzare.
• processedCount è il numero di relazioni di derivazione indicizzate.
• lastLineageConnection è l’ultima relazione di derivazione indicizzata.
• backfillComplete è true quando l’indicizzazione è completa per tutte le relazioni di derivazione.

Risposta di esempio

La richiesta restituisce testo JSON. Per visualizzare il codice JSON in un formato più leggibile, puoi usare un visualizzatore JSON o un componente aggiuntivo del browser.

{        
  "contentBackfillTotalDurationSeconds": 362,
  "lineageBackfillTotalDurationSeconds": 14,
  "contentBackfillStatuses": [
    {
	"contentType": "PublishedDatasource",
	"contentId": "sites/1/datasources/-631379806-1912815680",
	"successfullyIngestedCount": 20,
	"failedToIngestCount": 0,
	"durationSeconds": 312,
	"totalCount": 20,
	"checkpointCreatedTime": "2020-07-29T23:50:25.763Z",
	"backfillComplete": true
    },
    {
	"contentType": "Database",
	"contentId": "sites/1/databases/e1331f9d-4d73-ee04-9edf-96fd1c37cb8e",
	"successfullyIngestedCount": 35,
	"failedToIngestCount": 0,
	"durationSeconds": 26,
	"totalCount": 35,
	"checkpointCreatedTime": "2020-04-29T23:50:25.769Z",
	"backfillComplete": true
    },
    {
	"contentType": "DatabaseTable",
	"contentId": "sites/1/tables/d946d084-53a8-09b6-2ad2-93301e6b4b15",
	"successfullyIngestedCount": 64,
	"failedToIngestCount": 0,
	"durationSeconds": 49,
	"totalCount": 64,
	"checkpointCreatedTime": "2020-04-29T23:50:25.774Z",
	"backfillComplete": true
    },
    {
	"contentType": "Metric",
	"contentId": "sites/1/metrics/metric1",
	"successfullyIngestedCount": 2,
	"failedToIngestCount": 0,
	"durationSeconds": 254,
	"totalCount": 2,
	"checkpointCreatedTime": "2020-04-29T23:50:25.779Z",
	"backfillComplete": true
    },
    {
	"contentType": "Workbook",
	"contentId": "sites/1/workbooks/6749399-1501801290",
	"successfullyIngestedCount": 10,
	"failedToIngestCount": 0,
	"durationSeconds": 267,
	"totalCount": 10,
	"checkpointCreatedTime": "2020-04-29T23:50:25.784Z",
	"backfillComplete": true
    },
    {
	"contentType": "Flow",
	"contentId": "sites/1/flows/4",
	"successfullyIngestedCount": 4,
	"failedToIngestCount": 0,
	"durationSeconds": 195,
	"totalCount": 4,
	"checkpointCreatedTime": "2020-04-29T23:50:25.788Z",
	"backfillComplete": true
    }
   ],
  "lineageBackfillStatus": {
	"totalCount": 45,
	"processedCount": 18,
	"lastLineageConnection": "CloudFile downstreamWorkbooks Workbook",
	"backfillComplete": false
    }
}