database-connections

讀時間： 約 7 分鐘 · 系列： 平台啟用（數據工程）實踐 · 上一步： 分工 · 下一步： 工作區與資料目錄

為什麼用連線而不是匯資料進 Lantide

Lantide 在本機用 DuckDB 查詢：初始資料夾裡的檔案、以及經 Connections 掛上的資料庫或額外本機根。分析師可用 SQL 跨本地檔案與遠端表分析，無需先把整庫匯入本機。你負責把來源 配通、權限給對、alias 不衝突。

支援的資料來源

側邊欄 Data → Connections 可建立以下來源；目前皆可完整使用，產品不設方案層級或外部資料庫連線數上限：

基本流程（資料庫）

1. 側邊欄 Data 區 → Connections
2. 選類型，填連線資訊與唯一 alias
3. Test Connection → 成功後 Connect
4. Data 區出現 alias → schema → table 樹

SQL Server／Azure SQL： 先確保 Driver 18 已安裝且 App Detect 通過；可用 Autofill from connection string（僅 SQL login；Entra 不支援）。密碼連線成功後存於 OS vault（Keychain／Credential Manager）。查詢唯讀；ODBC staged——每條遠端 SQL 須單源，先物化再與本地／cache JOIN，不做單一 statement 透明跨源 JOIN。若 Agent 估計遠端結果超過約 50 萬列，可能 pause 請使用者確認後才繼續（見 USER_GUIDE §4.5、§12.6）。

Cloud folder： 選 provider 後填 bucket／prefix（或 Azure account／file system）與 credential。ADLS Gen2／Blob 可用 Autofill from SAS URL。Add 前可 Test connection；側邊欄若需建索引，對 alias Connect（Connections 卡片或 Sidebar 右鍵）。狀態 degraded 表示雲端可用但索引可能不完整，請 Connect 重建索引。Azure Files 須先由 OS／IT 掛載 SMB／檔案共用（Windows：對應磁碟機或 UNC；macOS：Finder → Connect to Server），再在 App 選擇 Mounted path——Lantide 不代為掛載。

管理現有綁定

Connections 對話框右側每張卡片有三個圖示：Edit（載入表單）、Connect／Disconnect（依狀態）、Remove（刪除設定）。Disconnect 後 Sidebar 不顯示該 alias，但綁定仍保留，可再 Connect。Link2 數字 = 已連線 DB + 已掛載 folder／cloud 總數。

Impact 確認： Remove、Disconnect 或 Edit → Save 若會影響 SQL 分頁對該來源的引用，系統會先列出引用 tab 數；必要時須勾選確認後才執行（與變更初始／Additional folder 路徑時相同）。

Additional／Cloud folder 在 Sidebar alias 列右鍵也可 Edit、Connect、Disconnect（英文選單）。

逐步操作見 USER_GUIDE §4.5。

引用格式（給分析師對照）

-- PostgreSQL 範例
SELECT * FROM pg_db.public.orders LIMIT 10;

-- Additional folder
SELECT * FROM "sales_drop"."orders.csv" LIMIT 10;

-- 跨源 JOIN 範例（本地／已掛載原生 DB／cache）
SELECT o.order_id, l.name
FROM sdb.main.orders o
JOIN "local.csv" l ON o.customer_id = l.customer_id;

alias 命名建議：短、唯一、團隊看得懂（例如 pg_warehouse），避免與初始資料夾語意、其他連線或 MCP alias 衝突。

限制與故障提示

你現在可以做一件事

用 唯讀帳號 建一條 PostgreSQL／MySQL／SQLite 測試連線，Test 成功後請分析師 SELECT 100 rows 右鍵預覽。若團隊有 SQL Server，再依 §4.5 完成 Driver 偵測與一條連線演練。

下一步

• 工作區與資料目錄
• 備份與匯入後重連
• 平台啟用（數據工程）引言