TablePlus 완벽 가이드: 전통적인 SQL 클라이언트와 다른 UI 마스터하기

개요

TablePlus는 macOS와 Windows를 지원하는 현대적인 데이터베이스 관리 도구입니다. 전통적인 SQL 클라이언트들(MySQL Workbench, DBeaver, phpMyAdmin 등)과 달리 미니멀하고 직관적인 UI를 제공하며, 빠른 성능과 우아한 디자인으로 많은 개발자들에게 사랑받고 있습니다.

이 가이드에서는 TablePlus의 기본 사용법부터 실무에서 유용한 팁까지 단계별로 알아봅니다.

TablePlus란?

TablePlus는 다양한 데이터베이스를 지원하는 통합 관리 도구입니다.

지원 데이터베이스:

관계형: MySQL, PostgreSQL, SQLite, MariaDB, Oracle, Amazon Redshift
NoSQL: MongoDB, Redis, Cassandra
클라우드: Amazon RDS, Google Cloud SQL, Azure Database

주요 특징:

깔끔하고 직관적인 UI/UX
빠른 성능과 안정성
다크 모드 지원
다중 연결 관리
쿼리 히스토리 및 북마크
데이터 내보내기/가져오기 기능

유료 vs 무료 버전

TablePlus는 **무료 버전(Free)**과 유료 버전(Pro) 두 가지가 있습니다.

무료 버전 (Free) - 제한사항

2개의 데이터베이스 연결만 가능
최대 2개의 쿼리 탭
기본 기능 제공 (대부분의 기본 작업 가능)

유료 버전 (Pro) - $89 (일회성 구매)

무제한 데이터베이스 연결
무제한 쿼리 탭
다중 창 지원
SSH 터널링
코드 포맷팅
자동 완성 강화
프라이빗 SSL 인증서 지원
프리미엄 지원

추천: 개발 초기에는 무료 버전으로 시작하고, 여러 데이터베이스를 다루거나 팀 작업이 필요해지면 Pro 버전을 구매하는 것을 추천합니다.

MySQL 데이터베이스 연결 생성하기

이제 실제로 MySQL 데이터베이스에 연결하는 방법을 알아봅시다.

1단계: 새 연결 생성

TablePlus를 실행하면 홈 화면이 나타납니다
좌측 상단의 "Create a new connection" 버튼을 클릭하거나, Cmd+N (macOS) / Ctrl+N (Windows) 단축키를 누릅니다
데이터베이스 종류 선택 화면에서 **"MySQL"**을 선택합니다

2단계: 연결 정보 입력

MySQL 연결 설정 화면에서 다음 정보를 입력합니다:

기본 설정:

Name (연결 이름): 원하는 이름 지정 (예: "로컬 MySQL", "프로덕션 DB")
Host: 데이터베이스 호스트 주소 (예: localhost, 127.0.0.1, db.example.com)
Port: MySQL 포트 번호 (기본값: 3306)
User: MySQL 사용자명 (예: root, admin)
Password: 비밀번호
Database: 연결할 데이터베이스 이름 (선택사항, 나중에 변경 가능)

고급 설정 (Advanced):

SSH Tunnel: SSH를 통해 접속하는 경우 활성화
SSL: SSL 연결이 필요한 경우 활성화
Connection Timeout: 연결 타임아웃 설정 (기본: 30초)

3단계: 연결 테스트 및 저장

우측 하단의 "Test" 버튼을 클릭하여 연결을 테스트합니다
"Connection successful" 메시지가 나타나면 연결 정보가 올바른 것입니다
"Connect" 버튼을 클릭하여 연결합니다

연결에 성공하면 TablePlus 메인 화면으로 이동합니다.

팁: 연결 정보는 자동으로 저장되며, 홈 화면의 "Recent" 섹션에서 최근 사용한 연결을 빠르게 선택할 수 있습니다.

데이터베이스 변경하기

연결 후 다른 데이터베이스로 전환하는 방법입니다.

방법 1: 사이드바에서 선택

좌측 사이드바에서 현재 데이터베이스 이름을 확인합니다
데이터베이스 이름 옆에 있는 **드롭다운 화살표 (▼)**를 클릭합니다
나타나는 목록에서 원하는 데이터베이스를 선택합니다

방법 2: 데이터베이스 메뉴 사용

상단 메뉴바에서 "Database" 메뉴를 클릭합니다
"Switch Database" 또는 **"Change Database"**를 선택합니다
데이터베이스 선택 창에서 원하는 데이터베이스를 선택합니다

방법 3: 키보드 단축키

macOS: Cmd+Shift+D
Windows: Ctrl+Shift+D

단축키를 누르면 데이터베이스 선택 창이 바로 나타납니다.

