---
schema_version: "1"
id: 271128a22e0c54850442bce3d00760302616f16cb95adb8493a46d3da207b3ee
title: 初期取り込みステータスの取得
collection: tableau
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/tableau/current/ja-jp/server/dm_tools_backfill.md
canonical_url: https://help.tableau.com/current/server/ja-jp/dm_tools_backfill.htm
source_site: help.tableau.com
content_type: documentation
content_hash: e1614c535a8bb49b26159a6c8f856032b8e323620eec77fe2aa3d623d649fe61
description: Use the Backfill API to monitor initial Metadata API ingestion status for content and lineage.
---
[メイン コンテンツに進む](#main-content)

# 初期取り込みステータスの取得

`tsm maintenance metadata-services` コマンドを使用して Tableau メタデータ API を有効にした後、バックフィル API を使用して初期取り込みの進行状況を監視し、コンテンツと系列のバックフィルのステータス情報を取得できます。

以下に説明する手順は、サーバー管理者が実行する必要があり、「Tableau Catalog の有効化」トピックの[ステップ 7: 初期取り込みの進行状況を監視し、その状態を検証する](https://help.tableau.com/current/server/ja-jp/dm_catalog_enable.htm#step7)と組み合わせて使用することをお勧めします。

## ステップ 1: REST API を使用して認証する

バックフィル 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 で使用可能なコンテンツに応じて、各コンテンツ タイプのステータスの概要と追加のステータス情報を返します。各コンテンツ タイプのインデックス作成は同時に実行されます。
- 系列のバックフィルの場合、リクエストはステータスの概要を返します。

### 応答のステータス値

以下の値は、バックフィル API によって返されます。

- `contentBackfillTotalDurationSeconds` と `lineageBackfillTotalDurationSeconds` は、それぞれのバックフィル タイプでどれくらい時間が経過したかを秒単位で示します。`backfillComplete` が `true` の場合、`contentBackfillTotalDurationSeconds` と `lineageBackfillTotalDurationSeconds` は、それぞれのバックフィル タイプの完了にかかった合計時間を示します。

コンテンツのバックフィルの場合: 

- `contentType` は、コンテンツ タイプ `PublishedDatasource`、`Database`、`DatabaseTable`、`Metric`、`Workbook`、および `Flow` を示します。
- `contentId` は、最後にインデックス化されたアイテムの識別子です。
- `successfullyIngestedCount`は、正常にインデックス化されたアイテムの数です。
- `failedIngestedCount`は、インデックス化できなかったアイテムの数です。
- `durationSeconds`は、コンテンツ タイプのアイテムのインデックス化に費やされた時間 (秒単位) です。
- `totalCount` は、インデックス化するアイテムの総数です。
- `checkpointCreatedTime` は、アイテムのインデックス化が最後に記録された日時 (UTC) です。バックフィル 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

    }

}