왜 설정 가이드가 필요한가요?
Lakebase는 Databricks가 완전 관리하는 PostgreSQL 호환 데이터베이스이지만, 인스턴스 생성, 연결 설정, 사용자 관리, 모니터링 등 초기 설정을 올바르게 해야 안정적으로 운영할 수 있습니다. 이 문서에서는 Lakebase를 처음부터 끝까지 설정하는 전체 과정을 단계별로 안내합니다.💡 관리형 데이터베이스(Managed Database): 서버 프로비저닝, 패치, 백업, 장애 복구 등 인프라 운영을 클라우드 제공자가 대신 처리하는 데이터베이스 서비스입니다. 사용자는 데이터와 쿼리에만 집중할 수 있습니다.
전체 설정 흐름
1단계: 인스턴스 생성
Lakebase 데이터베이스는 세 가지 방법으로 생성할 수 있습니다.UI를 통한 생성
- Databricks 워크스페이스에서 Catalog Explorer 를 엽니다
- 좌측 메뉴에서 원하는 카탈로그 > 스키마 를 선택합니다
- Create→ Lakebase Database 를 클릭합니다
- 데이터베이스 이름을 입력하고 Create 를 클릭합니다
SQL을 통한 생성
Python SDK를 통한 생성
💡 생성 시간: Lakebase 인스턴스는 일반적으로 1~3분 내에 생성됩니다. 상태가PROVISIONING에서RUNNING으로 바뀌면 사용 가능합니다.
2단계: 연결 설정
Lakebase는 표준 PostgreSQL 프로토콜 을 지원하므로, 기존 PostgreSQL 클라이언트와 드라이버를 그대로 사용할 수 있습니다.연결 정보 확인
psql (CLI) 연결
Python (psycopg2) 연결
Python (SQLAlchemy) 연결
JDBC 연결 (Java/Scala)
⚠️ SSL 필수: Lakebase는 보안을 위해 SSL 연결만 허용 합니다. 연결 시 sslmode=require를 반드시 설정하시기 바랍니다.
3단계: 인스턴스 사이징 가이드
Lakebase는 오토스케일링 을 지원하지만, 초기 워크로드 특성에 맞는 적절한 시작점을 선택하는 것이 좋습니다.🆕 오토스케일링 (GA): Lakebase는 워크로드에 따라 자동으로 컴퓨팅 리소스를 확장/축소합니다. 스토리지는 최대 8TB 까지 자동 확장됩니다. 별도의 스케일링 작업이 필요 없습니다.
4단계: 사용자 및 역할 관리
Lakebase는 Unity Catalog 와 통합되어, Databricks의 사용자 및 그룹 체계를 그대로 사용합니다.Unity Catalog 기반 권한 관리
역할 기반 접근 제어 패턴
💡 Unity Catalog 통합의 장점: Lakebase의 권한은 Unity Catalog에서 중앙 관리됩니다. OLTP 데이터와 Delta Lake 데이터의 권한을 하나의 체계로 관리할 수 있어, 거버넌스 복잡도가 크게 줄어듭니다.
5단계: OAuth 인증 설정
프로덕션 환경에서는 Personal Access Token 대신 OAuth 를 사용하는 것을 권장합니다.서비스 프린시펄(Service Principal) 인증
⚠️ Personal Access Token 주의: PAT는 만료일을 설정하더라도 유출 위험이 있습니다. 프로덕션 환경에서는 반드시 OAuth 인증 또는 서비스 프린시펄 을 사용하시기 바랍니다.
백업/복구, 모니터링, 네트워크(Private Link), 비용 관리, 전체 설정 실습은 Lakebase 백업·모니터링·네트워크 설정 페이지에서 이어집니다.