UUIDs são identificadores de 128 bits úteis quando diferentes processos precisam criar chaves sem um contador central. uuid4() usa aleatoriedade; o construtor UUID valida e normaliza representações recebidas.
from uuid import UUID, uuid4
identifier = uuid4()
stored = str(identifier)
parsed = UUID(stored)
assert parsed == identifier
print(identifier.version)Como usar com segurança
Escolha a versão conforme os requisitos de privacidade, ordenação e interoperabilidade. UUID não substitui autorização nem prova que um recurso existe. No banco, prefira o tipo UUID nativo quando disponível e valide o texto na fronteira da aplicação.
Para aprofundar a base, consulte guia de collections em Python e guia de type hints.
A documentação oficial do Python, consultada em 22 de julho de 2026, descreve a API, os casos-limite e a compatibilidade entre versões.