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는 다음 값을 반환합니다.

  • contentBackfillTotalDurationSecondslineageBackfillTotalDurationSeconds는 해당 백필 유형의 진행된 시간(초)입니다. backfillCompletetrue이면 contentBackfillTotalDurationSecondslineageBackfillTotalDurationSeconds는 해당 백필 유형을 완료하는 데 소요된 총 시간입니다.

콘텐츠 백필의 경우: 

  • contentTypePublishedDatasource, Database, DatabaseTable, Metric, WorkbookFlow 콘텐츠 유형을 표시할 수 있습니다.
  • contentId는 마지막 인덱싱된 항목의 식별자입니다.
  • successfullyIngestedCount는 성공적으로 인덱싱된 항목 수입니다.
  • failedIngestedCount는 인덱싱할 수 없는 항목 수입니다.
  • durationSeconds는 콘텐츠 유형에 대한 항목을 인덱싱하는 데 걸린 시간(초)입니다.
  • totalCount는 인덱싱할 항목의 총 수입니다.
  • checkpointCreatedTime은 항목이 인덱싱된 마지막 기록 시간(UTC)입니다. Backfill API는 5분마다 마지막으로 인덱싱된 항목을 확인합니다.
  • 콘텐츠 유형의 모든 항목에 대해 인덱싱이 완료되면 backfillCompletetrue입니다.

계보 백필의 경우:

  • 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

}

}

피드백을 제공해 주셔서 감사합니다!