Code Group

VPC 환경에서 이용 가능합니다.

NIMORO 서비스별로 특화된 코드를 코드 그룹(Code Group)으로 구성하여 관리하는 방법을 설명합니다. 외부 DB에서 코드 테이블(Code Table)을 불러온 후 상세 설정을 할 수 있습니다.

Code Group 화면

Code Group 화면은 다음과 같이 구성되어 있습니다.

코드 그룹 생성

코드 그룹을 생성하는 방법은 다음과 같습니다.

1. NIMORO 콘솔에 접속해 주십시오.(NIMORO 콘솔 접속 참조)
2. 좌측 메뉴에서 (NIMORO Studio)을 클릭해 주십시오.
3. Data Manage > Code Group 메뉴를 차례대로 클릭해 주십시오.
4. [CREATE CODE GROUP] 버튼을 클릭해 주십시오.
5. 다음 단계를 차례대로 진행해 주십시오.
   • 1. 코드 그룹 기본 정보 입력(Edit Code Group Info)
   • 2. 코드 테이블 쿼리 작성 및 미리보기(Import Code Table)
   • 3. 코드 테이블 세부 설정(Set Code Column)
   • 4. 분석 데이터 내용 갱신(Update References)

1. 코드 그룹 기본 정보 입력(Edit Code Group Info)

코드 그룹에 대한 기본 정보를 입력한 후 [NEXT] 버튼을 클릭해 주십시오.

• Code Group Name: 생성할 코드 그룹 이름 입력
  • 최대 30자까지 입력할 수 있습니다.
• Descriptions: 생성할 코드 그룹 설명 입력
  • 최대 500자까지 입력할 수 있습니다.

2. 코드 테이블 쿼리 작성 및 미리보기(Import Code Table)

코드 테이블을 불러오는 쿼리를 작성하고 [Apply] 버튼을 클릭해 쿼리 유효성 검증 및 미리보기 확인 후에 [NEXT] 버튼을 클릭해 주십시오.

• 코드 그룹 정보
  • 코드 그룹 이름
  • Descriptions: 코드 그룹 설명
  • Using This: 코드 그룹을 사용 중인 데이터 디자인 및 위저드 개수
• Import Code Table
  • Connector: 생성할 코드 그룹 커넥터 선택
    • Trino 커넥터 중에서 선택할 수 있습니다.
  • Query 입력: 커넥터에서 불러올 코드 테이블 선언 쿼리 입력
    • WHERE, CALCULATED 조건을 포함해서 작성합니다.
    • 코드 값에 ','(콤마) 또는 ':'(콜론)이 포함된 경우 해당 기호를 기점으로 코드 값을 분리하여 인식합니다. 코드 값을 분리되지 않은 상태로 제공하려는 경우 기호 대체 쿼리 문법을 통해 다른 기호로 대체하여 사용해야 합니다.
      • 기호 대체 쿼리 문법: regexp_replace(code column, condition, replace_string) as alias
      • <예시> regexp_replace(comm_cd_nm, ‘,’, ‘_’) as comm_cd_nm
  • 코드 데이터 미리보기: 불러온 코드 테이블의 샘플 데이터 표시
    • 최대 100건까지 표시됩니다.
    • 전체 데이터 열 개수를 확인할 수 있습니다.

3. 코드 테이블 세부 설정(Set Code Column)

코드 그룹 정보를 확인하고, 코드 테이블의 컬럼별로 세부 설정을 완료한 후 [SAVE] 버튼을 클릭해 주십시오.

• 코드 그룹 정보
  • 코드 그룹 이름
  • [Update History] 버튼: 클릭하여 코드 그룹 변경 이력 갱신
  • Created: 코드 그룹 생성 일시(yyyy-mm-dd hh:mm:ss) 및 생성자 이름
  • Last Edited: 코드 그룹 수정 일시(yyyy-mm-dd hh:mm:ss) 및 수정자 이름
  • Descriptions: 코드 그룹 설명
  • Code Sync: 코드 동기화 상태 및 일시(yyyy-mm-dd hh:mm:ss)
    • : 클릭하여 코드 동기화
  • Using This: 현재 코드 그룹을 사용 중인 데이터 디자인과 위저드 개수
• Code Column List: 코드 테이블 전체 컬럼 목록
  • no: 컬럼 목록 번호
  • Column Name: 컬럼 이름
  • Descriptions: 컬럼 설명
  • Join Key: 코드 테이블이 데이터 디자인의 특정 코드 컬럼 간 병합(Join) 조건 사용 여부
    • Y: Join Key 활용함
    • N: Join Key 활용하지 않음
  • Info 여부: 데이터 디자인 매핑 시 디멘션 또는 KPI 활용 컬럼 사용 여부
    • Y: Info 컬럼 활용함
    • N: Info 컬럼 활용하지 않음
    • Info 컬럼에만 태그를 지정할 수 있으며, 분석 콘텐츠 생성 시 태그가 지정된 Info 컬럼을 디멘션 또는 KPI로 활용 가능합니다.
  • Sort: 컬럼 정렬(표시 순서) 기준 정보
    • 해당 컬럼 항목 클릭 시 컬럼 정렬 기준 설정 가능
  • Using This: 컬럼을 사용 중인 데이터 디자인과 위저드 확인
    • 최초 생성 시에는 0건이 표시됩니다.
    • 목록을 클릭하여 해당 데이터 디자인 또는 위저드 수정 화면으로 이동할 수 있습니다.

