화면: 연결과 탐색기

데이터 내보내기, 가져오기와 Native Backup

객체 탐색기의 우클릭 메뉴에서 테이블의 데이터를 파일로 내보내고, 파일의 데이터를 테이블에 넣습니다. DBMS 가 제공하는 덤프 도구(pg_dump, mysqldump 등)로 테이블, 스키마, 데이터베이스를 백업하고 백업 파일로 복원할 수도 있습니다. 네 기능 모두 데스크톱 앱의 로컬 서버가 기기의 파일을 읽고 저장하므로 데스크톱 앱에서만 사용할 수 있습니다(웹과 데스크톱).

사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트

화면 구성

번호메뉴하는 일보이는 노드
1탐색기 우클릭데이터 내보내기...테이블의 모든 행을 CSV, JSON, Excel 파일로 저장합니다실제 DB 에 있는 테이블
2탐색기 우클릭Native Backup...DBMS 의 덤프 도구로 백업 파일을 만듭니다DBMS 마다 다릅니다(아래 'Native Backup')
3탐색기 우클릭데이터 가져오기...CSV, JSON, Excel 파일의 행을 테이블에 넣습니다실제 DB 에 있는 테이블
탐색기 우클릭Native Reload...백업 파일을 DB 에 복원합니다DBMS 마다 다릅니다(아래 'Native Reload')
  • 프로젝트에서 새로 만들었지만 DB 에 반영하지 않은 테이블과 삭제 표시한 테이블에는 탐색기 우클릭데이터 내보내기... 메뉴와탐색기 우클릭데이터 가져오기... 메뉴가 나오지 않습니다.
  • 같은 커넥션, 같은 데이터베이스의 테이블 여러 개를 함께 선택해(Ctrl 또는 Cmd 를 누른 채 클릭) 우클릭하면 한 번에 내보내거나 가져옵니다.

데이터 내보내기

  1. 테이블을 우클릭하고 탐색기 우클릭데이터 내보내기... 메뉴를 선택합니다. 데이터 Export 창이 열립니다. 여러 테이블이면 데이터 Export · 3개 테이블 창입니다.
  2. 형식 단계에서 CSV, JSON, Excel 가운데 하나를 선택합니다.
  3. 옵션 단계에서 형식별 옵션(CSV 의 필드 구분자, CSV 인코딩, 헤더, Excel 의 긴 셀 처리, 파일 분할 등)을 정합니다.
  4. 미리보기 단계에서 파일에 들어갈 모양을 확인합니다.
  5. 저장 위치 단계에서 저장 폴더 칸과 파일 이름을 정하고 다운로드 버튼을 클릭합니다.
  • 창이 닫히고 내보내기는 백그라운드에서 계속됩니다. 로컬 서버가 테이블의 행을 DB 에서 읽어 파일에 바로 저장합니다. 그래서 화면에 불러오지 않은 행까지 모두 들어갑니다.
  • 여러 테이블을 내보내면 모든 파일이 한 폴더에 저장됩니다. 이름이 겹치면 스키마 이름이나 번호가 붙습니다. 동시에 내보낼 테이블 수는 동시 내보내기 작업 수 칸에서 정합니다.
  • 형식의 한계로 값을 변환해 저장한 파일은 이름에 _lossy 가 붙으며, 원본 데이터로 다시 가져올 수 없습니다.
  • 옵션은 SQL 결과를 내보내는 창과 같습니다. 항목마다의 설명은 결과 내보내기 에 있습니다.

데이터 가져오기

  1. 테이블을 우클릭하고 탐색기 우클릭데이터 가져오기... 메뉴를 선택합니다. 데이터 Import · orders 창이 열립니다.
  2. 형식 단계에서 파일 형식(CSV, JSON, Excel)을 선택합니다.
  3. 옵션 단계에서 파일을 드래그 앤 드롭하거나 선택합니다. CSV 는 인코딩, 구분자, 첫 행을 컬럼명으로 사용 항목을, Excel 은 시트를 선택합니다. 데이터 반영 정책 항목도 여기서 정합니다(아래 표).
  4. 컬럼 매핑 단계에서 테이블의 컬럼마다 넣을 값을 정합니다. 첫 행이 컬럼 이름이면 이름이 같은(대소문자 무시) 파일 컬럼이, 아니면 같은 순서의 파일 컬럼이 처음부터 이어져 있습니다. 아래 파일 미리보기 (첫 20행) 표에서 들어갈 값을 확인합니다.
  5. Import 시작 버튼을 클릭합니다. 창이 닫히고 가져오기가 백그라운드에서 진행됩니다. 끝나면 데이터 Import 결과 창이 처리한 행, 실제 반영된 행, 오류/제외한 행 항목을 보여 줍니다.

