SQL 결과를 CSV, JSON, Excel 파일로 저장합니다. 데스크톱 앱의 로컬 서버가 기기에 파일을 저장하므로 데스크톱 앱에서만 사용할 수 있습니다 (웹과 데스크톱). 탐색기의 테이블을 파일로 내보내는 데이터 내보내기, 가져오기와 Native Backup 도 같은 창을 사용하고, 창의 옵션을 설명합니다.
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 단계 표시 | 형식, 옵션, 미리보기, 저장 위치 단계입니다. 저장 위치 단계는 전체 결과를 파일에 기록할 때만 있습니다(아래 '어떤 행이 파일에 들어가는가'). |
| 2 | 형식별 옵션 | 선택한 형식의 옵션입니다. JSON 은 형식별 옵션이 없습니다. 아래 표에서 설명합니다. |
| 3 | 고급 옵션 | 다시 가져올 때의 손실 안내와 추출 설정입니다. |
| 4 | 단계 버튼 | 이전 버튼, 다음 버튼, 마지막 단계의 다운로드 버튼입니다. 창 밖을 클릭하거나 Esc 를 눌러도 닫히지 않습니다. |
결과 내보내기
- SQL 을 실행하고 결과 도구의 Export 버튼을 클릭합니다. 데이터 Export 창이 열립니다.
- 형식 단계에서 CSV, JSON, Excel 가운데 하나를 선택합니다. 아래에 내보낼 SQL(SELECT 쿼리)이 보입니다.
- 옵션 단계에서 형식별 옵션을 정합니다.
- 미리보기 단계에서 컬럼별 값 형식 표로 컬럼마다 값을 기록할 모양을 정하고, 아래 미리보기에서 결과의 처음 20행이 파일에 어떻게 들어가는지 봅니다.
- 저장 위치 단계가 있으면 저장 폴더 칸에 폴더를 선택하고 파일명 패턴 칸을 확인합니다.
- 다운로드 버튼을 클릭합니다.
- Export 버튼은 SELECT 결과 탭에서만 클릭할 수 있습니다.
- 창이 닫히고 내보내기는 아래 상태바의 작업으로 진행됩니다. 전체 결과를 기록할 때는 작업 목록에서 진행한 행 수를 보고 취소할 수 있고, 끝나면 기록한 행 수가 알림으로 표시됩니다.
- 창에서 선택한 형식, 옵션, 저장 폴더는 기기에 기억되어 다음에 창을 열면 자동 기입됩니다.
어떤 행이 파일에 들어가는가
결과 영역의 Filter/Sort 줄에서 선택한 모드에 따라 파일에 들어가는 행과 사용할 수 있는 옵션이 다릅니다. 모드는 결과 그리드 에서 설명합니다.
| 클라이언트 모드(처음 상태) | 서버 모드 | |
|---|---|---|
| 들어가는 행 | 받아 온 행 가운데 화면에 보이는 행. 클라이언트 모드의 필터, 정렬, 검색 칸이 화면 그대로 적용됩니다 | 로컬 서버가 SQL 을 다시 실행해 읽은 전체 결과. 서버 모드의 필터와 정렬이 적용됩니다 |
| 긴 텍스트, 바이너리 | 화면의 값 그대로(CLOB 은 앞 1,000자, 바이너리는 [BLOB] 같은 표시) | 원래 값 전체. 바이너리는 Base64 로도 기록할 수 있습니다 |
| 저장 위치 단계 | 없습니다. 파일을 다운로드하기로 저장하고, 파일 이름은 테이블이름_날짜_시각 입니다 | 있습니다. 폴더와 파일명 패턴을 정합니다 |
| CSV 인코딩 | UTF-8 | UTF-8, EUC-KR(CP949), UTF-16 LE |
| 대용량 분할 | 시트 분할 | 시트 분할, 파일 분할 |
| 데이터 추출 | 없습니다 | 있습니다 |
- 결과가 테이블 하나에서 왔으면 파일 이름의 기준이 테이블 이름이고, 아니면
query_result입니다. - Databricks 에서 SQL 탭의 세션을 사용하는 결과는 서버 모드여도 받아 온 행만 기록합니다. 임시 뷰와 변수가 세션에만 있기 때문입니다.
옵션
CSV
| 옵션 | 내용 |
|---|---|
| CSV 인코딩 | 파일의 문자 인코딩입니다. BOM 포함 항목을 활성화하면 Excel 이 UTF-8 로 인식합니다. EUC-KR 에는 BOM 이 없습니다 |
| 필드 구분자 | 쉼표, 세미콜론, 파이프 가운데 선택하거나 한 글자를 직접 적습니다. 탭 구분자 사용 항목을 활성화하면 탭으로 나눕니다 |
| 헤더 | 첫 줄에 컬럼 이름을 기록할지 정합니다. 헤더 대소문자 항목으로 이름을 대문자나 소문자로 변경합니다 |
| 따옴표 문자, 따옴표 적용 | 값을 감쌀 글자와, 필요할 때만 감쌀지 항상 감쌀지입니다 |
| NULL 문자열 | NULL 을 기록할 글자입니다. 비우면 빈 값으로 기록합니다 |
| 셀 내부 개행 | 값 안의 줄바꿈을 그대로 둘지, 공백이나 다른 글자로 변경할지입니다 |
Excel
| 옵션 | 내용 |
|---|---|
| 긴 텍스트 처리 (32,767자 초과 셀) | Excel 셀 한 칸에 들어가는 32,767자를 넘는 값의 처리입니다. 분할 이어쓰기 — 초과분을 다음 행에 계속 (내용 보존, 행 구조 가공) 항목, 잘라서 기록 (32,767자 이후 내용 유실) 항목, Export 실패 처리 (무손실 보장) 항목 가운데 선택합니다 |
| 대용량 분할 | 정한 행 수(분할 단위 행 수)를 넘으면 다음 시트나 다음 파일로 나눕니다. 처음 값은 시트 하나의 최대 행 수입니다 |
| 정보 시트 포함 (첫 시트 "Info" 에 실행 SQL·컬럼 목록·행 수 등 기록) | 첫 시트 Info 에 실행한 SQL, 컬럼 목록, 행 수를 적습니다 |
공통, 고급
| 옵션 | 내용 |
|---|---|
| 바이너리 데이터 처리 | 바이너리 값을 [BLOB] 같은 표시로 기록할지, Base64 로 원래 값을 기록할지입니다. 서버 모드에서만 있습니다 |
| Fetch size | 로컬 서버가 DB 에서 한 번에 읽는 행 수입니다 |
| 페이지 쿼리 사용 | 결과를 쿼리당 행 수 행씩 나눠 여러 번 조회합니다. 아래 '주의할 점' 을 보세요 |
| 동시 내보내기 작업 수 | 탐색기에서 테이블 여러 개를 내보낼 때 동시에 내보낼 테이블 수입니다 |
컬럼별 값 형식
미리보기 단계의 컬럼별 값 형식 표에서 컬럼마다 셀 형식 칸을 일반 항목, 텍스트 (무손실) 항목, 숫자 항목, 날짜 항목 가운데 선택하고, 숫자, 날짜의 표시 형식을 적습니다. Excel 은 적은 형식을 셀 서식으로 사용하고, CSV 와 JSON 은 적은 형식으로 변환한 글자를 기록합니다. 컬럼별로 선택한 형식은 아래의 손실로 세지 않습니다.
다시 가져올 때의 손실
형식의 한계로 원래 값을 그대로 기록하지 못한 값이 하나라도 있으면, 파일은 이름 끝에 _lossy 가 붙고 끝날 때 경고가 표시됩니다. 원래 데이터로 다시 가져올 수 없습니다(포맷 제한으로 값이 가공되면 이 파일은 원본 데이터로 다시 import 할 수 없습니다. 가공이 실제로 발생한 파일은 파일명에 "_lossy" 가 표기됩니다.).
| 손실이 생기는 경우 | 피하는 방법 |
|---|---|
화면 값을 기록한 CLOB(앞 1,000자)과 바이너리 표시 | 서버 모드로 내보내고, 바이너리는 Base64 로 기록합니다 |
| Excel 의 32,767자 넘는 셀을 이어 기록하거나 잘라 기록함 | CSV 나 JSON 으로 내보냅니다 |
EUC-KR 로 기록할 수 없는 글자(? 로 바뀜) | UTF-8 로 내보냅니다 |
미리보기 단계의 미리보기에 손실이 생길 셀 수가 미리 보입니다.
클립보드 복사와의 차이
| 결과 영역의 복사 | 결과 내보내기 | |
|---|---|---|
| 사용할 수 있는 곳 | 웹, 데스크톱 | 데스크톱 |
| 행 | 선택한 행 또는 받아 온 모든 행 | 받아 온 행 또는 전체 결과(위 표) |
| 형식 | TSV, CSV, Markdown 표, INSERT 문 | CSV, JSON, Excel, 형식별 옵션 |
| 값 | 화면에 보이는 값 | 컬럼별 값 형식을 적용한 값 |
복사하는 방법은 결과 그리드 에서 설명합니다.
웹 앱에서는
웹 앱에도 Export 버튼이 보입니다. 클릭하면 해당 기능은 앱에서만 사용할 수 있습니다. 안내만 표시됩니다. 웹 앱에서는 결과 영역의 복사를 사용하세요.
주의할 점
- 클라이언트 모드에서는 받아 온 행 가운데 화면에 보이는 행만, 화면의 순서대로 파일에 들어갑니다. 결과가 잘렸으면((truncated)) 뒤의 행은 빠집니다.
- 서버 모드는 SQL 을 한 번 더 실행합니다. 큰 결과는 DB 에 오래 부하를 주고, 화면에서 본 결과와 내용이 다를 수 있습니다.
- 페이지 쿼리 사용 항목을 활성화하면 결과를 여러 번 나눠 조회합니다.
ORDER BY로 순서가 정해지지 않았거나 내보내는 동안 데이터가 변경되면 행이 겹치거나 빠질 수 있습니다. - 계정 프로젝트에서 내 역할에 마스킹이 걸린 컬럼은 파일에도 마스킹한 값으로 들어갑니다.
관련 화면
- 결과 그리드: 결과 영역, 두 필터 모드, 복사입니다.
- 데이터 내보내기, 가져오기와 Native Backup: 탐색기에서 테이블을 내보내는 같은 창입니다.
- 웹과 데스크톱: 데스크톱에서만 사용할 수 있는 기능의 목록입니다.
- 앱 메뉴, 상단 바와 상태바: 내보내기 작업이 보이는 상태바입니다.