> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sifi.life/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace 활용 팁과 베스트 프랙티스

> 놓치기 쉬운 유용한 기능, 워크스페이스 관리 베스트 프랙티스, 핵심 단축키, FAQ

> 이 문서는 **[Workspace UI 둘러보기](/training/02-databricks-overview/workspace-ui-tour)** 의 하위 문서입니다.

## UI에서 놓치기 쉬운 유용한 기능

### 🔍 글로벌 검색 (Search)

화면 상단의 **검색 바** 는 생각보다 강력합니다. 노트북, 테이블, 쿼리, 대시보드, 클러스터 등 Workspace의 거의 모든 자산을 한 곳에서 검색할 수 있습니다.

| 검색 대상 | 예시                     | 팁                               |
| ----- | ---------------------- | ------------------------------- |
| 노트북   | `my-etl-pipeline`      | 노트북 이름의 일부만 입력해도 검색됩니다          |
| 테이블   | `catalog.schema.users` | 3-level namespace로 정확히 검색 가능합니다 |
| 쿼리    | `daily sales report`   | 저장된 SQL 쿼리를 이름으로 검색합니다          |
| 최근 항목 | 검색 바 클릭만               | 최근 접근한 항목이 자동으로 나타납니다           |

> 💡 **단축키**: `Ctrl/Cmd + P`를 누르면 검색 바로 바로 이동할 수 있습니다. 마우스를 쓰지 않아도 됩니다.

### ⭐ Favorites (즐겨찾기)

자주 사용하는 노트북, 쿼리, 대시보드에 별표를 눌러 즐겨찾기에 추가할 수 있습니다. Home 화면의 **Favorites** 탭에서 한눈에 확인할 수 있습니다. 현업에서는 매일 확인하는 모니터링 대시보드, 자주 사용하는 유틸리티 노트북을 즐겨찾기에 등록해두면 편리합니다.

### 🕐 Recents (최근 항목)

Home 화면의 **Recents** 탭은 최근에 접근한 모든 자산을 시간순으로 보여줍니다. "어제 작업하던 그 노트북..."을 찾을 때 가장 빠른 방법입니다.

### 📋 Workspace 브라우저의 우클릭 메뉴

Workspace 파일 탐색기에서 노트북이나 폴더를 **우클릭** 하면 다음과 같은 유용한 기능을 사용할 수 있습니다.

| 기능              | 설명                                          |
| --------------- | ------------------------------------------- |
| **Clone**       | 노트북을 복제합니다. 기존 코드를 기반으로 새 실험을 시작할 때 유용합니다   |
| **Export**      | DBC, IPython, HTML, Python 등 다양한 포맷으로 내보냅니다 |
| **Permissions** | 특정 사용자/그룹에게 노트북 접근 권한을 부여합니다                |
| **Move**        | 노트북을 다른 폴더로 이동합니다                           |

### 📊 SQL Editor의 숨은 기능

* **쿼리 히스토리**: SQL Editor 좌측의 **History** 탭에서 과거에 실행한 모든 쿼리를 확인할 수 있습니다. 실수로 닫은 쿼리도 여기서 복구할 수 있습니다.
* **스키마 브라우저**: SQL Editor 좌측에서 카탈로그/스키마/테이블을 탐색하고, 테이블을 클릭하면 컬럼 정보를 바로 확인할 수 있습니다.
* **자동 포매팅**: 쿼리를 선택한 후 `Ctrl/Cmd + Shift + F`로 SQL을 자동 정렬할 수 있습니다.
* **멀티 쿼리**: `;`으로 구분된 여러 쿼리를 한 번에 작성하고, 원하는 쿼리만 선택하여 실행할 수 있습니다.

***

## 워크스페이스 관리 베스트 프랙티스

오랜 운영 경험에서 나온 실전 권장 사항들입니다.

### 폴더 구조 규칙

팀이 커지면 Workspace가 금세 어지러워집니다. 초기에 폴더 규칙을 정해야 합니다.

| 폴더 경로                               | 용도            |
| ----------------------------------- | ------------- |
| `Shared/`                           | 공유 루트 폴더      |
| `Shared/_templates/`                | 팀 공용 노트북 템플릿  |
| `Shared/_utils/`                    | 공용 유틸리티 함수    |
| `Shared/project-alpha/`             | 프로젝트별 폴더      |
| `Shared/project-alpha/exploration/` | 탐색/분석 노트북     |
| `Shared/project-alpha/pipeline/`    | ETL 파이프라인 노트북 |
| `Shared/project-alpha/archive/`     | 완료된 분석 보관     |
| `Shared/project-beta/`              | 다른 프로젝트 폴더    |

### 이름 짓기 규칙

| 대상            | 규칙               | 예시                                                |
| ------------- | ---------------- | ------------------------------------------------- |
| 노트북           | `[용도]_[대상]_[설명]` | `etl_orders_daily_load`, `analysis_churn_202503`  |
| 클러스터          | `[팀]_[용도]_[크기]`  | `de-team_etl_medium`, `ds-team_ml_gpu`            |
| SQL Warehouse | `[팀]_[용도]`       | `analytics_reporting`, `bi_dashboard`             |
| Job           | `[주기]_[파이프라인명]`  | `daily_orders_pipeline`, `hourly_clickstream_etl` |

