共用方式為

PostgreSQL Microsoft Graph 連接器 (預覽)

  • 發行項

PostgreSQL Microsoft Graph 連接器可讓您的組織從 PostgreSQL 資料庫為記錄編制索引。 設定連接器之後，終端使用者就可以從 Microsoft Copilot 中的 PostgreSQL 和任何Microsoft搜尋用戶端搜尋這些記錄。

本文適用於Microsoft 365 個系統管理員或設定、執行及監視PostgreSQL圖形連接器的任何人。

注意事項

PostgreSQL 連接器處於預覽狀態。 如果您想要取得試用的存取權，您必須為 管理員 帳戶啟用目標發行通道。

功能

  • 使用 SQL 查詢為 PostgreSQL 資料庫中的記錄編製索引。
  • 使用 SQL 查詢中新增的使用者或群組清單，指定每一筆記錄的訪問許可權。
  • 讓使用者在 Copilot 中詢問索引記錄的相關問題。
  • 在 Copilot 中使用語意搜尋 ，讓用戶能夠根據關鍵詞、個人喜好設定和社交連線來尋找相關內容。

限制

  • 支援的 PostgreSQL 版本：連接器支援 PostgreSQL 第 14 版或更新版本。
  • 為了支援高編目速度和更佳的效能，建置連接器僅支援 OLTP (在線事務處理) 工作負載。 OLAP (在線分析處理) 工作負載，這些工作負載不會在 40 秒逾時後執行提供的 SQL 查詢，且不受支援。
  • ACL 僅支援使用使用者主體名稱 (UPN) 、Microsoft Entra ID 或 Active Directory 安全性。
  • 不支援在資料庫數據行內編製豐富內容的索引。 這類內容的範例包括 HTML、JSON、XML、Blob，以及作為資料庫數據行內連結存在的檔剖析。

必要條件

  • 您必須是組織Microsoft 365 租使用者的 搜尋管理員 。
  • 安裝 Microsoft Graph 連接器代理程式：若要存取 PostgreSQL 伺服器，您必須安裝並設定連接器代理程式。 若要深入瞭解，請參閱 安裝 Microsoft Graph 連接器代理 程式。
  • PostgreSQL 伺服器位址：若要連線到 PostgreSQL 數據，您需要組織的 PostgreSQL 伺服器位址。
  • 服務帳戶：若要連線到 PostgreSQL 伺服器並允許 Microsoft Graph 連接器定期更新記錄，您需要具有授與服務帳戶讀取許可權的服務帳戶。

開始使用安裝程式

1.顯示名稱

顯示名稱可用來識別 Copilot 中的每個引文，協助使用者輕鬆辨識相關聯的檔案或專案。 顯示名稱也代表受信任的內容。 顯示名稱也會當做 內容來源篩選條件使用。 此欄位有預設值，但您可以將它自定義為組織中用戶可辨識的名稱。

2.PostgreSQL 伺服器

若要連線到 PostgreSQL 數據，您需要 PostgreSQL 伺服器位址、埠和資料庫名稱。

3.驗證類型

PostgreSQL 連接器僅支援以密碼為基礎的驗證來連線到資料庫。

4.向有限的物件推出

如果您想要在 Copilot 和其他搜尋介面中驗證此連線，再將此連線擴充至更廣泛的物件，請將此連線部署至有限的使用者基底。 若要深入瞭解有限的推出， 請按兩下這裡。

內容

若要搜尋資料庫內容，您必須在設定連接器時指定 SQL 查詢。 這些 SQL 查詢需要將您要編製索引的所有資料庫數據行命名 (源屬性) 。 這包括需要執行才能取得所有數據行的任何 SQL 聯結。 若要限制對搜尋結果的存取，您必須在設定連接器時，指定 #DB276D86A51C949BD9CA4F359FBBDCFDB 清單 (SQL 查詢內) 的 ACL。

1.需要完整編目 ()

a. 選 (選) 和 ACL 資料行 (選用資料行)

[按兩下以展開]選取數據行以進行完整編目查詢。

在此步驟中，您會設定執行資料庫完整編目的 SQL 查詢。 完整編目會選取需要在 Microsoft Copilot 或 Search 中顯示的所有資料行或屬性。 您也可以指定 ACL 資料行，將搜尋結果的存取限制為特定使用者或群組。

提示

若要取得您需要的所有資料行，您可以聯結多個數據表。

此範例示範五個數據行的選取範圍，這些數據行會保存搜尋的數據：OrderId、OrderTitle、OrderDesc、CreatedDateTime 和 IsDeleted。 若要設定每個數據列的檢視許可權，您可以選擇性地選取下列 ACL 數據行：AllowedUsers、AllowedGroups、DeniedUsers 和 DeniedGroups。 所有這些數據行也有 查詢、 搜尋、擷 取或 精簡的選項。

選取資料行，如下列範例查詢所示： SELECT OrderId, OrderTitle, OrderDesc, AllowedUsers, AllowedGroups, DeniedUsers, DeniedGroups, CreatedDateTime, IsDeleted

SQL 連接器不允許 SELECT 子句中具有非英數位元的數據行名稱。 使用別名，從數據行名稱中移除任何非英數位元。 範例 - SELECT column_name AS columnName

