本指南可帮助您排查在导入和导出术语表和条目链接时遇到的 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 暂存存储桶中的归档文件夹来跟踪成功导入的批次。
如需恢复作业，请按以下步骤操作：
重新运行导入实用程序。该实用程序会检测上次运行的状态，并显示以下提示：
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/目录。 - 日志格式：每个日志文件都会附加时间戳，以便您找到特定运行的日志。