---
schema_version: "1"
id: 3b61ebd2272f8abbf7a664425dbe921ba286b45dd03fe625924d9ef1f876fa06
title: 초기 수집 상태 가져오기
collection: tableau
version: current
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/current/ko-kr/server-linux/dm_tools_backfill.md
canonical_url: https://help.tableau.com/current/server-linux/ko-kr/dm_tools_backfill.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 04f8c4d6fe2952c96e26e202c8496219065fb5118032668e2b98be031c10e3bb
description: Use the Backfill API to monitor initial Metadata API ingestion status for content and lineage.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# 초기 수집 상태 가져오기

`tsm maintenance metadata-services` 명령을 사용하여 Tableau Metadata API를 사용하도록 설정한 후 Backfill API를 사용하여 초기 수집의 진행률을 모니터링하고 콘텐츠 및 계보 백필에 대한 상태 정보를 가져올 수 있습니다.

아래에 설명된 단계는 서버 관리자가 수행해야 하며, Tableau Catalog 사용 항목에서 [7단계: 초기 수집 프로세스 모니터링 및 상태 확인](https://help.tableau.com/current/server-linux/ko-kr/dm_catalog_enable.htm#step7)과 함께 사용하는 것이 좋습니다.

## 1단계: REST API를 사용하여 인증

Backfill API에 액세스하려면 먼저 Tableau Server에 대해 인증하고 토큰을 가져와야 합니다. 이 작업은 Tableau REST API를 사용하여 수행할 수 있습니다. 자세한 내용은 REST API 도움말에서 [로그인 및 로그아웃(인증)](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm)을 참조하십시오.

또는 관리자 자격 증명을 사용하여 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

    }

}