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

---