UUID v5 생성기

UUID v5 개요

UUID v5는 v3와 구조가 같고 해시 함수만 SHA-1입니다. 네임스페이스와 이름을 이어 붙여 해시한 뒤 128비트로 정리하므로, 같은 입력에는 언제나 같은 UUID가 나옵니다.

MD5를 쓰는 v3보다 충돌 저항성이 낫기 때문에, 이름 기반 식별자가 필요할 때 RFC 9562가 권하는 쪽은 v5입니다.

사용 방법

1. v5를 선택합니다 (이 페이지에서는 이미 선택되어 있습니다).
2. 네임스페이스를 고릅니다. 기본값은 DNS입니다.
3. 이름을 입력합니다. 예를 들어 example.com.
4. UUID 생성을 누릅니다. 입력이 같으면 결과도 같습니다.

사용 사례

• 도메인, URL, 이메일처럼 외부에서 정해진 키에 안정적인 ID를 붙일 때.
• 여러 서비스가 같은 입력에서 같은 UUID를 계산해야 할 때.
• 데이터 마이그레이션 중 기존 이름을 그대로 유지하며 식별자를 부여할 때.

구조

SHA-1 해시의 앞 128비트를 UUID로 옮기고, 13번째 16진수를 버전(5)으로, 17번째를 변형 번호로 고정합니다. 나머지 122비트는 해시에서 나옵니다.

UUID v5의 역할

UUID 버전 한눈에 보기

일곱 버전 모두 128비트이고, 모두 같은 8-4-4-4-12 표기법으로 표현합니다. 차이는 각 비트가 무엇을 담는지뿐입니다.

코드 예제

javascript

// SHA-1 구현이 필요합니다
// 예: js-sha1 + 직접 조립
const id = uuidv5('example.com', NAMESPACE_DNS);

python

import uuid
id = str(uuid.uuid5(uuid.NAMESPACE_DNS, 'example.com'))

java

// 라이브러리 없이는 직접 구현해야 합니다

csharp

// .NET에는 v5 생성기가 없습니다

sql

-- 보통 애플리케이션에서 계산해 저장합니다

관련 도구

같은 계열의 다른 페이지와 각 페이지에서 다루는 내용입니다.

자주 묻는 질문