화면: SQL 편집기

결과 그리드

SQL 탭 아래의 결과 영역은 실행한 SQL 의 결과를 표로 보여 줍니다. 결과를 거르고 정렬하고, 값을 자세히 보고, 클립보드로 복사합니다. 결과를 얼마나 가져오는지와 필터가 SQL 을 다시 실행하는 경우는 SQL 실행과 트랜잭션 에서 설명합니다. 결과를 수정하는 일은 결과 데이터 편집, 파일로 저장하는 일은 결과 내보내기 에서 설명합니다.

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

화면 구성

번호이름설명
1결과 탭결과마다 탭 하나입니다. 이름은 결과의 테이블 이름이고, 여러 테이블에서 온 결과면 이름 뒤에 점 세 개 아이콘이 붙습니다. 탭에 마우스를 올리면 실행한 SQL 이 보입니다. 아래 '결과 탭' 에서 설명합니다.
2History 탭SQL 탭에서 실행한 SQL 의 목록입니다. 항상 맨 끝에 있고 닫을 수 없습니다. SQL 이력과 저장된 SQL 에서 설명합니다.
3결과 도구새로고침 버튼(필터·정렬 초기화 후 원본 쿼리 재실행), 행 수 칸, Export 버튼입니다.
4Filter/Sort 줄클라이언트 모드와 서버 모드를 선택하고, 걸린 조건을 칩으로 보여 줍니다. 오른쪽에 WHERE 버튼과 모두 지우기 버튼이 있습니다.
5검색 칸받아 온 행 안에서 글자를 찾습니다(로딩된 행 검색...). 필터와 따로 동작합니다.
6컬럼 머리타입 아이콘, 컬럼 이름, 정렬 표시, 필터 아이콘입니다. 마우스를 올리면 타입과 컬럼 설명이 보입니다.
7결과 표맨 왼쪽 # 칸은 행 번호입니다. NULL 은 흐린 null 로, 빈 문자열은 빈 칸으로 보입니다. 외래 키 컬럼에는 참조 데이터를 여는 눈 아이콘이 붙습니다.
8Value 패널선택한 셀의 값을 크게 보여 줍니다. 아래 '값 패널' 에서 설명합니다.
9상태 줄받아 온 행 수, 더 있으면 (truncated) 표시와 Load More 버튼, 오른쪽 끝에 실행 시간입니다. 수정할 수 있는 결과에는 편집 버튼도 보입니다(결과 데이터 편집).
  • SELECT 가 아닌 문장은 표 대신 변경된 행 수(row(s) affected)나 실행 완료 문구와 실행 시간을 보여 줍니다. 오류가 나면 오류 문구와 SQLSTATE 가 보입니다.
  • 날짜와 시각의 표시 형식, 시간대는 프로젝트 설정SQL 편집기 탭에서 정합니다. 시간대가 있는 타입의 컬럼 머리에는 (+09:00) 처럼 오프셋이 붙습니다.

결과 탭

실행결과가 놓이는 곳
Execute 버튼지금 보고 있는 결과 탭을 새 결과로 변경합니다. 탭이 고정되어 있으면 고정되지 않은 다른 결과 탭을 사용하고, 없으면 새 탭을 만듭니다
Run Script 버튼Statistics 탭 하나와 SELECT 문장마다 결과 탭 하나를 만듭니다. 탭의 번호는 스크립트 안의 문장 순번입니다
실행 계획Explain 탭을 엽니다. 실행 계획 에서 설명합니다
  • Statistics 탭은 실행 문장, 반영된 행, 오류, 실행 시간, Fetch 시간 항목을 보여 줍니다. 오류가 있으면 먼저 보입니다.
  • Run Script 버튼을 클릭할 때 결과 탭이 열려 있으면 기존 결과 탭 닫기 창이 기존 탭 닫기 버튼과 기존 탭 유지 버튼 가운데 선택하게 합니다. 다시 묻지 않음 항목을 선택하면 다음부터 묻지 않습니다. 고정한 탭은 기존 탭 닫기 버튼을 선택해도 남습니다.
  • 탭의 핀 아이콘이나 우클릭 메뉴의 탭 고정 항목으로 탭을 고정합니다. 우클릭 메뉴에는 다른 탭 닫기 항목처럼 여러 탭을 닫는 항목도 있습니다. 탭은 드래그해서 순서를 변경합니다.
  • SQL 탭의 실행 대상(커넥션, 데이터베이스, 스키마)을 변경하면 이전 대상에서 받은 결과 탭에 경고 아이콘이 붙고, 결과 위에 다른 대상에서 조회한 결과라 편집할 수 없습니다. 안내와 현재 대상으로 재실행 버튼이 보입니다.

