ガバナンス ワークフローでメタデータの変更をリクエストする

このドキュメントでは、ガバナンス ワークフローを使用して、ビジネス用語集のカテゴリと用語、および Knowledge Catalog(旧 Dataplex Universal Catalog)エントリに単一リソースの変更を提案する方法について説明します。

始める前に

メタデータの変更にガバナンス ワークフローを使用するには、必要な API が有効になっていること、必要な Identity and Access Management(IAM)ロールと権限が付与されていることを確認してください。

Dataplex API が有効になっていない場合は、有効にします。

API を有効にするために必要なロール

API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール(roles/owner)を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール(roles/serviceusage.serviceUsageAdmin)を介してこの権限を取得できます。ロールを付与する方法を確認する。

API の有効化

必要なロール

メタデータの変更をリクエストするために必要な権限を取得するには、プロジェクト、用語集、エントリ グループに対する次の IAM ロールを付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

ロールと権限の詳細については、Knowledge Catalog の IAM ロールをご覧ください。

用語集カテゴリの変更をリクエストする

用語集カテゴリの作成、更新、削除を行う直接書き込みアクセス権がない場合は、ガバナンス ワークフローを使用して、このような変更をリクエストできます。メタデータ変更リクエストが送信されると、リクエスト元、承認者、ワークフロー管理者は、ライフサイクル全体でリクエストをモニタリングして管理できます。

カテゴリを作成する

コンソール

カテゴリをリクエストする手順は次のとおりです。

  1. Google Cloud コンソールで、Knowledge Catalog の [用語集] ページに移動します。

    [用語集] に移動

  2. カテゴリを作成する用語集を選択し、[カテゴリを作成] をクリックします。

  3. カテゴリの表示名を入力します。

  4. 省略可: [ラベル] セクションで、用語集のラベルを追加します。

  5. 省略可: [理由] セクションで、変更の理由を承認者に提供します。

  6. [詳細設定] セクションで、自動生成された ID を変更する場合は、[カテゴリ ID] を編集します。

  7. [審査に送信] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

