Skip to content

[Uid] Add note about ULIDs not being random in one case #15314

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 8, 2021
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions components/uid.rst
Original file line number Diff line number Diff line change
Expand Up @@ -209,6 +209,13 @@ ULIDs are an alternative to UUIDs when using those is impractical. They provide
128-bit compatibility with UUID, they are lexicographically sortable and they
are encoded as 26-character strings (vs 36-character UUIDs).

.. note::

If you generate more than one ULID during the same millisecond in the
same process then the random portion is incremented by one bit in order
to provide monotonicity for sorting. The random portion is **not**
random compared to the previous ULID in this case.

Generating ULIDs
~~~~~~~~~~~~~~~~

Expand Down