컬럼 정렬 기준 설정

코드 테이블 컬럼의 Sort 항목을 클릭하여 컬럼 정렬 기준 설정 팝업 창이 나타나면 정보를 확인 및 입력한 후 [SAVE] 버튼을 클릭해 주십시오.

• Column Name: 컬럼 이름 확인
• Sort by: 정렬 기준 적용 대상 컬럼 선택
  • 현재 조회 중인 컬럼이 기본값으로 설정됩니다.
  • 해당 컬럼의 정렬 방식에 따라 모든 설정 대상 컬럼의 코드 값이 정렬됩니다.
• Custom Order: Sort by에서 선택한 컬럼의 코드 값을 직접 입력
  • 필요한 경우에만 입력합니다.
  • 해당 코드 값을 우선으로 적용하여 정렬합니다.
• Default Order: Custom Order에서 설정한 값을 제외한 나머지 코드 값들의 정렬 조건 선택
  • None: 실제 코드 값 순서 적용
  • ASC: 오름차순 정렬
  • DESC: 내림차순 정렬
  • NUMBER_ASC: 코드 값을 숫자로 인식하여 오름차순 정렬
    • 데이터 타입은 무관합니다.
    • <예시> 실제 코드 값이 String 타입의 '1, 13, 9, 7'일 경우, '1, 7, 9, 13'으로 정렬되어 표시됩니다.
  • NUMBER_DESC: 코드 값을 숫자로 인식하여 내림차순 정렬
    • 데이터 타입은 무관합니다.
    • <예시> 실제 코드 값이 String 타입의 '1, 13, 9, 7'일 경우, '13, 9, 7, 1,'로 정렬되어 표시됩니다.

4. 분석 데이터 내용 갱신(Update References)

코드 그룹을 사용하는 데이터 디자인, NIMORO Wizard 목록을 조회한 후 관련 데이터 디자인과 위저드 내용을 갱신합니다.

• 해당 코드 그룹을 Data Design에서 사용 중인 경우
  • No: 데이터 디자인 목록 번호
  • Data Design Name: 데이터 디자인 이름
  • Last Deployed: 마지막으로 배포한 일시(yyyy-mm-dd hh:mm)
  • Last Deployer: 마지막으로 배포한 사용자 이름
  • : 클릭하여 Data Design 수정
• 해당 코드 그룹을 Wizard에서 사용 중인 경우
  • No: 위저드 목록 번호
  • Wizard Name: 위저드 이름
  • Last Deployed: 마지막으로 배포한 일시(yyyy-mm-dd hh:mm)
  • Last Deployer: 마지막으로 배포한 사용자 이름
  • : 클릭하여 위저드 수정

코드 그룹 수정

코드 그룹 정보를 수정하는 방법은 다음과 같습니다.

1. NIMORO 콘솔에 접속해 주십시오.(NIMORO 콘솔 접속 참조)
2. 좌측 메뉴에서 (NIMORO Studio)을 클릭해 주십시오.
3. Data Manage > Code Group 메뉴를 차례대로 클릭해 주십시오.
4. 수정하려는 코드 그룹 항목 또는 을 클릭해 주십시오.
5. 코드 그룹 생성 단계 중 수정을 원하는 단계를 클릭해 주십시오.
6. 필요한 정보를 수정해 주십시오.

코드 수동 동기화

코드 동기화(Code Sync)는 쿼리 기반으로 개발한 코드 그룹의 최신성을 확보하기 위해 코드 목록이 갱신되고 NIMORO 서비스와 연동됩니다. 매일 자동으로 서비스 내에서 동기화되나, 수동으로 코드 그룹 내에서 코드를 동기화하는 방법은 다음과 같습니다.

1. NIMORO 콘솔에 접속해 주십시오.(NIMORO 콘솔 접속 참조)
2. 좌측 메뉴에서 (NIMORO Studio)을 클릭해 주십시오.
3. Data Manage > Code Group 메뉴를 차례대로 클릭해 주십시오.
4. 다음 2가지 방법 중 한 가지를 수행해 주십시오.
   • 동기화하려는 코드 그룹 우측의 > Code Sync 클릭
   • 동기화하려는 코드 그룹 우측의 > Code Sync 클릭

코드 그룹 삭제

코드 그룹을 삭제하는 방법은 다음과 같습니다.

1. NIMORO 콘솔에 접속해 주십시오.(NIMORO 콘솔 접속 참조)
2. 좌측 메뉴에서 (NIMORO Studio)을 클릭해 주십시오.
3. Data Manage > Code Group 메뉴를 차례대로 클릭해 주십시오.
4. 삭제하려는 코드 그룹 우측의 > Delete를 클릭해 주십시오.
5. [예, 삭제합니다] 버튼을 클릭해 주십시오.