화면: 데이터 사전

도메인

도메인은 같은 성격의 값이 함께 사용하는 타입 규칙(타입, 길이, 소수점, NULL 허용, 기본값, 자동증가)에 이름을 붙인 것입니다. 도메인 팩 안의 도메인을 만들고 수정하는 화면과, 커넥션 하나에서만 도메인을 수정해 사용하는 문서 탭도메인 탭을 설명합니다. 도메인이 컬럼의 타입을 어떻게 정하는지는 데이터 사전 에서, 도메인 팩을 새로 만들거나 받는 방법은 데이터 사전 관리 에서 설명합니다.

사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
앱 메뉴데이터 사전 관리 화면 왼쪽 목록에서 도메인 팩을 선택하면 오른쪽에 열립니다. 대시보드의 데이터 사전 목록에서 도메인 팩을 열면 화면도메인 관리 화면으로 같은 팩이 열립니다.

화면 구성

번호이름설명
1머리 줄공개 여부 아이콘, 팩 이름, 언어셋, 게시한 최신 버전입니다. 저장하지 않은 편집이 있으면 저장되지 않은 변경사항 표시가 붙습니다.
2팩 버튼팩 삭제, 내보내기, 변경 취소, 저장, 게시 버튼입니다. 게시와 백업은 게시, 버전과 백업 에서 설명합니다.
3팩 정보이름 칸, 작성자 칸, 설명 칸은 수정할 수 있습니다. 언어셋 칸은 만들 때 정한 값이라 변경할 수 없습니다.
4목록 도구 모음도메인을 추가하는 추가 버튼, 도메인 수, 단축키로 행을 추가하는 안내, 게시본과 다른 항목의 수, 엑셀 버튼과 검색 칸입니다.
5도메인 목록도메인 하나가 한 행입니다. 열은 아래 '도메인의 칸' 표와 같습니다. 셀을 클릭하면 바로 수정합니다. 이름을 클릭하면 상세 창이 열립니다.
6행 버튼상세 창을 여는 버튼, 행의 수정을 되돌리는 버튼(수정한 행에만 보임), 삭제 버튼입니다.
  • 기기에 저장된 도메인 팩(로그인하지 않고 만들었거나 로컬 프로젝트에서 복제한 팩)에는 게시 버튼, 공개로 전환 버튼, 멤버 탭, 버전 탭이 없습니다. 게시라는 단계가 없기 때문입니다.

도메인의 칸

칸뜻
이름컬럼에서 선택할 때 보이는 이름입니다. 한 팩 안에서 겹칠 수 없습니다(대소문자 구분 없음).
타입공통 타입입니다. 아래 '공통 타입과 DBMS 별 타입' 에서 설명합니다.
길이, 소수점타입이 받는 인자입니다. 받지 않는 타입이면 칸이 잠깁니다. 최댓값을 넘겨 적으면 타입의 최댓값으로 변경되고 알림이 표시됩니다. 길이가 꼭 있어야 하는 타입(VARCHAR 등)은 비워 두면 경고가 표시됩니다.
NULL 허용컬럼이 NULL 을 받는지입니다.
기본값컬럼의 기본값입니다. 아래 '기본값' 에서 설명합니다.
자동증가정수 계열 타입에서만 활성화할 수 있습니다. 다른 타입으로 변경하면 비활성화된 것으로 봅니다.
설명메모입니다. 컬럼에는 복사되지 않습니다.

도메인 추가하기

  1. 목록 도구 모음의 추가 버튼(4)을 클릭합니다. 도메인 추가 창이 열립니다.
  2. 이름 칸과 타입 칸을 기입하고, 타입에 맞게 길이 칸과 소수점 칸을 적습니다.
  3. 필요하면 NULL 허용 칸, 자동증가 칸, 기본값 칸, 설명 칸을 정하고 창의 추가 버튼을 클릭합니다.
  4. 새 행이 목록에 들어갑니다. 팩 버튼의 저장 버튼을 클릭해 저장합니다.
  • 셀에 있는 채로 Ctrl+Enter(macOS 는 Cmd+Enter)를 누르면 창 없이 행 바로 아래에 빈 행을 만듭니다. 여러 줄을 이어 넣을 때 사용합니다.
  • 이름이 같은 도메인이 이미 있으면 창의 추가 버튼이 눌리지 않습니다.

