本指南可協助您排解匯入及匯出術語表和詞條連結時發生的 Knowledge Catalog 問題，包括詞條連結遺失、術語表網址無效錯誤，或匯入工作失敗等。
如果需要解決本頁面未提及的問題，請與 Google Cloud 支援團隊聯絡。
修正 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」術語集頁面，選取術語集，然後確認資源 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/目錄。 - 記錄格式：每個記錄檔都會附加時間戳記，方便您找出特定執行的記錄。