Skip to content
Last updated

ビルドのステータスの取得

特定のデータモデルとビルドIDを使用してAPIを呼び出すことで、ビルドのステータスを確認できます。

前提条件

特定のビルドのステータスを表示する

GETメソッドを使用して、特定のビルドのステータスを表示します。

curl -X GET https://${TD_API_ENDPOINT}/reporting/datamodels/ae9e7e75-9651-4d4d-afec-f7ac58b773c6/builds/5d7f0255-9e62-49ce-a4ea-36a2524d9447 \
-H 'authorization: TD1 xxxx/xxxxxxxxxxxxxx' \
-H 'accept: application/json'

特定のデータモデルに関連付けられたビルドを表示する

特定のデータモデルに関連付けられたビルドを取得できます。

curl -X GET https://${TD_API_ENDPOINT}/reporting/datamodels/xxxxxx/builds \
-H 'authorization: TD1 xxxx/xxxxxxxxxxxxxx' \
-H 'accept: application/json'

可能なビルドステータス

Treasure Insightsは、ビルドをクエリすると次のいずれかの状態を報告します。これらを使用して、追加のアクションが必要かどうかを判断します。

  • pending — ジョブはキューに入っていますが、まだ実行されていません。
  • building — ビルドは現在実行中です。
  • done — ビルドが正常に完了しました。
  • failed — ビルドは完了しましたが、エラーが発生したため注意が必要です。
  • canceled — ビルドは完了前に意図的に停止されました。

ビルドエラー

ビルドの失敗が発生した場合、メモリ使用量が割り当てられたビルドサイズ制限を超えている可能性があります。制限に対処するには、データ量を削減するか、カスタマーサポート担当者に連絡してください。

ダッシュボードのinsightsモデルエリアのResource Entitlementsでリソース制限を表示できます。

クエリエラー

ダッシュボードをロードできても、高いリソース負荷が発生する場合、データモデルのクエリ時にエラーが表示される可能性があります。

データモデルのクエリ時にエラーが発生した場合、次の解決策を試すことができます:

  • ウィジェットを削減する
  • データ量を削減する
  • カスタマーサポート担当者に連絡する。

ビルドおよびクエリリソースサイズの表示

すべてのデータモデル、ビルド、およびダッシュボード/クエリには、RAMとCPUの一定の上限が関連付けられているため、データモデルのビルドがその制限を超えると、ユーザーにエラーが表示されます。

指定されたアカウントIDでGETメソッドを使用して、GBでのクエリとダッシュボードの制限を表示し、特にbuild_sizeとquery_sizeの値に関するレスポンスに注意してください。同様に、ユーザーはUIでこの情報を表示できます。

curl -X GET https://${TD_API_ENDPOINT}/reporting/xxxxxx
-H 'authorization: TD1 xxxx/xxxxxxxxxxxxxx' \
-H 'cache-control: no-cache' \
-H 'accept: application/json'

特定のデータモデルに関連付けられたビルドのテスト

特定のデータモデルに関連付けられたビルドをテストすることもできます。

curl -X GET -H 'Authorization: TD1 xxxx' http://${TD_API_ENDPOINT}/reporting/datamodels/b61d7523-3655-4b8c-bc69-48f7f68a5314/builds/17e374e4-8267-4fbb-be92-d87aa5823c32
{"oid":"17e374e4-8267-4fbb-be92-d87aa5823c32","buildType":"full","status":"done","created":"2022-06-30T08:36:21.749+00:00","started":"2022-06-30T08:36:21.754+00:00","completed":"2022-06-30T08:37:01.224+00:00"}
curl -X GET -H 'Authorization: TD1 xxxx' http://<api endpoint>/reporting/datamodels/b61d7523-3655-4b8c-bc69-48f7f68a5314/builds
[{"oid":"17e374e4-8267-4fbb-be92-d87aa5823c32","buildType":"full","status":"done","created":"2022-06-30T08:36:21.749Z","started":"2022-06-30T08:36:21.754Z","completed":"2022-06-30T08:37:01.224Z"},{"oid":"978c2a7a-fc1f-489c-aae4-fcdc037fd46c","buildType":"full","status":"done","created":"2022-07-20T02:20:01.217Z","started":"2022-07-20T02:20:01.226Z","completed":"2022-07-20T02:20:41.920Z"}]