排解中繼資料變更動態饋給問題

Knowledge Catalog (舊稱 Dataplex Universal Catalog) 中繼資料異動動態饋給會將通知發布至 Pub/Sub,讓您近乎即時地追蹤中繼資料項目和切面的異動。設定或監控這些動態饋給時,您可以診斷及解決常見問題,包括動態饋給建立權限、VPC Service Controls 範圍、通知傳送和訊息酬載。詳情請參閱「關於中繼資料變更動態饋給」。

如果需要協助解決本文未提及的問題,請參閱「Cloud Customer Care」。

中繼資料變更動態饋給建立錯誤

本節說明如何解決建立中繼資料異動動態饋給時可能遇到的錯誤。

權限遭拒錯誤

嘗試建立中繼資料異動動態饋給時,收到 PERMISSION_DENIED 錯誤。

發生這個問題,是因為您或 Knowledge Catalog 服務帳戶可能缺少必要權限。

如要解決這個問題,請確認是否符合下列規定:

  • 請確認您具備 dataplex.metadataFeeds.create 權限。

  • 請確認您具備動態饋給範圍 (組織、專案或項目群組) 的 dataplex.entryGroups.export 權限。

  • 確認 Knowledge 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 perimeter:

  • 如果動態饋給的範圍是組織,則只會監控相同 perimeter 內的專案。

  • 如果動態饋給的範圍是專案或項目群組,請確認所有指定的專案或項目群組,都與您建立動態饋給的專案位於相同的 perimeter。

通知傳送問題

本節說明如何解決通知傳送問題。

未收到通知

Pub/Sub 主題未收到通知。可能原因如下:

  • 缺少權限:Knowledge Catalog 服務帳戶缺少主題的 roles/pubsub.publisher 角色。

  • 啟用延遲:新建立或更新的動態饋給最多可能需要 10 分鐘才會啟用。

  • 主題已刪除:如果目的地 Pub/Sub 主題已刪除,Knowledge Catalog 會停止發布。

  • 範圍或篩選條件不符:變更可能不符合設定的範圍或篩選條件。

如要解決問題,請檢查下列事項:

  • 確認 Knowledge Catalog 服務帳戶具備主題的 roles/pubsub.publisher 角色。

  • 建立或更新動態饋給後,請等待至少 10 分鐘。

  • 檢查 Pub/Sub 主題是否存在。如果已刪除,則必須重新建立。

  • 請檢查動態饋給設定,確保範圍和篩選器與您預期收到的中繼資料變更相符。

重複通知

收到重複的通知訊息。Knowledge Catalog 確保訊息「至少傳送一次」,因此可能會出現重複訊息,尤其是在重試期間。

請設定訂閱者應用程式,以便處理可能重複的訊息。您可以使用 messageId 或變更時間戳記,識別及簡化訊息。

內容問題

本節說明如何解決中繼資料變更動態饋給通知內容的問題。

酬載中缺少完整中繼資料

通知訊息只包含資源名稱和變更類型,不含完整中繼資料或特定變更。

這是因為中繼資料異動動態饋給通知的設計,是提供「異動簽章」(異動內容),而非完整酬載。這樣可以保持訊息輕量,並避免酬載大小限制。

使用通知中提供的資源名稱呼叫 Dataplex API (例如 GetEntry),並擷取資源的目前狀態。