0 / 0
資料の 英語版 に戻る
ガバナンス成果物のインポート方式
最終更新: 2024年10月07日
ガバナンス成果物のインポート方式

ファイルを使用してガバナンス成果物をインポートできます。 一度に 1 種類のガバナンス成果物をインポートすることも、別のIBM Knowledge Catalogインスタンスからすべてのガバナンス成果物をインポートすることもできます。

デプロイメント環境間の互換性

次の展開環境上のIBM Knowledge Catalogインスタンス間で、ガバナンス成果物をエクスポートしてからインポートできます：

  • Cloud Pak for Data 3.5
  • Cloud Pak for Data 4.x
  • Cloud Pak for Data as a Service

スチュワードの値は、IBM Knowledge CatalogインスタンスCloud Pak for Data as a Serviceと Cloud Pak for Data 3.5または4.xの間で互換性がありません。

IBM InfoSphere Information Governance CatalogからCloud Pak for Data 3.5および4.x 上のIBM Knowledge Catalogインスタンスにガバナンス・アーティファクトをインポートできます。 IBM InfoSphere Information Governance CatalogからCloud Pak for Data as a Service 上のIBM Knowledge Catalogインスタンスにガバナンスの成果物をインポートするには、各 CSV ファイルをIBM Knowledge Catalogの成果物 CSV ファイルの形式に合わせて編集する必要があります。 例えば、以下のタイプの編集が必要になる場合があります。

  • サポートされない列の削除
  • 異なる成果物タイプを複数の CSV ファイルに分割する
  • サポートされる列の変更
  • 必要な列の追加

インポート方式の比較

目標と環境に適したインポート方法を選択します。

単一タイプの成果物のインポート

CSV ファイルを使用して、一度に 1 つのタイプのガバナンス成果物をインポートできます。

この方法は、以下のタイプの状況で役立ちます。

  • インポートされた成果物をワークフローの対象にします。
  • 1 つのタイプのガバナンス成果物にプロパティーの値を追加する必要があります。 その成果物タイプを CSV ファイルとしてエクスポートし、CSV ファイルを編集してからインポートします。 例えば、このメソッドを使用して、ビジネス用語にカスタム属性を追加できます。
  • 別のプログラムで成果物を定義する必要があります。 成果物タイプごとに CSV ファイルを作成します。 例えば、このメソッドを使用して、スプレッドシート・プログラムで成果物を定義し、それらをインポートすることができます。

CSV ファイルを使用したタイプ別のガバナンス成果物のインポート および ガバナンス成果物をインポートするための CSV ファイル・フォーマットを参照してください。

複数のタイプの成果物のインポート

IBM Knowledge Catalogインスタンスから複数のタイプの既存のガバナンス成果物をエクスポートして作成した ZIP ファイルを使用して、複数のタイプのガバナンス成果物をインポートできます。 ZIP ファイルには、カテゴリーおよびエクスポートされたすべての成果物タイプの CSV ファイルが含まれています。 CSV ファイルは、以下の点を除き、CSV インポート・ファイルの形式と一致します。

  • 追加の 「成果物 ID」 列。これには、名前とカテゴリー・パスで成果物を識別する代わりに、成果物の ID が含まれます。
  • 関連成果物は、コンテキストおよび名前ではなく、成果物 ID を使用して定義されます。

この方法は、以下のタイプの状況で役立ちます。

  • IBM Knowledge Catalogインスタンスから別のインスタンスにすべてのガバナンス・アーティファクトを移動したい。

ZIP ファイルを使用したインスタンスからの複数のタイプのガバナンス成果物のインポートを参照してください。

以下の表に、CSV ファイルまたは ZIP ファイルを使用して成果物をインポートする場合の相違点を要約します。

