Spanner 中的 MODEL DDL 语句和 ML 函数会调用 Vertex AI 端点，可能会因各种原因而失败：
| 错误代码 | 错误消息 | 可能的原因 | 可能的解决方案 |
|---|---|---|---|
| 已取消 | 由于查询取消，对 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 存在区域性问题 | 使用故障转移端点 |