[Docs] Prisma ORM 8 / MongoDB: Decimal128 lacks usage guidance (input format, update operators, pipeline results)
メンテナーはふだん 1 日以内に返信
評価
- 難易度
- 4/5
- 見積もり時間
- 1〜2日
- 初心者へのやさしさ
- 45/100
- issue の種類
- ドキュメント
- 明瞭さ
- おおむね明確
- 活発さ
- 活発
- 技術スタック
- mongodb
調査の方向性
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.
索引モデルが issue の本文から書いたものです。
説明
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
- Write input. Do
create()andupdate()accept only decimal text such as"129.99"? Is a JSnumberrejected withRUNTIME.ENCODE_FAILED, or converted? Is aDecimal128instance from themongodbpackage accepted? - Invalid input. What happens with malformed text such as
"12.3.4", or with a value that has more than 34 significant digits? - Update operators. The ORM client reference says
inc()andmul()are offered on numeric fields only. Does that includeDecimal128? If so, what doesinc()take? Anumberwould lose precision before the value reaches the database; if it takes decimal text, that should be documented. - Pipeline builder results. The pipeline builder reference says documents come back raw once a stage such as
group()is present. Does that meanacc.sum(f.price)over aDecimal128field returns amongodbDecimal128object instead of the decimal text the ORM returns? What is the TypeScript type of that result? - Pipeline builder filters.
match()does not convert values. To compare aDecimal128field inmatch(), should we passDecimal128.fromString(...)directly, or wrap it inMongoParamRef? The 8.0.0-rc.14 release notes say query-builder filters comparing with aDecimal128now 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(withMongoFieldFilter.gte), andupdateexamples 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.
- 主要言語
- MDX
- スター
- 1.1k
- フォーク
- 1k
- 平均マージ
- 15時間 23分
- マージ済み PR(30日)
- 298
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
prisma/web のほかの issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 84/100
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 25/100
メンテナーはふだん 1 日以内に返信
-
New Prisma site header lags when transitioning to pill対応中かも @akshy-rai が 56 日前に担当しました。 オープン
難易度 3/5 1〜2日 初心者へのやさしさ 55/100
メンテナーはふだん 1 日以内に返信
似ている issue
-
area:breg enhancement
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
registrystack/registry-stack#2765 ·
メンテナーはふだん 1 日以内に返信
-
bug platform-macos
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
TableProApp/TablePro#4389 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
nowledge-co/hawdb#1881 ·
メンテナーはふだん 1 日以内に返信
-
autofixer: follow-up
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
tursodatabase/turso#12217 ·
メンテナーはふだん 1 日以内に返信
-
Aggregate ignores order by expressions that contain spaces対応中かも @chuenchen309 が今日担当しました。 オープン
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
メンテナーはふだん 1 日以内に返信