파일을 사용하여 통제 아티팩트를 가져올 수 있습니다. 한 번에 한 가지 유형의 거버넌스 아티팩트를 가져오거나 다른 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 파일로 분리
- 지원되는 컬럼 수정
- 필수 열 추가
import 메소드 비교
목표 및 상황에 적합한 가져오기 방법을 선택하십시오.
- 단일 유형의 아티팩트 가져오기
CSV 파일을 사용하여 한 번에 하나의 통제 아티팩트 유형을 가져올 수 있습니다.
이 메소드는 다음 유형의 상황에서 유용합니다.
- 가져온 아티팩트에 워크플로우가 적용되도록 하려고 합니다.
- 한 유형의 통제 아티팩트에 특성 값을 추가하려고 합니다. 해당 아티팩트 유형을 CSV 파일로 내보내고 CSV 파일을 편집한 후 가져오십시오. 예를 들어, 이 메소드를 사용하여 비즈니스 용어에 사용자 정의 속성을 추가할 수 있습니다.
- 다른 프로그램에서 아티팩트를 정의하려고 합니다. 각 아티팩트 유형에 대한 CSV 파일을 작성하십시오. 예를 들어, 이 메소드를 사용하여 스프레드시트 프로그램에서 아티팩트를 정의한 후 가져올 수 있습니다.
CSV 파일이 있는 유형별 통제 아티팩트 가져오기 및 통제 아티팩트 가져오기를 위한 CSV 파일 형식을 참조하십시오.
- 여러 유형의 아티팩트 가져오기
IBM Knowledge Catalog 인스턴스에서 여러 유형의 기존 거버넌스 아티팩트를 내보내서 만든 ZIP 파일로 여러 유형의 거버넌스 아티팩트를 가져올 수 있습니다. ZIP 파일에는 카테고리 및 내보낸 모든 아티팩트 유형에 대한 CSV 파일이 포함되어 있습니다. CSV 파일은 다음을 제외하고 CSV 가져오기 파일의 형식과 일치합니다.
- 이름 및 카테고리 경로로 아티팩트를 식별하는 대신 아티팩트의 ID를 포함하는 추가 아티팩트 ID 열.
- 관련 아티팩트는 컨텍스트 및 이름 대신 아티팩트 ID를 사용하여 정의됩니다.
이 메소드는 다음 유형의 상황에서 유용합니다.
- 모든 거버넌스 아티팩트를 한 IBM Knowledge Catalog 인스턴스에서 다른 인스턴스로 이동하려고 합니다.
다음 표에는 CSV 파일 또는 ZIP 파일을 사용하여 아티팩트를 가져오는 경우의 차이점이 요약되어 있습니다.
| 요건 | CSV 파일 | ZIP 파일 |
|---|---|---|
| 파일 작성 | 한 가지 유형의 기존 아티팩트 내보내기 스프레드시트 프로그램에서 파일 작성 IBM InfoSphere Information Governance Catalog 에서 아티팩트 내보내기 및 형식 조정 |
인스턴스에서 여러 유형의 아티팩트 내보내기 |
| 아티팩트 유형 수 | 파일당 카테고리 또는 하나의 아티팩트 유형입니다. | 카테고리 및 각 유형의 아티팩트가 있는 여러 유형의 아티팩트가 별도의 CSV 파일에 있습니다. |
| 가져오기 방법 | UI API 요청을 통해 |
API 요청 |
| 워크플로우 | 모든 아티팩트를 초안으로 가져오고 워크플로우에 종속됩니다. 카테고리는 워크플로우에 종속되지 않으므로 즉시 공개됩니다. | 모든 아티팩트 및 카테고리가 즉시 공개됩니다. |
| 필요 권한 | 카테고리를 작성하거나 편집할 수 있는 권한입니다. 가져올 카테고리의 편집자 이상이어야 합니다. 세부사항은 필수 권한을 참조하십시오. | 용어집 관리 권한 |
가져올 수 있는 거버넌스 아티팩트
두 가져오기 메소드 모두를 사용하여 카테고리 및 다음 유형의 통제 아티팩트를 가져올 수 있습니다.
제한사항:
- 다른 아티팩트와의 관계를 포함하여 이러한 유형의 통제 아티팩트의 모든 특성에 대한 값을 가져올 수 있습니다. 그러나 관계는 관련 아티팩트가 있거나 동일한 가져오기 프로세스에 정의된 경우에만 가져옵니다. 가져오기 프로세스에서 건너뛴 관계를 추가하려면 먼저 가져온 모든 초안 아티팩트를 공개한 후 가져오기 프로세스를 다시 실행하십시오.
- CSV를 사용하여 Cloud Pak for Data 인스턴스 간에 통제 아티팩트 및 해당 관계를 이동할 수 없습니다. 예를 들어, 일치하는 메소드 참조 데이터와 일치 를 사용하여 데이터 클래스를 CSV로 내보낸 후 다른 Cloud Pak for Data 인스턴스로 가져오려는 경우 아티팩트 ID가 CSV 가져오기 및 내보내기에 포함되지 않으므로 가져오기에 실패합니다. 대신 ZIP 가져오기를 사용하십시오.
- CSV 파일에서 참조 데이터 세트를 가져올 때 해당 세트의 참조 데이터 값을 가져오지 않습니다. 별도의 CSV를 사용하여 값을 데이터 세트로 가져와야 합니다. 또는 ZIP 가져오기를 사용하여 참조 데이터 세트 및 해당 참조 데이터 값을 모두 가져올 수 있습니다. 자세한 정보는 참조 데이터 세트의 파일 가져오기를 참조하십시오.
- 데이터 보호 규칙 또는 데이터 위치 규칙을 가져올 수 없습니다.
가져온 아티팩트와 기존 아티팩트를 병합하기 위한 메소드
CSV 파일 또는 ZIP 파일을 사용하여 아티팩트를 가져오는지 여부에 상관없이, 이미 존재하는 통제 아티팩트를 가져올 때 발생하는 상황과 특성의 값이 서로 다를 때 발생하는 상황을 선택해야 합니다. 다음 표에는 세 가지 병합 방법이 요약되어 있습니다.
| 병합 방법 | API | 원래 값에 미치는 영향 | 가져온 값에 대한 영향 |
|---|---|---|---|
| 모든 값 바꾸기 | merge_option=all |
모든 원래 값을 버립니다. | 비어 있는 값을 포함하여 가져온 모든 값을 허용합니다. |
| 정의된 값으로 바꾸기 | merge_option=specified |
가져온 값이 비어 있는 경우 원래 값을 유지합니다. | 비어 있는 값을 제외한 모든 가져온 값을 허용합니다. |
| 빈 값 바꾸기 | merge_option=empty |
비어 있는 값을 제외하고 원래 값을 유지합니다. | 빈 값을 대체하는 가져온 값만 허용합니다. |
새 아티팩트의 경우 이러한 각 메소드는 동일한 결과를 생성합니다.
모든 값 바꾸기
아티팩트의 모든 원래 값을 버리고 가져온 아티팩트의 값으로 대체합니다. 가져온 아티팩트의 특성 값이 비어 있는 경우 해당 특성의 원래 값이 제거됩니다.
예를 들어, 이름이 release 인 공개된 비즈니스 용어가 있고 이를 수정하기 위해 CSV 파일을 가져온다고 가정합니다. 다음 표에는 모든 값 바꾸기 옵션의 효과가 표시되어 있습니다.
| 특성 | 원래 값 | CSV 파일의 값 | 결과 값 |
|---|---|---|---|
| 이름 | 릴리스 | 릴리스 | 릴리스 |
| 아티팩트 유형 | glossary_term | glossary_term | glossary_term |
| 카테고리 | 마케팅 | 마케팅 | 마케팅 |
| 설명 | example term | example term edited | example term edited |
| 태그 | 베타 | 베타 | |
| 관련 용어 | 시장 > > 버전 | 시장 > > 날짜 | 시장 > > 날짜 |
| 분류 |
|
결과 초안 아티팩트에는 원래 값에 대한 다음 변경사항이 있습니다.
- 원래 설명이 새 설명으로 대체됩니다.
- 태그의 원래 비어 있는 값은 값으로 대체됩니다.
- 원래 관련 용어가 새 관련 용어로 대체됩니다.
- 원래 분류 값은 비어 있는 값으로 대체됩니다.
all 병합 옵션을 사용하는 경우 모든 CSV 컨텐츠가 아티팩트 간 관계와 관련하여 일치하는지 확인해야 합니다. 예를 들어, ZIP 가져오기 파일에 관계와 함께 연결된 용어 및 데이터 클래스가 모두 포함되어 있는 경우 이 관계는 데이터 클래스 CSV및 용어 CSV 모두에 있어야 합니다. 그렇지 않으면 관계 가져오기 동작을 예측할 수 없으며 관계를 가져올 수도 있고 가져올 수도 없습니다.
참조 데이터 값을 포함하는 ZIP 파일을 가져올 때 항상 API 호출에서 merge_option=all 를 사용해야 합니다.
정의된 값으로 바꾸기
아티팩트의 원래 값과 비어 있는 값은 가져온 아티팩트의 제공된 값으로 대체됩니다. 가져온 아티팩트의 특성 값이 비어 있으면 해당 특성의 원래 값이 유지됩니다.
예를 들어, 이름이 release 인 공개된 비즈니스 용어가 있고 이를 수정하기 위해 CSV 파일을 가져온다고 가정합니다. 다음 표에서는 정의된 값으로 바꾸기 옵션의 효과를 보여줍니다.
| 특성 | 원래 값 | CSV 파일의 값 | 결과 값 |
|---|---|---|---|
| 이름 | 릴리스 | 릴리스 | 릴리스 |
| 아티팩트 유형 | glossary_term | glossary_term | glossary_term |
| 카테고리 | 마케팅 | 마케팅 | 마케팅 |
| 설명 | example term | example term edited | example term edited |
| 태그 | 베타 | 베타 | |
| 관련 용어 | 시장 > > 버전 | 시장 > > 날짜 | 시장 > > 날짜 |
| 분류 |
|
|
결과 초안 아티팩트에는 원래 값에 대한 다음 변경사항이 있습니다.
- 원래 설명이 새 설명으로 대체됩니다.
- 태그의 원래 비어 있는 값은 값으로 대체됩니다.
- 원래 관련 용어가 새 관련 용어로 대체됩니다.
빈 값 바꾸기
원래 아티팩트의 비어 있는 값은 가져온 아티팩트의 제공된 값으로 대체됩니다.
예를 들어, 이름이 release 인 공개된 비즈니스 용어가 있고 이를 수정하기 위해 CSV 파일을 가져온다고 가정합니다. 다음 표는 비어 있는 값 대체 옵션의 효과를 표시합니다.
| 특성 | 원래 값 | CSV 파일의 값 | 결과 값 |
|---|---|---|---|
| 이름 | 릴리스 | 릴리스 | 릴리스 |
| 아티팩트 유형 | glossary_term | glossary_term | glossary_term |
| 카테고리 | 마케팅 | 마케팅 | 마케팅 |
| 설명 | example term | example term edited | example term |
| 태그 | 베타 | 베타 | |
| 관련 용어 | 시장 > > 버전 | 시장 > > 날짜 | 시장 > > 버전 |
| 분류 |
|
|
결과 초안 아티팩트는 다음과 같이 원래 값으로 변경됩니다.
- 태그의 원래 비어 있는 값은 값으로 대체됩니다.
보안 고려사항
CSV 파일로 내보낸 통제 데이터는 CSV 데이터를 자동으로 해석하는 스프레드시트 프로그램에 안전하도록 알려진 CSV 인젝션 공격에 대해 무결 처리됩니다. 결과적으로 다음 문자 중 하나로 시작하는 텍스트 값입니다.
- (=) 와 같음
- 더하기(P)
- 빼기(M)
- at (@)
작은따옴표 (') 가 앞에 붙습니다. 기능을 일관성 있게 유지하기 위해 가져온 CSV 파일을 추가로 구문 분석하여 작은따옴표 (') 를 자동으로 제거합니다. 관리 아티팩트에 CSV 파일이 포함되어 있으므로 ZIP 파일로 가져오고 내보낼 때에도 무결 처리가 적용됩니다.
이 기능을 사용하지 않도록 설정하려면
IBM Knowledge Catalog 용어집 서비스 배포 편집:
oc edit deployment wkc-glossary-service환경 변수
ESCAPE_FORMULAS_IN_CSV_FILES를false값으로 설정하십시오.
자세한 정보는 CSV 인젝션을 참조하십시오.
자세한 정보
상위 주제: 거버넌스 아티팩트 관리