Skip to main content
PostgreSQL 端口允許你透過向 PostgreSQL 推送資料或從中拉取資料，將 PostgreSQL 整合到資料流中。

​
核心功能

  • 功能完備的資料庫連線能力，並針對平臺進行了最佳化
  • 標準資料庫操作（Select、Lookup、Upsert），支援交易
  • 高階連線池和效能調優能力
  • 支援預存程序、函式和複雜查詢操作
請按照以下步驟將知行之橋連線到 PostgreSQL。

​
建立連線

若要允許知行之橋使用 PostgreSQL 中的資料，必須先建立到 PostgreSQL 的連線。建立此連線有兩種方式：
  • 將 PostgreSQL 端口新增到工作流程中。然後在設定索引標籤中，單擊連線下拉式清單旁邊的建立。
  • 開啟知行之橋設定頁面，然後開啟連線索引標籤。單擊新增，選擇 PostgreSQL，然後單擊下一步。
  • 僅在首次建立連線時需要登入過程。
  • 到 PostgreSQL 的連線可以在多個 PostgreSQL 端口之間重複使用。

​
輸入連線設定

開啟新的連線對話方塊後，請按照以下步驟操作：
  1. 提供所需資訊：
    • Name — 連線的靜態名稱。
    • Type — 始終設定為 PostgreSQL。
    • Server — 要連線的 PostgreSQL 伺服器地址。
    • Auth Scheme — 用於連線的身分驗證方案。選項包括 Password、AzureAD、AzureServicePrincipal、AzureServicePrincipalCert、AzurePassword、AzureMSI、AwsIAMRoles、AwsEC2Roles 和 GCPServiceAccount。系統會根據你的選擇顯示其他欄位。留空則使用預設身分驗證。
    • Database — 要定位的資料庫名稱。
    • Port — 連線伺服器時使用的端口。
    • User — 用於登入的使用者名稱。
    • Password — 上面輸入使用者的密碼。僅當身分驗證方案為 Password 或 AzurePassword 時需要。
    • AWS Access Key — AWS 帳戶存取金鑰。可從 AWS 安全憑證頁面取得。僅在使用 AWS 特定身分驗證方法時需要。
    • AWS Secret Key — AWS 帳戶金鑰。可從 AWS 安全憑證頁面取得。僅在使用 AWS 特定身分驗證方法時需要。
    • AWS Role ARN — 身分驗證時要使用的角色的 Amazon 資源名稱。僅在使用 AWS 特定身分驗證方法時需要。
    • AWS External Id — 上面輸入角色的 AWS 外部 ID。僅在使用 AWS 特定身分驗證方法時需要。
    • Azure Tenant — 託管資料庫的 Azure 租戶。僅在使用 Azure 特定身分驗證方法時需要。
    • OAuth Client Id — 分配給自定義 OAuth 應用程式的用戶端 ID（也稱為使用者金鑰）。僅當身分驗證方案為 AzureServicePrincipal 時需要。
    • OAuth Client Secret — 分配給自定義 OAuth 應用程式的用戶端金鑰。僅當身分驗證方案為 AzureServicePrincipal 時需要。
    • OAuth JWT Cert — 用戶端憑證的 JWT 憑證儲存名稱。僅當身分驗證方案為 AzureServicePrincipalCert 或 GCPServiceAccount 時需要。
    • OAuth JWT Cert Type — 包含 JWT 憑證的金鑰儲存型別。僅當身分驗證方案為 AzureServicePrincipalCert 或 GCPServiceAccount 時需要。
    • OAuth JWT Cert Password — 用於存取受密碼保護憑證儲存的 OAuth JWT 憑證密碼。如果憑證儲存不需要密碼，請留空。僅當身分驗證方案為 AzureServicePrincipalCert 或 GCPServiceAccount 時需要。
    • OAuth JWT Cert Subject — OAuth JWT 憑證的主題，用於在儲存中定位匹配憑證。支援部分匹配和萬用字元 ’*’ 以選擇第一個憑證。僅當身分驗證方案為 AzureServicePrincipalCert 或 GCPServiceAccount 時需要。
    • Scope — 指定認證使用者對應用程式的存取範圍，以確保其獲得適當的資料存取權限。僅在使用 Azure 特定身分驗證方法時需要。
  2. 可選：單擊高階開啟高階連線設定下拉功能表。大多數情況下不需要這些設定。
  3. 單擊測試連線，確保知行之橋可以使用所提供的資訊連線到 PostgreSQL。如果發生錯誤，請檢查所有欄位並重試。
  4. 單擊新增連線以完成連線。
  5. 在端口配置窗格的連線下拉式清單中，選擇新建立的連線。
  6. 單擊儲存更改。
高階索引標籤上還包含特定於資料來源的身分驗證和配置選項。本文件未全部介紹這些選項，但你可以在我們網站的線上幫助檔案頁面找到資料來源的詳細資訊。

​
選擇操作

