本指南可帮助您排查导入和导出术语库和条目链接时出现的 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 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 暂存存储桶中的归档文件夹跟踪成功导入的批次。
如需恢复作业，请按以下步骤操作：
重新运行导入实用程序。该实用程序会检测上次运行的状态，并显示以下提示：
Found X existing file(s) in archive folder from a previous incomplete import Continue using existing files? [y/N]:输入
y。该实用程序会跳过已成功导入的批次，并且仅处理剩余的文件。
执行期间脚本超时或 SSL 错误
运行导入或导出实用程序脚本时，执行会停止、超时或在终端中返回 SSL 错误。
出现此问题的原因是以下网络级错误：
- 公司代理或防火墙拦截：安全代理或防火墙正在拦截和检查 HTTPS 流量，这会导致 SSL 证书失效。
- 有效的 VPN 限制：您的 VPN 配置将出站流量限制为 某些 Google Cloud API 或 Google 表格端点。
- 本地网络不稳定：互联网连接暂时中断，导致会话中断。
如需解决这些网络问题，请尝试以下步骤：
确保网络连接稳定。
检查代理和防火墙设置
检查您的 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，并且您的经过身份验证的服务帐号已被授予必要的 IAM 角色。
查看执行日志
导入和导出实用程序在运行时会生成详细的执行日志。 如果导入作业失败，请检查日志以查找具体错误。这些日志可帮助您审核传输过程并识别跳过的条目或格式警告。
- 日志位置：导入和导出实用程序会将日志文件写入本地执行路径中的
logs/目录。 - 日志格式：每个日志文件都会附加时间戳，以便您查找特定运行的日志。