초기 수집 상태 가져오기
tsm maintenance metadata-services 명령을 사용하여 Tableau Metadata API를 사용하도록 설정한 후 Backfill API를 사용하여 초기 수집의 진행률을 모니터링하고 콘텐츠 및 계보 백필에 대한 상태 정보를 가져올 수 있습니다.
아래에 설명된 단계는 서버 관리자가 수행해야 하며, Tableau Catalog 사용 항목에서 7단계: 초기 수집 프로세스 모니터링 및 상태 확인과 함께 사용하는 것이 좋습니다.
1단계: REST API를 사용하여 인증
Backfill API에 액세스하려면 먼저 Tableau Server에 대해 인증하고 토큰을 가져와야 합니다. 이 작업은 Tableau REST API를 사용하여 수행할 수 있습니다. 자세한 내용은 REST API 도움말에서 로그인 및 로그아웃(인증)(링크가 새 창에서 열림)을 참조하십시오.
또는 관리자 자격 증명을 사용하여 Tableau Server에 로그인할 수 있습니다.
2단계: GET 요청 수행
다음 GET 요청을 수행하거나 URL을 브라우저에 붙여 넣습니다.
http://my_tableau_server/api/metadata/v1/control/backfill/status
요청은 처음에 콘텐츠 백필에 대한 정보를 반환합니다. 콘텐츠 백필이 완료되면 계보 백필 정보가 반환됩니다.
- 콘텐츠 백필의 경우 요청은 Tableau Server에서 사용할 수 있는 콘텐츠에 따라 각 콘텐츠 유형에 대한 상태 요약 및 추가 상태 정보를 반환합니다. 각 콘텐츠 유형에 대한 인덱싱은 동시에 발생합니다.
- 계보 백필의 경우 요청은 상태 요약을 반환합니다.
응답의 상태 값
Backfill API는 다음 값을 반환합니다.
contentBackfillTotalDurationSeconds및lineageBackfillTotalDurationSeconds는 해당 백필 유형의 진행된 시간(초)입니다.backfillComplete가true이면contentBackfillTotalDurationSeconds및lineageBackfillTotalDurationSeconds는 해당 백필 유형을 완료하는 데 소요된 총 시간입니다.
콘텐츠 백필의 경우:
contentType은PublishedDatasource,Database,DatabaseTable,Metric,Workbook및Flow콘텐츠 유형을 표시할 수 있습니다.contentId는 마지막 인덱싱된 항목의 식별자입니다.successfullyIngestedCount는 성공적으로 인덱싱된 항목 수입니다.failedIngestedCount는 인덱싱할 수 없는 항목 수입니다.durationSeconds는 콘텐츠 유형에 대한 항목을 인덱싱하는 데 걸린 시간(초)입니다.totalCount는 인덱싱할 항목의 총 수입니다.checkpointCreatedTime은 항목이 인덱싱된 마지막 기록 시간(UTC)입니다. Backfill API는 5분마다 마지막으로 인덱싱된 항목을 확인합니다.- 콘텐츠 유형의 모든 항목에 대해 인덱싱이 완료되면
backfillComplete가true입니다.
계보 백필의 경우:
totalCount는 인덱싱할 계보 관계의 총 수입니다.processedCount는 인덱싱된 계보 관계의 수입니다.lastLineageConnection은 마지막으로 인덱싱된 계보 관계입니다.backfillComplete는 모든 계보 관계에 대한 인덱싱이 완료되면true입니다.
예제 응답
요청은 JSON 텍스트를 반환합니다. JSON을 더 읽기 쉬운 형식으로 보려면 JSON 뷰어 또는 브라우저 추가 기능을 사용할 수 있습니다.
{ "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
}
}