룩업

개요

룩업(lookup)은 로그프레소 소나에서 쿼리를 실행하면서 수시로 조회되는 데이터를 간편하게 관리할 수 있는 테이블입니다. 예를 들어 쿼리에서 자주 사용하는 임직원 ID, 우편번호, 국가코드와 같은 데이터를 룩업에 등록해 사용할 수 있습니다.

룩업 조회

분석 > 룩업 메뉴에서 룩업 목록을 확인할 수 있습니다.

• 이름: 룩업의 고유 이름
• 설명: 룩업에 대한 설명
• 건수: 룩업에 등록된 레코드 건수

특정 룩업을 검색하려면 목록 좌측 상단의 검색창을 사용하세요. 입력한 단어가 이름 또는 설명에 포함된 록업이 검색됩니다. 검색은 대소문자를 구분하지 않습니다.

룩업 데이터 조회

룩업의 데이터를 확인하려면 룩업의 이름을 클릭하세요. 예를 들어 위 그림에서 users를 클릭하면 users 룩업의 데이터 조회 패널이 나타납니다.

데이터 조회 패널에서는 해당 룩업에 저장된 레코드를 확인할 수 있습니다. 각 레코드는 여러 필드로 구성되며, 최소 2개의 필드를 포함해야 합니다. 첫 번째 필드는 키 필드로 사용됩니다.

룩업 테이블의 첫 번째 행은 필드 이름으로 사용됩니다. 이 행에는 (1) 필드 이름, (2) 입력 가능한 값의 최대 길이, (3) 빈 값 허용 여부가 표시됩니다. 빈 값을 허용하지 않는 필드 이름 앞에는 별표(*)가 붙습니다. 예를 들어 * id (10)은 빈 값을 허용하지 않는 필드이며, 이름은 id, 값의 최대 길이는 10자입니다.

룩업 스키마 조회

룩업에 적용된 스키마를 확인하려면, 룩업 패널 우측 상단의 스키마 조회 버튼을 클릭하세요. 이 버튼은 토글 방식으로, 데이터 조회 화면에서 스키마 조회 화면으로, 스키마 조회 화면에서는 다시 데이터 조회 화면으로 전환할 때 쓰입니다.

스키마 조회 패널에서는 룩업의 기본 속성과 룩업 스키마를 확인할 수 있습니다. 룩업 스키마에는 필드 이름, 길이, 빈 값 허용 여부 등 룩업을 구성하는 필드 속성이 정의됩니다.

• 스키마 조회 화면에서는 새 필드 추가 및 필드 삭제 버튼("-")이 비활성화되어 있습니다. 룩업 스키마는 룩업 추가 시에만 정의할 수 있으며, 한 번 정의된 스키마는 수정할 수 없습니다.
• 스키마 조회 화면 우측 상단의 데이터 조회 버튼을 클릭하면 데이터 조회 화면으로 전환됩니다.

룩업 조회 쿼리

쿼리에서 룩업 데이터를 조회하려면 lookup 명령을 사용하세요. 룩업 테이블의 내용을 조회하려면 lookuptable 명령을 사용하세요.

룩업 추가

1. 목록 우측 상단의 추가 버튼을 클릭하세요.

   

2. 기본 속성을 입력하세요. 이름과 설명 항목이 포함됩니다.

   

   • 이름: 룩업의 고유 이름
   • 설명: 룩업에 대한 설명

3. 룩업 스키마를 설정하세요. 룩업은 최대 40개의 필드로 구성할 수 있습니다. 새 필드 버튼을 눌러 필드를 추가하거나, 필드 오른쪽의 삭제("**-") 버튼을 클릭해 필드를 제거할 수 있습니다.

   

   • 필드 이름: 필드의 고유 이름. 첫 번째 필드는 키 필드로 사용됩니다. created, created_at, updated, updated_at은 예약어기 때문에 사용할 수 없습니다.
   • 길이: 필드 값의 최대 길이(문자 수 기준). 키 필드는 최대 255자, 그 외 필드는 최대 2,000자까지 입력할 수 있으며, 전체 필드 길이의 합은 50,000자를 초과할 수 없습니다.
   • 빈 값 허용: 빈 값(null) 입력 허용 여부. 키 필드에는 빈 값을 입력할 수 없습니다.

4. 룩업 스키마는 한 번 정의하면 수정할 수 없으므로, 구성 내용을 반드시 확인하세요. 기본 속성과 룩업 스키마를 모두 입력한 후, 저장 버튼을 클릭해 룩업을 추가하세요.

룩업 수정

룩업은 한 번 정의되면 스키마를 수정할 수 없고, 이름 또는 설명같은 기본 속성만 수정할 수 있습니다.

1. 스키마 조회 화면에서 룩업의 기본 속성을 수정할 수 있습니다.

   

2. 이름과 설명을 변경한 뒤 저장 버튼을 클릭하면 수정 사항이 반영됩니다.

   

룩업 삭제

1. 룩업 목록에서 삭제할 항목의 왼쪽 체크박스를 선택하고 목록 우측 상단의 버튼을 클릭하세요.