실전 팁: 여러 데이터베이스 간에 자주 전환해야 한다면, 각 데이터베이스별로 별도의 연결을 만들어서 관리하는 것도 좋은 방법입니다.

테이블 정보 확인하기

TablePlus에서는 테이블의 구조와 데이터를 매우 직관적으로 확인할 수 있습니다.

테이블 목록 확인

좌측 사이드바에서 데이터베이스 이름을 확장합니다
"Tables" 폴더를 클릭하면 모든 테이블 목록이 표시됩니다
테이블을 더블클릭하거나 선택 후 Enter 키를 누르면 테이블을 열 수 있습니다

테이블 구조 (Schema) 확인

테이블을 열면 기본적으로 "Structure" 탭이 표시됩니다. 이 탭에서 다음 정보를 확인할 수 있습니다:

컬럼 정보:
- 컬럼명
- 데이터 타입
- NULL 허용 여부
- 기본값
- 키 정보 (Primary Key, Foreign Key 등)
- 인덱스 정보
인덱스:
- 인덱스 이름, 타입, 컬럼
외래키 (Foreign Keys):
- 관련된 테이블과 컬럼

테이블 데이터 확인

테이블 창에서 "Content" 탭을 클릭하면 실제 데이터를 확인할 수 있습니다.

데이터 보기 기능:

필터링: 컬럼 헤더를 클릭하여 필터 조건 추가
정렬: 컬럼 헤더를 클릭하여 오름차순/내림차순 정렬
검색: 상단 검색창에서 전체 테이블 데이터 검색
페이징: 하단에서 페이지 이동 및 페이지 크기 조정

추가 정보 확인

테이블 창의 다른 탭들:

Relations: 외래키 관계 시각화
Indexes: 인덱스 상세 정보
Triggers: 트리거 목록
SQL: 테이블 생성 SQL 스크립트

실전 팁:

테이블명을 우클릭하면 컨텍스트 메뉴가 나타나며, "Show Table Info"를 선택하면 모든 정보를 한눈에 볼 수 있습니다
Cmd+Click (macOS) 또는 Ctrl+Click (Windows)으로 여러 테이블을 동시에 열어서 비교할 수 있습니다

쿼리 실행하기

TablePlus에서 SQL 쿼리를 실행하는 방법을 알아봅시다.

새 쿼리 탭 생성

상단 툴바에서 "Query" 버튼을 클릭하거나
단축키 사용:
- macOS: Cmd+T
- Windows: Ctrl+T
메뉴에서 "Query" → "New Query" 선택

새 쿼리 탭이 생성되며, SQL을 입력할 수 있는 에디터가 나타납니다.

쿼리 작성 및 실행

쿼리 에디터에 SQL을 작성한 후:

실행 방법:

단축키 사용 (추천):
- macOS: Cmd+Enter 또는 Cmd+R
- Windows: Ctrl+Enter 또는 Ctrl+R
툴바 버튼: 우측 상단의 "Run" 버튼 클릭
메뉴: "Query" → "Run Current"

쿼리 결과 확인

쿼리 실행 후 결과는 하단 결과 패널에 표시됩니다:

테이블 뷰: 결과를 테이블 형태로 표시 (기본값)
JSON 뷰: JSON 형식으로 표시
CSV 뷰: CSV 형식으로 표시

결과 패널 기능:

결과 데이터 편집 가능
결과 내 검색
결과를 파일로 내보내기 (CSV, JSON, Excel 등)
결과 개수 확인

여러 쿼리 실행

여러 개의 SQL 문을 작성한 경우:

모두 실행: Cmd+Shift+Enter (macOS) / Ctrl+Shift+Enter (Windows)
선택한 쿼리만 실행: 실행하고 싶은 SQL을 드래그로 선택한 후 Cmd+Enter 실행

팁: 쿼리 에디터는 자동 완성 기능을 제공합니다. 컬럼명이나 테이블명을 입력하다가 Tab 키를 누르면 자동으로 완성됩니다.

쿼리 저장하기

자주 사용하는 쿼리를 저장하여 나중에 다시 사용할 수 있습니다.

북마크로 저장하기

쿼리를 작성한 후, 쿼리 창의 상단 **북마크 아이콘 (⭐)**을 클릭합니다
또는 단축키: Cmd+B (macOS) / Ctrl+B (Windows)
북마크 이름을 입력하고 저장합니다

북마크 사용하기

저장된 북마크는 좌측 사이드바의 "Bookmarks" 섹션에서 확인할 수 있습니다:

사이드바에서 "Bookmarks" 확장
저장된 북마크를 클릭하면 해당 쿼리가 새 탭에서 열립니다
북마크를 더블클릭하면 현재 탭에 로드됩니다

