使用 SQL 編輯器查詢 Microsoft Fabric HorizonDB

Fabric HorizonDB 的 SQL 編輯器會針對作業 PostgreSQL 端點執行 PostgreSQL SQL。 使用此功能建立與檢視客戶擁有的架構、查詢資料、測試交易,以及檢視 PostgreSQL 錯誤。

Important

Fabric HorizonDB 目前處於公開預覽階段。 功能、限制與行為可能會在正式推出前發生變化。 如需更多資訊,請參閱 Microsoft Fabric 預覽功能。

Prerequisites

  • 存取 Fabric 工作區及 HorizonDB 資料庫。
  • 以建立資料庫的 Microsoft Entra 使用者身分登入。

其他使用者與主體即使能開啟項目,也無法在目前預覽版中連線至 PostgreSQL。 請參閱 驗證 PostgreSQL 存取。

開啟查詢

  1. 在 Fabric 入口網站中開啟 HorizonDB 資料庫。

  2. 選擇 新查詢。

  3. 確認編輯器指向的是作業資料庫,而非 SQL 分析端點。

  4. 跑步:

    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 之後:

  1. 重新整理相關的結構或物件群組。
  2. 展開客戶擁有的綱要。
  3. 檢查欄位、限制條件與索引。
  4. 確認顯示的物件與查詢所使用的資料庫及結構相符。

如果總管已過時,請使用 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 分析端點 這些端點擁有不同的引擎、權限、新鮮度以及支援的操作。