컬럼마다 선택하는 값 지정 항목은 다섯 가지입니다.

값 지정넣는 값
파일 컬럼선택한 파일 컬럼의 값
고정값모든 행에 같은 값
DB 기본값컬럼의 DB 기본값
NULLNULL
Import 제외컬럼을 INSERT 에서 제외합니다. 필수 컬럼은 제외할 수 없습니다

데이터 반영 정책 항목은 오류가 나거나 취소했을 때 어디까지 되돌릴지를 정합니다.

정책Commit 시점실패하거나 취소하면
전체 성공 후 반영파일 전체가 성공한 뒤 한 번모두 되돌립니다
N행마다 확정정한 행 수마다마지막 Commit 뒤의 행만 되돌립니다

가져오는 중에 행 하나가 실패하면 진행을 멈추고 데이터 Import 오류 창이 실패한 행의 파일 행 번호, 대상 컬럼, 원본 값을 보여 줍니다. 건너뛰기 버튼, 모두 건너뛰기 버튼, 재시도 버튼, 중지 버튼 가운데 선택합니다. 중지 버튼은 정책이 전체 성공 후 반영 항목이면 중지 및 전체 롤백 버튼으로, N행마다 확정 항목이면 중지 및 미확정 행 롤백 버튼으로 보이고, 나머지 경우에는 중지 (반영된 행 유지) 버튼으로 보입니다. 중지하면 위 정책대로 되돌립니다.

여러 테이블을 한 번에 가져오기

옵션 단계의 다중 파일 업로드 칸에 파일을 함께 드래그 앤 드롭합니다. 파일 이름에 테이블 이름이 들어 있으면 같은 이름의 테이블에 자동으로 이어지고, Excel 은 워크시트 이름으로도 잇습니다. Import 순서 항목은 FK 를 보고 부모 테이블이 먼저 오도록 처음부터 정해 두며, 드래그해서 변경할 수 있습니다. 테이블은 정한 순서대로 하나씩 가져오고, 한 테이블이 실패하거나 취소되면 뒤의 테이블은 시작하지 않습니다.

Native Backup

Native Backup 은 DBMS 의 덤프 도구를 기기에서 실행해 백업 파일을 만듭니다. 덤프 도구는 NeoSQL 에 들어 있지 않으니 먼저 기기에 설치하세요. H2 와 SQL Server 는 덤프 도구 없이 DB 가 직접 백업합니다(아래 표).

  1. 백업할 노드를 우클릭하고 탐색기 우클릭Native Backup... 메뉴를 선택합니다. Native Backup 창이 열립니다.
  2. 로컬 클라이언트 칸에 덤프 도구의 실행 파일을 선택합니다. 선택하면 실행해 보고 버전을 보여 줍니다. 한 번 선택한 경로는 기기에 기억됩니다. 로컬 클라이언트 칸은 H2 와 SQL Server 에는 없습니다.
  3. 저장 폴더 칸과 파일명 칸을 확인합니다. 파일 이름에는 날짜와 시각이 붙어 있습니다.
  4. Backup 시작 버튼을 클릭합니다. 창이 닫히고 백업이 백그라운드에서 진행됩니다.
DBMS덤프 도구파일백업할 수 있는 노드
PostgreSQLpg_dump.dump테이블, 스키마, 데이터베이스
MySQLmysqldump.sql테이블, 스키마(= 데이터베이스)
MariaDBmariadb-dump.sql테이블, 스키마(= 데이터베이스)
Oracleexpdp(Data Pump).dmp테이블, 스키마, 커넥션(전체 데이터베이스)
SQLitesqlite3.sql테이블, 커넥션(파일 전체)
H2필요 없음.sql테이블, 커넥션
SQL Server필요 없음.bak데이터베이스(시스템 데이터베이스 제외)
  • 같은 커넥션의 데이터베이스 여러 개, 또는 같은 데이터베이스의 테이블 여러 개를 함께 선택해 백업할 수 있습니다. 동시에 실행할 수는 동시 실행 수 칸에서 정합니다.
  • PostgreSQL 은 덤프 도구와 서버의 메이저 버전이 다르면 경고가 나옵니다. 백업은 되지만 복원하지 못할 수 있으니 같은 메이저 버전의 도구를 사용하세요.
  • Oracle 은 DB 서버의 Data Pump 디렉터리에 파일을 만든 뒤 선택한 폴더로 가져옵니다. Oracle Data Pump 디렉터리 칸에 디렉터리 이름을 적고, 디렉터리의 READ, WRITE 권한이 있어야 합니다. 서버의 파일은 삭제하지 않습니다.
  • SQL Server 는 SQL Server 호스트의 폴더에 copy-only 전체 백업을 만듭니다. 폴더는 기기가 아니라 DB 서버의 경로이고, SQL Server 서비스 계정이 폴더에 저장할 수 있어야 합니다.