若要管理搜尋結果的存取權，您可以在查詢中指定一或多個 ACL 資料行。 SQL 連接器可讓您控制每個記錄層級的存取權。 您可以選擇對資料表中的所有記錄擁有相同的存取控制。 如果 ACL 資訊儲存在個別的數據表中，您可能必須在查詢中與這些數據表聯結。

上述查詢中每個 ACL 資料行的使用方式如下所述。 下列清單說明四 種訪問控制機制。

  • AllowedUsers：此數據行會指定可存取搜尋結果的使用者標識符清單。
  • AllowedGroups：此數據行會指定可存取搜尋結果的使用者群組。
  • DeniedUsers：此資料行會指定 無法 存取搜尋結果的用戶清單。
  • DeniedGroups：此數據行會指定 無法 存取搜尋結果的使用者群組。

b. 支援的數據類型

[按兩下以展開]支援的數據類型清單。

下表摘要說明 PostgreSQL 連接器中支援的 SQL 資料類型。 數據表也會摘要說明支援的SQL數據類型的索引數據類型。 若要深入瞭解Microsoft圖形連接器支持的數據類型來編製索引，請參閱 屬性資源類型的檔。

類別 源數據類型 編製數據類型的索引
數值 smallint
整數
bigint
smallserial
串行
bigserial		 int64
數值 十進位
數值的
實數
雙精確度		 double
字元 字元變化 (n)
varchar (n)
字元 (n)
char (n)
bpchar (n)
bpchar
文字
 字串
貨幣 錢 int64
二進位 bytea 字串
日期或時間 timestamp [ (p) ] 沒有時區
時間戳 [ (p) ] 與時區
date
time [ (p) ] 沒有時區
time [ (p) ] 搭配時區		 datetime
日期或時間 interval [fields] [ (p) ] 字串
布林值 布林值 布林值
枚舉 列舉 字串

針對目前不直接支援的任何其他數據類型，數據行必須明確轉換為支持的數據類型。


c. 浮浮浮水印 (必要)

[按兩下以展開]在完整編目查詢中指定浮浮浮水印數據行

若要防止多載資料庫，連接器會使用完整編目浮浮水印數據行批次並繼續完整編目查詢。 使用浮浮水印數據行的值，會擷取每個後續批次，並從最後一個檢查點繼續查詢。 基本上，此機制會控制完整編目的數據重新整理。

建立浮浮浮水印的查詢代碼段，如下列範例所示：

  • WHERE (CreatedDateTime > @watermark). 使用保留關鍵詞 @watermark來寫入浮 如果浮浮水印資料列的排序順序為遞增，請使用 >，否則請使用 <。
  • ORDER BY CreatedDateTime ASC. 以遞增或遞減順序排序浮水印數據行。

若要擷取第一批數據列，請指定浮水印數據行的數據類型。

第一個查詢會使用下列方法擷取前 N 個數據列數：“CreatedDateTime > January 1， 1753 00：00：00” (dateTime 數據類型的最小值) 。 擷取第一個批次之後，如果數據列是以遞增順序排序，則批次中傳回的最高值 CreatedDateTime 會儲存為檢查點。 例如，2019 年 3 月 1 日 03：00：00。 然後在查詢中使用 「CreatedDateTime > March 1， 2019 03：00：00」 擷取下一批 N 個數據列。


2.選擇性) (虛刪除指示

若要排除資料庫中虛刪除的數據列不編製索引，請指定虛刪除數據行名稱和值，指出數據列已刪除。

使用者

1.對應包含訪問許可權信息的數據行

選取 [對應數據行] 以選擇指定存取控制機制的各種存取控制 (ACL) 資料行。 選取您在完整編目 SQL 查詢中指定的數據行名稱。

每個 ACL 資料行都應該是多重值數據行。 分號 (;) 、逗號 (、) 等分隔符可以分隔這些多個標識符值。 您必須在值分隔符欄位中指定此 分隔符 。

使用 作為 ACL 時支援下列識別元型態：

  • UPN) (用戶主體名稱 ：UPN) (用戶主體名稱是電子郵件位址格式的系統用戶名稱。 例如，UPN (： john.doe@domain.com) 包含使用者名稱 (登入名稱) 、@符号) (分隔符，以及 UPN 後綴) (功能變數名稱。
  • Microsoft Entra ID：在 Microsoft Entra ID 中，每個使用者或群組都有類似 'e0d3ad3d-0000-1111-2222-3c5f5c52ab9b' 的物件標識符。
  • Active Directory (AD) 安全性標識符：在內部部署 AD 安裝程式中，每個使用者和群組都有不可變的唯一安全標識符，看起來像 'S-1-5-21-3878594291-2115959936-132693609-65242.'

2.訪問許可權

您可以選擇使用上一個步驟中指定的 ACL，也可以覆寫這些 ACL，讓每個人都能看到您的內容。

同步處理

重新整理間隔會決定數據源與 Graph 連接器索引之間同步處理資料的頻率。

您可以根據此處的排程選項來設定完整和累加編目。 根據預設，如果每隔 15 分鐘設定一次) ，則累加編目 (，且會設定每天的完整編目。 如有需要，您可以調整這些排程，以符合您的數據重新整理需求。

此時，您已準備好建立 PostgreSQL 的連線。 您可以按下 [建立] 按鈕，從您的資料庫發佈連線和索引數據。

疑難排解

發佈連線之後，您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除，請參閱 管理您的連接器。

如果您有問題或想要提供意見反應，請 連絡 Microsoft Graph |支援。