# 가져오기·내보내기

> 스키마를 Sqemo 안팎으로 옮깁니다: 7개 방언 SQL DDL, DBML 왕복, 이식 가능한 프로젝트 파일, CSV·Markdown 정의서, 이미지, 인쇄.

Sqemo는 고립된 도구가 아닙니다. 이미 쓰고 있는 데이터베이스에서 스키마가 들어오고,
파이프라인이 기대하는 형식으로 나갑니다.

## SQL DDL

`CREATE TABLE` DDL을 가져오고 7개 방언으로 다시 내보냅니다:
**MySQL, PostgreSQL, Oracle, SQL Server, SQLite, H2, CUBRID**.

가져올 때 기본키, 외래키(인라인 `REFERENCES` 컬럼 제약 포함), 코멘트를 인식합니다 —
외래키는 캔버스의 관계선이 됩니다. 가져오기·내보내기는 물리 모델 기준입니다.

## DBML

DBML은 가져오기와 내보내기가 왕복하므로, Sqemo와 dbdiagram 같은 텍스트 우선 도구
사이를 스키마를 다시 치지 않고 오갈 수 있습니다.

## 프로젝트 파일(`.erd.json`)

프로젝트 파일에는 전부 담깁니다: 논리·물리 모델, 단어사전, 명명 규칙, 스키마 버전.
평범한 JSON 파일입니다 — 저장소에 커밋하고, 리뷰에서 diff하고, 동료에게 보내세요.
[MCP 서버와 CLI](/ko/docs/mcp/)도 같은 형식으로 동작합니다.

## 단어사전·도메인·용어사전

표준 쪽은 CSV로 옮깁니다. 스프레드시트를 거쳐 돌아와도 살아남습니다:

- **단어사전(Word list)** — CSV 또는 JSON으로 내보내고, 어느 쪽이든 다시 가져옵니다.
  팀의 약어가 기존 표준 문서에서 들어오는 경로입니다. 행정안전부 공통표준단어
  (공공데이터포털 CSV, 한글 헤더)도 손대지 않고 그대로 가져옵니다 — 영문약어명이
  물리 단어가 되고 폐기된 단어는 건너뜁니다.
- **도메인(Domains)** — CSV로 내보내고 가져옵니다.
- **용어사전(Glossary)** — [용어 정의](/ko/docs/business-glossary/)를 CSV로
  내보냅니다.

프로젝트가 팀 표준에 연결된 동안에는 단어사전·도메인 가져오기가 비활성입니다. 거기서는
표준이 원본이기 때문입니다 — [명명 표준](/ko/docs/naming-standards/)을 보세요.

## 정의서(CSV·Markdown)

설계 리뷰와 감사를 위해 보통 손으로 다시 만드는 표 네 가지를 내보냅니다 —
엔터티정의서·컬럼정의서·인덱스정의서·관계정의서. 각각 물리 모델을 논리명과 나란히
담은 평면 CSV라, 도구를 열지 않는 리뷰어도 스키마가 말하는 바를 읽을 수 있습니다.

위키나 풀 리퀘스트에 붙일 때는 **정의서 내보내기 (Markdown)**가 같은 내용을 `.md` 파일
하나에 담습니다 — GitHub·Notion·Obsidian이 그림으로 그려 주는 mermaid `erDiagram` 블록,
엔터티 목록, 엔터티별 컬럼·인덱스 표, 관계 표 순서입니다. 표 헤더는 앱 UI 언어를 따르므로
한국어·영어 팀 페이지에 그대로 붙일 수 있습니다. GitHub은 바로 그림으로 그려 주고,
Notion은 페이지에 붙여넣은 뒤 Mermaid 코드 블록 오른쪽 위의 보기 전환에서 미리보기를
고르면 다이어그램이 나타납니다. 이미지·인쇄와 같은 **범위** 선택(전체·선택한 엔터티·주제영역)이
있어, 리뷰 대상 영역만 담은 짧은 문서를 만들 수 있습니다 — 주제영역을 고르면 파일명과
제목에 영역 이름이 붙고, 범위 밖 엔터티와 걸친 관계는 빠집니다.

## 이미지와 인쇄

설계 문서·리뷰용으로 캔버스를 **PNG 또는 SVG**로 내보내거나, **PDF·인쇄**로
다이어그램을 종이에 배치합니다 — A4 또는 A3, 세로 또는 가로 — 브라우저 대화상자에서
인쇄하거나 PDF로 저장합니다.

## 마이그레이션 SQL(Pro)

스키마 전체 내보내기 외에, 저장된 기준선과 현재 모델 사이의 `ALTER` 스크립트를 생성할
수 있습니다 — 관련된 드리프트 검사는 [실제 데이터베이스 연결](/ko/docs/live-database/)을
보세요. 이 기능은 Pro입니다.

## 명령줄에서

CLI(MCP 패키지에 포함, 로그인 불필요)는 앱을 열지 않고 프로젝트 파일을 내보냅니다:

```bash
npx sqemo-mcp export schema.erd.json --format sql --dialect postgres > schema.sql
npx sqemo-mcp export schema.erd.json --format dbml > schema.dbml
```

---
Source: https://sqemo.com/ko/docs/import-export/ · Updated 2026-09-22