Datatypes › Universal unique identifiers
Universally unique identifier (UUID)
ID uuid
128-bit identifier that systems generate without a central registry, defined by RFC 9562 (2024), which replaced RFC 4122. Microsoft calls it a GUID. The text form is 32 hexadecimal digits in five groups of 8, 4, 4, 4 and 12 separated by hyphens, in any letter case. The first digit of the third group is the version (1 to 8, see uuid_v1, uuid_v4 and uuid_v7), and the first digit of the fourth group is 8, 9, a or b for the RFC 9562 variant. The Nil UUID (all zeros) and the Max UUID (all f) are special values. Microsoft tools and the Windows registry write GUIDs in curly braces, a form the regexp also accepts. The regexp does not accept the 32 digits without hyphens, which look like an MD5 hash, or the urn:uuid form (uuid_urn).
- Categories
- Universal unique identifiers
- Countries
- Global (not tied to a country)
- Languages
- Common to most languages
- AutoType benchmark
guid- Microsoft CDM
is.dataFormat.guid- FTA
GUID- MISP attribute type
uuid- Presidio
UUID- Former IDs
guid- Quality
- 100/100
- Metacrafter rules
- 4 rules (2 by field name, 2 by value)
guiddata, basic/identifiers.yaml, key guidguidbynamefield, basic/identifiers.yaml, key guiduuidbynamefield, basic/identifiers.yamluuidbyvaluedata, basic/identifiers.yaml
- Supported by tools
- Auto-Type, Collibra Data Classification, csv-detective, Capital One DataProfiler, Frictionless Table Schema, FTA (Fast Text Analysis), Great Expectations Semantic Types Expectations, Logstash and Elastic grok patterns, metacrafter, Microsoft Presidio, Pydantic and pydantic-extra-types, pyWhat, Microsoft Recognizers-Text, SAP CDS semantic annotations (@Semantics), Soda, validator.js, visions and ydata-profiling
Regular expression
^(?:[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}|\{[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}\})$
Python re syntax.
Test a value
Examples
| Value | Description |
|---|---|
| f81d4fae-7dec-11d0-a765-00a0c91e6bf6 | Example string UUID of RFC 9562 (Figure 1) |
| 919108f7-52d1-4320-9bac-f847db4148a8 | UUIDv4 test vector of RFC 9562 (Appendix A.3) |
| 6fa459ea-ee8a-3ca4-894e-db77e160355e | Name-based UUIDv3 from the Python uuid module documentation |
| {C232AB00-9414-11EC-B3C8-9F6BDECED846} | UUIDv1 test vector of RFC 9562 in the braced GUID form of Microsoft tools |
| f81d4fae7dec11d0a76500a0c91e6bf6 invalid | 32 hexadecimal digits without hyphens |
| urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6 invalid | URN form, see uuid_urn |
| {f81d4fae-7dec-11d0-a765-00a0c91e6bf6 invalid | Unbalanced brace |
Patterns
Specific representations of this datatype.
| ID | Name | Categories | Countries | Description |
|---|---|---|---|---|
| uuid_urn | UUID as a URN (urn:uuid) pattern | identifiers | global | A UUID written as a URN in the uuid namespace, urn:uuid:<UUID>, as RFC 9562 defines. It is used where an identifier must be a URI, for... |
Child datatypes
| ID | Name | Categories | Countries | Description |
|---|---|---|---|---|
| dotnet_mvid | .NET module version ID (MVID) | software, identifiers | global | GUID that the compiler writes into the metadata of every .NET module (the Module table, stored in the GUID heap) so that two versions of... |
| dotnet_typelib_id | .NET TypeLib ID (assembly GUID) | software, identifiers | global | GUID in the GuidAttribute of a .NET assembly, written by Visual Studio into Properties/AssemblyInfo.cs when a project is created... |
| musicbrainz_id | MusicBrainz Identifier (MBID) | media | global | Permanent identifier of an entity in MusicBrainz, the open music encyclopedia: an artist, release group, release, recording, work,... |
| uuid_v1 | Time-based UUID (version 1) | identifiers | global | UUID of version 1 under RFC 9562. It holds a 60-bit count of 100-nanosecond intervals since 15 October 1582, a clock sequence and a... |
| uuid_v4 | Random UUID (version 4) | identifiers | global | UUID of version 4 under RFC 9562. Apart from the version and variant bits, its 122 bits are random, so it carries no time or host... |
| uuid_v7 | Unix time-ordered UUID (version 7) | identifiers | global | UUID of version 7, introduced by RFC 9562 in 2024. The first 48 bits are the Unix time in milliseconds, and the rest, apart from the... |
Translations
| Language | Name | Description |
|---|---|---|
| Russian | Универсальный уникальный идентификатор (UUID) | 128-битный идентификатор по RFC 9562, который системы создают без центрального реестра. В Microsoft его называют GUID. Записывается как 32 шестнадцатеричные цифры в пяти группах (8-4-4-4-12) через дефис; первая цифра третьей группы указывает версию. |
Sources
- wikipedia: Universally unique identifier (en.wikipedia.org)
- wikidata: wikidata.org/wiki/Q195284
- doc: rfc-editor.org/rfc/rfc9562
Use this record
- Page URL:
https://registry.apicrafter.io/datatype/uuid - JSON: API v1 · legacy shape (used by metacrafter) · Markdown (for LLMs)
- Improve it: edit
data/datatypes/any/identifiers/uuid.yamlon GitHub