拓冰网站定制  生成随机 v4 UUID)
文档教程知识库【免费下载链接】til:memo: Today I Learned项目地址https://gitcode.com/gh_mirrors/ti/til点击查看免费下载本篇指南围绕本仓库 postgres/generating-uuids-with-pgcrypto.md 记录的核心结论展开当只需要随机生成的 v4 UUID 时应优先使用pgcrypto扩展自带的gen_random_uuid()函数而不是维护状况不佳的uuid-ossp扩展。读完本文你将掌握 pgcrypto 的安装与使用、v4 UUID 的结构特征、gen_random_uuid()在 PostgreSQL 各版本中的演进以及它在表结构迁移中的实战用法。为什么弃用 uuid-ossp官方文档给出的明确信号在 PostgreSQL 的uuid-ossp扩展文档中官方针对其底层依赖 OSSP UUID 库给出了这样一段警示The OSSP UUID library... is not well maintained, and is becoming increasingly difficult to port to newer platforms.OSSP UUID 库……维护不力且越来越难以移植到更新的平台。紧接着官方文档给出了明确的替代建议If you only need randomly-generated (version 4) UUIDs, consider using the gen_random_uuid() function from the pgcrypto module instead.如果你只需要随机生成第 4 版UUID请考虑改用 pgcrypto 模块中的 gen_random_uuid() 函数。这段建议是本文的核心前提PostgreSQL 已经内置了uuid数据类型参见仓库笔记 postgres/generate-a-uuid.md如果我们的使用场景只是为uuid列生成随机值完全没有必要引入维护状况欠佳的uuid-ossp直接依托pgcrypto即可。快速上手安装 pgcrypto 并生成 v4 UUIDpgcrypto是随 PostgreSQL 一起分发的扩展安装一条命令即可 create extension pgcrypto; CREATE EXTENSION安装后即可调用其中的gen_random_uuid()函数该函数生成的正是随机 v4 UUID select gen_random_uuid(); gen_random_uuid -------------------------------------- 0a557c31-0632-4d3e-a349-e0adefb66a69 select gen_random_uuid(); gen_random_uuid -------------------------------------- 83cdd678-8198-4d56-935d-d052f2e9db37每次调用都会返回不同的值。从上面的输出可以观察 v4 UUID 的结构特征第 13 个十六进制字符固定为4表示版本号为 4紧接着的字符为a表示变体位。在示例中4d3e中的4与a349中的a恰好印证了这一点——这正是 RFC 4122 定义的 v4 布局128 位中除版本位与变体位外其余 122 位由随机数填充。gen_random_uuid() 在 PostgreSQL v13 之后的演进需要说明一个重要版本差异早期版本中gen_random_uuid()依赖pgcrypto扩展但自 PostgreSQL v13 起该函数已被并入核心功能无需安装任何扩展即可直接使用。仓库中的笔记 postgres/generate-random-uuids-without-an-extension.md 记录了这个事实 select gen_random_uuid(); gen_random_uuid -------------------------------------- 0aa72fe6-ede7-4ccf-b328-348becc58066 (1 row)因此在实际项目中可以这样决策PostgreSQL v13 及以上直接使用gen_random_uuid()连create extension都不需要PostgreSQL v13 以下先create extension pgcrypto;再使用同一函数需要非 v4 版本的 UUID如基于时间戳的 v1 等才需要继续依赖uuid-ossp详见 postgres/generate-a-uuid.md 中介绍的uuid_generate_v4()及其他生成函数。顺带一提仓库中还有一篇 postgres/install-postgres-with-uuid-ossp-using-asdf.md记录了一个常见坑通过asdf安装 PostgreSQL 时默认不包含uuid-ossp扩展会报出uuid-ossp.control file missing in extention folder之类的错误需要借助POSTGRES_EXTRA_CONFIGURE_OPTIONS--with-uuide2fs等额外配置项才能装上。这从侧面再次说明能少依赖一个扩展就少一分环境适配成本。pgcrypto 不止 UUID同模块的加密能力佐证pgcrypto扩展提供的是一个加密工具函数集合gen_random_uuid()只是其中面向 UUID 场景的一小部分。本仓库中还有多篇笔记可以相互印证其能力边界哈希计算digest()函数支持md5、sha1、sha224、sha256、sha384、sha512等算法见 postgres/compute-hashes-with-pgcrypto.md随机字节生成gen_random_bytes(n)可以生成指定长度的加密级随机字节仓库笔记 postgres/generate-random-alphanumeric-identifier.md 正是用它配合 CTE 生成随机的短标识符密码加盐哈希crypt()与gen_salt()组合可做加盐密码存储与校验见 postgres/salt-and-hash-a-password-with-pgcrypto.md。这些笔记共同说明gen_random_uuid()依赖的正是 pgcrypto 底层的加密随机数能力而非普通的伪随机数生成器——这也是其适合用作主键等安全敏感场景的原因。实战将 gen_random_uuid() 用于表结构迁移在实际项目中gen_random_uuid()最常见的落地场景之一是把现有整型主键列迁移为 UUID 类型。由于 PostgreSQL 无法自动把int转成uuid需要借助ALTER TABLE的using子句显式指定转换逻辑。仓库笔记 postgres/switch-non-castable-column-type-with-using-clause.md 给出了完整示例alter table users alter column id set data type uuid using (gen_random_uuid());这里using子句的作用是忽略原列中已有的整型id值改用gen_random_uuid()为每一行生成全新的 UUID 填充。由于该笔记中调用的是无前缀的函数名也印证了在 v13 环境下gen_random_uuid()已是内置函数这一事实。三种生成方式速查对比方案适用版本扩展依赖适用场景pgcrypto的gen_random_uuid()v13 以下需pgcryptov13 起内置需create extension pgcrypto;只需要随机 v4 UUID官方推荐uuid-ossp的uuid_generate_v4()各版本需create extension uuid-ossp;需要非 v4 版本的 UUID 函数内置gen_random_uuid()v13 及以上无随机 v4 UUID 的最简方案需要留意的是不同环境的扩展安装方式可能存在差异例如 postgres/install-postgres-with-uuid-ossp-using-asdf.md 中记录的自定义编译场景在以迁移脚本或部署流程形式使用上述命令前应先确认目标数据库版本与扩展可用性。小结生成 v4 随机 UUID 时官方文档明确建议使用pgcrypto的gen_random_uuid()而非维护状况不佳的uuid-ossp在 PostgreSQL v13 及以上版本中该函数已内置连扩展安装都可以省去该函数基于 pgcrypto 的加密随机数能力适合作为 UUID 主键、迁移脚本中的using子句转换逻辑等场景若确实需要非 v4 的 UUID再回到uuid-ossp并注意其在不同安装方式下的额外配置成本。如果你想继续深入可以继续阅读本仓库的 postgres/generate-a-uuid.md、postgres/generate-random-uuids-without-an-extension.md 与 postgres/switch-non-castable-column-type-with-using-clause.md 三篇配套笔记覆盖 UUID 生成方案的前世今生与迁移实战。赞分享文档教程知识库【免费下载链接】til:memo: Today I Learned项目地址https://gitcode.com/gh_mirrors/ti/til点击查看免费下载相关推荐在 PostgreSQL 中使用 pgcrypto 与 CTE 生成加密安全的随机字母数字标识符在 PostgreSQL 中使用 pgcrypto 与 CTE 生成加密安全的随机字母数字标识符 导读 本文介绍如何在 PostgreSQL 中仅用一条查询语句文档教程知识库Instatic与GraphQL客户端Apollo、Relay集成完整指南Instatic与GraphQL客户端Apollo、Relay集成完整指南 Instatic是一款现代自托管可视化CMS它通过内置的插件系统提供了灵活的数据CMS后端前端asyncpg与PostgreSQL扩展pgcrypto非对称加密asyncpg与PostgreSQL扩展pgcrypto非对称加密 在现代应用开发中数据安全是不可忽视的核心需求。特别是涉及用户隐私、支付信息等敏感数据时数据库后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 用 PostgreSQL pgcrypto 扩展的 gen_random_uuid() 生成随机 v4 UUID
文档教程知识库【免费下载链接】til:memo: Today I Learned项目地址https://gitcode.com/gh_mirrors/ti/til点击查看免费下载本篇指南围绕本仓库 postgres/generating-uuids-with-pgcrypto.md 记录的核心结论展开当只需要随机生成的 v4 UUID 时应优先使用pgcrypto扩展自带的gen_random_uuid()函数而不是维护状况不佳的uuid-ossp扩展。读完本文你将掌握 pgcrypto 的安装与使用、v4 UUID 的结构特征、gen_random_uuid()在 PostgreSQL 各版本中的演进以及它在表结构迁移中的实战用法。为什么弃用 uuid-ossp官方文档给出的明确信号在 PostgreSQL 的uuid-ossp扩展文档中官方针对其底层依赖 OSSP UUID 库给出了这样一段警示The OSSP UUID library... is not well maintained, and is becoming increasingly difficult to port to newer platforms.OSSP UUID 库……维护不力且越来越难以移植到更新的平台。紧接着官方文档给出了明确的替代建议If you only need randomly-generated (version 4) UUIDs, consider using the gen_random_uuid() function from the pgcrypto module instead.如果你只需要随机生成第 4 版UUID请考虑改用 pgcrypto 模块中的 gen_random_uuid() 函数。这段建议是本文的核心前提PostgreSQL 已经内置了uuid数据类型参见仓库笔记 postgres/generate-a-uuid.md如果我们的使用场景只是为uuid列生成随机值完全没有必要引入维护状况欠佳的uuid-ossp直接依托pgcrypto即可。快速上手安装 pgcrypto 并生成 v4 UUIDpgcrypto是随 PostgreSQL 一起分发的扩展安装一条命令即可 create extension pgcrypto; CREATE EXTENSION安装后即可调用其中的gen_random_uuid()函数该函数生成的正是随机 v4 UUID select gen_random_uuid(); gen_random_uuid -------------------------------------- 0a557c31-0632-4d3e-a349-e0adefb66a69 select gen_random_uuid(); gen_random_uuid -------------------------------------- 83cdd678-8198-4d56-935d-d052f2e9db37每次调用都会返回不同的值。从上面的输出可以观察 v4 UUID 的结构特征第 13 个十六进制字符固定为4表示版本号为 4紧接着的字符为a表示变体位。在示例中4d3e中的4与a349中的a恰好印证了这一点——这正是 RFC 4122 定义的 v4 布局128 位中除版本位与变体位外其余 122 位由随机数填充。gen_random_uuid() 在 PostgreSQL v13 之后的演进需要说明一个重要版本差异早期版本中gen_random_uuid()依赖pgcrypto扩展但自 PostgreSQL v13 起该函数已被并入核心功能无需安装任何扩展即可直接使用。仓库中的笔记 postgres/generate-random-uuids-without-an-extension.md 记录了这个事实 select gen_random_uuid(); gen_random_uuid -------------------------------------- 0aa72fe6-ede7-4ccf-b328-348becc58066 (1 row)因此在实际项目中可以这样决策PostgreSQL v13 及以上直接使用gen_random_uuid()连create extension都不需要PostgreSQL v13 以下先create extension pgcrypto;再使用同一函数需要非 v4 版本的 UUID如基于时间戳的 v1 等才需要继续依赖uuid-ossp详见 postgres/generate-a-uuid.md 中介绍的uuid_generate_v4()及其他生成函数。顺带一提仓库中还有一篇 postgres/install-postgres-with-uuid-ossp-using-asdf.md记录了一个常见坑通过asdf安装 PostgreSQL 时默认不包含uuid-ossp扩展会报出uuid-ossp.control file missing in extention folder之类的错误需要借助POSTGRES_EXTRA_CONFIGURE_OPTIONS--with-uuide2fs等额外配置项才能装上。这从侧面再次说明能少依赖一个扩展就少一分环境适配成本。pgcrypto 不止 UUID同模块的加密能力佐证pgcrypto扩展提供的是一个加密工具函数集合gen_random_uuid()只是其中面向 UUID 场景的一小部分。本仓库中还有多篇笔记可以相互印证其能力边界哈希计算digest()函数支持md5、sha1、sha224、sha256、sha384、sha512等算法见 postgres/compute-hashes-with-pgcrypto.md随机字节生成gen_random_bytes(n)可以生成指定长度的加密级随机字节仓库笔记 postgres/generate-random-alphanumeric-identifier.md 正是用它配合 CTE 生成随机的短标识符密码加盐哈希crypt()与gen_salt()组合可做加盐密码存储与校验见 postgres/salt-and-hash-a-password-with-pgcrypto.md。这些笔记共同说明gen_random_uuid()依赖的正是 pgcrypto 底层的加密随机数能力而非普通的伪随机数生成器——这也是其适合用作主键等安全敏感场景的原因。实战将 gen_random_uuid() 用于表结构迁移在实际项目中gen_random_uuid()最常见的落地场景之一是把现有整型主键列迁移为 UUID 类型。由于 PostgreSQL 无法自动把int转成uuid需要借助ALTER TABLE的using子句显式指定转换逻辑。仓库笔记 postgres/switch-non-castable-column-type-with-using-clause.md 给出了完整示例alter table users alter column id set data type uuid using (gen_random_uuid());这里using子句的作用是忽略原列中已有的整型id值改用gen_random_uuid()为每一行生成全新的 UUID 填充。由于该笔记中调用的是无前缀的函数名也印证了在 v13 环境下gen_random_uuid()已是内置函数这一事实。三种生成方式速查对比方案适用版本扩展依赖适用场景pgcrypto的gen_random_uuid()v13 以下需pgcryptov13 起内置需create extension pgcrypto;只需要随机 v4 UUID官方推荐uuid-ossp的uuid_generate_v4()各版本需create extension uuid-ossp;需要非 v4 版本的 UUID 函数内置gen_random_uuid()v13 及以上无随机 v4 UUID 的最简方案需要留意的是不同环境的扩展安装方式可能存在差异例如 postgres/install-postgres-with-uuid-ossp-using-asdf.md 中记录的自定义编译场景在以迁移脚本或部署流程形式使用上述命令前应先确认目标数据库版本与扩展可用性。小结生成 v4 随机 UUID 时官方文档明确建议使用pgcrypto的gen_random_uuid()而非维护状况不佳的uuid-ossp在 PostgreSQL v13 及以上版本中该函数已内置连扩展安装都可以省去该函数基于 pgcrypto 的加密随机数能力适合作为 UUID 主键、迁移脚本中的using子句转换逻辑等场景若确实需要非 v4 的 UUID再回到uuid-ossp并注意其在不同安装方式下的额外配置成本。如果你想继续深入可以继续阅读本仓库的 postgres/generate-a-uuid.md、postgres/generate-random-uuids-without-an-extension.md 与 postgres/switch-non-castable-column-type-with-using-clause.md 三篇配套笔记覆盖 UUID 生成方案的前世今生与迁移实战。赞分享文档教程知识库【免费下载链接】til:memo: Today I Learned项目地址https://gitcode.com/gh_mirrors/ti/til点击查看免费下载相关推荐在 PostgreSQL 中使用 pgcrypto 与 CTE 生成加密安全的随机字母数字标识符在 PostgreSQL 中使用 pgcrypto 与 CTE 生成加密安全的随机字母数字标识符 导读 本文介绍如何在 PostgreSQL 中仅用一条查询语句文档教程知识库Instatic与GraphQL客户端Apollo、Relay集成完整指南Instatic与GraphQL客户端Apollo、Relay集成完整指南 Instatic是一款现代自托管可视化CMS它通过内置的插件系统提供了灵活的数据CMS后端前端asyncpg与PostgreSQL扩展pgcrypto非对称加密asyncpg与PostgreSQL扩展pgcrypto非对称加密 在现代应用开发中数据安全是不可忽视的核心需求。特别是涉及用户隐私、支付信息等敏感数据时数据库后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考