特性 CSV ファイル (CSV file) ZIPファイル
ファイルの作成 既存の成果物の 1 つのタイプのエクスポート
スプレッドシート・プログラムでのファイルの作成
IBM InfoSphere Information Governance Catalog およびフォーマットの調整		 インスタンスから複数のタイプの成果物をエクスポート
成果物タイプの数 ファイルごとにカテゴリーまたは 1 つの成果物タイプ。 複数のタイプの成果物。カテゴリーと各タイプの成果物が別個の CSV ファイルに含まれます。
インポート方式 UI
API 要求を介して		 API 要求
ワークフロー すべての成果物はドラフトとしてインポートされ、ワークフローの対象となります。 カテゴリーはワークフローの対象ではないため、即時に公開されます。 すべての成果物とカテゴリーが即時に公開されます。
必要な権限 カテゴリーを作成または編集する権限。 インポート先のカテゴリーの編集者以上でなければなりません。 詳しくは、 必要な許可を参照してください。 「グロッサリーの管理」 権限

インポートできるガバナンス成果物

どちらのインポート方式でも、 カテゴリー および以下のタイプのガバナンス成果物をインポートできます。

制約事項:

  • 他の成果物との関係を含め、これらのタイプのガバナンス成果物のすべてのプロパティーの値をインポートできます。 ただし、関係は、関連成果物が存在する場合、または同じインポート・プロセスで定義されている場合にのみインポートされます。 インポート・プロセスでスキップされた関係を追加するには、まず、インポートされたすべてのドラフト成果物を公開してから、インポート・プロセスを再度実行します。
  • Cloud Pak for Data インスタンス間でガバナンス成果物とその関係を移動するために CSV を使用することはできません。 例えば、 「参照データに一致 (Match to reference data)」 方式のデータ・クラスを CSV にエクスポートし、それを別の Cloud Pak for Data インスタンスにインポートしようとすると、成果物 ID が CSV のインポートおよびエクスポートに含まれないため、インポートは失敗します。 代わりに ZIP インポートを使用してください。
  • CSV ファイルから参照データ・セットをインポートする場合、そのセットからの参照データ値はインポートされません。 値をデータ・セットにインポートするには、別の CSV を使用する必要があります。 別の方法として、ZIP インポートを使用して、参照データ・セットとその参照データ値の両方をインポートすることもできます。 詳しくは、 参照データ・セットのファイルのインポートを参照してください。
  • データ保護ルールもデータ・ロケーション・ルールもインポートできません。

インポートされた成果物と既存の成果物をマージする方法

CSV ファイルと ZIP ファイルのどちらを使用して成果物をインポートする場合でも、既に存在するガバナンス成果物をインポートするときにプロパティーの値が異なる場合に何が起こるかを選択する必要があります。 次の表は、3 つのマージ方法を要約したものです。

マージ法 API 元の値への影響 インポートされた値への影響
すべての値を置換 merge_option=all 元の値をすべて破棄します。 空の値も含めて、インポートされたすべての値を受け入れます。
定義済みの値で置換 merge_option=specified インポートされた値が空の場合は、元の値を保持します。 空の値を除き、インポートされたすべての値を受け入れます。
空の値を置換 merge_option=empty 空の値を除き、元の値を保持します。 空の値を置き換えるインポートされた値のみを受け入れます。

新規成果物の場合、これらの各メソッドは同じ結果を生成します。

すべての値を置換

成果物の元の値はすべて破棄され、インポートされた成果物の値に置き換えられます。 インポートされた成果物のプロパティーの値が空の場合、そのプロパティーの元の値はすべて削除されます。

例えば、 release という名前の公開済みビジネス用語があり、CSV ファイルをインポートして変更するとします。 以下の表に、 「すべての値を置換」 オプションの効果を示します。

プロパティー 元の値 CSV ファイル内の値 結果の値
名前 リリース リリース リリース
成果物タイプ glossary_term glossary_term glossary_term
カテゴリー マーケティング マーケティング マーケティング
説明 用語の例 編集された用語の例 編集された用語の例
タグ ベータ ベータ
関連用語 marketing>> バージョン マーケット>> 日付 マーケット>> 日付
分類

機密情報

