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