오류 코드 이해하기

이 페이지에는 발생할 수 있는 오류 코드가 나열되어 있으며 각 오류를 해결하는 방법에 관한 제안이 제공됩니다.

DeadlineExceeded (262)

다음으로 인해 DeadlineExceeded (262) 오류가 증가할 수 있습니다.

  • 지연 시간의 증가로 인해 작업이 완료되는 시간이 마감시간(기본적으로 60초)보다 오래 걸렸습니다.
DeadlineExceeded (262): Deadline exceeded.

이 문제를 해결하려면 지연 시간 문제 해결 가이드를 참조하세요.

중단됨 (112)

다음과 같은 경우 Aborted (112) 오류가 증가할 수 있습니다.

  • 초당 너무 많은 업데이트를 수신하는 문서
  • 겹쳐진 트랜잭션이 경합하는 경우
  • 트래픽이 급증하거나 핫 스팟이 발생하는 경우
Aborted (112): Too much contention on these documents. Please try again

또는

Aborted (112): Aborted due to cross-transaction contention. This occurs when
multiple transactions attempt to access the same data, requiring at least one
to be aborted in order to enforce serializability.

이 문제를 해결하려면 다음 안내를 따르세요.

  • 빠른 트래픽 증가를 위해 MongoDB 호환 Firestore는 늘어난 수요를 충족시키기 위해 자동으로 확장을 시도합니다. MongoDB 호환성을 갖춘 Firestore가 확장되면 지연 시간 감소가 시작됩니다.
  • 핫스팟은 MongoDB 호환성을 갖춘 Firestore의 확장 기능을 제한합니다. 규모 확장을 위한 설계를 검토하여 핫스팟을 식별합니다.
  • 트랜잭션의 데이터 경합 및 트랜잭션 사용량을 검토합니다.
  • 개별 문서에 대한 쓰기 속도를 줄이세요.

InvalidArgument (2)

다음 경우에 InvalidArgument (2) 오류가 발생할 수 있습니다.

  • 색인 항목의 7.5KiB 한도를 초과하는 문서를 커밋하려고 시도합니다.

7.5KiB는 색인 항목의 한도입니다. 이 한도는 초과할 수 없으며 조정 가능한 할당량이 아닙니다.

InvalidArgument (2): Index entry on field_name is larger than 7680 bytes.

이 문제를 해결하려면 다음 안내를 따르세요.

색인이 생성된 필드 값의 경우 필드를 여러 필드로 분할합니다. 가능하면 색인이 생성되지 않은 필드를 만들고 색인을 생성할 필요가 없는 데이터를 색인이 생성되지 않은 필드로 이동합니다.