Native Reload

탐색기 우클릭Native Reload... 메뉴는 Native Backup 으로 만든 파일(또는 같은 도구로 만든 덤프)을 DB 에 복원합니다.
  1. 복원할 노드를 우클릭하고 탐색기 우클릭Native Reload... 메뉴를 선택합니다. PostgreSQL Native Reload 창이 열립니다.
  2. 창 위의 경고에서 DBMS 의 복원이 무엇을 변경하고 무엇을 되돌리지 못하는지 확인합니다.
  3. Backup 파일 칸에 백업 파일을, 로컬 클라이언트 칸에 복원 도구를 선택합니다. Native Backup 에서 선택한 덤프 도구가 있으면 같은 폴더의 복원 도구가 미리 들어옵니다.
  4. Reload 시작 버튼을 클릭합니다. 끝나면 Native Reload가 완료되었습니다. 알림이 표시되고 탐색기에서 복원한 노드를 다시 읽습니다.
DBMS복원 도구파일복원할 노드기존 객체와 되돌리기
PostgreSQLpg_restore.dump, .backup데이터베이스기존 객체를 삭제하지 않습니다. 이름이 겹치면 전체를 되돌립니다
MySQL, MariaDBmysql, mariadb.sql스키마(= 데이터베이스)파일의 DROP, CREATE DATABASE, USE 문까지 그대로 실행합니다. 오류가 나도 이미 실행한 것은 되돌리지 않습니다
Oracleimpdp(Data Pump).dmp커넥션파일을 Data Pump 디렉터리에 업로드해 복원합니다. 기존 테이블은 건너뛰고, 전체를 되돌리지는 않습니다
SQLite, H2sqlite3, 필요 없음.sql커넥션파일의 SQL 을 실행합니다. 오류가 나도 이미 반영한 것은 되돌리지 않을 수 있습니다
SQL Server필요 없음.bak데이터베이스(시스템 데이터베이스 제외)데이터베이스를 백업 파일로 변경합니다. 기존 연결을 끊고, 덮어쓴 뒤에는 되돌릴 수 없습니다

SQL Server 의 백업 파일은 기기에서 업로드하지 않습니다. SQL Server Backup 파일 칸에 SQL Server 서비스 계정이 읽을 수 있는 서버의 경로를 적습니다.

진행 상황과 취소

내보내기, 가져오기, 백업, 복원은 모두 창을 닫은 뒤 백그라운드 작업으로 진행됩니다. 아래 상태바의 작업 표시를 클릭하면 백그라운드 작업 목록이 열리고, 작업마다 진행 상황과 취소 버튼이 있습니다. 가져오기는 끝난 뒤에도 목록에서 결과 상세 보기 버튼으로 결과 창을 다시 엽니다. 상태바는 앱 메뉴, 상단 바와 상태바 에서 설명합니다.

웹 앱에서는

웹 앱에도 네 메뉴가 보입니다. 클릭하면 해당 기능은 앱에서만 사용할 수 있습니다. 안내만 표시되고 아무 일도 하지 않습니다. 웹 앱에서는 SQL 결과를 내보내는 결과 내보내기 를 사용합니다.

주의할 점

  • 커넥션 프로파일의 보호 모드는 탐색기 우클릭데이터 가져오기... 메뉴와 탐색기 우클릭Native Reload... 메뉴에도 걸립니다. 보호 모드를 읽기 전용 (SELECT 외 차단) 항목으로 둔 커넥션에서는 두 기능이 시작하지 않고, 확인 (DDL + 위험 DML) 항목이면 탐색기 우클릭Native Reload... 메뉴는 파일을 선택하기 전에 묻습니다. 운영 DB 에서 사용하기 전에 대상 커넥션을 다시 확인하세요(운영 DB 안전장치).
  • 탐색기 우클릭Native Reload... 메뉴는 기존 데이터를 덮어쓰거나 일부만 반영된 채 멈출 수 있고, DBMS 에 따라 되돌릴 수 없습니다(위 표). 복원하기 전에 대상 데이터베이스를 따로 백업해 두세요.
  • 계정 프로젝트에서 내 역할의 DDL 이 제한되어 있으면 탐색기 우클릭Native Reload... 메뉴가 흐리게 보입니다. 비활성 커넥션에서도 같습니다.
  • 계정 프로젝트에서 내 역할에 민감 컬럼 마스킹이 걸려 있으면 탐색기 우클릭Native Backup... 메뉴가 보이지 않습니다. 덤프 도구는 마스킹을 거치지 않고 원본 데이터를 그대로 사용하기 때문입니다.
  • 덤프 도구와 복원 도구의 경로는 기기에만 기억됩니다. 다른 기기에서는 다시 선택하세요.

관련 화면