Lantide Data

← 返回學習中心

workspace-and-data-folder

讀時間: 約 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。

下一步