Knowledge Catalog リソースの名前付けに関するガイドライン

Google Cloud リソースは、 内で作成または使用するコンポーネントです。Google Cloudこれらのリソースは、 プラットフォームで実行されるアプリケーションとシステムの構成要素となります。

一般的な Google Cloud リソースの命名規則について詳しくは、リソース名をご覧ください。

リソース名の形式

次の表に、Knowledge Catalog リソースの完全なリソース名の形式を示します。

リソース 完全なリソース名の形式
エントリ グループ projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}
エントリ projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}/entries/{ENTRY_ID}
エントリタイプ projects/{PROJECT_ID}/locations/{LOCATION}/entryTypes/{ENTRY_TYPE_ID}
アスペクト タイプ projects/{PROJECT_ID}/locations/{LOCATION}/aspectTypes/{ASPECT_TYPE_ID}
エントリ リンク projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}/entryLinks/{ENTRY_LINK_ID}
メタデータ ジョブ projects/{PROJECT_ID}/locations/{LOCATION}/metadataJobs/{METADATA_JOB_ID}
メタデータ フィード projects/{PROJECT_ID}/locations/{LOCATION}/metadataFeeds/{METADATA_FEED_ID}
用語集 projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}
用語集カテゴリ projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}/categories/{GLOSSARY_CATEGORY_ID}
用語集の用語 projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}/terms/{GLOSSARY_TERM_ID}
データ プロダクト projects/{PROJECT_ID}/locations/{LOCATION}/dataProducts/{DATA_PRODUCT_ID}
データドメイン projects/{PROJECT_ID}/locations/{LOCATION}/dataDomains/{DATA_DOMAIN_ID}
リネージ プロセス projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}
リネージ実行 projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}/runs/{RUN_ID}
リネージ イベント projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}/runs/{RUN_ID}/lineageEvents/{LINEAGE_EVENT_ID}

リソース名のコンポーネント

以降のセクションでは、各コンポーネントについて説明します。

プロジェクト ID

値は、プロジェクト ID またはプロジェクト番号にする必要があります。これは、 コンソール Google Cloud から取得できます。たとえば、my-cool-project はプロジェクト ID で、123456789123 はプロジェクト番号です。

ロケーション

値は、サポートされている Knowledge Catalog のロケーションのいずれかにする必要があります。 使用可能なロケーションの一覧については、 Knowledge Catalog のロケーションをご覧ください。

リソース ID

リソースパスには、階層内の各リソースとその親リソースの一意の識別子（ID）セグメントが含まれています。以降のセクションでは、各タイプのリソース ID の命名規則と形式の要件について説明します。

標準リソース ID

エントリ ID と データリネージ リソース ID を除き、 {ENTRY_GROUP_ID} や {GLOSSARY_ID} などのすべてのリソース ID 変数は、 次のガイドラインに準拠する必要があります。

  • 先頭は小文字でなければなりません。
  • 1 ～ 63 文字で構成されます。
  • 小文字、数字、ハイフン、アンダースコアのみを含みます。
  • 末尾は数字または小文字でなければなりません。

システム エントリ グループ

エントリ ID

{ENTRY_ID} の命名規則は次のとおりです。

  • 最大 4,000 文字で構成されます。

  • 完全なリソース名に基づくエントリ ID 形式を使用します。 Google Cloud 完全なリソース名に基づきます。 形式は、API サービス名部分の接頭辞の二重スラッシュがないリソースの完全なリソース名です。これにより、関連付けられたリソース名を使用してエントリを取得できます。

    次に例を示します。

    • Looker インスタンスの完全なリソース名が //looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance, の場合、推奨される {ENTRY_ID} は looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance です。

データリネージ リソース ID

データリネージ リソースは、データ変換オペレーションの階層を表します。

  • プロセス ID（{PROCESS_ID}）: データ変換の定義（特定の SQL クエリや ETL パイプラインなど）を識別します。
  • 実行 ID（{RUN_ID}）: 親プロセスの単一の実行インスタンスを識別します。
  • リネージ イベント ID（{LINEAGE_EVENT_ID}）: 実行中に発生したソースとターゲット間の個別の データ移動イベントを識別します。

API を使用してカスタム リネージ リソースを作成する場合、変数 {PROCESS_ID}、{RUN_ID}、{LINEAGE_EVENT_ID} は次のガイドラインに準拠する必要があります。

  • 最大 200 文字で構成されます。
  • 文字（大文字と小文字が区別されます）、数字、ハイフン、アンダースコア、コロン、ピリオドのみを含みます。

自動リネージ（BigQuery クエリ、Managed Service for Apache Spark、OpenLineage の取り込みなど）の場合、Knowledge Catalog はこれらの ID を自動的に生成します。

BigQuery エントリ名

Knowledge Catalog API を介して BigQuery リソースを操作する場合は、エントリ グループ ID とエントリ ID に特定の形式を使用する必要があります。

  • エントリ グループ ID: @bigquery
  • エントリ ID: bigquery.googleapis.com/projects/{PROJECT_ID}/datasets/{DATASET_ID}/tables/{TABLE_ID}

例

BigQuery テーブルが projects/test-project/datasets/test_dataset/tables/test_table の場合、完全修飾された Knowledge Catalog エントリ名は次のようになります。

projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/@bigquery/entries/bigquery.googleapis.com/projects/test-project/datasets/test_dataset/tables/test_table