### 비용 낭비를 막는 3가지 규칙

| 규칙                      | 설정                            | 효과                          |
| ----------------------- | ----------------------------- | --------------------------- |
| **Auto-termination 강제** | Cluster Policy에서 10\~30분으로 설정 | 퇴근 후 방치되는 클러스터 방지           |
| **인스턴스 타입 제한**          | Cluster Policy에서 허용 인스턴스 지정   | 불필요하게 큰 클러스터 생성 방지          |
| **Max workers 제한**      | Cluster Policy에서 최대 노드 수 설정   | Autoscaling이 과도하게 확장되는 것 방지 |

***

## 핵심 단축키

| 단축키                    | 기능                     | 사용 위치                |
| ---------------------- | ---------------------- | -------------------- |
| `Shift + Enter`        | 현재 셀 실행 후 다음 셀로 이동     | Notebook             |
| `Ctrl/Cmd + Enter`     | 현재 셀/쿼리 실행             | Notebook, SQL Editor |
| `Ctrl/Cmd + P`         | 글로벌 검색 (파일, 테이블, 쿼리 등) | 전체                   |
| `Ctrl/Cmd + Shift + -` | 셀 분할                   | Notebook             |
| `Ctrl/Cmd + /`         | 주석 토글                  | Notebook, SQL Editor |
| `Ctrl/Cmd + Shift + F` | SQL 자동 포매팅             | SQL Editor           |
| `Tab`                  | 자동 완성                  | Notebook, SQL Editor |
| `Esc`                  | 셀 편집 모드 → 커맨드 모드 전환    | Notebook             |
| `A` (커맨드 모드)           | 위에 새 셀 추가              | Notebook             |
| `B` (커맨드 모드)           | 아래에 새 셀 추가             | Notebook             |
| `D, D` (커맨드 모드)        | 셀 삭제 (D를 두 번)          | Notebook             |

> 💡 **현업 팁**: 단축키를 외우는 것은 번거롭지만, `Shift+Enter`(셀 실행), `Ctrl+P`(검색), `Ctrl+/`(주석) 이 3개만 알아도 생산성이 크게 올라갑니다.

***

## 정리

| 핵심 메뉴          | 역할                       |
| -------------- | ------------------------ |
| **Home**       | 최근 작업, 빠른 시작             |
| **Workspace**  | 노트북, 파일, 폴더 관리           |
| **SQL Editor** | SQL 쿼리 작성·실행             |
| **Compute**    | 클러스터, SQL Warehouse 관리   |
| **Jobs**       | 작업 스케줄링·모니터링             |
| **Dashboards** | 데이터 시각화                  |
| **Catalog**    | Unity Catalog를 통한 데이터 탐색 |

다음 문서에서는 코드를 작성하고 실행하는 핵심 도구인 **Notebook** 의 사용법을 자세히 알아보겠습니다.

***

## 자주 묻는 질문 (FAQ)

### Q: Workspace와 Account의 차이가 뭔가요?

**Account** 는 조직 전체를 관리하는 최상위 레벨입니다. Account Console(`accounts.cloud.databricks.com`)에서 여러 Workspace를 생성하고, 사용자를 관리하고, 결제를 관리합니다. **Workspace** 는 실제 작업이 이루어지는 환경입니다. 하나의 Account에 여러 Workspace를 만들 수 있습니다.

| 레벨            | 관리 대상                                       | 접근 URL                                |
| ------------- | ------------------------------------------- | ------------------------------------- |
| **Account**   | Workspace, 사용자, 결제, Unity Catalog Metastore | `accounts.cloud.databricks.com`       |
| **Workspace** | 노트북, 클러스터, Jobs, SQL, 카탈로그                  | `<workspace-id>.cloud.databricks.com` |

> 💡 **현업에서는 이렇게 합니다**: 보통 환경별로 Workspace를 분리합니다. `dev-workspace` (개발), `staging-workspace` (스테이징), `prod-workspace` (운영). 이렇게 하면 개발 환경의 실수가 운영에 영향을 주지 않습니다.

### Q: Workspace 접속이 안 됩니다. 어떻게 하나요?

| 증상                 | 원인              | 해결                        |
| ------------------ | --------------- | ------------------------- |
| 로그인 페이지가 안 뜸       | VPN 또는 IP 접근 제어 | VPN 연결 확인, 관리자에게 IP 허용 요청 |
| 로그인 후 빈 화면         | 브라우저 캐시 문제      | 시크릿/프라이빗 모드로 접속 시도        |
| "Access denied" 에러 | Workspace 권한 없음 | 관리자에게 사용자 추가 요청           |
| SSO 인증 실패          | IdP 설정 문제       | IT 관리자에게 SSO 설정 확인 요청     |

***

## 참고 링크

* [Databricks: Navigate the workspace](https://docs.databricks.com/aws/en/workspace/)
* [Azure Databricks: Workspace UI](https://learn.microsoft.com/en-us/azure/databricks/workspace/)
