オブジェクトコンテキスト

このドキュメントでは、データの管理と検出に役立てるために、オブジェクトコンテキストを使用してオブジェクトにコンテキスト情報を追加する方法について説明します。

オブジェクトコンテキストを追加して管理する方法については、オブジェクトコンテキストを使用するをご覧ください。

概要

オブジェクトコンテキストを使用すると、説明情報を Key-Value ペアとして Cloud Storage オブジェクトに追加できます。オブジェクトにコンテキストを埋め込むと、データの分類、追跡、検索の方法を改善できます。コンテキストは、新しいオブジェクトを作成するとき、または既存のオブジェクトにコンテキストを追加するときに適用できます。

たとえば、請求書オブジェクトをアップロードするときに、customer_id コンテキストと payment_status コンテキストを追加して拡充できます。

{
  "contexts": {
    "custom": {
      "customer_id": {
        "value": "cust-78901"
      },
      "payment_status": {
        "value": "unpaid"
      }
    }
  }
}

オブジェクトコンテキストのユースケース

オブジェクトコンテキストを使用すると、データを分類、追跡、拡充できます。以降のセクションでは、オブジェクトコンテキストを使用してさまざまな種類の情報を管理するシナリオについて説明します。

オブジェクトをグループ化して分類する

バケット間やプロジェクト間でオブジェクトを分類して整理します。コンテキストを使用して、データセットの出所、所有者、コストセンターなどの属性別にデータにタグを付けます。

例 1: コンプライアンスポリシーで処理できるように、個人を特定できる情報（PII）を含むオブジェクトにコンテキスト data_classification: PII を割り当てます。
例 2: batch_id: 2025_Q4_Model_Run コンテキストを割り当てて、取り込み中に新しいトレーニング画像をグループ化し、モデルの効率的なテストと取得を可能にします。

ワークフローを追跡する

カスタムワークフローを最適化し、冗長なオペレーションを防ぐために、ワークフローの状態情報をオブジェクトに直接埋め込み、処理パイプラインにおけるオブジェクトのジャーニーを追跡します。

例 1: processing_status: awaiting_review を使用して、外部リリース承認待ちのオブジェクトを示します。
例 2: processed_by: analytics_pipeline を使用して、あるステージを完了したファイルをカスタムデータ処理サービスが再スキャンしないようにします。

アプリケーション固有のコンテキストでオブジェクトを拡充する

アプリケーションやビジネスプロセスに関する特定の情報を追加して、各オブジェクトの追加コンテキストとデータリネージを提供します。

例 1: 衛星画像について、capture_angle: 45deg_NW などのキャプチャの詳細を記録するか、lineage: ingested_from_s3 でファイルの履歴を追跡します。
例 2: document_type: service_manual や