행 수와 더 가져오기

  1. 결과 도구의 행 수 칸에서 한 번에 가져올 행 수를 선택합니다(처음 값은 200 rows 항목이고 500, 1000, 5000 행이 있습니다).
  2. SQL 을 실행합니다. 결과가 더 있으면 상태 줄에 (truncated) 표시가 붙습니다.
  3. Load More 버튼을 클릭하거나 표를 끝까지 내립니다. 선택한 행 수만큼 더 가져옵니다.
  • Load More 버튼은 SQL 을 처음부터 다시 실행해 더 많은 행을 받습니다. 그사이 데이터가 변경되었으면 앞쪽 행도 변경될 수 있습니다.
  • 결과를 수정한 채 더 가져오면 수정사항 확인 창이 수정한 내용을 버릴지 묻습니다.
  • 다시 실행해도 데이터가 변경되지 않는다고 확인되지 않은 SQL(함수로 시퀀스를 올리는 조회 등)은 Load More 버튼을 클릭할 수 없습니다.
  • 웹 앱은 플랜에 따라 한 번에 가져올 수 있는 행 수에 상한이 있을 수 있습니다. 선택한 값이 상한을 넘으면 상한까지만 가져오고 알림이 표시됩니다.

거르고 정렬하기

Filter/Sort 줄의 두 모드는 무엇을 대상으로 하는지가 다릅니다.

클라이언트 모드(처음 상태)서버 모드
대상이미 받아 온 행DB 의 전체 결과
방법화면 안에서 거르고 정렬합니다결과를 WHERE, ORDER BY 로 감싸 SQL 을 다시 실행합니다
정렬컬럼 머리를 클릭할 때마다 오름차순, 내림차순, 해제. Shift 를 누른 채 클릭하면 여러 컬럼으로 정렬합니다컬럼 하나로 정렬합니다
WHERE 버튼사용하지 않습니다직접 적은 조건을 다른 조건과 AND 로 붙입니다
  1. 컬럼 머리의 필터 아이콘을 클릭합니다. 연산자와 값을 선택하는 창이 열립니다. 텍스트, 숫자, 날짜, 열거형 컬럼마다 사용할 수 있는 연산자(같음, 범위, IN, LIKE 패턴, NOT)가 다르고, DB 값 불러오기 버튼으로 컬럼의 값을 DB 에서 불러와 선택할 수도 있습니다.
  2. 적용 버튼을 클릭합니다. 조건이 Filter/Sort 줄에 칩으로 붙습니다.
  3. 조건이 두 개 이상이면 줄의 AND 버튼을 클릭해 OR 로 변경할 수 있습니다. 칩의 X 로 조건 하나를, 모두 지우기 버튼으로 모두를 삭제합니다.
  • 결과가 잘린 상태에서 클라이언트 모드로 거르면 받아 온 행 안에서만 거릅니다. 경고 아이콘이 알려 줍니다.
  • 서버 모드는 다시 실행해도 안전하다고 확인된 SELECT 에서만 선택할 수 있습니다.
  • 같은 이름의 컬럼이 두 번 나오는 결과에서는 컬럼에 필터를 걸 수 없습니다. SQL 에서 별칭(AS)을 지정하세요.
  • 컬럼 머리를 우클릭하면 'status' 복사 항목, 오름차순 정렬 항목, 내림차순 정렬 항목, 필터 항목, 초기화 (정렬/필터) 항목이 있습니다.
  • 결과 도구의 새로고침 버튼은 필터와 정렬을 삭제하고 원래 SQL 을 다시 실행합니다.

