Microsoft Fabric HorizonDB 中的驗證

Fabric HorizonDB 使用 Microsoft Entra 驗證來進行 PostgreSQL 連線。 呼叫主體決定有效的 PostgreSQL 身份。

Important

Fabric HorizonDB 目前處於公開預覽階段。 只有建立資料庫的 Microsoft Entra 身份才能連線。 其他使用者和主體無法連線,即使他們可以開啟 Fabric 項目。 使用您自己的資料庫中的連線詳細資訊。 如需更多資訊,請參閱 Microsoft Fabric 預覽功能。

驗證與授權是不同的

身分驗證可驗證身分。 授權決定了該身份能做什麼。

成功登入本身並不代表能獲得:

  • 存取 Fabric 工作區或項目。
  • PostgreSQL CONNECT 權限。
  • 架構 USAGE。
  • 表格、序列、函數或 DDL 權限。
  • 存取聯盟來源、複製作業來源或 SQL 分析端點。

關於授權,請參閱授權。

支援的身分模式

以資料庫建立者身分登入 Fabric SQL 編輯器、Visual Studio Code、應用程式練習及複製工作目的地連線。 在目前預覽版中,Microsoft Entra 群組、服務主體、受管理身份及其他 Microsoft Entra 使用者不支援 PostgreSQL 連線。

互動式客戶端

對於 Fabric SQL 編輯器,服務會使用您已登入的 Fabric 上下文。 呼叫主體決定有效的 PostgreSQL 身份。

針對 Visual Studio Code:

  1. 安裝 Microsoft PostgreSQL 擴充功能。

  2. 在 Fabric HorizonDB 工具列中選擇 Visual Studio Code,然後在連線窗格中選擇「在 VS Code 中開啟」。

  3. 選擇 Entra Auth。

  4. 以資料庫建立者身分登入正確的租戶。

  5. 確認主機、資料庫、使用者格式及 TLS 設定。

  6. 跑步:

    SELECT
        current_database(),
        current_user,
        clock_timestamp();
    

應用程式驗證

應用程式應:

  1. 從設定中載入非敏感連線資訊。
  2. 預覽練習中使用資料庫建立者的 Microsoft Entra 身份。
  3. 使用您為預覽連線指定的受眾或範圍請求令牌。
  4. 開啟一個受 TLS 保護的 PostgreSQL 連線,並提供該令牌作為密碼等效的憑證。
  5. 設定有限連線逾時時間及非敏感應用程式名稱。
  6. 不再需要時丟棄該標記。

不要用服務主體或管理身份來取代創作者。 進行本機 Python 練習時,請使用 Psycopg 3 和明確指定的互動式認證。 請參閱使用 Python 連線。

代幣與池生命週期

當建立實體連線時,權杖驗證會發生。 現有的工作階段不會在每次語句前自動重新驗證。

  • 每新增一次實體連線或更新池,請取得一個新的令牌。
  • 在令牌到期前更換池連線。
  • 在暫停、擴展或維護後驗證借用連線。
  • 限制重試,且絕不無限期重試無效或過期的認證。

變更 Fabric 項目權限不會在目前預覽版中啟用額外的 PostgreSQL 身份。

驗證已驗證的身分識別

跑步:

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

確認回傳的身份是否代表資料庫建立者或其對應的資料庫識別。 不要建立 PostgreSQL 登入角色以繞過預覽限制。

驗證疑難排解

徵兆 支票
令牌獲取失敗 憑證設定、租戶選擇、條件存取及本機登入狀態。
PostgreSQL 拒絕該憑證 令牌範圍或受眾、到期日、租戶、使用者格式、伺服器時鐘及端點。
入口網站運作正常,但應用程式無法運作 比較身份、資料庫、使用者格式、令牌流程、TLS 模式及有效資料庫存取。
其他使用者無法連線 在目前預覽中預期如此。 以資料庫建立者身份重新連線;分享該項目不會啟用其他 PostgreSQL 身份。
驗證可行,但查詢被拒絕 確認目前的資料庫、物件擁有權,以及該操作是否被支援。
資料庫已暫停 在授權連線開始恢復時,請使用受限的連線重試。

擷取已清理的錯誤類別、UTC 時間戳記、用戶端與驅動程式版本,以及關聯 ID。 永遠不要傳送 token 或完整的 連接字串。

Limitations

  • 密碼驗證並未列為公開預覽身分識別模型。
  • 不提供客戶超級使用者與主機驗證設定。
  • 只有資料庫建立者能連線;不支援額外使用者與應用程式主體。
  • 分享並不是解決僅限建立者使用的限制的權宜之計。
  • 不要假設 SQL 角色管理或細緻多使用者存取功能可用。
  • TLS 和端點值不能與另一個服務的值互換。