CSV(쉼표로 구분된 값) 형식의 카탈로그 외부에서 참조 데이터 세트를 작성한 후 값을 가져오거나 다시 가져올 수 있습니다. 또한 가져오기 값-다중 참조 데이터 세트의 값 사이의 맵핑 관계를 사용할 수 있습니다.
다음 방법 중 하나를 사용하여 참조 데이터 세트를 가져오십시오.
API 요청을 사용하여 이전에 내보낸 ZIP 파일에서 하나 이상의 참조 데이터 세트를 가져오십시오.
ZIP 파일로 인스턴스에서 모든 거버넌스 아티팩트 가져오기에 설명된 대로 참조 데이터 세트를 ZIP 파일로 가져올 때는 항상 API 호출에 '
merge_option=all'을 사용해야 합니다.UI 또는 API 요청을 사용하여 CSV 파일에서 참조 데이터 세트 정의를 가져옵니다. 여러 참조 데이터 세트 정의를 하나의 파일로 가져올 수 있습니다. 이 방법에는 참조 데이터 값이 포함되지 않으므로 값을 별도로 가져와야 합니다.
UI 또는 API 요청을 사용하여 특정 세트에 대한 CSV 파일에서 참조 데이터 값을 가져오십시오.
UI 또는 API 요청을 사용하여 관련 참조 데이터 값을 CSV 파일에서 기존 참조 데이터 세트로 가져오십시오.
IBM Knowledge Catalog 플랜은 생성할 수 있는 참조 데이터 세트의 수와 크기에 제한이 있습니다.
ZIP 파일로 참조 데이터 세트를 가져오거나 내보내는 경우 파일에는 해당 ZIP 파일에 포함된 참조 데이터 세트를 정의하는 CSV 파일이 포함되며 별도의 폴더에 참조 데이터 값이 있는 세트당 하나의 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 파일의 모든 중복이 저장된 값으로 계수되는 반면 이러한 중복 중 하나만 결국 가져오기 때문입니다 (선택한 중복 처리 방법에 따라).
참조 데이터 집합 정의가 있는 파일 가져오기
- 메인 메뉴에서 거버넌스 > 참조 데이터를 클릭합니다.
- 참조 데이터 집합 추가를 클릭하고 파일에서 가져오기를 선택합니다.
- 위에서 설명한 대로 참조 데이터 세트 정의가 포함된 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 파일을 가져와서 관련 값을 추가하려면 다음 단계를 완료하십시오.
- 관련 값을 추가할 참조 데이터 세트를 여십시오.
- 세 개의 점 메뉴에서 관련 값 업로드를 클릭하십시오.
- 관련 값 가져오기 창으로 끌거나 파일을 찾아 업로드하려는 파일을 추가하십시오. 그리고 나서 다음을 클릭하십시오.
- 하나 이상의 다른 코드 값에 맵핑할 코드 값이 있는 파일에서 열을 선택하십시오.
- 각 값과 관련 값 사이에 원하는 관계의 유형(일대일 또는 일대다)을 선택하십시오.
- 맵핑하려는 참조 값의 관련 코드가 있는 파일에서 열을 선택하고 관련 값이 속한 참조 데이터 세트를 선택하십시오.
- 저장 을 클릭하십시오.
참고: 복합 키로 정의된 참조 데이터 값이 있는 CSV 파일에 대해 작업할 때 값과 단일 및 다중 맵핑된 관련 값 간의 상위 관계가 |로 구분된 CODE및 복합 키 사용자 정의 열 값의 연결로 표시되는지 확인하십시오. 코드는 항상 먼저 이동한 후 복합 키 열 값 (예: CODE|CC1|CC2|CC3) 으로 이동합니다.
자세한 정보
상위 주제: 참조 데이터