데이터 사전은 조직이 합의한 이름과 타입의 규칙을 모아 둔 목록입니다. NeoSQL 은 데이터 사전을 ERD 의 컬럼 편집 안으로 가져와, 컬럼의 논리명을 기입하면 물리명과 타입이 표준대로 자동 기입됩니다. 아래에서는 단어와 도메인이 각각 무엇을 정하는지, 사전을 어디에 지정하는지, 사전을 수정하면 컬럼은 어떻게 되는지를 설명합니다.
단어는 이름을, 도메인은 타입을 통일합니다
데이터 모델링에서는 이름과 타입의 규칙을 보통 세 가지로 나누어 관리합니다.
| 개념 | 뜻 | 예 |
|---|---|---|
| 표준 단어 | 이름을 이루는 가장 작은 단위입니다. 정식 명칭과 영문 약어를 짝지어 둡니다 | 주문 = ORD, 일시 = DTM |
| 표준 용어 | 표준 단어를 이어 만든, 실제로 사용하는 컬럼명입니다 | 주문일시 = ORD_DTM |
| 도메인 | 같은 성격의 값이 함께 사용하는 타입 규칙에 이름을 붙인 것입니다 | 금액 = DECIMAL(15,2), 여부 = CHAR(1) |
같은 뜻을 사람마다 다르게 적으면(고객번호, cust_no, customer_id) 같은 값이 시스템마다 다른 이름과 다른 타입으로 흩어지고, 통합과 조회, 이관 때 비용이 됩니다. 표준 단어가 이름을 통일한다면, 도메인은 이름이 갖는 타입을 통일합니다.
NeoSQL 은 규칙을 두 종류의 자산에 담습니다. 둘은 따로 지정하므로 하나만 사용해도 됩니다.
| 자산 | 담는 것 | 하는 일 |
|---|---|---|
| 도메인 팩 | 도메인 목록. 도메인마다 타입, 길이, 소수 자릿수, NULL 허용, 기본값, 자동 증가를 묶습니다 | 컬럼에 도메인을 지정하면 도메인의 값이 컬럼에 입력됩니다 |
| 사전 | 표준 단어와 약어, 동의어 같은 관련어, 단어마다 연결한 도메인 | 논리명을 읽어 물리명을 만들고, 읽은 단어의 도메인을 컬럼에 지정하거나 추천합니다 |
표준 용어는 따로 관리하지 않습니다. 사전이 논리명을 단어로 끊어 조합하거나, 등재된 표기와 정확히 맞을 때만 사용합니다(아래 '조합형과 완성형').
논리명 한 번으로 이름과 타입이 정해집니다
NeoSQL 에서는 사전의 단어에 도메인을 연결할 수 있습니다. "일시" 에 날짜, 시간 도메인을 연결해 두면, 논리명에 "주문일시" 를 적는 순간 물리명과 타입이 함께 정해집니다. 이름의 표준과 타입의 표준을 두 번에 나눠 적용하지 않아도 됩니다.
| 논리명 | 만들어지는 물리명 | 연결된 도메인 |
|---|---|---|
| 주문일시 | ord_dtm | 일시 |
| 고객번호 | cust_no | 번호 |
| 사용여부 | use_yn | 여부 |
- Logical Name 칸(1)에 적은 이름을 사전이 단어로 끊어 읽고, 단어의 약어를
_로 이어 물리명(2, Column 칸)을 만듭니다. 대소문자는 커넥션 DBMS 의 식별자 규칙을 따릅니다. - 읽은 단어에 연결된 도메인이 Domain 칸(3)에 들어가고, 도메인의 타입(4, Data Type 칸)과 길이, NULL 허용 같은 값이 컬럼에 입력됩니다.
- 도메인 후보는 뒤쪽 단어부터 찾습니다. 컬럼의 성격은 보통 뒤쪽 단어가 정하기 때문입니다("주문일시" 는 "일시"). 끝 단어에 도메인이 없으면 끝 단어 바로 앞 단어의 도메인으로 내려갑니다. 후보가 하나면 바로 지정하고, 둘 이상이면 선택할 수 있게 추천만 합니다.
- 사전에 없는 글자는 물리명에서 빠지고, 논리명 칸에 사전에 없다는 표시가 남습니다. 영문과 숫자도 마찬가지입니다.
- 물리명은 만드는 순간 한 번 정해집니다. 나중에 단어의 약어가 변경되어도 이미 만든 컬럼명은 저절로 변경되지 않습니다.
조합형과 완성형
사전이 논리명을 읽는 방식은 두 가지이고, 사전을 만들 때 선택합니다. 만든 뒤에는 변경할 수 없습니다.
| 조합형 | 완성형 | |
|---|---|---|
| 읽는 방식 | 등록된 단어를 가장 긴 것부터 끊어 읽고, 약어를 이어 붙입니다 | 논리명 전체가 등재된 표기 하나와 정확히 같을 때만 등재된 약어를 사용합니다. 부분 조합은 하지 않습니다 |
| 예 | 주문일시 = 주문(ORD) + 일시(DTM) → ord_dtm | "고객주문" 이 등재되어 있어야 cust_ord 가 됩니다. "고객" 과 "주문" 이 따로 있어도 조합하지 않습니다 |
| 도메인 후보 | 뒤쪽 단어부터 찾으므로 여럿일 수 있습니다 | 일치한 단어의 도메인 하나뿐입니다 |
| 읽지 못한 글자 | 읽은 구간만 물리명에 넣고, 못 읽은 글자에 표시를 남깁니다 | 물리명을 만들지 않고 논리명 전체를 사전에 없는 것으로 표시합니다 |
| 입력 도움 | 후보 목록을 띄우지 않습니다. 여러 단어를 잇는 중이라 지금 치는 단어의 경계를 알 수 없기 때문입니다 | 치는 동안 등재된 명칭을 추천하고, 선택하면 물리명과 도메인이 함께 정해집니다 |
단어 단위의 표준 단어 정의서를 활용하고 있다면 조합형이, 이미 확정된 용어만 사용하게 해야 한다면 완성형이 맞습니다. 커넥션 하나에는 사전을 하나만 지정하므로, 두 방식이 모두 필요하면 사전을 따로 만들어 커넥션마다 지정합니다.
지정은 커넥션 단위입니다
- 사전과 도메인 팩은 프로젝트가 아니라 커넥션에 지정합니다. 같은 프로젝트 안에서도 운영 중인 DB 와 새로 설계하는 DB 가 서로 다른 표준을 사용하는 상황을 그대로 담기 위해서입니다.
- 커넥션마다 도메인 자리와 사전 자리가 하나씩 있습니다. 비어 있으면 사용하지 않는다는 뜻입니다. 사전이 도메인 팩을 정해 두었으면 도메인 자리는 정한 팩으로 고정됩니다.
- 지정은 메뉴로 여는 커넥션 설정의 데이터 사전 탭에서 합니다. 저장한 커넥션이고 커넥션을 수정할 권한이 있어야 탭이 보입니다.
- 지정한 팩을 커넥션에서만 수정해 사용할 수도 있습니다(). 수정은 커넥션에만 적용되고 원본 자산은 변경되지 않습니다. 수정한 상태를 새 자산으로 굳히려면 같은 패널의 현재 상태 복제 버튼을 사용합니다.
자산을 수정해도 커넥션은 지정한 시점에 머뭅니다
커넥션은 자산을 지정한 시점의 내용을 봅니다. 자산을 수정해도 커넥션이 저절로 따라가지 않게 한 것은, 다른 사람이 수정한 표준이나 방금 삭제한 항목이 내 컬럼을 조용히 변경하지 않게 하기 위해서입니다. 다만 무엇에 고정되는지는 자산이 저장된 곳에 따라 다릅니다.
| 서버의 자산(공식 팩, 계정 자산) | 기기 자산 | |
|---|---|---|
| 저장되는 곳 | NeoSQL 서버. 공식 팩은 NeoSQL 이 제공하고, 계정 자산은 내 계정에 있어 다른 기기와 팀원이 함께 사용합니다 | 기기. 커넥션 설정에서 이 기기 표시가 붙습니다 |
| 지정하는 것 | 게시한 버전 하나. 게시한 버전이 없으면 지정할 수 없습니다 | 지정한 시점의 사본. 게시와 버전이 없습니다 |
| 자산을 수정한 뒤 | 새 버전을 게시해도 커넥션은 지정한 버전에 머물고, 새 버전 v2 같은 표시만 붙습니다 | 커넥션은 사본을 계속 봅니다. 도메인 팩이나 사전이 변경되었으면 데이터 사전 패널에 원본 변경됨 표시가 나타나고, 클릭하면 지금 내용을 다시 가져옵니다. 커넥션에서 수정한 내용은 그대로 보존됩니다 |
| 예외 | 게시할 때 현재 버전 덮어쓰기 버튼을 선택하면 버전을 지정한 커넥션에 바로 반영됩니다 | 없습니다 |
기기 자산도 사본을 보게 한 것은, 자산에서 항목을 삭제했을 때 자산을 지정한 커넥션에서까지 함께 사라지지 않게 하기 위해서입니다.
로컬 프로젝트에서 지정할 수 있는 것
| 로컬 프로젝트 | 계정 프로젝트 | |
|---|---|---|
| 지정할 수 있는 자산 | 공식 팩, 기기의 자산 | 공식 팩, 공개 자산, 내가 소유하거나 함께 편집하는 계정 자산 |
| 계정 자산 | 로그인해도 지정할 수 없습니다 | 지정할 수 있습니다 |
| 기기 자산 | 지정할 수 있습니다 | 지정할 수 없습니다 |
| 지정과 커넥션 전용 수정이 저장되는 곳 | 기기 | 내 계정 |
로컬 프로젝트는 계정에 연결되지 않습니다. 계정 자산을 지정하면 로그아웃하거나 다른 기기에서 열 때 원본을 읽을 수 없게 되므로, 로그인한 상태여도 계정 자산은 목록에 나오지 않습니다. 반대로 기기 자산은 기기에만 있으므로 계정 프로젝트에는 지정할 수 없습니다.
기기 자산은 이렇게 생깁니다.
- 로그인하지 않은 데스크톱에서 화면으로 새로 만들거나, 공개된 자산을 받아 온 것은 기기에 저장됩니다.
- 로그인한 데스크톱에서는 같은 화면에서 만들 때 이 기기에 저장 체크를 활성화하면 기기 자산이 됩니다. 비활성화하면 계정 자산입니다.
- 로컬 프로젝트에서 공식 팩을 지정하고 데이터 사전 패널의 현재 상태 복제 버튼으로 복제한 사본도 로그인 상태와 상관없이 기기에 만들어집니다.
이미 DB 에 있는 컬럼은 저절로 변경되지 않습니다
논리명을 적었을 때 무엇이 변경되는지는 컬럼이 이미 DB 에 있는지에 따라 다릅니다.
| 컬럼 | 논리명을 적으면 |
|---|---|
| 설계 중인 컬럼(새 테이블의 컬럼, 새로 더한 컬럼, 이름이 없는 컬럼) | 물리명을 만들어 넣고, 도메인 후보가 하나면 지정합니다 |
| 이미 DB 에 있는 컬럼 | 이름도 타입도 변경하지 않습니다. 사전과 이름이 다르면 논리명 칸에 표시만 하고, 도메인은 추천까지만 합니다 |
이미 있는 DB 에 논리명을 붙이는 일은 대개 문서화가 목적입니다. 그때마다 이름이나 타입이 변경되면 DB 반영을 기다리는 변경이 쌓이고, 길이가 줄면 데이터가 잘릴 수 있습니다. 사전대로 이름을 변경할지는 논리명 칸의 표시를 클릭해 직접 정합니다. 이름을 변경해도 타입은 변경하지 않습니다.
도메인 값은 컬럼에 복사됩니다
- 도메인을 지정하면 도메인의 값이 컬럼에 복사됩니다. 참조로 남지 않으므로 자산을 열 수 없는 상태여도 ERD 와 DDL 은 그대로 동작합니다.
- 도메인이 정한 값을 컬럼에서 직접 수정해 도메인과 달라지면 컬럼의 도메인 지정이 해제됩니다. 컬럼마다 따로 변경해 두는 예외는 만들지 않습니다.
- 커넥션에서 도메인을 수정해 저장하면 도메인 변경 영향 창이 도메인을 사용하는 컬럼을 찾아 보여 주고, 반영할 것을 선택하게 합니다.
- 커넥션의 도메인 팩 지정을 해제하거나 다른 팩으로 변경하면 컬럼의 도메인 지정도 함께 해제되지만, 컬럼의 타입과 길이는 그대로 보존됩니다.
- 논리명은 실제 DB 에 만들어지는 테이블에 들어가지 않습니다. 자세한 것은 ERD 와 실제 DB 에서 설명합니다.
주의할 점
- 사전 타입(조합형, 완성형)은 만들 때 정하고 변경할 수 없습니다.
- 로그인한 상태에서 관리 화면으로 만든 자산은 이 기기에 저장 체크를 활성화하지 않으면 계정 자산이라 로컬 프로젝트의 지정 목록에 나오지 않습니다.
- 기기 자산은 기기에만 있습니다. 다른 기기로 옮기려면 자산 화면의 내보내기 버튼으로 백업 파일을 만들어 옮길 기기에서 가져옵니다. 가져온 자산은 가져온 기기의 로그인 상태에 따라 계정 자산이나 기기 자산이 됩니다.
- 공식 팩과 계정 자산의 새 버전은 저절로 적용되지 않습니다. 새 버전을 사용하려면 커넥션 설정에서 자산을 다시 선택해 버전을 정합니다.
관련 페이지
- 데이터 사전 관리: 도메인 팩과 사전을 만들고 수정하는 화면입니다.
- 커넥션에 지정: 커넥션에 자산을 지정하고 커넥션에서만 수정해 사용하는 방법입니다.
- 게시, 버전과 백업: 계정 자산을 게시하고 버전을 다루며, 백업 파일로 옮기는 방법입니다.
- 데이터 사전으로 표준 이름 사용하기: 공식 팩을 지정해 ERD 에서 표준 이름으로 컬럼을 만드는 순서입니다.
- ERD 와 실제 DB: 논리명과 물리명, 저장과 DB 반영의 관계입니다.
- 로그인과 프로젝트 종류: 로컬 프로젝트와 계정 프로젝트의 차이입니다.