驗證 PostgreSQL 對 Microsoft Fabric HorizonDB 的存取

使用資料庫建立者的 Microsoft Entra 身份來連接 Fabric HorizonDB。 本文協助您在不設定額外使用者的情況下驗證身份並檢查其有效存取權限。

Important

Fabric HorizonDB 目前處於公開預覽階段。 只有建立資料庫的 Microsoft Entra 身份才能連線。 其他使用者與主體無法連線,即使 Fabric 項目已分享。 如需更多資訊,請參閱 Microsoft Fabric 預覽功能。

Prerequisites

  • 一個 HorizonDB 資料庫。
  • 以建立資料庫的 Microsoft Entra 使用者身分登入。
  • 這些是 HorizonDB 資料庫顯示的 PostgreSQL 連線值。

了解公開預覽存取模式

存取路徑包含兩個強制執行點:

執行點 Purpose
Fabric 控制主體是否能透過支援的 Fabric 體驗來發現並使用該項目。
Fabric HorizonDB PostgreSQL 端點 驗證 Microsoft Entra 令牌,並強制執行為主體具體化的資料庫權限。

Fabric 工作區與項目權限不會覆蓋預覽版僅限創建者的 PostgreSQL 連線限制。 請勿嘗試透過 SQL 角色、群組成員資格、服務主體或受管理身份來新增使用者。

開啟建立者連線

  1. 以建立者身分開啟 HorizonDB 資料庫。
  2. 選擇「新增查詢」,或選擇「Visual Studio Code」以開啟桌面連線。
  3. 若要使用桌面連線,請選擇 Entra Auth ,並以創建者身分登入。
  4. 保留項目所提供的 PostgreSQL 端點與資料庫名稱。

驗證存取權

以建立者身份開啟新連線並執行:

SELECT
    current_database() AS database_name,
    current_user AS current_role,
    session_user AS session_role,
    clock_timestamp() AS checked_at;

確認回傳的角色是否代表建立者或其對應的資料庫身份。 然後在練習資料表上測試預期的操作。

您可以在不更改資料的情況下檢查有效權限:

SELECT
    has_schema_privilege(
        current_user,
        'horizon_sample',
        'USAGE'
    ) AS can_use_schema,
    has_table_privilege(
        current_user,
        'horizon_sample.orders',
        'SELECT'
    ) AS can_read_orders,
    has_table_privilege(
        current_user,
        'horizon_sample.orders',
        'UPDATE'
    ) AS can_update_orders;

這些函數會回報目前工作階段可見的權限。

不支援 SQL 角色管理

資料庫使用者在公開預覽期間無法透過 SQL 管理使用者或角色。 不要使用:

  • CREATE ROLE、ALTER ROLE 或 DROP ROLE。
  • GRANT role TO principal 或 REVOKE role FROM principal。
  • 基於密碼的登入角色。
  • 自訂角色階層,用於資料表層級或檢視層級的使用者權限。

這些指令並不是針對僅限建立者使用的限制的權宜之計。

變更或撤銷存取權

透過 Fabric 管理項目及分析存取。 這些權限不會讓您使用其他 PostgreSQL 身分。 若要變更創作者的存取權限或現有工作階段,請與您的預覽聯絡人確認所支援的程序。

公開預覽限制

  • Microsoft Entra 認證是必須的。 PostgreSQL 密碼驗證不是受支援的客戶身分識別模型。
  • 只有資料庫建立者能連線。
  • 無法支援資料表層級及檢視層級的使用者權限管理。
  • 其他 Microsoft Entra 使用者、群組、服務主體及受控識別無法連線。
  • 客戶不會獲得 PostgreSQL 超級使用者、主機或檔案系統的存取權限。

Troubleshoot

徵兆 Resolution
使用者無法開啟該項目 在 Fabric 中確認工作區與項目權限。
PostgreSQL 令牌被拒絕 以建立者身分登入,使用預覽版的驗證指引取得新的令牌,並驗證租戶、端點、TLS 設定及用戶端時鐘。
current_user 不是預期的身份 重新連接至預定的 Microsoft Entra 帳戶。 請不要嘗試只更改 PostgreSQL 使用者名稱來選擇其他身份。
創作者連線成功,但查詢被拒絕 檢查物件擁有權、有效權限,以及該操作是否受支援。
其他使用者在分享後無法連線 在目前預覽中預期如此。 分享不會啟用另一個 PostgreSQL 身分識別。
CREATE ROLE 或 GRANT role 失敗 請勿使用 SQL 角色來繞過預覽連線限制。