借助 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 术语表页面，选择您的术语表，然后确认资源 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 导入作业失败问题
如果导入作业在执行过程中中断或失败，您无需重启整个流程或修改源 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/目录。 - 日志格式：每个日志文件都会附加一个时间戳，以便您找到特定运行的日志。