값 패널

Value 패널은 선택한 셀의 값을 표보다 크게 보여 줍니다. 패널 머리의 버튼으로 접고 펼치며, 상태는 기기에 기억됩니다.

  • JSON 값은 정렬 버튼과 압축 버튼으로 모양을 변경해 봅니다. HTML, URL, 이미지 URL 도 인식해 알맞게 보여 줍니다.
  • 100KB 를 넘는 값은 앞부분만 보이고 전체 보기 버튼이 나옵니다.
  • 공간 데이터는 지도 미리보기 버튼, 벡터는 벡터 미리보기 버튼으로 따로 봅니다. 바이너리는 미리 볼 수 없습니다.
  • 수정할 수 있는 셀이면 패널에서 값을 수정하고 적용 버튼으로 표에 넣습니다. 수정할 수 없는 셀에는 읽기 전용 표시가 보입니다.
  • 수정할 수 없는 셀을 두 번 클릭하면 접힌 패널이 펼쳐집니다.

복사하기

하는 일방법복사되는 것
셀 하나셀을 선택하고 Ctrl+C(macOS 는 Cmd+C)셀의 값
표 모양셀을 우클릭하고 복사 항목, CSV로 복사 항목, Markdown 표로 복사 항목 가운데 하나선택한 행(없으면 받아 온 모든 행)과 머리 줄. 복사 항목은 탭으로 나눠 스프레드시트에 붙여 넣기 좋습니다
INSERT 문셀을 우클릭하고 INSERT 구문 복사 항목선택한 행마다 INSERT 문 하나. 자동 증가 컬럼과 생성 컬럼은 제외합니다. 결과가 테이블 하나에서 왔을 때만 있습니다
  • 행은 클릭으로 선택하고, Ctrl(macOS 는 Cmd)을 누른 채 클릭해 더하고, Shift 를 누른 채 클릭해 범위로 선택합니다. # 머리를 클릭하면 모든 행을 선택합니다.
  • 복사는 화면에 받아 온 행만 대상입니다. 전체 결과를 파일로 다운로드하려면 결과 내보내기 를 사용하세요.

마스킹된 값

계정 프로젝트에서 내 역할에 민감 컬럼 마스킹이 걸려 있으면 컬럼의 값은 결과를 받기 전에 마스킹됩니다.

마스킹표에 보이는 값
컬럼 마스킹모든 값이 **** 로 보입니다
패턴 마스킹값에서 패턴에 맞는 부분만 마스킹되어 보입니다
  • 마스킹한 값은 복사하거나 내보내도 마스킹한 그대로입니다. 원래 값은 화면으로 오지 않습니다.
  • 로컬 프로젝트에는 마스킹이 없습니다. 마스킹을 정하는 방법은 컬럼 마스킹 에서 설명합니다.

주의할 점

  • 서버 모드의 필터, 정렬, Load More 버튼은 SQL 을 다시 실행합니다. 실행할 때마다 DB 에 부하가 생기고, 그사이 변경된 데이터가 결과에 섞입니다.
  • CLOB 처럼 긴 텍스트 타입의 값은 결과 표에는 앞 1,000자만 담깁니다. 바이너리는 [BLOB] 같은 표시로 변경됩니다. 원래 값 전체가 필요하면 데스크톱에서 결과 내보내기 를 서버 모드로 사용하세요.
  • 결과 탭은 SQL 탭을 닫으면 사라집니다. 남겨 둘 결과는 내보내세요. 실행한 SQL 은 History 탭에서 편집기로 다시 가져올 수 있습니다.

관련 화면