[Docs] Prisma ORM 8 / MongoDB: Decimal128 lacks usage guidance (input format, update operators, pipeline results)

Đang mở
#8,443 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@amrsorne đang làm issue này rồi.

Từ ngày 18/11/2026.

  • #8868 của @amrsorne — đang mở

Đánh giá

Độ khó
4/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
45/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
mongodb
Lĩnh vực
databases, documentation

Hướng nghiên cứu

Start with the Field types table and the Json note on the MongoDB data-modeling docs page, which is where the new Decimal128 subsection would go. Several answers (number handling, malformed input, inc() and mul() on Decimal128, pipeline result types) must be checked by running the ORM against a test MongoDB, not read from the docs. Done means a Decimal128 subsection with a verified contract and examples, and unsupported behaviour explicitly noted.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Page

https://www.prisma.io/docs/orm/data-modeling/mongodb

What the page says today

The Field types table lists Decimal128 as stored as BSON decimal and exposed in code as "a string, so that no digit is lost". The note under the table says a Decimal128 value inside a Json field fails with RUNTIME.DECODE_FAILED / RUNTIME.ENCODE_FAILED.

That is all the page says about it. There is no contract example that declares a Decimal128 field, and no example of writing, filtering, or updating one through db.orm.

Questions the docs don't answer
  1. Write input. Do create() and update() accept only decimal text such as "129.99"? Is a JS number rejected with RUNTIME.ENCODE_FAILED, or converted? Is a Decimal128 instance from the mongodb package accepted?
  2. Invalid input. What happens with malformed text such as "12.3.4", or with a value that has more than 34 significant digits?
  3. Update operators. The ORM client reference says inc() and mul() are offered on numeric fields only. Does that include Decimal128? If so, what does inc() take? A number would lose precision before the value reaches the database; if it takes decimal text, that should be documented.
  4. Pipeline builder results. The pipeline builder reference says documents come back raw once a stage such as group() is present. Does that mean acc.sum(f.price) over a Decimal128 field returns a mongodb Decimal128 object instead of the decimal text the ORM returns? What is the TypeScript type of that result?
  5. Pipeline builder filters. match() does not convert values. To compare a Decimal128 field in match(), should we pass Decimal128.fromString(...) directly, or wrap it in MongoParamRef? The 8.0.0-rc.14 release notes say query-builder filters comparing with a Decimal128 now match the stored value, but the docs don't show the call.
Suggested change

A short Decimal128 subsection under Field types with:

  • a contract example
  • create, where (with MongoFieldFilter.gte), and update examples showing the accepted input
  • a note on update operators and on pipeline-builder results and filters
  • a recommendation to use a decimal library instead of Number(...) for arithmetic
Minimal contract
model Product {
  id    ObjectId   @id @map("_id")
  name  String
  price Decimal128
  @@map("products")
}
Environment
  • prisma:
  • @prisma/orm-mongo:
  • MongoDB server:
  • Node.js:
Additional context

MongoDB support in Prisma ORM 8 is early access, so some of this may be intentionally undocumented. If so, a short note saying which of these are not supported yet would already help.

Ngôn ngữ chính
MDX
Star
1.1k
Fork
1k
Merge trung bình
15 giờ 23 phút
Pull request đã merge (30 ngày)
298

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của prisma/web

Tất cả issue của prisma/web

Issue tương tự

Thêm issue về Databases

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.