このドキュメントでは、メタデータのインポートに使用される Knowledge Catalog(以前の Dataplex Universal Catalog)コネクタ ジョブを表示、更新、削除する方法について説明します。
始める前に
コネクタ ジョブを管理するには、適切な IAM ロールが必要です。詳細については、IAM ロールをご覧ください。
- ジョブと実行履歴を表示するには:
- BigQuery ユーザー(
roles/bigquery.user) - Dataplex 閲覧者(
roles/dataplex.viewer)
- BigQuery ユーザー(
- ジョブを編集、削除、手動でトリガーするには:
- BigQuery 管理者 (
roles/bigquery.admin) - Dataplex 管理者(
roles/dataplex.admin)または Dataplex 編集者(roles/dataplex.editor)
- BigQuery 管理者 (
BigQuery Data Transfer Service を 有効にする必要があります。
また、BigQuery Data Transfer Service サービス エージェント
(service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com)
に dataplex.entryGroups.import 権限または
Dataplex エントリ グループ インポーター(roles/dataplex.entryGroupImporter)
ロールを付与する必要があります。これは、プロジェクト レベルまたはエントリ グループ レベルで付与できます。
コネクタ ジョブを表示する
コンソールで、Knowledge Catalog ページに移動します。 Google Cloud
ナビゲーション メニューの [管理] セクションで、[コネクタ] をクリックします。 [コネクタ] ページには、プロジェクト内のすべてのメタデータ インポート ジョブが一覧表示されます。
特定のジョブの詳細、実行履歴、構成を表示するには、リスト内の表示名をクリックします。
ジョブの実行履歴とログを表示する
コネクタ ジョブでは、成功した実行と失敗した実行を含む実行履歴を表示できます。90 日以上前のジョブ実行は自動的に削除されます。
- [コネクタ] ページで、表示するジョブの表示名をクリックします。
- [実行履歴] タブをクリックします。このタブには、最近のジョブ実行が表示されます。
- 特定の実行のログを表示するには、リストで実行を見つけて [詳細を表示] をクリックします。
ロギングとモニタリング
Knowledge Catalog メタデータ コネクタは、インポート構成のオブザーバビリティを提供するログと指標を Cloud Monitoring と Cloud Logging にエクスポートします。Monitoring を使用して、メタデータ インポート構成のモニタリング、実行パフォーマンスの評価、エラー メッセージの確認を行うためのダッシュボードを設定し、実行エラーのトラブルシューティングを行うことができます。Logging を使用して、実行または構成に関連するログを表示できます。
コネクタ ジョブを更新する
既存のジョブの構成(スケジュール、宛先エントリ グループ、通知設定、インポートするソース オブジェクトなど)を変更できます。
- [コネクタ] ページで、更新するジョブの表示名をクリックします。
- [編集] をクリックします。
- 必要に応じてジョブ構成を変更します。
- [保存] をクリックします。
コネクタ ジョブを無効または有効にする
ジョブを無効にすると、ジョブ名が disabled ステータスで更新され、新しいジョブ実行はスケジュールされません。すでに進行中の実行は完了します。
ジョブを無効にしても、Knowledge Catalog にすでにインポートされているメタデータは削除されません。
- [コネクタ] ページで、無効または有効にするジョブを見つけます。
- [アクション] をクリックして、[無効にする] または [有効にする] を選択します。
コネクタ ジョブを削除する
ジョブを削除すると、新しい実行はスケジュールされず、進行中の実行は停止します。ジョブを削除しても、Knowledge Catalog にすでにインポートされているメタデータは削除されません。
- [コネクタ] ページで、削除するジョブを見つけます。
- [アクション] をクリックして、[削除] を選択します。
- 確認するには、「
delete」と入力して [削除] をクリックします。
ジョブを手動でトリガーする
通常のスケジュール外でジョブ実行を開始できます。これは「バックフィル」と呼ばれることもあります。
- [コネクタ] ページで、実行するジョブの表示名をクリックします。
[今すぐ転送を実行] をクリックし、[1 回限りの転送を実行] を選択します。