結果のドラフト成果物には、元の値に対する以下の変更があります。

  • 元の記述は新しい記述に置き換えられます。
  • タグの元の空の値は値に置き換えられます。
  • 元の関連用語は、新しい関連用語に置き換えられます。
  • 元の分類値は空の値に置き換えられます。
注:

all マージ・オプションを使用する場合は、成果物間の関係について、すべての CSV コンテンツが整合していることを確認する必要があります。 例えば、ZIP インポート・ファイルに、関係に関連付けられた用語とデータ・クラスの両方が含まれている場合、この関係はデータ・クラス CSV と用語 CSV の両方に存在する必要があります。 そうしないと、関係のインポート動作が予測不能になり、関係がインポートされる場合とされない場合があります。

参照データ値を含む ZIP ファイルをインポートする場合、API 呼び出しでは常に merge_option=all を使用する必要があります。

定義された値で置換

アーティファクトの元の値と空の値は、インポートされたアーティファクトの提供された値で置き換えられます。 インポートされた成果物のプロパティーの値が空の場合、そのプロパティーの元の値が保持されます。

例えば、 release という名前の公開済みビジネス用語があり、CSV ファイルをインポートして変更するとします。 次の表は、 「定義された値で置換」 オプションの効果を示しています。

プロパティー 元の値 CSV ファイル内の値 結果の値
名前 リリース リリース リリース
成果物タイプ glossary_term glossary_term glossary_term
カテゴリー マーケティング マーケティング マーケティング
説明 用語の例 編集された用語の例 編集された用語の例
タグ ベータ ベータ
関連用語 marketing>> バージョン マーケット>> 日付 マーケット>> 日付
分類

機密情報

機密情報

結果のドラフト成果物には、元の値に対する以下の変更があります。

  • 元の記述は新しい記述に置き換えられます。
  • タグの元の空の値は値に置き換えられます。
  • 元の関連用語は、新しい関連用語に置き換えられます。

空の値を置換

元の成果物の空の値は、インポートされた成果物の指定された値に置き換えられます。

例えば、 release という名前の公開済みビジネス用語があり、CSV ファイルをインポートして変更するとします。 以下の表は、 「空の値を置換」 オプションの効果を示しています。

プロパティー 元の値 CSV ファイル内の値 結果の値
名前 リリース リリース リリース
成果物タイプ glossary_term glossary_term glossary_term
カテゴリー マーケティング マーケティング マーケティング
説明 用語の例 編集された用語の例 用語の例
タグ ベータ ベータ
関連用語 marketing>> バージョン マーケット>> 日付 marketing>> バージョン
分類

機密情報

機密情報

結果のドラフト成果物には、元の値に対する以下の変更があります。

  • タグの元の空の値は値に置き換えられます。

セキュリティーに関する考慮事項

CSV ファイルにエクスポートされたガバナンス・データは、既知の CSV インジェクション攻撃に対してサニタイズされ、CSV データを自動的に解釈するスプレッドシート・プログラムにとって安全です。 結果として、以下のいずれかの文字で始まるテキスト値。

  • 等しい (=)
  • プラス (+)
  • マイナス (-)
  • 時刻 (@)

単一引用符文字 (') が接頭部として付きます。 機能を一貫性のあるものにするために、インポートされた CSV ファイルは追加で解析され、単一引用文字 (') が自動的に削除されます。 CSV ファイルが含まれているため、ガバナンス成果物を ZIP ファイルにインポートおよびエクスポートする場合にもサニタイズが適用されます。

この機能を無効にするには:

  1. IBM Knowledge CatalogGlossary Service の展開を編集します：

    oc edit deployment wkc-glossary-service

  2. 環境変数 ESCAPE_FORMULAS_IN_CSV_FILES を値 falseに設定します。

詳しくは、 CSV 注入を参照してください。

もっと見る

親トピック: ガバナンス成果物の管理

生成 AI の検索と回答
これらの回答は、製品資料の内容に基づいて、 watsonx.ai のラージ言語モデルによって生成されます。 詳細