建立到 PostgreSQL 的連線後，必須選擇 PostgreSQL 端口要執行的操作。下表概觀了每個操作及其在知行之橋工作流程中的位置。

​
進階選項卡

高階索引標籤上的許多設定會從當前使用的資料來源動態載入，因此本文件不介紹這些設定。你可以在我們網站的線上幫助檔案頁面找到資料來源的詳細資訊。 下面描述的選項適用於所有資料來源。

​
訊息

儲存至 Sent 資料夾和Sent 資料夾方案設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇顯示成功路徑，然後將成功路徑連線到File 端口。

​
進階設定

進階設定 是依賴任意資料庫驅動來連線各種資料來源的端口（例如 Database、CData 和 API 端口）的通用設定。

​
其他設定

其他設定 適用於特定用例。

​
自動化索引標籤

​
自動化設定

與端口自動處理檔案相關的設定。

​
效能

與端口資源分配相關的設定。

​
告警索引標籤

與告警配置相關的設定。 在執行服務級別協議（SLA）之前，需要設定電子郵件告警通知。預設情況下，知行之橋使用告警索引標籤上的全域設定。若要為此端口使用其他設定，請啟用覆蓋全域設定。 預設情況下，錯誤告警處於啟用狀態，這意味著只要發生錯誤就會傳送電子郵件。若要關閉，請取消勾選啟用核取方塊。 輸入主題（必填），然後可選擇輸入以逗號分隔的收件人電子郵件清單。

​
SLA 索引標籤

與服務級別協議（SLA）配置相關的設定。 SLA 可用於配置工作流程中端口預計傳送或接收的數量，並設定預計達成該數量的時間範圍。當 SLA 未滿足時，知行之橋會傳送電子郵件警告使用者，並將 SLA 標記為_存在風險_；這意味著如果很快仍未滿足 SLA，它將被標記為_已違反_。這使使用者有機會介入，確定 SLA 未滿足的原因並採取適當操作。如果在風險時間段結束時 SLA 仍未滿足，則會將 SLA 標記為已違反，並再次通知使用者。 若要定義 SLA，請啟用預期數量，然後單擊設定索引標籤。 空 SLA 配置
  • 如果端口具有單獨的傳送和接收操作，請使用選項按鈕指定 SLA 適用的方向。
  • 在視窗的至少期望部分：
    • 設定期望處理的最小交易數（數量）
    • 使用每欄位指定時間範圍
    • 指明 SLA 應何時生效。如果選擇開始於，請填寫日期和時間欄位。
    • 勾選希望 SLA 生效的星期幾。如有必要，可使用下拉式清單選擇每天。
  • 在視窗的**將狀態設定為“存在風險”**部分，指定何時應將 SLA 標記為存在風險。
    • 預設情況下，只有 SLA 已違反時才會傳送通知。若要更改此行為，請勾選傳送“存在風險”通知。
以下範例顯示了為某個端口配置的 SLA：該端口預計在週一至週五每天接收 1000 個檔案。如果在時間段結束前 1 小時仍未收到 1000 個檔案，則傳送存在風險通知。 SLA 配置範例
如有必要，可以關閉 SLA 告警。這在維護視窗期間很有用。單擊導覽列上的設定，然後導航到告警 > 常規告警。單擊平板和鉛筆圖示進行編輯，並取消勾選 SLA Alerts 設定。

​
宏

在檔案命名策略中使用宏可以提高組織效率，並增強對資料上下文的理解。透過在檔名中加入宏，可以動態包含識別碼、時間戳和訊息頭資訊等相關資訊，為每個檔案提供有價值的上下文。這有助於確保檔名反映對組織重要的詳細資訊。 知行之橋支援以下宏，它們都使用以下語法：%Macro%。

​
範例

某些宏（例如 %Ext% 和 %ShortDate%）不需要參數，但其他宏需要參數。所有接受參數的宏都使用以下語法：%Macro:argument% 以下是一些接受參數的宏範例：
  • %Header:headername%：其中 headername 是訊息上的訊息頭名稱。
  • %Header:mycustomheader% 解析為輸入訊息上設定的 mycustomheader 訊息頭的值。
  • %Header:ponum% 解析為輸入訊息上設定的 ponum 訊息頭的值。
  • %RegexFilename:pattern%：其中 pattern 是規則運算式模式。例如，%RegexFilename:^([\w][A-Za-z]+)% 匹配並解析為檔名中的第一個單詞，且不區分大小寫（test_file.xml 解析為 test）。
  • %Vault:vaultitem%：其中 vaultitem 是保管庫中某項的名稱。例如，%Vault:companyname% 解析為保管庫中儲存的 companyname 項的值。
  • %DateFormat:format%：其中 format 是可接受的日期格式（詳情請參見範例日期格式）。例如，%DateFormat:yyyy-MM-dd-HH-mm-ss-fff% 解析為檔案上的日期和時間戳。
你還可以建立更復雜的宏，如以下範例所示：
  • 在一個檔名中組合多個宏：%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%
  • 在宏外包含文字：MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%
  • 在宏內包含文字：%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%