ADD DISTPATH

使用 ADD DISTPATH 來建立分送路徑。建立分送路徑的目的，是將某個部署的「分送服務」連結到另一個部署的「接收端服務」，以便將歷程檔從來源部署傳送至目標部署。

語法

ADD DISTPATH path-name
         SOURCE source-uri
         TARGET target-uri|
         [TARGETTYPE ( MANAGER | COLLECTOR | RECVSRVR )] |
         AUTHENTICATION ( OAUTH
                        | (CERTIFICATE certificate-name)
                        | (USERIDALIAS alias [DOMAIN domain])
                        | [ENCRYPTIONPROFILE encryption-profile-name ]

path-name

您要新增的分送路徑唯一名稱。

source-uri

指定來源關鍵字之後的來源 URI，以指示資料的起源位置。此 URI 的格式包含「分送服務」的協定 (只支援歷程檔)、主機名稱、連接埠號碼，以及來源歷程檔的位置。

target-uri

在目標關鍵字之後指定目標 URI，以指示資料的傳送目標。此 URI 的格式為：

支援的通訊協定、udt、ogg、Web 通訊埠 ws 或安全 Web 通訊埠 wss

主機名稱，

接收端服務的連接埠號碼，

以及目標歷程檔的位置。

TARGETTYPE

分送路徑若使用舊版協定，請指定目標類型。此引數只有在目標 URI 綱要為 ogg:// 時才有效。

如果目標為執行中管理程式的舊有部署，請選擇 MANAGER。

如果目標為執行靜態收集器的舊有部署，請選擇 COLLECTOR。

目標為執行「接收端服務」的「微服務架構」建置時，請選擇 RECVSRVR。

AUTHENTICATION OAUTH

如果您使用外部身分識別提供者授權設定檔，請使用此選項。這將會設定從分送服務至接收端服務的流程。請參閱 Oracle GoldenGate Microservices Documentation 中的 Deploy-Delegate User Authentication and Authorization to an External ID Provider 。

注意：如果您的部署已啟用 IDCS，您仍然可以選擇使用其它認證選項進行驗證。

AUTHENTICATION CERTIFICATE certificate-name

已上傳分送路徑特定從屬端憑證的識別碼，且在管理服務中管理。

AUTHENTICATION USERIDALIAS

(除了憑證認證之外)，您可以將每個分送路徑與目標 DBLOGIN USERIDALIAS 建立關聯。

ENCRYPTIONPROFILE

指定分送路徑的加密設定檔名稱。

範例

---

ADD DISTPATH dpe  SOURCE trail://localhost:9002/services/v2/sources?trail=ea
                    TARGET wss://localhost:9003/services/v2/targets?trail=ea

---

目標歷程檔必須指定包含歷程檔的目錄。此範例使用預設的 dirdat 目錄。

ADD DISTPATH dpe  SOURCE trail://localhost:9002/services/v2/sources?trail=ea
                    TARGET ogg://localhost:9003/services/v2/targets?trail=dirdat/eb
                    TARGETTYPE MANAGER

---

完全合格的 DBLOGIN USERIDALIAS。

ADD DISTPATH dpe SOURCE ... TARGET ws://recvsrvr-host:recvsrvr-port ...
AUTHENTICATION USERIDALIAS target-dblogin-useridalias DOMAIN target-domain

---

來自預設網域的 DBLOGIN USERIDALIAS。

ADD DISTPATH dpe SOURCE ... TARGET wss://recvsrvr-host:recvsrvr-port ...

下列為此實行的範例：

ADD DISTPATH dpe SOURCE ... TARGET wss://recvsrvr-host:recvsrvr-port ...
AUTHENTICATION USERIDALIAS ggeast DOMAIN OracleGoldenGate

---

您可以選擇搭配 base64-encoded user:password 執行命令，以便使用證明資料存放區中管理的 USERIDALIAS 進行認證。

ADD DISTPATH dpe SOURCE ... TARGET ws://webuser:webpass@recvsrvr-host:recvsrvr-port...

在此例中，webuser 是使用者，而 webpass 是密碼。