Spanner 中的 MODEL DDL 语句和 ML 函数会调用 Vertex AI 端点，并且可能会因各种原因而失败：
| 错误代码 | 错误消息 | 可能的原因 | 可能有用的解决方案 |
|---|---|---|---|
| CANCELLED | 由于查询取消，对 Vertex AI 端点 {ENDPOINT} 的调用已取消。 | 客户端应用取消了查询。 | 调查客户端取消查询的原因。 |
| DEADLINE_EXCEEDED | Vertex AI 端点 {ENDPOINT} 已超出调用期限。 | 查询截止期限过短。 | 延长客户端的查询截止时间。 |
| - | - | 端点过于繁忙。 | 请参阅 Vertex AI 监控并部署更多节点。 |
| FAILED_PRECONDITION | Vertex AI 端点 {ENDPOINT} 返回了“前提条件失败”错误。 | 端点未部署任何模型。 | 将模型部署到端点。 |
| INTERNAL | 访问 Vertex AI 端点 {ENDPOINT} 时发生未知错误。 | 发生了意外的内部错误。 | 使用故障切换端点或创建支持服务工单。 |
| INVALID_ARGUMENT | 向 Vertex AI 端点 {ENDPOINT} 发出的请求无效。 确保 Vertex AI 端点和 Spanner 模型架构匹配。 | Spanner 模型架构和 Vertex AI 端点架构 不匹配 | 更新 Spanner 模型的架构。 |
| NOT_FOUND | 找不到 Vertex AI 端点 {ENDPOINT}。 | 端点已被删除。 | 更新 Spanner 模型的架构。 |
| PERMISSION_DENIED | 系统拒绝了对 Vertex AI 端点 {ENDPOINT} 的访问。 | Spanner 服务代理无权访问端点 | 授予服务代理角色权限 |
| - | - | VPC SC 错误 | 查看 Vertex AI 错误消息 并按照 VPC SC 问题排查中的说明操作 |
| RESOURCE_EXHAUSTED | Vertex AI 端点 {ENDPOINT} 的配额已超出。 | 对 Vertex AI 的请求过多。 | 增加在线预测配额 |
| UNAVAILABLE | 无法为项目 {PROJECT} 创建服务代理。 | Service Usage API 问题。 | 手动创建服务代理 |
| - | Vertex AI 端点 {ENDPOINT} 不可用。 | 向 Vertex AI 发出的请求过多。 | 部署更多节点。 |
| - | - | Vertex AI 存在区域性问题 | 使用故障转移端点 |