Knowledge Catalog (舊稱 Dataplex Universal Catalog) 可讓您大量匯入及匯出組織詞彙和項目連結，大規模管理組織詞彙。執行匯入或匯出公用程式指令碼時，您可以診斷及解決常見問題，例如缺少項目連結、匯出空白詞彙、詞彙或試算表網址無效、匯入工作中斷，以及指令碼網路逾時。詳情請參閱「關於匯入及匯出詞彙表和詞條連結」。
如果需要協助解決本文未提及的問題，請參閱「Cloud Customer Care」。
修正 Knowledge Catalog 中缺少的項目連結
執行匯出項目連結公用程式，將項目連結從 Knowledge Catalog 匯出至 Google 試算表後，您發現產生的 Google 試算表缺少部分項目連結 (關聯)。
如果匯出公用程式因下列情況而自動略過項目連結，就會發生這個問題：
權限不足 (遮蓋資源)：您不具備必要的 IAM 權限，無法查看與連結相關聯的來源項目或目標項目。
項目連結類型無效：項目連結使用不支援或無法辨識的關係類型。有效類型僅限
definition、related和synonym。項目參照不完整：項目中繼資料缺少必要的結構定義欄位，導致驗證檢查略過資源。
如要解決這個問題，請執行下列檢查：
驗證權限：確認您有權查看缺少的項目連結。確認執行指令碼的主體已獲派必要角色。
檢查執行記錄：查看終端機或指令碼記錄，找出含有
Skipping redacted entrylink的警告。記錄會輸出略過項目連結的特定資源 ID，以及省略的原因。檢查連結結構定義是否有效：如果您先前曾透過程式輔助方式修改這些連結，請確認其屬性符合結構定義規定。
詞彙表中找不到字詞
將組織詞彙匯出至 Google 試算表時，即使組織詞彙包含有效字詞，執行作業仍會失敗或傳回空白結果，並顯示 No terms found in the glossary 訊息。
如果指令碼找不到指定的詞彙表，或缺少擷取內容所需的存取權限，就會發生這個問題。常見原因包括：
- 詞彙表網址不正確：執行參數中設定的詞彙表網址不正確或拼寫錯誤。
- IAM 權限不足：執行指令碼的已驗證服務帳戶或使用者憑證，不具備查看或列出目標詞彙表中字詞的權限。
- 詞彙表 ID 不符：指令碼指令中指定的詞彙表 ID，與 Knowledge Catalog 中的實際詞彙表資源 ID 不符。
如要解決這個問題，請檢查設定和權限：
檢查詞彙表 ID：在 Google Cloud 控制台，前往「Knowledge Catalog」(知識目錄) 的「Glossaries」(詞彙表) 頁面，選取詞彙表，並確認資源 ID 與您傳遞至公用程式指令碼的 ID 相符。
驗證 IAM 權限：確認已驗證的憑證 (服務帳戶或您模擬的使用者帳戶) 已獲派必要角色。
驗證詞彙表網址結構：如果您將直接資源路徑或網址傳遞至指令碼，請確認該路徑或網址符合正確的 Knowledge Catalog 資源格式：
projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID
Knowledge Catalog 找不到項目的警告
在匯入項目連結作業期間，指令碼會暫停並顯示類似下方的警告：
Found X entries not found in Knowledge Catalog. EntryLinks associated with
these entries will be skipped. Continue with import? [y/N]:
如果 Google 試算表包含的項目連結，參照了 Knowledge Catalog 中不存在的資料資產或詞彙，就會發生這個問題。
如要解決這個問題，請選擇下列其中一個選項：
如要繼續部分匯入，請在提示中輸入
y。公用程式會匯入所有有效的項目連結，只略過參照遺失資源的連結。如要取消並修正缺少的資源，請輸入
n取消執行。確認來源文件中的項目 ID 與 Knowledge Catalog 中的資源名稱完全一致。請修正任何缺少的資源或錯字，然後再次執行匯入指令碼。
排解 Knowledge Catalog 匯入工作失敗的問題
如果匯入工作在執行過程中中斷或失敗，您不必重新啟動整個程序，也不必修改來源 Google 試算表。
這項公用程式會使用 Cloud Storage 暫存 bucket 中的封存資料夾，追蹤成功匯入的批次。
如要繼續執行工作，請按照下列步驟操作：
重新執行匯入公用程式。公用程式會偵測上次執行的狀態，並顯示下列提示：
Found X existing file(s) in archive folder from a previous incomplete import Continue using existing files? [y/N]:輸入
y。公用程式會略過已成功匯入的批次，只處理剩餘的檔案。
執行期間發生指令碼逾時或 SSL 錯誤
執行匯入或匯出公用程式指令碼時，執行作業停止、逾時，或在終端機中傳回 SSL 錯誤。
這個問題是由下列網路層級錯誤所造成：
- 企業 Proxy 或防火牆攔截：安全 Proxy 或防火牆攔截並檢查 HTTPS 流量，導致 SSL 憑證失效。
- 有效的 VPN 限制：VPN 設定限制了傳送至特定 Google Cloud API 或 Google 試算表端點的傳出流量。
- 區域網路不穩定：網際網路連線暫時中斷，導致工作階段中斷。
如要解決這些網路問題，請嘗試下列步驟：
確認網路連線穩定。
檢查 Proxy 和防火牆設定
檢查 VPN 設定。
依賴內建重試機制：公用程式指令碼內建重試邏輯，可因應暫時性網路故障。如果網路只是暫時中斷，請等待指令碼完成重試，再重新啟動執行作業。
試算表網址無效錯誤
嘗試執行匯入或匯出公用程式時，指令列介面會傳回 Invalid spreadsheet URL 錯誤並停止執行。
如果指令碼無法剖析提供的 Google 試算表連結，或沒有查看檔案的授權，就會發生這個問題。常見原因包括：
- 網址格式錯誤：網址不符合標準 Google 試算表路徑格式。
- 缺少試算表 ID：路徑缺少指向特定工作表的專屬英數字元 ID。
- 存取限制：已驗證的服務帳戶沒有查看或編輯工作表的權限，因此公用程式無法驗證連結。
如要解決這個問題，請驗證試算表連結和存取權設定：
驗證網址前置字元：請確認傳送至公用程式的試算表網址開頭為下列標準 Google 試算表路徑：
https://docs.google.com/spreadsheets/驗證試算表 ID：確認網址包含試算表的專屬 ID。有效網址應遵循以下結構：
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit檢查存取權限：在瀏覽器中開啟 Google 試算表，按一下「共用」，確認您已將服務帳戶電子郵件地址新增為「編輯者」。
解決無效詞彙表網址錯誤
嘗試執行詞彙匯入或匯出公用程式時，指令列介面會傳回 Invalid glossary URL 錯誤並停止執行。確認參數中沒有無效的詞彙表網址。
如果指令碼無法剖析提供的 Knowledge Catalog 詞彙資源路徑，或沒有查看資源的授權，就會發生這個問題。常見原因包括：
- 資源路徑格式錯誤：資源路徑不符合標準 Knowledge Catalog 詞彙表路徑格式。
- ID 不正確：路徑包含不正確的專案 ID、區域位置或詞彙表 ID。
- 存取限制或缺少資源：詞彙表不存在，或已驗證的服務帳戶缺少存取所需的 IAM 權限。
如要解決這個問題，請驗證詞彙表資源路徑和憑證：
驗證資源路徑結構：確認傳遞至公用程式的詞彙表路徑符合下列標準 Knowledge Catalog 格式：
projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID驗證路徑中的 ID：使用正確的專案 ID、位置和詞彙表 ID。
確認資源存在及存取權：確認詞彙表存在且 ID 正確，且已驗證的服務帳戶已獲派必要的 IAM 角色。
查看執行記錄
匯入和匯出公用程式在執行時會產生詳細的執行記錄。如果匯入工作失敗，請查看記錄檔，找出特定錯誤。這些記錄可協助您稽核轉移程序，並找出略過的項目或格式警告。
- 記錄檔位置：匯入和匯出公用程式會將記錄檔寫入本機執行路徑中的
logs/目錄。 - 記錄格式：每個記錄檔都會附加時間戳記，方便您找出特定執行作業的記錄。