SELECT INTO(7)

NAME
SELECT INTO - 問い合わせの結果からの新しいテーブルを定義する

SYNOPSIS

[ WITH [ RECURSIVE ] with_query [, ...] ]
SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ]
    * | expression [ [ AS ] output_name ] [, ...]
    INTO [ TEMPORARY | TEMP ] [ TABLE ] new_table
    [ FROM from_item [, ...] ]
    [ WHERE condition ]
    [ GROUP BY expression [, ...] ]
    [ HAVING condition [, ...] ]
    [ HAVING condition [, ...] ]
    [ { UNION | INTERSECT | EXCEPT } [ ALL ] select ]
    [ ORDER BY expression [ ASC | DESC | USING operator ] [ NULLS { FIRST | LAST } ] [, ...] ]
    [ LIMIT { count | ALL } ]
    [ OFFSET start [ ROW | ROWS ] ]
    [ FETCH { FIRST | NEXT } [ count ] { ROW | ROWS } ONLY ]
    [ FOR { UPDATE | SHARE } [ OF table_name [, ...] ] [ NOWAIT ] [...] ]

説明

SELECT INTOは新しいテーブルを作成し、そこに問い合わせによって計算したデータを格納します。 このデータは通常のSELECTのようにはクライアントに返されません。 新しいテーブルの列はSELECTの出力列に関連するデータ型と名前を持ちます。

パラメータ

TEMPORARY or TEMP
    このオプションが指定された場合、テーブルは一時テーブルとして作成されます。 詳細はCREATE TABLE [create_table(7)]を参照してください。

new_table
    作成するテーブルの名前です（スキーマ修飾名も可）。

その他のパラメータについては、SELECT [select(7)]で詳細に説明されています。

注釈

CREATE TABLE AS [create_table_as(7)]は機能的にはSELECT INTOと同じです。 INTO句の解釈が異なるため、SELECT INTOという形式はECPGやPL/pgSQLでは使用できません。 そのため、CREATE TABLE AS構文を使用することをお勧めします。 さらに、CREATE TABLE ASは、SELECT INTOの機能に加え、さらに多くの機能を提供します。

PostgreSQL 8.1より前は、 SELECT INTOで作成されるテーブルはデフォルトでOIDを含んでいました。 PostgreSQL 8.1ではこの問題はありません。 新しいテーブルにOIDを含めたければ、 default_with_oids設定変数を有効にする必要があります。 WITH OIDS句を付けてCREATE TABLE ASを実行するという別の方法もあります。

例

filmsテーブルの最近の項目のみから構成される、新しいfilms_recentテーブルを作成します。

SELECT * INTO films_recent FROM films WHERE date_prod >= '2002-01-01';

互換性

標準SQLでは、SELECT INTOは新しいテーブルの作成ではなく、選択した値をホストプログラムのスカラ変数とするために使われます。 これは実際、ECPG（in the documentationを参照）やPL/pgSQL（in the documentationを参照）で見られる使用方法です。 PostgreSQLにおいて、テーブルを作成するSELECT INTOの用法は歴史的なものです。 新しいコードでは、テーブルの作成にはCREATE TABLE ASを使うのが最善です。

関連項目
CREATE TABLE AS [create_table_as(7)]