도메인 수정하기, 삭제하기

  1. 수정할 셀을 클릭해 바로 수정하거나, 이름(또는 행 버튼의 상세 버튼)을 클릭해 도메인 상세 정보 창에서 수정합니다.
  2. 수정한 행의 색이 변경되고 행 끝에 되돌리기 버튼이 나타납니다. 계정 자산에서는 행의 수정을 버리고 게시본의 값으로, 기기의 팩에서는 저장한 값으로 돌립니다. 기기의 팩은 저장하면 색이 원래대로 돌아갑니다.
  3. 삭제할 행은 행 버튼의 삭제 버튼을 클릭하고 확인합니다. 삭제한 행은 저장할 때까지 취소선으로 남고, 되돌리기 버튼으로 살릴 수 있습니다.
  4. 저장 버튼을 클릭합니다. 저장 전에 편집을 모두 버리려면 변경 취소 버튼을 클릭합니다. 마지막으로 저장한 상태로 돌아갑니다.
  • 저장한 것만으로는 팩을 지정한 커넥션이 변경되지 않는 경우가 있습니다. 서버의 팩(공식 팩, 계정 자산)은 커넥션이 게시한 버전 하나를 보고, 기기의 팩은 지정한 시점의 사본을 봅니다. 데이터 사전 의 '자산을 수정해도 커넥션은 지정한 시점에 머뭅니다' 를 보세요.

공통 타입과 DBMS 별 타입

도메인의 타입은 DBMS 와 상관없는 공통 타입(VARCHAR, DECIMAL, DATETIME, BOOLEAN, JSON 등)으로 적습니다. 같은 도메인 팩을 여러 DBMS 의 커넥션에 지정해 사용하기 위해서입니다.

  • 커넥션에서 도메인을 사용할 때는 공통 타입이 커넥션 DBMS 의 타입으로 변경됩니다. 예를 들어 Oracle 커넥션에서는 VARCHAR 가 VARCHAR2 가 되고, 길이의 최댓값도 커넥션 DBMS 를 따릅니다.
  • 관리 화면은 공통 타입만 수정합니다. 특정 DBMS 의 타입을 직접 선택하려면 원하는 DBMS 의 커넥션에서 도메인을 수정합니다(아래 '커넥션에서만 도메인 수정하기'). 커넥션의 화면은 타입 칸에 DB 의 타입 목록을 보여 주고, 선택한 값은 DBMS 에만 적용됩니다.
  • 커넥션의 화면에서 타입에 마우스를 올리면 공통 정의: VARCHAR 처럼 공통 타입이 보입니다.

기본값

기본값 칸은 세 가지 상태가 있습니다. 상세 창에서는 버튼으로 선택합니다.

상태뜻
리터럴적은 값을 그대로 기본값으로 사용합니다. 타입에 맞지 않는 값(숫자 타입에 글자, 날짜 형식이 아닌 값, 길이를 넘는 글자 등)은 저장할 수 없습니다.
표현식CURRENT_TIMESTAMP 같은 함수입니다. 목록에서 선택하거나 직접 적습니다. 타입에 사용할 수 없는 함수는 잠긴 채 이유와 함께 보입니다. 목록의 셀에서는 기울어진 보라색 글자로 보입니다.
미설정도메인에 기본값이 없습니다. 도메인을 컬럼에 지정하면 컬럼의 기본값이 비워집니다.
  • DBMS 에서만 통하는 이름으로 함수를 적으면 표준 이름으로 변경하라는 제안(CURRENT_TIMESTAMP 로 바꾸기)이 보입니다. 클릭하면 변경됩니다. 저절로 변경하지는 않습니다.

커넥션에서만 도메인 수정하기

커넥션에 지정한 도메인 팩을 커넥션에서만 수정해 사용할 수 있습니다. 원본 팩은 변경되지 않습니다. 수정하는 곳은 두 군데이고, 같은 편집을 봅니다. 한쪽에서 수정하면 다른 쪽에도 보입니다.

  • 탐색기의 커넥션 아래 Data Dictionary › Domains 노드를 클릭하면 열리는 문서 탭도메인 탭입니다. 탭의 동작은 아래에서 설명합니다.
  • 오른쪽 레일의 프로젝트 레일데이터 사전 패널입니다. 커넥션에 지정 에서 설명합니다.
