이제 MongoDB 호환성을 갖춘 Cloud Firestore Enterprise 버전을 사용할 수 있습니다.
자세히 알아보기
오류 코드 이해하기
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
|
Cloud Firestore Enterprise 버전에만 해당합니다.
|
이 페이지에는 발생할 수 있는 오류 코드가 나열되어 있으며 각 오류를 해결하는 방법에 대한 제안이 제공됩니다.
DeadlineExceeded(262)
다음으로 인해 DeadlineExceeded (262) 오류가 증가할 수 있습니다.
- 지연 시간의 증가로 인해 작업이 완료되는 시간이 기한(기본적으로 60초)보다 오래 걸렸습니다.
DeadlineExceeded (262): Deadline exceeded.
이 문제를 해결하려면 지연 시간 문제 해결 가이드를 참조하세요.
Aborted(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 호환성을 갖춘 Cloud Firestore는 늘어난 수요를 충족시키기 위해 자동으로 확장을 시도합니다. MongoDB 호환성을 갖춘 Cloud Firestore가 확장되면 지연 시간이 감소하기 시작합니다.
- 핫 스팟은 MongoDB 호환성을 갖춘 Cloud Firestore의 확장 기능을 제한합니다. 규모 확장을 위한 설계를 검토하여 핫스팟을 식별합니다.
- 트랜잭션의 데이터 경합 및 트랜잭션 사용량을 검토합니다.
- 개별 문서에 대한 쓰기 속도를 줄이세요.
InvalidArgument(2)
다음 경우에 InvalidArgument (2) 오류가 발생할 수 있습니다.
- 색인 항목의 7.5KiB 한도를 초과하는 문서를 커밋하려고 시도합니다.
7.5KiB는 색인 항목의 한도입니다. 이 한도는 초과될 수 없으며 조정 가능한 할당량이 아닙니다.
InvalidArgument (2): Index entry on field_name is larger than 7680 bytes.
이 문제를 해결하려면 다음 안내를 따르세요.
색인이 생성된 필드 값의 경우 필드를 여러 필드로 분할합니다. 가능하면 색인이 생성되지 않은 필드를 만들고 색인을 생성할 필요가 없는 데이터를 색인이 생성되지 않은 필드로 이동합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-28(UTC)
[null,null,["최종 업데이트: 2025-08-28(UTC)"],[],[],null,["\u003cbr /\u003e\n\n\n|--------------------------------------------------------|\n| *Relevant to Cloud Firestore Enterprise edition only.* |\n\n\u003cbr /\u003e\n\nThis page lists error codes that you might encounter and provides suggestions\nfor how to fix each of them.\n\nDeadlineExceeded (262)\n\nThe following can increase `DeadlineExceeded (262)` errors:\n\n- An increase in latency caused an operation to take longer than the deadline (60 seconds by default) to complete.\n\n DeadlineExceeded (262): Deadline exceeded.\n\nTo resolve this issue, see the [guide to troubleshooting latency](/docs/firestore/enterprise/resolve-latency).\n\nAborted (112)\n\nThe following situations can increase `Aborted (112)` errors:\n\n- A document receiving too many updates per second.\n- Contention from overlapping transactions.\n- Traffic that increases rapidly or encounters hot-spots.\n\n Aborted (112): Too much contention on these documents. Please try again\n\nOr \n\n Aborted (112): Aborted due to cross-transaction contention. This occurs when\n multiple transactions attempt to access the same data, requiring at least one\n to be aborted in order to enforce serializability.\n\nTo resolve this issue:\n\n- For rapid traffic increases, Cloud Firestore with MongoDB compatibility attempts to automatically scale to meet the increased demand. When Cloud Firestore with MongoDB compatibility scales, latency begins to decrease.\n- Hot-spots limit the ability of Cloud Firestore with MongoDB compatibility to scale up. Review [designing for scale](/docs/firestore/enterprise/understand-reads-writes-scale#avoid_hotspots) to identify hot-spots.\n- Review [data contention in transactions](/docs/firestore/enterprise/understand-reads-writes-scale#high-level_steps_in_a_write_transaction) and your usage of transactions.\n- Reduce the write rate to individual documents.\n\nInvalidArgument (2)\n\nThe following situations can cause `InvalidArgument (2)` errors:\n\n- Attempting to commit a document with that exceeds the 7.5 KiB limit for an index entry.\n\n7.5 KiB is a [limit](/docs/firestore/enterprise/quotas) for index entries. You cannot exceed this limit\nand it's not a quota that can be adjusted. \n\n InvalidArgument (2): Index entry on \u003cvar class=\"readonly\" translate=\"no\"\u003efield_name\u003c/var\u003e is larger than 7680 bytes.\n\nTo resolve this issue:\n\nFor indexed field values, split the\nfield into multiple fields. If possible, create an un-indexed field\nand move data that doesn't need to be indexed into the un-indexed\nfield."]]
