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),並擷取資源的目前狀態。