북마크 관리

편집: 북마크를 우클릭하여 "Edit" 선택
삭제: 북마크를 우클릭하여 "Delete" 선택
폴더 구성: 북마크를 드래그하여 폴더로 이동 (Pro 버전)

쿼리 히스토리

TablePlus는 최근 실행한 쿼리 히스토리를 자동으로 저장합니다:

쿼리 에디터에서 Cmd+↑ (macOS) / Ctrl+↑ (Windows)를 누르면 히스토리 목록이 나타납니다
또는 메뉴: "Query" → "History"
히스토리에서 이전 쿼리를 선택하여 다시 실행할 수 있습니다

실전 팁:

복잡한 쿼리는 북마크로 저장하고, 간단한 검색 쿼리는 히스토리에서 찾아 사용합니다
북마크에 카테고리별로 폴더를 만들어 체계적으로 관리하면 더욱 효율적입니다 (Pro 버전)

자주 사용하는 단축키

TablePlus의 생산성을 크게 높여주는 단축키들을 정리했습니다.

연결 및 네비게이션

기능	macOS	Windows	설명
새 연결	`Cmd+N`	`Ctrl+N`	새 데이터베이스 연결 생성
새 쿼리 탭	`Cmd+T`	`Ctrl+T`	새 쿼리 탭 열기
데이터베이스 전환	`Cmd+Shift+D`	`Ctrl+Shift+D`	데이터베이스 선택 창 열기
테이블 새로고침	`Cmd+R`	`F5`	테이블 목록 새로고침
창 닫기	`Cmd+W`	`Ctrl+W`	현재 탭/창 닫기

쿼리 실행

기능	macOS	Windows	설명
쿼리 실행	`Cmd+Enter`	`Ctrl+Enter`	현재 쿼리 실행
모두 실행	`Cmd+Shift+Enter`	`Ctrl+Shift+Enter`	모든 쿼리 실행
실행 중지	`Cmd+.`	`Ctrl+.`	실행 중인 쿼리 중지
쿼리 포맷팅	`Cmd+Shift+F`	`Ctrl+Shift+F`	SQL 코드 포맷팅 (Pro)

편집

기능	macOS	Windows	설명
북마크 추가	`Cmd+B`	`Ctrl+B`	현재 쿼리를 북마크로 저장
히스토리	`Cmd+↑`	`Ctrl+↑`	쿼리 히스토리 열기
주석 처리	`Cmd+/`	`Ctrl+/`	선택한 줄 주석 처리/해제
찾기	`Cmd+F`	`Ctrl+F`	텍스트 찾기
바꾸기	`Cmd+Option+F`	`Ctrl+H`	찾아 바꾸기

데이터 편집

기능	macOS	Windows	설명
행 추가	`Cmd+I`	`Ctrl+I`	새 행 삽입
행 삭제	`Cmd+Delete`	`Ctrl+Delete`	선택한 행 삭제
변경사항 저장	`Cmd+S`	`Ctrl+S`	테이블 변경사항 저장
변경사항 취소	`Cmd+Z`	`Ctrl+Z`	변경사항 취소

뷰 전환

기능	macOS	Windows	설명
구조 뷰	`Cmd+1`	`Ctrl+1`	테이블 구조 보기
데이터 뷰	`Cmd+2`	`Ctrl+2`	테이블 데이터 보기
쿼리 뷰	`Cmd+3`	`Ctrl+3`	SQL 쿼리 보기

팁: 모든 단축키는 메뉴바의 "TablePlus" → "Preferences" → "Shortcuts"에서 확인하고 변경할 수 있습니다.

실전 활용 팁

실무에서 TablePlus를 더욱 효율적으로 사용하기 위한 고급 팁들을 소개합니다.

1. 빠른 데이터 검색

테이블 데이터를 빠르게 검색하는 방법:

테이블을 연 후 상단 검색창에 키워드 입력
검색 결과가 하이라이트되며, Cmd+G / Ctrl+G로 다음 결과로 이동
특정 컬럼만 검색하려면 컬럼 헤더를 클릭하여 필터 추가

실전 예시:

사용자 이메일로 빠르게 찾기:
1. users 테이블 열기
2. email 컬럼 헤더 클릭
3. 필터에 "@gmail.com" 입력
4. 즉시 Gmail 사용자만 필터링됨

2. 데이터 내보내기 및 가져오기

내보내기:

테이블이나 쿼리 결과 선택
우클릭 → "Export" 선택
형식 선택: CSV, JSON, Excel, SQL 등
파일 저장 위치 지정

가져오기:

테이블 선택
우클릭 → "Import" 선택
CSV 또는 JSON 파일 선택
컬럼 매핑 확인 후 진행

3. 여러 테이블 동시 비교

