CSV (コンマ区切り値) 形式でカタログの外部に参照データ・セットを作成してから、値をインポートまたは再インポートすることができます。 複数の参照データ・セット内の値の間の値マッピング関係のインポートも実行できます。
以下のいずれかの方法を使用して、参照データ・セットをインポートします。
API 要求を使用して、以前にエクスポートした ZIP ファイルから 1 つ以上のリファレンス・データ・セットをインポートします。
ZIP ファイルでインスタンスからすべてのガバナンス成果物をインポートする」で説明されているように、ZIP ファイルで参照データセットをインポートする場合は、API 呼び出しで常に「
merge_option=all使用する必要があります。UI または API リクエストを使用して、CSV ファイルから参照データセット定義をインポートします。 複数の参照データセット定義を1つのファイルにインポートできる。 この方法にはリファレンス・データの値は含まれません - 値は別途インポートする必要があります。
UI または API 要求を使用して、特定のセットの CSV ファイルからリファレンス・データ値をインポートします。
UI または API 要求を使用して、関連する参照データ値を CSV ファイルから既存の参照データ・セットにインポートします。
IBM Knowledge Catalogプランでは、作成できる参照データ・セットの数とサイズに制限があります。
ZIP ファイル内の参照データ・セットをインポートまたはエクスポートすると、その ZIP ファイルに含まれる参照データ・セットを定義する CSV ファイルがファイルに含まれます。別個のフォルダーには、セットごとに 1 つの CSV ファイルとその参照データ値が含まれます。 これらの CSV ファイルの形式は異なります。
参照データセット定義CSVファイルには、アーティファクトID、名前、説明、所属カテゴリ、参照データセットタイプなど、含まれる各セットのプロパティに関する情報が含まれる。 形式は以下のようになります。
artifact_id,Name,Artifact Type,Category,Description,Secondary Categories,Related Terms,Data Set Type
026df326-74f2-4dce-8d6b-7d2f36b09d98,Customer Non Performing Loan Status,reference_data,54b9bd8a-ddfb-4512-8d46-e26d2926981e,Distinguishes between Customers according to their number of outstanding non-performing loans.,ecf8fade-4956-4e92-9a56-308949f0cb58,a9a63e90-94df-4b00-95ec-a951189d2183,TEXT
0544a0b7-07b7-4509-8cbe-22e36caa218b,Household Life Cycle Status,reference_data,8a72919e-8c40-4a73-b190-4803deb2160d,Distinguishes between Households according to the state of existence of the Household.,ecf8fade-4956-4e92-9a56-308949f0cb58,3a6f0d98-64fc-4166-b3e4-7f2ebcbeac9f,TEXT
07cf348c-76a3-482c-9614-2b89edabbaaf,Financial Legal Status,reference_data,54b9bd8a-ddfb-4512-8d46-e26d2926981e,"Distinguishes between Individuals or Organizations according to whether they are undergoing proceedings that affect their financial standing; for example, (US) Chapter 11 status, In Liquidation, In Receivership, Bankrupt.",ecf8fade-4956-4e92-9a56-308949f0cb58,03976617-abe9-4e5a-88cf-57193b22cce1,TEXT
リファレンスデータ値のCSVファイルは、最低限、リファレンスデータセット用に定義された以下の列で構成される：
- コード
- 値
- 説明 (オプション)
- 親 (オプション)
また、関連する参照データ値やカスタム列などの他の情報が含まれている場合もあります。
例えば NAICS コードでは、参照データ・セットの最初の数行は次のようになります。
Code,value,description,parent
11,Agriculture, Forestry, Fishing and Hunting
111,Crop Production,Crop Produ,11
1111,Oilseed and Grain Farming,111
11111,Soybean Farming,Soybean Farming,1111
111110,Soybean Farming,Soybean Farming,1111
11112,Oilseed (except Soybean) Farming,Oilseed (except Soybean) Farming,1111
111120,Oilseed (except Soybean) Farming,Oilseed (except Soybean) Farming,1111
ガバナンス成果物をインポートするための CSV ファイル・フォーマットでの CSV ファイルのフォーマットについて詳しく説明します。 さまざまなインポート方法については、 ガバナンス成果物のインポート方法で説明されています。
以下のセクションでは、UI を使用して参照データ・セットの CSV ファイルをインポートする方法について説明します。 UI で、インポート・タスクの進行状況表示バーを表示したり、インポートの要約をエラーの説明とともに表示したりすることもできます。 リファレンス・データ値をインポートする場合、インポート要約にリストされている保存済みの値の数が、実際にインポートされた値の数と異なる可能性があることに注意してください。 これは、CSV ファイルからのすべての重複が保存された値としてカウントされるのに対して、これらの重複のうちの 1 つのみが最終的にインポートされるためです (選択した重複処理方法によって異なります)。
参照データセット定義ファイルをインポート
- メインメニューのGovernance>Reference dataをクリックする。
- Add reference data setをクリックし、Import from fileを選択する。
- 上記の参照データセット定義を含むCSVファイルを選択する。
- マージオプションを選択する。 このオプションは参照データセットの定義に関係するものであり、その値に関係するものではないことに注意。 値は別のステップでインポートしなければならない。
- 「次へ」をクリックする
その結果、新しい参照データセット定義が作成される。 一度作成したら、手動で値を追加するか、次のタスクで説明するように、別のCSVファイルから値をインポートすることができます。
参照データ値を持つファイルのインポート
選択した参照データ・セットで、 「ファイルのアップロード」 をクリックして、値のインポート元の CSV ファイルを選択します。
- ファイル内の行のうち、既存のコードを持つものは、既存の行を更新します。
- 新しいコードを持つ行が、追加されます。
CSV ファイルから値をインポートする場合は、ファイルの列を任意のデフォルト列またはカスタム列にマップします。 列が存在しない場合は、作成できます。
カスタム列のインポート
デフォルトでは、参照データ・セットの値には、「コード」、「値」、「説明」(オプション)、および「親」(オプション) の各列があります。 ただし、コードに関連する追加情報を カスタム列にキャプチャーすることもできます。 例えば、国別コードの参照データ・セットがあり、その国の首相、言語、代替名などの他の属性を取り込む必要が生じることがあります。
カスタム列は、そのような列が定義されている CSV ファイルから参照データ・セットを作成するとき、または CSV ファイルから既存の参照データ・セットに値をインポートまたは再インポートするときに追加できます。
カスタム列を含む CSV ファイルの一部については、以下の例を参照してください。 このファイルは、値のインポートまたは再インポートに使用できます。
code,value,description,Capital City,National Day,Official Language,Population
AFG,Afghanistan,The Islamic Republic of Afghanistan,Kabul,19/08/1919,دری,37200000
ALA,Åland Islands,Åland,Mariehamn,07/05/1920,svɛ̂nːska,28007
ALB,Albania,The Republic of Albania,Tirana,28/11/1912,Albanian,2850000
DZA,Algeria,The People's Democratic Republic of Algeria,Algiers,05/07/1962,الجزائر,42200000
ASM,American Samoa,The Territory of American Samoa,Pago Pago,14/06/1889,English,55465
カスタム列を参照データ・セットにインポートするには、以下のようにします。
- 参照データ・セットを開き、 「ファイルのアップロード」をクリックします。 CSV ファイルを指定して、 「次へ」をクリックします。
- ファイルの列を、参照データ・セットのデフォルト列または既存の列にマップします。 新しいカスタム列を追加するには、 「ターゲット列」 ドロップダウン・リストから 「+ カスタム列の追加 (オプション)」を選択します。
- 列名、説明、最大文字数を指定し、列の値を別の参照データ・セットのコードに照らして検証するかどうかを指定します。
- カスタム列に 複合キーの一部としてマークを付けることができます。 複合キーの一部であるカスタム列は、デフォルトでは必須です。
- マップする CSV ファイルの各列について、上記のステップを繰り返します。
- すべての列をマップする場合は、情報を確認し、必要に応じて列を再配置して、 「保存」をクリックします。
関連する値のインポート
CSV ファイルを使用して、参照データ・セット内の値の間の関係をインポートできます。 関係を作成するには、ソース参照データ・セットとターゲット参照データ・セットの値がシステムに存在している必要があります。存在していない場合、関係はインポートされません。 最初に、関連する両方の参照データ・セットをインポートしてから、同じ CSV ファイルを使用して関係をインポートします。
以下の、値マッピングを含む CSV ファイルの例を参照してください。
code,value,description,map_1_n_to_states,map_1_1_continents
IND,India,Asian country,"KA,AP,MP,DL,GJ",ASIA
USA,America,North American Country,"CA,FL,NY,TX",NorthAmerica
GER,Germany,European Country,,Europe
CSV ファイルをインポートして関連値を追加するには、以下のステップを実行します。
- 関連する値を追加する参照データ・セットを開きます。
- 3 つのドットのメニューから、 「関連値のアップロード」をクリックします。
- アップロードしたいファイルを 関連する値のインポート ウィンドウにドラッグするか、またはファイルを参照することによって、ファイルを追加します。 次に、「次へ」をクリックします。
- 1 つ以上の他のコード値にマップするコード値を持つ列をファイルから選択します。
- それぞれの値と関連する値の間に設定する関係のタイプ (1 対 1 または 1 から多) を選択します。
- マップ先の参照値の関連コード、および関連する値が属する参照データ・セットを含む列を、ファイルから選択します。
- 保存 をクリックします。
注: 複合キーによって定義された参照データ値を持つ CSV ファイルを処理する場合は、値と、単一マップおよび複数マップの関連値の間の親関係が、CODE と複合キーのカスタム列値の連結として | で区切られて表されることを確認してください。コードは常に最初に複合キー列値 (例: CODE|CC1|CC2|CC3) となります。
もっと見る
親トピック: リファレンス・データ