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
enlineageBackfillTotalDurationSeconds
geven aan hoeveel tijd er in seconden is verstreken op het desbetreffende type backfill. WanneerbackfillComplete
true
iscontentBackfillTotalDurationSeconds
enlineageBackfillTotalDurationSeconds
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
enFlow
.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
istrue
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
istrue
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
}
}