Status eerste opname ophalen

Nadat u de Tableau Metadata API hebt ingeschakeld met behulp van de opdracht tsm maintenance metadata-services, kunt u de Backfill API gebruiken om toezicht te houden op de voortgang van de initiële opname en om statusinformatie te verkrijgen voor inhoud- en herkomstbackfills.

De hieronder beschreven stappen moeten worden uitgevoerd door een serverbeheerder en kunnen het beste worden uitgevoerd in combinatie met Stap 7: de voortgang van de initiële opname monitoren en de status ervan valideren in het onderwerp Tableau Catalog inschakelen.

Stap 1: Verifiëren met gebruik van de REST API

U dient u te verifiëren bij Tableau Server en een token te ontvangen om toegang te krijgen tot de Backfill API. U kunt dit doen met behulp van de Tableau REST API. Zie Aan- en afmelden (verificatie)(Link wordt in een nieuw venster geopend) in de Help bij de REST API voor meer informatie.

U kunt u ook met uw beheerdersreferenties aanmelden bij Tableau Server.

Stap 2: Een GET-verzoek opstellen

Maak het volgende GET-verzoek of plak de URL in uw browser:

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

Het verzoek retourneert in eerste instantie informatie over de inhoudbackfill. Wanneer de inhoudbackfill voltooid is, wordt informatie over de herkomstbackfill geretourneerd.

  • Voor de inhoudbackfill retourneert het verzoek een statussamenvatting en aanvullende statusinformatie voor elk inhoudstype, afhankelijk van welke inhoud beschikbaar is op Tableau Server. Indexering gebeurt voor elk inhoudstype gelijktijdig.
  • Voor de herkomstbackfill retourneert het verzoek een statussamenvatting.

Statuswaarden uit het antwoord

De volgende waarden worden geretourneerd door de Backfill API.

  • contentBackfillTotalDurationSeconds en lineageBackfillTotalDurationSeconds geven aan hoeveel tijd er in seconden is verstreken op het desbetreffende type backfill. Wanneer backfillComplete true is contentBackfillTotalDurationSeconds en lineageBackfillTotalDurationSeconds de totale tijd is die nodig is om het betreffende type backfill te voltooien.

Voor inhoudbackfill: 

  • contentType kan de volgende inhoudstypen weergeven: PublishedDatasource, Database, DatabaseTable, Metric, Workbook en Flow.
  • contentId is de identificatiecode van het laatst geïndexeerde item.
  • successfullyIngestedCount is het aantal items dat is geïndexeerd.
  • failedIngestedCount is het aantal items dat niet kan worden geïndexeerd.
  • durationSeconds is de tijd, in seconden, die nodig is om items voor het inhoudstype te indexeren.
  • totalCount is het totale aantal items dat geïndexeerd moet worden.
  • checkpointCreatedTime is de laatste geregistreerde tijd, in UTC, waarop een item is geïndexeerd. De Backfill API controleert elke vijf minuten op het laatst geïndexeerde item.
  • backfillComplete is true wanneer de indexering voor alle items van het inhoudstype voltooid is.

Voor herkomstbackfill:

  • totalCount is het totale aantal herkomstrelaties dat geïndexeerd moet worden.
  • processedCount is het aantal geïndexeerde herkomstrelaties.
  • lastLineageConnection is de laatste geïndexeerde herkomstrelatie.
  • backfillComplete is true wanneer de indexering voor alle herkomstrelaties voltooid is.

Voorbeeldreactie

Het verzoek retourneert JSON-tekst. Als u de JSON in een beter leesbaar formaat wilt bekijken, kunt u een JSON-viewer of browseradd-on gebruiken.

{        

"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

}

}

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.