비슷한 구조의 테이블을 비교할 때:

첫 번째 테이블을 열어둡니다
Cmd+Click (macOS) / Ctrl+Click (Windows)으로 두 번째 테이블을 클릭하여 새 탭에서 엽니다
두 탭을 나란히 놓고 비교할 수 있습니다 (Pro 버전에서는 다중 창 지원)

4. SQL 자동 완성 활용

TablePlus의 자동 완성은 매우 강력합니다:

테이블명 입력 후 . 입력 → 컬럼 목록 자동 완성
SELECT 입력 후 Tab → SELECT * FROM 자동 완성
함수명 입력 중 Tab → 함수 파라미터 힌트 표시

팁: 자동 완성 창이 나타나면 Tab 또는 Enter로 선택하고, Esc로 취소할 수 있습니다.

5. 쿼리 결과를 바로 편집

SELECT 쿼리 결과를 직접 편집할 수 있습니다:

쿼리 결과가 표시된 상태
결과 테이블에서 셀을 더블클릭하여 수정
Cmd+S / Ctrl+S로 변경사항 저장
TablePlus가 자동으로 UPDATE 문을 생성하여 실행

주의: 이 기능은 기본키가 있는 테이블에서만 안전하게 작동합니다.

6. 스키마 비교 (Pro 버전)

두 데이터베이스의 스키마를 비교할 수 있습니다:

메뉴: "Database" → "Compare Schemas"
비교할 두 데이터베이스 선택
차이점이 시각적으로 표시됩니다

7. 쿼리 성능 분석

쿼리 실행 시간을 확인하고 최적화:

쿼리 실행 후 하단 결과 패널 확인
"Execution Time" 또는 "Query Time" 표시 확인
느린 쿼리는 북마크에 "⚠️ Slow" 같은 태그 추가

8. 다크 모드 활용

장시간 작업 시 눈의 피로를 줄이기 위해:

메뉴: "TablePlus" → "Preferences" → "Appearance"
"Theme"에서 "Dark" 선택
또는 Cmd+Shift+D (macOS)로 빠르게 전환

9. 연결 그룹 관리

여러 환경(개발, 스테이징, 프로덕션)을 관리할 때:

각 환경별로 연결을 생성
연결 이름에 환경 표시 (예: "[DEV] MySQL", "[PROD] MySQL")
색상 태그 사용 (Pro 버전)

10. 쿼리 템플릿 사용

반복되는 쿼리 패턴을 템플릿으로 저장:

자주 사용하는 쿼리 구조를 작성
북마크로 저장
필요할 때 북마크를 열고 파라미터만 수정

예시 템플릿:

-- 사용자 검색 템플릿
SELECT * FROM users 
WHERE email LIKE '%@example.com'
AND created_at >= '2025-01-01'
ORDER BY created_at DESC
LIMIT 100;

TablePlus vs 전통적인 SQL 클라이언트

TablePlus가 기존 도구들과 다른 점을 간단히 정리합니다.

특징	TablePlus	MySQL Workbench / DBeaver
UI/UX	현대적이고 미니멀	전통적인 IDE 스타일
시작 속도	매우 빠름	상대적으로 느림
리소스 사용	가볍고 효율적	상대적으로 무거움
디자인	깔끔하고 직관적	기능 중심적
가격	무료 (제한) / $89	무료
지원 DB	10개 이상	특정 DB 중심

어떤 경우에 TablePlus를 선택할까?

빠르고 깔끔한 UI를 원할 때
여러 데이터베이스를 하나의 도구로 관리하고 싶을 때
간단한 쿼리와 데이터 확인이 주요 작업일 때
현대적인 디자인을 선호할 때

전통적인 도구를 선택하는 경우:

복잡한 ER 다이어그램이 필요할 때
대규모 데이터 마이그레이션 작업
무료 도구의 모든 기능이 필요할 때

마치며

TablePlus는 전통적인 SQL 클라이언트와는 확실히 다른 경험을 제공합니다. 특히 직관적인 UI와 빠른 성능이 가장 큰 장점입니다.

처음 사용하시는 분들은 다음 순서로 익숙해지시길 추천합니다:

✅ 기본 연결 생성 및 데이터베이스 전환
✅ 테이블 구조 및 데이터 확인
✅ 간단한 쿼리 작성 및 실행
✅ 북마크로 쿼리 저장
✅ 단축키 익히기
✅ 실전 팁 적용

무료 버전으로 충분히 사용해보시고, 필요에 따라 Pro 버전으로 업그레이드하는 것을 추천합니다. TablePlus의 직관적인 인터페이스는 곧 여러분의 데이터베이스 작업을 더욱 즐겁고 효율적으로 만들어줄 것입니다!

개요