Man page - insert(7)

Manual

INSERT

NAME
SYNOPSIS
DESCRIPTION 描 述
PARAMETERS 引 數
OUTPUTS 輸 出
EXAMPLES 例 子
COMPATIBILITY 相 容 性
譯 者


NAME

INSERT - 在 表 中 建 立 新 行

SYNOPSIS

INSERT INTO table [ ( column [, ...] ) ]
{ DEFAULT VALUES | VALUES ( { expression | DEFAULT } [, ...] ) | query }

DESCRIPTION 描 述

INSERT 允 許 我 們 向 表 中 插 入 新 行 。 我 們 可 以 一 次 插 入 一 行 或 多 行 作 為 查 詢 結 果 。

目 標 列 表 中 的 列 /欄 位 可 以 按 任 何 順 序 排 列 。 在 目 標 列 中 沒 有 出 現 的 列 /欄 位 將 插 入 預 設 值 , 可 能 是 定 義 了 的 預 設 值 或 者 NULL。

如 果 每 行 的 表 示 式 不 是 正 確 的 資 料 型 別 , 系 統 將 試 圖 進 行 自 動 的 型 別 轉 換 。

要 想 向 表 中 插 入 資 料 , 你 必 須 有 INSERT 許 可 權 , 如 果 你 使 用 了 query 子 句 插 入 來 自 查 詢 裡 的 資 料 行 , 你 還 需 要 擁 有 在 查 詢 裡 使 用 的 表 的 SELECT 許 可 權 。

PARAMETERS 引 數

table

現 存 表 的 名 稱 ( 可 以 有 模 式 修 飾 ) 。

column

table 中 的 欄 位 名 。

DEFAULT VALUES

所 有 欄 位 都 會 用 它 們 的 預 設 值 填 充 。

expression

賦 予 column 的 一 個 有 效 表 示 式 或 值 。

DEFAULT

這 個 欄 位 將 被 欄 位 它 的 填 充 。

query

一 個 查 詢 ( SELECT 語 句 ) , 它 提 供 插 入 的 資 料 行 。 請 參 考 SELECT 語 句 獲 取 語 法 描 述 。

OUTPUTS 輸 出

成 功 完 成 後 , 一 條 INSERT 命 令 返 回 一 個 下 面 形 式 的 命 令 標 籤

INSERT oid count

count 是 插 入 的 行 數 。 如 果 count 正 好 是 一 , 並 且 目 標 表 有 OID, 那 麼 oid 是 賦 予 插 入 行 的 OID。 否 則 oid 是 零 。

EXAMPLES 例 子

向 表 films 裡 插 入 一 行 :

INSERT INTO films VALUES
(’UA502’, ’Bananas’, 105, ’1971-07-13’, ’Comedy’, ’82 minutes’);

在 第 二 個 例 子 裡 面 省 略 了 欄 位 len 因 此 在 它 裡 面 將 只 儲 存 預 設 的 NULL 值 :

INSERT INTO films (code, title, did, date_prod, kind)
VALUES (’T_601’, ’Yojimbo’, 106, ’1961-06-16’, ’Drama’);

在 第 三 個 例 子 裡 , 我 們 用 DEFAULT 值 作 為 資 料 欄 位 , 而 不 是 宣 告 一 個 數 值 :

INSERT INTO films VALUES
(’UA502’, ’Bananas’, 105, DEFAULT, ’Comedy’, ’82 minutes’);
INSERT INTO films (code, title, did, date_prod, kind)
VALUES (’T_601’, ’Yojimbo’, 106, DEFAULT, ’Drama’);

從 表 tmp 中 插 入 幾 行 到 表 films 中 :

INSERT INTO films SELECT * FROM tmp;

插 入 陣 列 :

-- 建 立 一 個 空 的 3x3 遊 戲 板 來 玩 圈 -和 -叉 遊 戲
-- (所 有 這 些 查 詢 建 立 相 同 的 遊 戲 )
INSERT INTO tictactoe (game, board[1:3][1:3])
VALUES (1,’{{"","",""},{},{"",""}}’);
INSERT INTO tictactoe (game, board[3][3])
VALUES (2,’{}’);
INSERT INTO tictactoe (game, board)
VALUES (3,’{{,,},{,,},{,,}}’);

COMPATIBILITY 相 容 性

INSERT 完 全 遵 循 SQL 標 準 。 可 能 碰 到 的 關 於 query 子 句 特 性 的 限 制 在 SELECT [ select (7)] 語 句 中 有 相 關 文 件 。

譯 者

Postgresql 中 文 網 站 何 偉 平 <laser@pgsqldb.org>

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。
中 文 man 手 冊 頁 計 劃 : https://github.com/man-pages-zh/manpages-zh