プロジェクト内の既存のメタデータ・インポートの管理
メタデータ・インポート 資産 を作成した後、メタデータ・インポート 資産 を表示、編集、または削除したり、インポートを再実行したりすることができます。
既存のメタデータ・インポートを管理します。
- メタデータ・インポートの表示と編集
- メタデータ・インポート・ ジョブ のリアルタイムの進行状況と メトリック を表示します
- メタデータ・インポートの ジョブ 実行ウィンドウの構成
- インポートを再実行します
- メタデータ・インポートの複製
- メタデータ・インポート 資産 の削除
ユーザー・インターフェースの代わりに API を使用して、これらのタスクを実行することもできます。 これらの API へのリンクは、『 詳細を表示 』セクションにリストされています。
- 必要な権限
- メタデータ・インポートを管理および再実行するには、以下の役割と権限が必要です。
- 資産のディスカバリーの管理 ユーザー権限。 資産
- プロジェクトの 管理者 または 編集者 の役割。
- 資産 をインポートまたは公開するカタログ内の 管理者 または 編集者 の役割。
- インポートされる データ資産 のデータ・ソースへの接続と、対応するデータベースに対する SELECT または類似の権限へのアクセス。
メタデータのインポートの表示
メタデータ・インポート資産は、「資産」ページの「メタデータのインポート」セクションにリストされます。 資産を表示するには、資産の名前をクリックするか、または資産のアクション・メニューから 表示 を選択してください。
メタデータ・インポート資産を表示すると、関連するインポート・ジョブの実行でインポートされた資産のリストが表示されます。 これらの資産を操作したり、メタデータ・インポートを編集したり、インポートを再実行したりすることができます。
各インポートされた資産に対して、以下の情報が閲覧されます：
- 資産 名。これは、プロジェクトまたはカタログ内の 資産 へのリンクを提供します。
- 資産 ・タイプ (例えば、
DataやReport)。 データ資産 の場合、Relational tableなどの形式も表示されます。 その他の 資産 ・タイプの場合、「形式」列にはダッシュ (—) が表示されます。 - 資産コンテキスト (例：親やファイル・パスなど)。
- 資産が最後にインポートされた日付と時刻。
- インポート・ステータスは、インポートに成功した場合は
Imported、インポートに失敗した場合はIn progress、またはRemovedとなります。 インポートの再実行を参照してください。
資産 の追加情報を表示したり、 資産 をカタログに公開したり (機密のマークが付けられたプロジェクト内以外)、を削除したりすることができます。 インポートされた資産のリストから資産を削除すると、その資産はインポート先のプロジェクトまたはカタログから削除されますが、メタデータ・インポート・スコープからは削除されません。 資産 のセットを公開または削除するには、 資産 を個別に選択するか、 すべて選択 オプションまたは ページ上のすべてを選択 オプションを使用します。
インポートされたデータ資産は、接続済みデータ資産と完全に同じ方法で処理できます。 インポートされたアセットには、該当する場合、アセットの親を反映したタグが自動的に割り当てられます。
このメタデータ・インポートについて サイド・パネルには、インポート構成、 ジョブ の詳細、スケジュール、拡張オプション、関連 資産 のリスト、およびタグの要約が表示されます。 メトリック の表示 をクリックして、最新の ジョブ 実行の専用ページを開き、 ジョブ 状況をモニターしたり、ログを表示したりします。 このメタデータ・インポートについて パネルの詳細を非表示にするには、情報アイコンをクリックします。
メタデータ・インポート資産を編集するには、 メタデータ・インポートの編集をクリックしてください。 以下の構成設定を変更できます：
Metadata import 資産 名、説明、タグなどの 資産 の詳細。 資産名を変更しても、関連付けられたインポート・ジョブの名前は変更されないので注意してください。 接続またはインポート・ターゲットを変更することはできません。
ディスカバリーおよび リネージュ のメタデータ・インポート目標。 選択した DSD または接続で目標を使用できない場合は、その目標は使用できません。
特定のタイプのインポートのデータ・スコープ:
- 目標が ディスカバー のメタデータ・インポートの場合は、データ・スコープ全体。
- For metadata imports with the goal ETL ジョブ リネージュ の取得 or BI レポートの リネージュ の取得, the scope of data assets to be included in such metadata import if the import additionally includes connections for source or target data assets
データ・モデル、ビジネス・インテリジェンス・レポート、または ETL ジョブのインポートのスコープ、またはインポートの一部であるソース・データ資産とターゲット・データ資産のスコープを除き、 リネージュ のインポートのスコープを変更することはできません。 データ資産
- データ・モデルのインポートの場合、初期インポート・スコープの設定時に選択したデータ・モデル・ファイルまたはデータ・モデリング・ツールを変更することはできません。
- ETL ジョブ または ETL ジョブ リネージュ のインポートの場合、初期インポート・スコープの設定時に選択した ETL ジョブ ・ファイル、データ統合ツール、またはデータ統合ツールへの接続を変更することはできません。
- ビジネス・インテリジェンス・レポートの場合、またはレポートの リネージュ ・インポートの場合、初期インポート・スコープを設定したときに選択したレポート入力ファイル、レポート作成ツール、またはレポート作成ツールへの接続を変更することはできません。
- リネージュ のインポートの場合、選択した接続または 資産 を変更することはできません。
ただし、メタデータ・インポート 資産 を複製して、新しいメタデータ・インポートでスコープを更新することはできます。 メタデータ・インポート・ 資産 の複製 を参照してください。
スケジュール。
拡張インポート・オプション。
メタデータ・インポート・ ジョブ のリアルタイムの進行状況と メトリック の表示
「プロジェクト」>「 PROJECT_NAME 」>「 MDI_RUN_ジョブ 」>「 ジョブ の実行の詳細」 の 「実行 メトリック 」タブ で、 資産 および リネージュ のメタデータ・インポート ジョブ の実行の進行状況と メトリック をリアルタイムでモニターします。
ジョブ の実行中に、タブにはグラフ、進行状況表示バー、およびカウントを含む詳細なビジュアル・ビューが表示されます。
インポートが失敗した場合は、 ダウンロード失敗 資産 ・ログ をクリックすると、詳細を含むログを表示してダウンロードできます。
メタデータ・インポートの ジョブ 実行ウィンドウの構成
ウィンドウの構成 をクリックすると、必要に応じて、指定した日の指定した時刻範囲でのみ実行するメタデータ・インポート・ジョブを定義できます。 ジョブ の実行は、構成された実行時間枠内に完了しないと自動的に一時停止し、次の実行時間枠が開始するとジョブが再開されます。
インポートの再実行
スケジュールを構成していない場合は、以下のいくつかの方法で、いつでもメタデータのインポートを手動で再実行できます。
- メタデータ・インポート資産を開き、 資産の再インポートを選択してください。
- メタデータ・インポート 資産 を開き、 このメタデータ・インポートについて サイド・パネルで ジョブ 名をクリックします。これにより、 ジョブ ページが表示されます。 このページで実行アイコンをクリックします。
- プロジェクトの ジョブ ページに移動し、そこからインポート・ジョブを実行します。
再インポートすると、資産情報が更新されます。 既存の資産が更新されます。つまり、コンテンツの変更はすべてマージされます。 定義されたスコープに応じて、データ・ソース内の新規資産が追加される場合があります。 メタデータ・インポート資産、プロジェクト、またはカタログから資産を削除した場合、スコープから削除しない限り、問題の資産は再度インポートされます。
資産 デフォルトでは、そのような 資産 の状況は Removed に設定されますが、 資産 はターゲット・プロジェクトまたはカタログから削除されません。 ターゲット・プロジェクトまたはカタログをクリーンアップするには、データ・ソースで使用できなくなった 資産 、または再インポート時にインポート・スコープから削除された 資産 を削除することを選択できます。
ETL ジョブまたは リネージュ メタデータをインポートする場合、データ・ソースで使用できない 資産 のみを削除できます。 データ・モデルをインポートする場合、削除オプションはいずれも適用されません。
資産 を再インポートすると、 資産 の状況が 削除済み に誤って設定され、 The asset was deleted from the data source が理由として表示されることがあります。 これは、再インポート中の接続の問題が原因である可能性があります。 再インポートのメタデータ・インポート設定によっては、そのような 資産 がターゲット・プロジェクトまたはカタログから削除される場合があります。 手動で、またはスケジュールされた再インポートによって、後でインポートを再実行します。 接続が復元されると、 資産 が再度インポートされます。
デフォルトでは、 資産 が再インポートされると、すべての 資産 ・プロパティーが更新されます。 ただし、メタデータ・インポートを構成して、 資産 名、 資産 の説明、列の説明のいずれかの更新をスキップすることができます。
メタデータのインポートが適切に構成されている場合、新規または変更された データ資産 のみがインポートされます。
データ・スコープとして機能する .zip ファイルの更新バージョンをアップロードした後、データ・モデルのインポートを再実行して、カタログ内のモデル情報を更新できます。
メタデータ・インポート・ ジョブ の実行結果に応じて、完了メッセージまたはエラー通知が表示されます。
ジョブ の実行が正常に完了した場合、警告を伴って完了した場合、またはエラーが発生して完了した場合、完了メッセージが表示されます。 ジョブ の実行全体が失敗した場合は、エラー通知が表示されます。 いずれのタイプの通知にも、特定の ジョブ 実行に関する詳細を提供する ジョブ 実行ログへのリンクが含まれています。
E メール通知 再インポートされたデータの簡単な要約 (ジョブ 状況、変更、追加、および削除された 資産 の数) を受信するように E メール通知をセットアップできます。 E メール通知を構成するには、通知イベントを作成します。 詳しくは、 IBM Software Hub の資料の E メールへの通知の転送 を参照してください。 通知イベントを構成するには、管理者であるか、 「プラットフォーム管理」>「構成の管理」 権限を持つユーザーである必要があります。
メタデータ・インポート・ 資産 の複製
メタデータ・インポート 資産 を作成した後、目標が ディスカバー のメタデータ・インポートのみのスコープを変更できます。 他の目標でメタデータをインポートする代わりに、メタデータ・インポート・ 資産 を複製し、スコープおよびその他の設定を調整することができます。
メタデータ・インポート 資産 を複製するには、 資産 を開き、 資産 名の横にあるオーバーフロー・メニューから 複製 を選択します。
複製されたメタデータ・インポート 資産 のデフォルト名は Copy of <name of original metadata import>_timestamp です。例えば、 Copy of BI report_2023-08-14_20:38:21 などです。 関連する ジョブ の名前も同じパターンに従います。 メタデータ・インポート・ 資産 および ジョブ の名前を変更できます。
インポート・ターゲット、有効範囲、および拡張オプションの設定は事前に入力されていますが、必要に応じてこの構成を変更できます。 元のメタデータ・インポートで定義されているスケジュールは、持ち越されません。 必要に応じて、新規スケジュールを構成します。
メタデータ・インポート資産の削除
メタデータ・インポート 資産 は、以下のいずれかの方法でプロジェクトから削除できます。
- プロジェクトの 資産 ページで、 資産 のオーバーフロー・メニューを選択し、 削除(L) を選択します。
- 資産 を開き、 資産 名の横にあるオーバーフロー・メニューを選択し、 削除 を選択します。
メタデータ・インポート構成とそれに関連付けられたメタデータ・インポート・ジョブが削除されます。 このメタデータ・インポート資産を使用してインポートされたプロジェクトまたはカタログ内の資産は影響を受けません。