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

개요

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

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

TablePlus란?

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

지원 데이터베이스:

• 관계형: MySQL, PostgreSQL, SQLite, MariaDB, Oracle, Amazon Redshift, SQL Server
• NoSQL: MongoDB, Redis, Cassandra, DynamoDB (v6.7.0+)
• 클라우드: Amazon RDS, Google Cloud SQL, Azure Database, ClickHouse, Snowflake, CockroachDB

주요 특징:

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

유료 vs 무료 버전

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

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

• 2개의 데이터베이스 연결(또는 창)만 가능
• 최대 2개의 작업 탭 (쿼리 탭 포함)
• 최대 2개의 고급 필터(Advanced Filter) 사용 가능 (v6.0+)
• 기본 기능 제공 (대부분의 기본 작업 가능)

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

• 무제한 데이터베이스 연결 및 탭
• 다중 창(Multiple Windows) 지원
• 모든 고급 필터 무제한 사용
• SSH 터널링 및 프라이빗 SSL 인증서 지원
• SQL 코드 포맷팅 및 자동 완성 강화
• 1년 동안 무료 업데이트 제공 (이후에도 구매한 버전은 영구 사용 가능)
• 프리미엄 기술 지원

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

🍯 무료 버전 탭 제한(2개) 극복하는 꿀팁

무료 버전의 가장 큰 제약인 **‘탭 2개 제한’**은 몇 가지 기능만 잘 활용하면 실무에서도 큰 불편함 없이 극복할 수 있습니다.

1. “Open Anything” (Cmd+P) 활용하기

여러 탭을 미리 열어두는 대신, 필요할 때마다 Cmd+P를 눌러 테이블이나 뷰를 검색해서 바로 전환하세요. 현재 탭의 내용이 새로운 테이블로 교체되므로, 탭 개수를 늘리지 않고도 여러 테이블을 빠르게 오갈 수 있습니다.

2. 단일 쿼리 탭에 여러 스니펫 작성

하나의 SQL 쿼리 탭에 여러 개의 쿼리문을 작성해두고 사용하세요.

• 실행하고 싶은 쿼리 문장에 커서를 두거나 드래그로 선택한 뒤 Cmd+Enter를 누르면 해당 쿼리만 실행됩니다.
• 자주 쓰는 쿼리들은 주석(--)으로 제목을 달아 한 탭에 모아 관리하면 탭을 여러 개 열 필요가 없습니다.

3. 작업 공간 분할 (Cmd+D) - 가장 강력한 방법!

하나의 탭 안에서 화면을 분할하여 여러 결과를 동시에 볼 수 있습니다.

• Cmd+D: 현재 쿼리 에디터를 아래로 분할합니다.
• Cmd+Shift+D (또는 에디터 상단 아이콘): 옆으로 분할합니다. 이렇게 하면 하나의 탭 안에서 서로 다른 두 개의 쿼리를 작성하고 각각 다른 결과 세트를 확인할 수 있어, 사실상 2개 이상의 탭을 쓰는 효과를 냅니다.

4. 북마크와 히스토리 적극 활용

• 북마크(Cmd+B): 복잡한 쿼리는 탭에 띄워두지 말고 북마크로 저장하세요. 필요할 때만 더블클릭해서 현재 탭에 불러오면 됩니다.
• 히스토리(Cmd+↑): 방금 실행했던 쿼리는 히스토리에서 바로 찾아 재사용할 수 있으므로, 굳이 쿼리를 보관하기 위해 탭을 유지할 필요가 없습니다.

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

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

1단계: 새 연결 생성

1. TablePlus를 실행하면 현대적으로 디자인된 Welcome Screen이 나타납니다.
2. 하단의 “Create a new connection” 링크를 클릭하거나, Cmd+N (macOS) / Ctrl+N (Windows) 단축키를 누릅니다.
3. 데이터베이스 종류 선택 화면에서 **“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단계: 연결 테스트 및 저장

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

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

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

데이터베이스 변경하기

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

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

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

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

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

