讀時間: 約 6 分鐘 · 系列: 平台啟用(數據工程)實踐 · 上一步: 資料源與連線 · 下一步: .lantide 匯出匯入
工作區是什麼
每個 Workspace 是獨立環境,各自擁有:
- SQL 分頁與快取
- 初始資料夾(每工作區一個本機根)
- 專案(Plan / Report)
- 連線與 MCP 設定(含 Additional folder 綁定;存於該工作區設定檔)
分析師用工作區隔離 不同專案線或不同資料環境(例如「大促復盤」vs「日常 adhoc」)。
初始資料夾 vs Additional folder
| 初始資料夾 | Additional folder | Cloud folder | |
|---|---|---|---|
| 入口 | Data 區本機資料夾列 → Change data folder | Connections → Additional folder | Connections → Cloud folder |
| 數量 | 每工作區 一個 | 可多個;各有 alias | 可多個;各有 alias |
| 可用性 | 完整可用 | 完整可用 | 完整可用 |
| 查詢 | "file.csv" 等(相對初始根) |
"alias"."file.csv" |
"alias"."file.parquet" 等 |
| 刷新 | Data Refresh | Connect 重掃 | Connect 重建索引;degraded 時亦需 Connect |
| 變更路徑 | 右鍵 Change data folder(有 SQL 引用時須勾選確認) | Connections Edit 改路徑(同上) | Connections Edit 改 bucket/prefix 等 |
Additional folder 不搬移、不刪除來源檔;它提供獨立 alias、Connect/Disconnect 與可攜管理——不是本機檔案 DRM(使用者仍可能改初始資料夾指向等方式讀多路徑)。細節見 USER_GUIDE §4.5。
常用操作
| 操作 | 方式 |
|---|---|
| 建立 | 側邊欄 Workspace + |
| 切換 | 點其他工作區名稱或右鍵 Switch |
| 重新命名 | 右鍵 → Rename(1–40 字元;英數、簡繁漢字、_ - .;不可用空白、中文標點或全形符號) |
| 封存 | 右鍵非使用中工作區 → Archive Workspace |
| 管理封存 | 右鍵 Workspace (n) → Manage Archived Workspaces…;圖示可取消封存或永久刪除,外部資料夾會保留 |
| 變更初始資料夾 | Data 區本機資料夾列右鍵 → Change data folder(有 SQL 引用時須勾選確認) |
| 掛額外本機根 | Data → Connections → Additional folder |
詳見 USER_GUIDE §3。
隔離意味著什麼
- 切換工作區 → 快取表會清掉,切回需重跑查詢或 Source Run
- 分頁、側邊欄展開狀態 依工作區分別記住
- 匯入 Workspace 時,若 bundle 與本機既有工作區屬於同一版本歷史,可明確選擇更新既有工作區或匯入為獨立副本;不相符時建立新工作區
規劃時建議:一個業務域或一個資料環境一個工作區,減少分析師誤用錯誤資料夾。
資料目錄最佳實踐
- 初始資料夾指向團隊 共用或同步 的穩定路徑(NAS、雲端同步目錄等)
- 多個不相鄰本機根、又不想合併目錄 → 使用 Additional folder,並約定 alias 命名
- 換機匯入 Workspace 時:
- Rebind: bundle 未含 physical data 時,在新機指定對應資料夾/額外根
- Extract: 匯出勾選 Include physical data files(含初始與 additional);匯入時選擇一個專用位置,預設資料還原至
main/,Additional 還原至additional/<alias>/。所選位置內的main、additional都必須未被占用;需要時可在進階選項改選 Additional 自訂基底(見 .lantide 匯出匯入)
- 桌面版可用 Reveal in Finder / Show in File Explorer 確認目前初始資料夾
檔案搬移後如何接續
資料改名或搬移後先按 Data → Refresh。可可靠追蹤的本機同 volume 來源會嘗試恢復;無法判定時使用 Locate folder/Locate file,不要靠同名檔猜測。單檔恢復不能超出原來源資料夾;改到另一根目錄應先 Rebind。
來源恢復可能更新目前 SQL 分頁的引用,未儲存編輯會保留並提示。歷史 SQL 保持原文,讀取時另附目前來源對應;這不證明資料內容沒變,仍須重新執行。跨磁碟、外接碟、NAS 與雲端同步位置不保證自動恢復。
你現在可以做一件事
為團隊建立一個命名規範範例:ws_prod_analytics、ws_campaign_618,並在 wiki 註明各工作區對應的初始資料夾路徑與(若有)Additional folder alias。
Local data、Additional folder 與 Cloud folder 父列可拖到外部 Agent,指定「看看這個來源下的數據表」。Agent 先列目前可查詢檔案/工作表,再按需求讀 schema 或抽樣;遵守既有掃描與索引設定,Cloud 不會因拖移自動 Refresh。改綁目錄/雲端位置或 rename alias 後請重新拖移。來源父列不插入內建聊天 chip、不進 @,也不提供 Add to chat。