Man page - alter_sequence(7)

Manual

ALTER SEQUENCE

NAME
SYNOPSIS
DESCRIPTION 描 述
PARAMETERS 参 数
EXAMPLES 例 子
NOTES 注 意
COMPATIBILITY 兼 容 性
SQL99
译 者
跋

---

NAME

ALTER SEQUENCE - 更 改 一 个 序 列 生 成 器 的 定 义

SYNOPSIS

ALTER SEQUENCE name [ INCREMENT [ BY ] increment ]
[ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ]
[ RESTART [ WITH ] start ] [ CACHE cache ] [ [ NO ] CYCLE ]

DESCRIPTION 描 述

ALTER SEQUENCE 命 令 修 改 一 个 现 有 的 序 列 发 生 器 的 参 数 。 任 何 没 有 明 确 在 ALTER SEQUENCE 命 令 里 声 明 的 参 数 都 将 保 留 原 先 的 设 置 。

PARAMETERS 参 数

name

一 个 要 修 改 的 序 列 的 名 字 （ 可 以 有 模 式 修 饰 ） 。

increment

INCREMENT BY increment 子 句 是 可 选 的 。 一 个 正 数 会 让 序 列 成 为 递 增 序 列 ， 负 数 则 成 为 递 减 序 列 。 如 果 没 有 声 明 ， 将 沿 用 原 来 的 递 增 值 。

minvalue
NO MINVALUE

可 选 的 子 句 MINVALUE minvalue 决 定 一 个 序 列 可 以 生 成 的 最 小 的 值 。 如 果 声 明 了 NO MINVALUE， 将 使 用 缺 省 值 ， 对 于 递 增 和 递 减 的 序 列 分 别 是 1 和 -2ˆ63-1。 如 果 没 有 声 明 任 何 选 项 ， 则 沿 用 当 前 的 最 小 值 。

maxvalue
NO MAXVALUE

可 选 的 子 句 MAXVALUE maxvalue 决 定 序 列 的 最 大 值 。 如 果 声 明 了 NO MAXVALUE， 则 使 用 缺 省 值 ， 对 于 递 增 和 递 减 的 序 列 分 别 是 2ˆ63-1 和 -1。 如 果 两 个 选 项 都 没 有 声 明 ， 则 沿 用 当 前 的 最 大 值 。

start

可 选 的 RESTART WITH start 子 句 允 许 序 列 可 以 在 任 何 地 方 开 始 。

	cache		CACHE cache 选 项 打 开 序 列 号 预 分 配 并 存 储 在 内 存 缓 冲 的 功 能 。 最 小 值 是 1 （ 也 就 是 每 次 只 能 生 成 一 个 数 值 ， 没 有 缓 冲 ） 。 如 果 没 有 声 明 ， 将 沿 用 旧 的 缓 冲 值 。
	CYCLE

可 选 的 键 字 CYCLE 可 以 用 于 允 许 序 列 在 达 到 递 增 序 列 的 maxvalue 或 者 递 减 序 列 的 minvalue的 时 候 重 叠 使 用 。 如 果 达 到 了 极 限 ， 那 么 生 成 的 下 一 个 数 字 将 分 别 是 minvalue 或 maxvalue 。

NO CYCLE

如 果 声 明 了 可 选 键 字 NO CYCLE， 任 何 在 序 列 达 到 其 最 大 极 限 后 对 nextval 的 调 用 都 将 返 回 错 误 。 如 果 既 未 声 明 CYCLE 也 未 声 明 NO CYCLE， 那 么 将 沿 用 原 有 的 循 环 行 为 。

EXAMPLES 例 子

从 105 开 始 重 新 开 始 一 个 叫 serial 的 序 列 ：

ALTER SEQUENCE serial RESTART WITH 105;

NOTES 注 意

为 了 避 免 并 发 的 事 务 从 同 一 个 序 列 获 取 数 值 的 时 候 被 阻 塞 住 ， ALTER SEQUENCE 操 作 从 来 不 会 回 滚 ； 修 改 马 上 生 效 并 且 不 能 恢 复 。

ALTER SEQUENCE 将 不 会 立 即 影 响 后 端 的 nextval 结 果 ， 除 了 当 前 的 之 外 ， 因 为 它 又 已 经 缓 冲 了 的 序 列 号 。 它 们 只 有 再 使 用 光 所 有 已 经 缓 冲 的 数 值 之 后 才 能 意 识 到 改 变 了 的 序 列 参 数 。 当 前 后 端 将 立 即 被 影 响 。

COMPATIBILITY 兼 容 性

SQL99

ALTER SEQUENCE 是 PostgreSQL 语 言 扩 展 。 在 SQL99 里 没 有 ALTER SEQUENCE 语 句 。

译 者

Postgresql 中 文 网 站 何 伟 平 <laser@pgsqldb.org>

跋

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。
中 文 man 手 册 页 计 划 ： https://github.com/man-pages-zh/manpages-zh

---