コネクタ ジョブを管理する

このドキュメントでは、メタデータのインポートに使用される Knowledge Catalog（以前の Dataplex Universal Catalog）コネクタ ジョブを表示、更新、削除する方法について説明します。

始める前に

コネクタ ジョブを管理するには、適切な IAM ロールが必要です。詳細については、IAM ロールをご覧ください。

  • ジョブと実行履歴を表示するには:
  • ジョブを編集、削除、手動でトリガーするには:
    • BigQuery 管理者（roles/bigquery.admin）
    • Dataplex 管理者（roles/dataplex.admin）または Dataplex 編集者（roles/dataplex.editor）

BigQuery Data Transfer Service を有効にする必要があります。

また、BigQuery Data Transfer Service サービス エージェント（service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com）に dataplex.entryGroups.import 権限または Dataplex エントリ グループのインポーター（roles/dataplex.entryGroupImporter）ロールを付与する必要があります。これは、プロジェクト レベルまたはエントリ グループ レベルで付与できます。

コネクタ ジョブを表示する

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

    Knowledge Catalog に移動

  2. ナビゲーション メニューの [管理] セクションで、[コネクタ] をクリックします。[コネクタ] ページには、プロジェクト内のすべてのメタデータ インポート ジョブが一覧表示されます。

  3. 特定のジョブの詳細、実行履歴、構成を表示するには、リスト内の表示名をクリックします。

ジョブの実行履歴とログを表示する

コネクタ ジョブの実行履歴（成功した実行と失敗した実行を含む）を表示できます。90 日以上経過したジョブ実行は自動的に削除されます。

  1. [コネクタ] ページで、表示するジョブの表示名をクリックします。
  2. [実行履歴] タブをクリックします。このタブには、最近のジョブ実行が表示されます。
  3. 特定の実行のログを表示するには、リストで実行を見つけて [詳細を表示] をクリックします。

ロギングとモニタリング

Knowledge Catalog メタデータ コネクタは、ログと指標を Cloud Monitoring と Cloud Logging にエクスポートして、インポート構成にオブザーバビリティを提供します。Monitoring を使用して、メタデータ インポート構成のモニタリング、実行パフォーマンスの評価、エラー メッセージの表示を行うためのダッシュボードを設定し、実行エラーのトラブルシューティングを行うことができます。Logging を使用して、実行または構成に関連するログを表示できます。

コネクタ ジョブを更新する

既存のジョブの構成（スケジュール、宛先エントリ グループ、通知設定、インポートするソース オブジェクトなど）を変更できます。

  1. [コネクタ] ページで、更新するジョブの表示名をクリックします。
  2. [編集] をクリックします。
  3. 必要に応じてジョブ構成を変更します。
  4. [保存] をクリックします。

コネクタ ジョブを無効または有効にする

ジョブを無効にすると、ジョブ名が disabled ステータスで更新され、新しいジョブ実行はスケジュールされません。すでに進行中の実行は完了します。ジョブを無効にしても、Knowledge Catalog にすでにインポートされているメタデータは削除されません。

  1. [コネクタ] ページで、無効または有効にするジョブを見つけます。
  2. [アクション] をクリックして、[無効にする] または [有効にする] を選択します。

コネクタ ジョブを削除する

ジョブを削除すると、新しい実行はスケジュールされず、進行中の実行は停止します。ジョブを削除しても、Knowledge Catalog にすでにインポートされているメタデータは削除されません。

  1. [コネクタ] ページで、削除するジョブを見つけます。
  2. [アクション] をクリックして、[削除] を選択します。
  3. 削除を確定するには、「delete」と入力して [削除] をクリックします。

ジョブを手動でトリガーする

定期的なスケジュール外でジョブ実行を開始できます。これはバックフィルと呼ばれることもあります。

  1. [コネクタ] ページで、実行するジョブの表示名をクリックします。

  2. [今すぐ転送を実行] をクリックし、[1 回限りの転送を実行] を選択します。