화면: SQL 편집기

결과 내보내기

SQL 결과를 CSV, JSON, Excel 파일로 저장합니다. 데스크톱 앱의 로컬 서버가 기기에 파일을 저장하므로 데스크톱 앱에서만 사용할 수 있습니다 (웹과 데스크톱). 탐색기의 테이블을 파일로 내보내는 데이터 내보내기, 가져오기와 Native Backup 도 같은 창을 사용하고, 창의 옵션을 설명합니다.

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

화면 구성

번호이름설명
1단계 표시형식, 옵션, 미리보기, 저장 위치 단계입니다. 저장 위치 단계는 전체 결과를 파일에 기록할 때만 있습니다(아래 '어떤 행이 파일에 들어가는가').
2형식별 옵션선택한 형식의 옵션입니다. JSON 은 형식별 옵션이 없습니다. 아래 표에서 설명합니다.
3고급 옵션다시 가져올 때의 손실 안내와 추출 설정입니다.
4단계 버튼이전 버튼, 다음 버튼, 마지막 단계의 다운로드 버튼입니다. 창 밖을 클릭하거나 Esc 를 눌러도 닫히지 않습니다.

결과 내보내기

  1. SQL 을 실행하고 결과 도구의 Export 버튼을 클릭합니다. 데이터 Export 창이 열립니다.
  2. 형식 단계에서 CSV, JSON, Excel 가운데 하나를 선택합니다. 아래에 내보낼 SQL(SELECT 쿼리)이 보입니다.
  3. 옵션 단계에서 형식별 옵션을 정합니다.
  4. 미리보기 단계에서 컬럼별 값 형식 표로 컬럼마다 값을 기록할 모양을 정하고, 아래 미리보기에서 결과의 처음 20행이 파일에 어떻게 들어가는지 봅니다.
  5. 저장 위치 단계가 있으면 저장 폴더 칸에 폴더를 선택하고 파일명 패턴 칸을 확인합니다.
  6. 다운로드 버튼을 클릭합니다.
  • Export 버튼은 SELECT 결과 탭에서만 클릭할 수 있습니다.
  • 창이 닫히고 내보내기는 아래 상태바의 작업으로 진행됩니다. 전체 결과를 기록할 때는 작업 목록에서 진행한 행 수를 보고 취소할 수 있고, 끝나면 기록한 행 수가 알림으로 표시됩니다.
  • 창에서 선택한 형식, 옵션, 저장 폴더는 기기에 기억되어 다음에 창을 열면 자동 기입됩니다.

어떤 행이 파일에 들어가는가

결과 영역의 Filter/Sort 줄에서 선택한 모드에 따라 파일에 들어가는 행과 사용할 수 있는 옵션이 다릅니다. 모드는 결과 그리드 에서 설명합니다.

클라이언트 모드(처음 상태)서버 모드
들어가는 행받아 온 행 가운데 화면에 보이는 행. 클라이언트 모드의 필터, 정렬, 검색 칸이 화면 그대로 적용됩니다로컬 서버가 SQL 을 다시 실행해 읽은 전체 결과. 서버 모드의 필터와 정렬이 적용됩니다
긴 텍스트, 바이너리화면의 값 그대로(CLOB 은 앞 1,000자, 바이너리는 [BLOB] 같은 표시)원래 값 전체. 바이너리는 Base64 로도 기록할 수 있습니다
저장 위치 단계없습니다. 파일을 다운로드하기로 저장하고, 파일 이름은 테이블이름_날짜_시각 입니다있습니다. 폴더와 파일명 패턴을 정합니다
CSV 인코딩UTF-8UTF-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 로 순서가 정해지지 않았거나 내보내는 동안 데이터가 변경되면 행이 겹치거나 빠질 수 있습니다.
  • 계정 프로젝트에서 내 역할에 마스킹이 걸린 컬럼은 파일에도 마스킹한 값으로 들어갑니다.

관련 화면