Fabric HorizonDB 的 SQL 編輯器會針對作業 PostgreSQL 端點執行 PostgreSQL SQL。 使用此功能建立與檢視客戶擁有的架構、查詢資料、測試交易,以及檢視 PostgreSQL 錯誤。
Important
Fabric HorizonDB 目前處於公開預覽階段。 功能、限制與行為可能會在正式推出前發生變化。 如需更多資訊,請參閱 Microsoft Fabric 預覽功能。
Prerequisites
- 存取 Fabric 工作區及 HorizonDB 資料庫。
- 以建立資料庫的 Microsoft Entra 使用者身分登入。
其他使用者與主體即使能開啟項目,也無法在目前預覽版中連線至 PostgreSQL。 請參閱 驗證 PostgreSQL 存取。
開啟查詢
在 Fabric 入口網站中開啟 HorizonDB 資料庫。
選擇 新查詢。
確認編輯器指向的是作業資料庫,而非 SQL 分析端點。
跑步:
SELECT current_database() AS database_name, current_user AS signed_in_user, pg_backend_pid() AS session_id, clock_timestamp() AS connected_at;
結果應能識別所選資料庫及您 Microsoft Entra 主體的有效身份。
貼上查詢,選取完整語句,然後選擇 執行。 確認結果格中顯示一列,並檢查訊息區域是否有警告或錯誤。
使用陳述式
編輯器可以依照已釋出介面中顯示的控制項,執行所選語句或目前查詢文字。 要讓腳本可預測:
- 語句結尾請用分號。
- 使用 PostgreSQL 語法與資料型態。
- 以 schema 對客戶資料表進行限定。
- 除非刻意區分大小寫,否則請使用小寫、不加引號的識別碼。
- 避免與無關查詢同時執行破壞性語句。
- 當列順序很重要時,請加入
ORDER BY。 - 加入選擇性的
WHERE子句,以及在探索大型表格時合理的LIMIT。
例如:
SELECT
order_row.order_reference,
customer.customer_name,
order_row.status,
order_row.total
FROM horizon_sample.orders AS order_row
JOIN horizon_sample.customers AS customer
ON customer.customer_id = order_row.customer_id
WHERE order_row.status IN ('open', 'processing')
ORDER BY order_row.order_date DESC, order_row.order_reference
LIMIT 100;
檢視結果與訊息
會傳回資料列的成功陳述式會顯示結果格線。 審閱:
- 欄位名稱與 PostgreSQL 類型。
- 傳回的資料列數。
- 空值與數值精確度。
- 伺服器通知或警告。
- 執行狀態及已過時間(如有)。
空結果集可能是正確的。 這並不能證明該陳述式執行失敗。 相反地,結果方格並不表示另一個鏡像或 Copy 作業運作正常。
PostgreSQL 錯誤通常會指出錯誤類別與位置。 在更改語句前請先閱讀完整訊息。 常見原因包括缺少結構描述限定、加上引號的識別碼大小寫、無效的 cast、限制違反或權限不足。
使用明確的事務
編輯器工作階段可以在陳述式之間保持開啟,因此請明確設定事務邊界以對應相關變更:
BEGIN;
UPDATE horizon_sample.orders
SET status = 'processing'
WHERE order_reference = 'ORD-1001'
AND status = 'open';
SELECT
order_reference,
status
FROM horizon_sample.orders
WHERE order_reference = 'ORD-1001';
COMMIT;
當驗證失敗時,請使用 ROLLBACK; 代替 COMMIT; 。
不要讓交易保持開啟狀態。 閒置事務可能會保留鎖定並阻止維護。 如果連線在 COMMIT 進行期間中斷,結果可能不確定;在重播變更前,重新連線並驗證業務紀錄。
探索資料庫物件
使用物件總管瀏覽結構、資料表、檢視、函數及支援的擴充功能。 DDL 之後:
- 重新整理相關的結構或物件群組。
- 展開客戶擁有的綱要。
- 檢查欄位、限制條件與索引。
- 確認顯示的物件與查詢所使用的資料庫及結構相符。
如果總管已過時,請使用 PostgreSQL 目錄驗證該物件:
SELECT
table_schema,
table_name,
table_type
FROM information_schema.tables
WHERE table_schema = 'horizon_sample'
ORDER BY table_name;
檢視查詢活動
檢查您目前的工作階段:
SELECT
pid,
usename,
application_name,
state,
xact_start,
query_start,
wait_event_type,
wait_event
FROM pg_catalog.pg_stat_activity
WHERE pid = pg_backend_pid();
其他工作階段及其查詢文字的可見性取決於 PostgreSQL 權限。 查詢文字可能包含敏感值;請勿將未經審核的輸出貼入問題回報或截圖中。
處理長時間執行的工作
- 除非編輯者確認關閉查詢分頁不會取消伺服器操作,否則在執行陳述式時保持查詢分頁開啟。
- 在您獲得權限時,請使用獨立的工作階段檢查
pg_stat_activity和pg_blocking_pids()。 - 只取消指定的語句。 未經明確授權,請勿終止其他使用者的工作階段。
- 在瀏覽器或網路中斷後,請確認資料變更語句是否已提交,再重新執行該語句前。
服務可在閒置一段時間後暫停。 開啟的編輯器分頁並不保證 PostgreSQL 工作階段能無限期保持可用。
排除編輯器問題
| 徵兆 | Resolution |
|---|---|
| 登入失敗 | 重新整理 Fabric 工作階段,確認租戶與工作區權限,然後重試一次。 |
| 查詢失敗:權限遭拒 | 確認您是資料庫建立者,檢查物件擁有權,並確認該操作是否受支援。 |
| 關聯不存在 | 確認資料庫、結構、拼字及引號識別碼大小寫。 |
| 物件總管不會顯示新資料表 | 如果需要,提交 DDL 並重新整理總管。 |
| 查詢等待 | 檢查阻塞工作階段、生命週期狀態,以及資料庫是否正在恢復。 |
| 連線重設 | 重新開啟查詢,啟動新事務,並安全地調和先前任何寫入的一致性。 |
| 查詢可在 PostgreSQL 端點上運作,但不適用於 SQL 分析端點 | 這些端點擁有不同的引擎、權限、新鮮度以及支援的操作。 |