google-app-engine - allocate_ids は常に正の値を返しますか?

Question

allocate_ids 関数は常に正の値を返しますか? または、負の値またはゼロの値を返すことがありますか?

Answer 1

グーグルグループのコメントで、スティーブンと呼ばれる誰かが次のことについて言っていdb.modelます：

ID は 64 ビットの正の整数です。「シーケンス」と呼ばれるエンティティに ID を割り当てると、自動割り当ての場合に一意の範囲を使用する親を持つエンティティを含む、他の種類のエンティティに ID を使用できます。「シーケンス」の ID はデータストア内で一意になります。これは、ID がエンティティ グループごとに一意であるという要件のスーパーセットです。ただし、常にシーケンスからの ID を使用し、自動割り当てを許可しないようにする必要があります。

彼は自分が話していることを知っているようです。データストアの自動 ID シーケンス ジェネレーターへの別の参照が見つかりませんが、この同様の質問では、 allocateidsの Java 定義がリンクされ、このエラーがスローされる可能性があると書かれています。

java.lang.IllegalArgumentException - 親が完全なキーでない場合、num が 1 未満の場合、または num が 10 億より大きい場合。