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

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 回限りの転送を実行] を選択します。