번호이름설명
1도구 모음검색 칸, 도메인 수, 미저장 2건 표시, 도메인 추가 버튼, 삭제 버튼, 전체 되돌리기 버튼, 저장 (2) 버튼입니다.
2도메인 목록관리 화면과 같은 열이지만 타입, 길이, 소수점이 커넥션 DB 의 값으로 보입니다. 저장하지 않은 행은 색이 붙습니다.
  1. 탐색기에서 커넥션 아래 Data Dictionary 노드를 펼치고 Domains 노드를 클릭합니다. 탭 제목은 지정한 팩의 이름입니다.
  2. 셀을 수정하거나, 도메인 추가 버튼으로 도메인을 추가하거나, 행을 선택해 삭제 버튼을 클릭합니다.
  3. 저장 (1) 버튼을 클릭합니다. 바로 저장하지 않고 도메인 변경 영향 창이 먼저 열립니다.
  4. 창이 커넥션에서 도메인을 사용하는 컬럼을 찾아, 변경될 컬럼과 변경되는 값을 보여 줍니다. 확인하고 저장하고 반영 버튼을 클릭합니다.
  5. 도메인 편집이 저장되고, 선택한 컬럼에 새 값이 입력된 뒤 테이블이 저장됩니다.
  • 타입, 길이, 소수점이 다른 컬럼은 반영합니다. NULL 허용, 기본값, 자동증가만 다른 컬럼은 컬럼마다 다르게 둘 수 있는 값이라 'NULL 허용 · 기본값 · 자동증가' 변경 사항 적용 체크를 활성화했을 때만 반영합니다. 도메인의 NULL 허용, 기본값, 자동증가를 수정했으면 체크가 활성화된 채로 창이 열리니, 컬럼마다 다르게 둔 값이 있으면 비활성화하세요.
  • 테이블에 이미 자동증가 컬럼이 있으면 그 컬럼에는 자동증가만 제외하고 나머지(타입, 길이, NULL 허용, 기본값)를 반영하고 알립니다. 컬럼에 도메인을 선택할 때와 같은 규칙입니다. 다른 사람이 수정하고 있는 테이블도 건너뜁니다.
  • DB 정보를 읽지 못한 테이블은 읽지 못한 테이블 1개 묶음으로 따로 보입니다. 다시 검사 버튼이 다시 읽습니다.
  • 찾을 수 없는 도메인을 가리키는 컬럼은 끊어진 도메인 지정 1건 묶음으로 보입니다. 지정을 저절로 해제하지는 않습니다.
  • 저장 도중 실패하면 멈추고 남은 테이블 수를 알립니다. 다시 반영하면 남은 테이블부터 이어서 처리합니다.
  • 길이가 꼭 있어야 하는 타입인데 길이가 빈 도메인이 있으면 창을 열지 않고 도메인 이름을 알립니다.

컬럼에 도메인을 사용하면 변경되는 것

ERD 와 테이블 탭의 컬럼 목록에 Domain 열이 있습니다. 커넥션에 도메인 팩을 지정했을 때 사용할 수 있습니다.

일컬럼에 일어나는 일
도메인을 선택한다도메인의 타입(커넥션 DBMS 의 타입), 길이, 소수점, NULL 허용, 기본값, 자동증가가 컬럼에 복사됩니다. 기본값이 미설정 상태인 도메인은 컬럼의 기본값을 비웁니다.
도메인이 정한 값을 컬럼에서 직접 수정한다컬럼의 도메인 지정이 해제됩니다. 수정한 값은 남습니다.
도메인 지정을 지정 안 함 항목으로 변경한다지정만 해제되고 컬럼의 값은 그대로 남습니다.
커넥션에서 도메인을 수정해 저장한다위 도메인 변경 영향 창이 선택한 컬럼에만 새 값을 저장합니다.
관리 화면에서 원본 팩을 수정한다컬럼은 변경되지 않습니다. 커넥션이 보는 버전이나 사본이 그대로이기 때문입니다.
  • 컬럼에 값이 복사되므로, 팩을 열 수 없는 상태여도 ERD 와 DDL 은 그대로 동작합니다.
  • 컬럼의 값이 변경되면 테이블 설계가 변경된 것입니다. 실제 DB 에는 DB 반영을 해야 들어갑니다.
  • 컬럼의 논리명을 적으면 사전이 도메인을 선택해 주기도 합니다. 데이터 사전 의 '논리명 한 번으로 이름과 타입이 정해집니다' 를 보세요.

주의할 점

  • 저장하지 않은 도메인은 컬럼의 Domain 열에서 선택할 수 없습니다. 커넥션의 화면에서 만든 도메인도 저장한 뒤에 나타납니다.
  • 커넥션의 화면에서 저장하면 도메인을 사용하는 컬럼의 테이블이 함께 저장됩니다. 저장 전에 영향 창의 목록을 확인하세요. 길이가 줄어드는 변경을 DB 에 반영하면 데이터가 잘릴 수 있습니다.
  • 계정 프로젝트에서 내 역할에 Domain 제한 권한이 있으면 커넥션의 도메인을 읽기 전용입니다. 컬럼에 도메인을 선택하는 것은 가능합니다. 커넥션을 수정할 권한이 없을 때도 마찬가지입니다.
  • 도메인을 삭제한 뒤 사용하던 컬럼은 끊어진 지정으로 남습니다. 컬럼의 값은 그대로입니다.
  • 언어셋 칸은 만든 뒤 변경할 수 없습니다.

관련 화면

  • 데이터 사전: 도메인이 컬럼의 타입을 정하는 방식과 지정의 단위입니다.
  • 데이터 사전 관리: 도메인 팩을 만들고 받는 화면입니다.
  • 단어: 사전의 단어에 도메인을 연결하는 화면입니다.
  • 게시, 버전과 백업: 저장한 팩을 게시하고, 엑셀과 백업 파일로 옮기는 방법입니다.
  • 커넥션에 지정: 커넥션에 도메인 팩을 지정하고 데이터 사전 패널에서 수정해 사용하는 방법입니다.
  • DB 반영: 변경된 컬럼을 실제 DB 에 넣는 방법입니다.