2. 룩업 삭제 대화상자에서 삭제 대상의 이름을 확인하고 삭제 버튼을 클릭하세요. 삭제를 취소하려면 취소 버튼을 클릭하세요.

   

3. 전체 목록에서 해당 룩업이 삭제되었는지 확인하세요.

룩업 목록 다운로드

룩업 목록을 로컬 PC에 파일로 저장하려면 목록 우측 상단의 버튼을 클릭하세요. 룩업 목록 다운로드 대화상자가 나타나면 필요한 항목을 입력하거나 선택한 후 확인 버튼을 클릭하세요.

• 이름: 다운로드할 파일의 이름을 입력하세요. 기본값은 "룩업 목록"입니다.
• 컬럼: 파일에 포함할 룩업 속성을 선택하세요. 전체 선택을 클릭하면 모든 속성이 포함됩니다.
• 형식: 다운로드할 파일의 형식을 선택하세요(기본값: CSV).
  • CSV: CSV 파일
  • Excel XML: Microsoft Excel에서 열어볼 수 있는 XML 파일
  • Microsoft Word: DOCX 파일
  • HTML: HTML 파일
  • JSON: JSON 파일
  • PDF: PDF 파일
  • Hancom HWPX: HWPX 파일
• 인코딩: 파일 문자 인코딩 형식을 선택하세요(기본값: 확장완성형). 선택 가능한 옵션은 UTF-8, UTF-16 BE, 확장완성형입니다.
• 범위: 목록에 포함할 룩업의 개수를 지정하세요. 가장 최근에 생성된 항목부터 설정한 개수만큼 포함됩니다.

룩업 레코드 관리

이 섹션에서는 룩업에 레코드를 추가, 수정, 삭제하는 방법과 룩업 데이터를 파일로 백업하는 방법을 설명합니다.

도구 모음

룩업 데이터 조회 화면에서 룩업 레코드를 관리할 수 있습니다. 다음은 룩업 레코드 관리에 사용되는 도구 모음의 구성입니다.

(1) 레코드 필터

전체 레코드를 조회하거나, 테이블의 첫번째 필드가 체크된 항목만 필터링합니다(전체, 선택됨).

(2) 검색

검색어를 입력한 후 돋보기 버튼을 클릭하면, 해당 문자열을 포함한 레코드를 조회합니다. 레코드 선택 상태나 # 필드 값은 검색할 수 없습니다.

(3) 특정 행으로 이동

숫자를 입력하고 이동 버튼을 클릭하면 # 필드 값이 해당 숫자인 레코드로 이동합니다.

(4) 조회 레코드 개수

현재 조회 중인 레코드 개수를 표시합니다.

(5) 새 레코드

단일 입력 기능을 사용해 룩업 레코드를 한 건 추가합니다.

(6) 일괄 입력

일괄 입력 기능을 통해 여러 건의 레코드를 한 번에 추가합니다.

(7) 다운로드

룩업 레코드 백업 기능을 이용해 현재 레코드를 CSV 파일로 내려받습니다.

(8) 업로드

파일 업로드 기능을 통해 CSV 파일로 레코드를 추가합니다.

(9) 새로 고침

레코드 목록을 최신 상태로 갱신합니다.

(10) 휴지통

선택한 레코드를 삭제합니다.

룩업 레코드 추가

룩업에 레코드를 추가하는 방법은 단일 입력, 일괄 입력, 파일 업로드입니다.

단일 입력

레코드를 한 건만 추가할 때 사용하는 방식입니다. 사용자가 직접 각 필드에 값을 입력하며, 입력값이 룩업 스키마를 준수하지 않으면 오류 메시지가 표시됩니다.

1. 룩업 데이터 조회 화면에서 새 레코드 버튼을 클릭하세요.

   

2. 각 필드에 값을 입력하고 추가 버튼을 클릭하세요.

   

   입력값이 스키마 조건을 만족하지 않으면 오류 메시지가 표시됩니다. 메시지를 참고해 올바른 값을 입력하세요.

   

일괄 입력

여러 건의 레코드를 한 번에 입력할 수 있는 기능입니다. 마이크로소프트 엑셀과 유사한 그리드 화면에서 직접 데이터를 입력하거나, Excel 또는 Google Sheets에서 복사한 내용을 붙여넣을 수 있습니다.

한 번에 추가할 수 있는 레코드 수는 최대 1,000건입니다. 그 이상을 추가하려면 파일 업로드를 이용하세요.

일괄 입력할 레코드는 다음과 같이 룩업 스키마에 맞춰 작성되어 있어야 합니다.

• 키 필드는 반드시 값을 포함해야 합니다.
• 필드값은 룩업 스키마에 정의된 필드 순서를 따라야 합니다.
• 각 필드는 스키마에 정의된 제약 조건(길이, 빈 값 허용 여부 등)을 준수해야 합니다.

입력값이 스키마 조건을 만족하지 않으면 오류 메시지가 표시됩니다. 메시지를 참고해 올바른 값을 입력하세요.