カテゴリの作成をリクエストするには、glossaries.requestGlossaryChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createCategoryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "categoryId": "sample-category-id",
      "category": {
        "displayName": "Sample category name",
        "description": "Sample category description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: 用語集が存在するリージョン(us-central1 など)。
  • GLOSSARY_ID: 親用語集の ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、変更リクエストのリソース名を含むレスポンスを返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

カテゴリを更新する

コンソール

カテゴリの変更を提案する手順は次のとおりです。

  1. Google Cloud コンソールで、Knowledge Catalog の [用語集] ページに移動します。

    [用語集] に移動

  2. 更新するカテゴリを含む用語集を選択します。

  3. カテゴリ名をクリックして、[カテゴリの詳細] ペインを開きます。

  4. カテゴリの詳細を追加または更新するには、更新するセクションの横にある [追加] または [編集] をクリックします。

  5. [審査に送信] をクリックします。一部の項目では、変更の追加の理由が必要になる場合があります。理由を入力し、[変更の送信に進む] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

カテゴリの表示名と説明の更新をリクエストするには、glossaries.requestGlossaryChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateCategoryRequest": {
      "category": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: 用語集が存在するリージョン(us-central1 など)。
  • GLOSSARY_ID: 親用語集の ID。
  • CATEGORY_ID: 更新するターゲット カテゴリの ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、変更リクエストのリソース名を含むレスポンスを返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

カテゴリを削除する

コンソール

カテゴリの削除をリクエストする手順は次のとおりです。

  1. Google Cloud コンソールで、Knowledge Catalog の [用語集] ページに移動します。

    [用語集] に移動

  2. 用語集を開き、削除するカテゴリをクリックします。

  3. [カテゴリの詳細] ペインで、メニューから [削除] を選択します。

  4. 省略可: [理由] セクションで、変更の理由を承認者に提供します。

  5. [審査に送信] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

カテゴリの削除をリクエストするには、glossaries.requestGlossaryChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteCategoryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: 用語集が存在するリージョン(us-central1 など)。
  • GLOSSARY_ID: 親用語集の ID。
  • CATEGORY_ID: 削除するターゲット カテゴリの ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、変更リクエストのリソース名を含むレスポンスを返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

用語集の用語の変更をリクエストする

用語集の用語を作成、更新、削除するための直接書き込みアクセス権がない場合は、ガバナンス ワークフローを使用して、このような変更をリクエストできます。

用語集の用語を作成する

コンソール

用語集の用語の作成をリクエストする手順は次のとおりです。

  1. Google Cloud コンソールで、Knowledge Catalog の [用語集] ページに移動します。

    [用語集] に移動

  2. 用語を作成する用語集またはカテゴリを選択して、詳細ウィンドウを開きます。

    • 用語集の詳細ページから用語を作成する場合は、メニューから [用語を作成] を選択します。
    • カテゴリの詳細ページから用語を作成する場合は、メニューから [キーワードを追加] を選択します。
  3. カテゴリの表示名を入力します。

  4. 省略可: [ラベル] セクションで、用語のラベルを追加します。

  5. 省略可: [理由] セクションで、変更の理由を承認者に提供します。

  6. [詳細設定] セクションで、自動生成された ID を変更する場合は、[用語 ID] を編集します。

  7. [審査に送信] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

用語集の用語の作成をリクエストするには、glossaries.requestGlossaryChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createTermRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "termId": "sample-term-id",
      "term": {
        "displayName": "Sample term name",
        "description": "Sample term description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: 用語集が存在するリージョン(us-central1 など)。
  • GLOSSARY_ID: 親用語集の ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、変更リクエストのリソース名を含むレスポンスを返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

用語集の用語を更新する

コンソール

用語集の用語の変更をリクエストする手順は次のとおりです。

  1. Google Cloud コンソールで、Knowledge Catalog の [用語集] ページに移動します。

    [用語集] に移動

  2. 更新する用語が含まれている用語集を選択します。

  3. 用語名をクリックして、[用語の詳細] ペインを開きます。

  4. 更新するセクションの横にある [追加] または [編集] をクリックして、期間の詳細を追加または更新します。

  5. [審査に送信] をクリックします。一部のセクションでは、リクエストを送信する前に追加の理由を入力する必要があります。理由を入力し、[変更の送信に進む] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

用語集の用語の表示名と説明の更新をリクエストするには、glossaries.requestGlossaryChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateTermRequest": {
      "term": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: 用語集が存在するリージョン(us-central1 など)。
  • GLOSSARY_ID: 親用語集の ID。
  • TERM_ID: 更新するターゲット用語の ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、変更リクエストのリソース名を含むレスポンスを返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

用語集の用語を削除する

コンソール

用語の削除をリクエストする手順は次のとおりです。

  1. Google Cloud コンソールで、Knowledge Catalog の [用語集] ページに移動します。

    [用語集] に移動

  2. 削除する用語が含まれている用語集を選択します。

  3. 用語名をクリックして、[用語の詳細] ペインを開きます。

  4. [削除] をクリックします。

  5. [審査に送信] をクリックします。一部のセクションでは、リクエストを送信する前に追加の理由を入力する必要があります。理由を入力し、[変更の送信に進む] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

用語集の用語の削除をリクエストするには、glossaries.requestGlossaryChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteTermRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: 用語集が存在するリージョン(us-central1 など)。
  • GLOSSARY_ID: 親用語集の ID。
  • TERM_ID: 削除するターゲット用語の ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、ChangeRequest のリソース名を含む RequestGlossaryChangeResponse を返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

エントリの変更をリクエストする

Knowledge Catalog エントリを作成、変更、削除するための直接書き込みアクセス権がない場合は、ガバナンス ワークフローを使用してこのような変更をリクエストできます。

エントリを作成する

コンソール

エントリの作成をリクエストする手順は次のとおりです。

  1. Google Cloud コンソールで、Knowledge Catalog の [メタデータのタイプ] ページに移動します。

    [メタデータのタイプ] に移動

  2. [エントリ グループ] タブをクリックします。

  3. エントリを作成するエントリ グループを選択し、[エントリを作成] をクリックします。

  4. エントリの ID と表示名を入力します。

  5. エントリタイプを選択します。

  6. 省略可: アスペクトの詳細を指定するか、説明を追加します。

  7. [審査に送信] をクリックします。一部のセクションでは、リクエストを送信する前に追加の理由を入力する必要があります。理由を入力し、[変更の送信に進む] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

エントリの作成をリクエストするには、entryGroups.requestCatalogChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryId": "sample-entry-id",
      "entry": {
        "entryType": "projects/PROJECT_ID/locations/LOCATION/entryTypes/ENTRY_TYPE_ID",
        "entrySource": {
          "displayName": "Sample entry name",
          "description": "Sample entry description"
        }
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: エントリ グループが存在するリージョン(us-central1 など)。
  • ENTRY_GROUP_ID: 親エントリ グループの ID。
  • ENTRY_TYPE_ID: エントリタイプの ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、変更リクエストのリソース名を含むレスポンスを返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

エントリを更新する

コンソール

エントリの更新をリクエストする手順は次のとおりです。

  1. Google Cloud コンソールで、Knowledge Catalog の [検索] ページまたは [カタログ] ページに移動します。

[検索] に移動

  1. 更新するエントリを検索して選択します。
  2. エントリをクリックして、[エントリの詳細] ページを開きます。
  3. 更新するセクションの横にある [追加] をクリックします。
  4. セクションを更新します。
  5. [審査に送信] をクリックします。一部のセクションでは、リクエストを送信する前に追加の理由を入力する必要があります。理由を入力し、[変更の送信に進む] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

エントリソースの表示名と説明の更新をリクエストするには、entryGroups.requestCatalogChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "entrySource": {
          "displayName": "Sample new name",
          "description": "Sample new description"
        }
      },
      "updateMask": {
        "paths": [
          "entry_source.display_name",
          "entry_source.description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: エントリ グループが存在するリージョン(us-central1 など)。
  • ENTRY_GROUP_ID: 親エントリ グループの ID。
  • ENTRY_ID: ターゲット エントリの ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、変更リクエストのリソース名を含むレスポンスを返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

エントリを削除する

コンソール

エントリの削除をリクエストする手順は次のとおりです。

  1. Google Cloud コンソールで、Knowledge Catalog の [検索] ページまたは [カタログ] ページに移動します。

[検索] に移動

  1. 削除するエントリを検索して選択します。
  2. エントリをクリックして、[エントリの詳細] ページを開きます。
  3. [削除] をクリックします。
  4. [審査に送信] をクリックします。一部のセクションでは、リクエストを送信する前に追加の理由を入力する必要があります。理由を入力し、[変更の送信に進む] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

エントリの削除をリクエストするには、entryGroups.requestCatalogChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: エントリ グループが存在するリージョン(us-central1 など)。
  • ENTRY_GROUP_ID: 親エントリ グループの ID。
  • ENTRY_ID: 削除するターゲット エントリの ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、変更リクエストのリソース名を含むレスポンスを返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

アスペクトを更新する

コンソール

アスペクトの更新をリクエストする手順は次のとおりです。

  1. Google Cloud コンソールで、Knowledge Catalog の [検索] ページに移動します。

[検索] に移動

  1. 変更をリクエストするエントリを検索して選択します。
  2. エントリをクリックして、[エントリの詳細] ページを開きます。
  3. [アスペクト] セクションに移動し、[ 追加] をクリックします。
  4. アスペクトの詳細を指定します。
  5. 省略可: 変更の理由を入力します。
  6. [審査に送信] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

エントリに連絡先アスペクトをアタッチまたは更新するようにリクエストするには、entryGroups.requestCatalogChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "aspects": {
          "dataplex-types.global.contacts": {
            "data": {
              "identities": [
                {
                  "role": "Data Steward",
                  "name": "Dana",
                  "id": "dana@example.com"
                }
              ]
            }
          }
        }
      },
      "updateMask": {
        "paths": [
          "aspects"
        ]
      },
      "aspectKeys": [
        "dataplex-types.global.contacts"
      ]
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: エントリ グループが存在するリージョン(us-central1 など)。
  • ENTRY_GROUP_ID: 親エントリ グループの ID。
  • ENTRY_ID: ターゲット エントリの ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、変更リクエストのリソース名を含むレスポンスを返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

エントリリンクを作成する

コンソール

エントリリンクの作成をリクエストする手順は次のとおりです。たとえば、用語集の用語を添付する場合などです。

  1. Google Cloud コンソールで、Knowledge Catalog の [検索] ページに移動します。

    [検索] に移動

  2. 用語をリンクするデータアセット エントリを検索して選択します。

  3. エントリの詳細ページで、次のいずれかを行います。

    • 用語をエントリにリンクするには、[詳細] タブの [用語集] セクションで [追加] をクリックします。
    • 用語を列にリンクするには、[スキーマ] タブで列を選択し、[ビジネス用語を追加] をクリックします。
  4. リンクする用語を検索して選択します。

  5. 省略可: 変更の理由を入力します。

  6. [審査に送信] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

用語集の用語とデータアセット エントリの間に定義リンクを作成するには、entryGroups.requestCatalogChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryLinkRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryLinkId": "sample-definition-link",
      "entryLink": {
        "entryLinkType": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
        "entryReferences": [
          {
            "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
            "type": "SOURCE"
          },
          {
            "name": "projects/PROJECT_ID/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_ID/locations/global/glossaries/GLOSSARY_ID/terms/TERM_ID",
            "type": "TARGET"
          }
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: エントリ グループが存在するリージョン(us-central1 など)。
  • ENTRY_GROUP_ID: 親エントリ グループの ID。
  • ENTRY_ID: ターゲット エントリの ID。
  • GLOSSARY_ID: 用語を含む用語集の ID。
  • TERM_ID: 用語集の用語の ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、変更リクエストのリソース名を含むレスポンスを返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

エントリリンクを削除する

コンソール

エントリリンクの削除をリクエストする手順は次のとおりです。たとえば、添付された用語集の用語を削除します。

  1. Google Cloud コンソールで、Knowledge Catalog の [検索] ページに移動します。

    [検索] に移動

  2. リンクされた用語を削除するデータアセット エントリを検索して選択します。

  3. エントリの詳細ページで、次のいずれかを行います。

    • エントリから用語を削除するには、[詳細] タブの [用語集] セクションで、用語をクリックし、 [削除] をクリックします。
    • 列から用語を削除するには、[スキーマ] タブで、用語の横にある [削除] をクリックします。
  4. 省略可: 変更の理由を入力します。

  5. [審査に送信] をクリックします。

システムは新しい変更リクエストをログに記録し、承認者に通知します。リクエストの進行状況は、[ガバナンス ワークフロー] ページの [マイ リクエスト] タブで確認できます。

REST

用語集の用語とデータアセット エントリ間のエントリリンクの削除をリクエストするには、entryGroups.requestCatalogChange メソッドを使用します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryLinkRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

次のように置き換えます。

  • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
  • LOCATION: エントリ グループが存在するリージョン(us-central1 など)。
  • ENTRY_GROUP_ID: 親エントリ グループの ID。
  • ENTRY_LINK_ID: 削除するターゲット エントリリンクの ID。
  • JUSTIFICATION: 変更を提案する理由の説明。

サービスは、変更リクエストのリソース名を含むレスポンスを返します。システムは新しい変更リクエストをログに記録し、承認者に通知します。

次のステップ