Après avoir activé l’API Tableau Metadata à l’aide de la commande tsm maintenance metadata-services, vous pouvez utiliser l’API Backfill pour surveiller l’avancement de l’ingestion initiale et obtenir des informations d’état pour les renvois de contenu et de lignage.

Les étapes décrites ci-dessous doivent être effectuées par un administrateur de serveur et doivent de préférence être utilisées conjointement avec Étape 7 : Surveiller l'avancement de l'ingestion initiale et valider son statut dans la rubrique Activer Tableau Catalog.

Étape 1 : S’authentifier à l’aide de l’API REST

Pour accéder à l’API Backfill, vous devez d’abord vous authentifier sur Tableau Server et obtenir un jeton. Vous pouvez le faire à l’aide de l’API REST de Tableau. Pour plus d’informations, voir Connexion et déconnexion (Authentification)(Le lien s’ouvre dans une nouvelle fenêtre) dans l’aide de l’API REST.

Sinon, vous pouvez vous connecter à Tableau Online à l'aide de vos identifiants d'administrateur.

Étape 2 : Émettre une demande GET

Émettez la demande GET suivante ou collez l’URL dans votre navigateur :

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

La demande renvoie d’abord des informations sur le renvoi du contenu. Une fois le renvoi de contenu terminé, les informations de renvoi du lignage sont retournées.

  • Pour le renvoi de contenu, la demande renvoie un résumé d’état et des informations d’état supplémentaires pour chaque type de contenu en fonction du contenu disponible sur Tableau Server. L’indexation pour chaque type de contenu a lieu dans le même temps.
  • Pour le renvoi de lignage, la demande retourne un résumé d’état.

Valeurs d’état de la réponse

Les valeurs suivantes sont renvoyées par l’API Backfill.

  • contentBackfillTotalDurationSeconds et lineageBackfillTotalDurationSeconds indiquent la durée écoulée, en secondes, pour le type de renvoi respectif. Lorsque backfillComplete est true, contentBackfillTotalDurationSeconds et lineageBackfillTotalDurationSeconds indiquent la durée totale écoulée pour mener à bien le type de renvoi respectif.

Pour le renvoi de contenu : 

  • contentType peut afficher les types de contenu suivants : PublishedDatasource, Database, DatabaseTable, Metric, Workbook et Flow.
  • contentId est l’identificateur du dernier élément indexé.
  • successfullyIngestedCount indique le nombre d’éléments indexés avec succès.
  • failedIngestedCount indique le nombre d’éléments qui n’ont pas pu être indexés.
  • durationSeconds correspond au temps passé, en secondes, à indexer les éléments pour le type de contenu.
  • totalCount est le nombre total d’éléments à indexer.
  • checkpointCreatedTime est la dernière occurrence enregistrée, au format UTC, de l’indexation d’un élément. L’API Backfill recherche le dernier élément indexé toutes les cinq minutes.
  • backfillComplete est true lorsque l’indexation est terminée pour tous les éléments du type de contenu.

Pour le renvoi de lignage :

  • totalCount est le nombre total de relations de lignage à indexer.
  • processedCount est le nombre de relations de lignage indexées.
  • lastLineageConnection est la dernière relation de lignage indexée.
  • backfillComplete est true lorsque l’indexation est terminée pour toutes les relations de lignage.

Exemple de réponse

La demande retourne le texte JSON. Pour afficher le texte JSON dans un format plus lisible, vous pouvez utiliser une visionneuse JSON ou un module complémentaire de navigateur.

{        

"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

}

}

Merci de vos commentaires !