本文說明如何排解及解決 Dataplex Universal Catalog 中繼資料變更記錄的常見問題。
建立中繼資料變更動態饋給時發生錯誤
本節說明如何解決建立中繼資料變更動態饋給時可能發生的錯誤。
權限遭拒錯誤
嘗試建立中繼資料變更動態消息時，您會收到 PERMISSION_DENIED 錯誤。
發生這個問題的原因可能是您或 Dataplex Universal Catalog 服務帳戶缺少必要權限。
如要解決這個問題，請查看下列規定：
確認您具備
dataplex.metadataFeeds.create權限。確認您在動態饋給範圍 (機構、專案或項目群組) 內擁有
dataplex.entryGroups.export權限。請確認 Dataplex Universal Catalog 服務帳戶 (
service-{PROJECT_NUMBER}@gcp-sa-dataplex.iam.gserviceaccount.com) 具備目的地 Pub/Sub 主題的roles/pubsub.publisher角色。
VPC Service Controls 錯誤
建立動態饋給時，系統顯示 PERMISSION_DENIED 或 VPC Service Controls 錯誤。
如要解決這個問題，請確認中繼資料變更動態饋給和監控的資源屬於同一個 VPC Service Controls 範圍：
如果動態消息的範圍是機構，系統只會監控同一重疊範圍內的專案。
如果動態饋給的範圍是專案或項目群組，請確保所有指定的專案或項目群組都與建立動態饋給的專案位於同一週邊。
通知傳送問題
本節說明如何解決通知傳送問題。
未收到通知
您不會在 Pub/Sub 主題中收到通知。可能原因如下：
缺少權限：Dataplex Universal Catalog 服務帳戶失去主題的
roles/pubsub.publisher角色。啟用延遲：新建立或更新的動態饋給最多可能需要 10 分鐘才會啟用。
主題已刪除：如果目的地 Pub/Sub 主題已刪除，Dataplex Universal Catalog 會停止發布。
範圍或篩選條件不符：變更可能不符合設定的範圍或篩選條件。
如要解決這個問題，請檢查下列事項：
確認 Dataplex Universal Catalog 服務帳戶是否具備主題的
roles/pubsub.publisher角色。建立或更新動態饋給後，請至少等待 10 分鐘。
檢查 Pub/Sub 主題是否存在。如果已刪除，請重新建立。
檢查動態消息設定，確保範圍和篩選條件符合您預期收到的中繼資料變更。
重複通知
收到重複的通知訊息。Dataplex Universal Catalog 會確保「至少傳送一次」，因此可能會出現重複訊息，尤其是在重試期間。
設定訂閱端應用程式，處理可能的重複項目。您可以使用 messageId 或變更時間戳記來識別及刪除重複訊息。
內容問題
本節說明如何解決中繼資料變更動態消息通知內容的問題。
酬載中缺少完整中繼資料
通知訊息只會包含資源名稱和變更類型，不會提供完整的中繼資料或具體變更內容。
這是因為根據設計，中繼資料變更動態饋給通知會提供「變更簽章」(變更內容)，而非完整酬載。這樣可確保訊息輕巧，並避免超出酬載大小上限。
使用通知中提供的資源名稱呼叫 Dataplex Universal Catalog API (例如 GetEntry)，並擷取資源的目前狀態。