Spanner의 MODEL DDL 문 및 ML 함수는 Vertex AI 엔드포인트를 호출하며 다음과 같은 다양한 이유로 실패할 수 있습니다.
| 오류 코드 | 오류 메시지 | 가능한 원인 | 해결책 |
|---|---|---|---|
| 취소됨 | 쿼리 취소로 인해 Vertex AI 엔드포인트({ENDPOINT}) 호출이 취소되었습니다. | 클라이언트 애플리케이션에서 쿼리를 취소했습니다. | 클라이언트에서 쿼리를 취소한 이유를 조사합니다. |
| DEADLINE_EXCEEDED | Vertex AI 엔드포인트({ENDPOINT})가 호출 기한을 초과했습니다. | 쿼리 기한이 너무 짧습니다. | 클라이언트에서 쿼리 기한을 늘립니다. |
| - | - | 엔드포인트 작업이 너무 많습니다. | Vertex AI 모니터링을 확인하고 노드를 더 배포합니다. |
| FAILED_PRECONDITION | Vertex AI 엔드포인트({ENDPOINT})가 실패한 전제조건 오류를 반환했습니다. | 엔드포인트에 배포된 모델이 없습니다. | 모델을 엔드포인트에 배포합니다. |
| 내부 | 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에 리전 문제가 있습니다. | 장애 조치 엔드포인트를 사용합니다. |