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

CSV (コンマ区切り値) 形式でカタログの外部に参照データ・セットを作成してから、値をインポートまたは再インポートすることができます。 複数の参照データ・セット内の値の間の値マッピング関係のインポートも実行できます。

以下のいずれかの方法を使用して、参照データ・セットをインポートします。

  • API 要求を使用して、以前にエクスポートした ZIP ファイルから 1 つ以上の参照データ・セットをインポートします。

    ZIP ファイルでインスタンスからすべてのガバナンス成果物をインポートする」で説明されているように、ZIP ファイルで参照データセットをインポートする場合は、API 呼び出しで常に「merge_option=all使用する必要があります。

  • UIまたはAPIリクエストを使用して、 CSV ファイルから参照データセットの定義をインポートします。 複数の参照データセット定義を1つのファイルにインポートできる。 この方法には参照データの値は含まれません - 値は別途インポートする必要があります。

  • UIまたはAPIリクエストを使用して、特定のセットの参照データ値を CSV ファイルからインポートします。

  • UIまたはAPIリクエストを使用して、 CSV ファイルから関連する参照データ値を既存の参照データセットにインポートします。

注: インポートできる値の最大数は 5000 個です。

ZIPファイル内の参照データセットをインポートまたはエクスポートする場合、そのファイルには、そのZIPファイルに含まれる参照データセットを定義する CSV ファイルが含まれており、別のフォルダ内には、各データセットごとに参照データの値が格納された CSV ファイルが1つずつ含まれています。 これらの 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 」ファイルをインポートする方法について説明します。 UI で、インポート・タスクの進行状況表示バーを表示したり、インポートの要約をエラーの説明とともに表示したりすることもできます。 参照データ値をインポートする場合、インポート要約にリストされている保存済みの値の数が、実際にインポートされた値の数と異なる可能性があることに注意してください。 これは、 CSV ファイル内の重複データはすべて保存済み値としてカウントされる一方で、最終的にインポートされるのはそれらの重複データのうち1つだけだからです（選択した重複データの処理方法によります）。

参照データセット定義ファイルをインポート

  1. メインメニューのGovernance>Reference dataをクリックする。

  2. Add reference data setをクリックし、Import from fileを選択する。

  3. 前述のように参照データセットの定義が含まれている CSV ファイルを選択してください。

  4. マージオプションを選択する。 このオプションは参照データセットの定義に関係するものであり、その値に関係するものではないことに注意。 値は別のステップでインポートする必要がある。

  5. 「次へ」をクリックする

その結果、新しい参照データセット定義が作成される。 作成後は、手動で値を追加することも、次のタスクで説明するように、別の 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

カスタム列を参照データ・セットにインポートするには、以下のようにします。

  1. 参照データ・セットを開き、 「ファイルのアップロード」をクリックします。 「 CSV 」ファイルを選択し、 「次へ 」をクリックします。
  2. ファイルの列を、参照データセットのデフォルトまたは既存の列にマッピングします。 新しいカスタム列を追加するには、 「ターゲット列」 ドロップダウン・リストから 「+ カスタム列の追加 (オプション)」を選択します。
  3. 列名、説明、最大文字数を指定し、列の値を別の参照データ・セットのコードに照らして検証するかどうかを指定します。
  4. カスタム列に 複合キーの一部としてマークを付けることができます。 複合キーの一部であるカスタム列は、デフォルトでは必須です。
  5. CSV ファイル内の、マッピングしたい各列について、上記の手順を繰り返します。
  6. すべての列をマップする場合は、情報を確認し、必要に応じて列を再配置して、 「保存」をクリックします。

関連する値のインポート

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 ファイルをインポートして関連する値を追加するには、以下の手順を実行してください：

  1. 関連する値を追加する参照データ・セットを開きます。
  2. 3 つのドットのメニューから、 「関連値のアップロード」をクリックします。
  3. アップロードしたいファイルを 関連する値のインポート ウィンドウにドラッグするか、またはファイルを参照することによって、ファイルを追加します。 そして、「次へ」 をクリックします。
  4. 1 つ以上の他のコード値にマップするコード値を持つ列をファイルから選択します。
  5. 各値と関連値の間に設定する関係の種類（一対一または一対多）を選択してください。
  6. マップ先の参照値の関連コード、および関連する値が属する参照データ・セットを含む列を、ファイルから選択します。
  7. 保存をクリックしてください。

注：複合キーによって定義された参照データ値を含む CSV ファイルを扱う際は、値間の親子関係、および単一マッピングおよび複数マッピングされた関連値が、CODEと複合キーのカスタム列の値を「|」で区切って連結した形式で表現されていることを確認してください。CODEは常に先頭に配置し、その後に複合キーの列値を続けます。例 CODE|CC1|CC2|CC3：

詳細情報