1. 룩업 데이터 조회 화면에서 일괄 입력 버튼을 클릭하세요.

   

2. 룩업 데이터 편집 모드로 전환되면 각 필드에 값을 입력하고 저장 버튼을 클릭하세요.

   

   • 마이크로소프트 엑셀엑셀처럼 셀을 직접 입력할 수 있습니다.

   • 스프레드시트 형식(XLS, XLSX 등)에서 복사한 데이터를 붙여넣을 수 있습니다.

   • 입력값이 스키마에 맞지 않으면 오류 셀이 붉게 표시되며, 셀에 커서를 올리면 풍선 도움말로 오류 메시지를 확인할 수 있습니다.

     

   • 도구 모음에 있는 레코드 필터에서 오류를 선택하면 오류가 있는 레코드만 필터링할 수 있습니다.

     

파일 업로드

CSV 파일을 업로드하여 룩업 레코드를 추가할 수 있습니다. 대량의 레코드를 별도로 관리할 때 유용한 방식입니다.

CSV 파일은 반드시 룩업 스키마를 준수해야 하며, 다음 조건을 충족해야 합니다:

• 첫 행은 스키마에 정의된 모든 필드를 포함해야 하며, 필드 순서는 관계없습니다.
• 키 필드는 반드시 값을 포함해야 합니다.
• 각 필드는 스키마에 정의된 제약 조건(길이, 빈 값 허용 여부 등)을 준수해야 합니다.

로그프레소 서버는 레코드를 저장하기 전에 스키마 적합성을 검증합니다. 모든 레코드가 유효해야만 저장되며, 하나라도 오류가 있으면 전체 레코드는 저장되지 않습니다.

1. 룩업 데이터 조회 화면에서 업로드 버튼을 클릭하세요.

   

2. 룩업 파일 업로드 대화상자에서 업로드할 CSV 파일과 인코딩 방식을 선택한 후 업로드 버튼을 클릭하세요.

   

   • 파일: 업로드할 CSV 파일을 선택하세요.
   • 인코딩: UTF-8, UTF-16 BE, 확장완성형 중에서 선택하세요.

   서버는 CSV 파일의 스키마 적합성을 자동으로 검증합니다. 다음과 같은 경우 룩업 파일 업로드 실패 메시지가 표시됩니다:

   • 필드 불일치: 파일의 첫 행이 스키마에 정의된 필드와 일치하지 않음

     

   • 필드 제약 조건 위반: 키 필드 누락, 빈 값 포함, 최대 길이 초과 등

     

3. 검증된 CSV 파일은 로그프레소 서버로 전송되고 룩업 파일 업로드 완료 메시지가 표시됩니다. 창을 닫으려면 완료를 클릭하세요.

   

   전송 중 통신 오류가 발생한 경우 다음과 같은 실패 메시지가 표시됩니다.

   

룩업 레코드 수정

룩업 레코드를 수정하려면,

1. 룩업 데이터 조회 화면에서 수정할 레코드의 셀을 더블 클릭하거나, 화살표 키로 셀을 선택한 뒤 Enter 키를 누르세요.

   

2. 셀이 편집 모드로 전환되면 값을 수정하세요. 수정 후 Enter 키를 누르면 저장되며, Esc 키를 누르면 수정이 취소됩니다.

룩업 레코드 삭제

룩업 레코드를 삭제하려면,

1. 룩업 데이터 조회 화면에서 삭제할 레코드를 선택하고 도구 모음에서 버튼을 클릭하세요.

2. 룩업 레코드 삭제 대화상자에서 삭제 대상의 개수를 확인한 후 삭제 버튼을 클릭하세요. 삭제를 취소하려면 취소 버튼을 클릭하세요.

   

3. 룩업 데이터 화면에서 해당 레코드가 삭제되었는지 확인하세요.

룩업 레코드 백업

룩업 레코드를 CSV 파일로 다운로드하여 백업할 수 있습니다. 전체 레코드 또는 선택한 레코드만 백업할 수 있습니다.

1. 룩업 데이터 조회 화면의 도구 모음에서 다운로드 버튼을 클릭하세요. 특정 레코드만 선택한 상태에서 클릭하면 해당 레코드만 백업됩니다.

   

2. 룩업 파일 다운로드 대화상자에서 파일 속성을 지정한 후 확인 버튼을 클릭하세요.

   

   • 이름: 다운로드할 파일의 이름을 입력하세요. 기본값은 "룩업"입니다.
   • 형식: 다운로드할 파일의 형식을 선택하세요. 현재는 CSV 형식만 지원됩니다.
   • 인코딩: 파일의 문자 인코딩 형식을 선택하세요. UTF-8, UTF-16 BE, 확장완성형 중에서 선택하세요.
   • 범위: 백업할 레코드 범위를 지정하세요. 룩업 데이터 조회 화면의 첫 번째 행의 번호가 1입니다. 특정 레코드를 선택하여 백업하는 경우에는 범위 설정 항목이 표시되지 않습니다.