방법 3: 키보드 단축키

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

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

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

테이블 정보 확인하기

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

테이블 목록 확인

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

테이블 구조 (Schema) 확인

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

• 컬럼 정보:

  • 컬럼명
  • 데이터 타입
  • NULL 허용 여부
  • 기본값
  • 키 정보 (Primary Key, Foreign Key 등)
  • 인덱스 정보

• 인덱스:

  • 인덱스 이름, 타입, 컬럼

• 외래키 (Foreign Keys):

  • 관련된 테이블과 컬럼

테이블 데이터 확인

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

데이터 보기 기능:

• 뒤로 / 앞으로 가기: 상단 툴바의 화살표 버튼으로 탐색 기록 이동 (v6.0+)
• 필터링: 하단의 “Filter” 버튼을 클릭하여 조건 추가 (컬럼명, 연산자, 값 입력)
• 정렬: 컬럼 헤더를 클릭하여 오름차순/내림차순 정렬 (고급 필터에서 여러 컬럼 정렬 가능)
• 검색: 상단 검색창에서 전체 테이블 데이터 검색 (Cmd+F)
• 페이징: 하단에서 페이지 이동 및 페이지당 행(Rows per page) 조정

추가 정보 확인

테이블 창의 다른 탭들:

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

실전 팁:

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

쿼리 실행하기

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

새 쿼리 탭 생성

1. 상단 툴바에서 “Query” 버튼을 클릭하거나
2. 단축키 사용:
   • macOS: Cmd+T
   • Windows: Ctrl+T
3. 메뉴에서 “Query” → “New Query” 선택

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

팁 (v6.0+): 쿼리 에디터 상단의 뷰 모드 아이콘을 사용하여 **작업 공간을 가로 또는 세로로 분할(Split)**하여 여러 쿼리나 결과를 동시에 볼 수 있습니다.

쿼리 작성 및 실행

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

실행 방법:

1. 단축키 사용 (추천):
   • macOS: Cmd+Enter 또는 Cmd+R
   • Windows: Ctrl+Enter 또는 Ctrl+R
2. 툴바 버튼: 우측 상단의 “Run” 버튼 클릭
3. 메뉴: “Query” → “Run Current”

쿼리 결과 확인

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

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

결과 패널 기능:

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

여러 쿼리 실행

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

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

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

쿼리 저장하기

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

북마크로 저장하기

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

북마크 사용하기

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

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

북마크 관리

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

쿼리 히스토리

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

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

실전 팁:

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

자주 사용하는 단축키

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

연결 및 네비게이션

쿼리 실행

편집

데이터 편집

뷰 전환

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

실전 활용 팁

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

1. 빠른 데이터 검색

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

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

실전 예시:

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

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

내보내기:

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

가져오기:

1. 테이블 선택
2. 우클릭 → “Import” 선택
3. CSV 또는 JSON 파일 선택
4. 컬럼 매핑 확인 후 진행

3. 여러 테이블 동시 비교

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

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

4. SQL 자동 완성 활용

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

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

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

5. 쿼리 결과를 바로 편집

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

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

주의: 이 기능은 기본키가 있는 테이블에서만 안전하게 작동합니다. 최신 버전에서는 JOIN 쿼리 결과에 대해서도 기본 테이블의 데이터를 직접 수정할 수 있는 기능이 강화되었습니다.

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

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

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

7. 쿼리 성능 분석

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

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

8. 다크 모드 활용

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

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

9. 연결 그룹 관리

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

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

10. 쿼리 템플릿 사용

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

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

예시 템플릿:

-- 사용자 검색 템플릿
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를 선택할까?

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

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

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

마치며

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

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

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

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

참고 자료

• TablePlus 공식 웹사이트
• TablePlus 문서
• TablePlus 단축키 가이드

이 가이드는 TablePlus Version 6.8.0 (macOS 기준)을 바탕으로 작성되었습니다. 앱의 버전이나 OS 환경에 따라 일부 UI 구성이 다를 수 있습니다.