参照データ・セットのファイルのインポート

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 ファイルは、少なくとも、参照データ・セット用に定義された以下の列で構成されます。

1. コード
2. 価値
3. 説明 (オプション)
4. 親 (オプション)

また、関連する参照データ値やカスタム列などの他の情報が含まれている場合もあります。

例えば 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 ファイルをインポートする方法について説明します。

• 参照データ値を持つファイルのインポート
• カスタム列のインポート
• 関連する値のインポート

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

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