INSERT

INSERT [restriction] INTO table
          DEFAULT VALUES |
          [(columnlist)] VALUES (valuelist) |
          [(columnlist)] VALUES host-variable |
          [(columnlist)] query |
          SET column1=value1 {,column2=value2, . . . }

restriction	オプション — キーワード %NOLOCK、%NOCHECK、%NOINDEX、%NOTRIGGER のうちの 1 つ、またはこれらのキーワードのコンマで区切られたリスト。
table	挿入を実行するテーブルまたはビューの名前。
columnlist	オプション — 列名のコンマ区切りのリスト。値のリストに対応した順序で指定します。省略した場合、値のリストは列番号順にすべての列に適用されます。
valuelist	対応する columnlist の各フィールドのデータ値を指定するコンマ区切りのスカラ式のリスト。
host-variable	対応する columnlist の各フィールドのデータ値を指定するホスト変数 (以下の例を参照)。
query	対応する columnlist の各フィールドに 1 行以上の行のデータ値を指定する、クエリの結果セット。
column	1 つの列名。この列のデータ値として、等号で対になっている value が設定されます。
value	対になった列の値のソースとなるスカラ式。

SELECT 文と組み合わせた INSERT 文では、テーブルに複数の新しい行を挿入できます。このテクニックは一般に、あるテーブルに他のテーブルから抽出した既存のデータを追加する場合に使用されます。このような INSERT の使用方法は、以下の "INSERT クエリ結果" のセクションで説明されています。

テーブルには、直接挿入することも、ビュー経由で挿入することもできます。ビュー経由で挿入する場合は、CREATE VIEW で説明されているように、必要条件や制限事項に従います。

INSERT は、全か無かのイベントです。行がすべて挿入されるか、まったく挿入されないかのいずれかです。Caché は、SQLCODE ステータス変数を返し、INSERT の成功もしくは失敗を示します。テーブルに行を挿入するには、以下の条件を満たしている必要があります。

列のリストを省略すると、INSERT は、すべての列が列番号順で挿入されるものと判断します。列のリストを指定すると、個々の値は、列のリスト内の列の名前と位置的に一致する必要があります。

フィールド値がすべてそのフィールドの既定値に設定されているか NULL 値に設定されている行をテーブルに挿入できます。これには、以下のコマンドを使用します。

INSERT INTO Mytable DEFAULT VALUES

%NOCHECK を指定しない場合、Caché ではシステム構成設定を使用して外部キーの参照整合性チェックを実行するかどうかが決まります。システムの既定値は以下のように設定できます。

INSERT 操作時に、すべての外部キー参照について、参照されるテーブルの該当する行に対する共有ロックが取得されます。この行は、トランザクションの終了までロックされています。これにより、参照されている行は、INSERT の参照整合性チェックからトランザクションの終了までの間、変更されないことが保証されます。

SELECT 文との組み合わせにより、1 つの INSERT を使用して複数の行をテーブルに挿入することができます。SELECT が 1 つのテーブルの複数の行から列データを抽出し、INSERT がこの列データを格納した新しい対応する行を別のテーブル内に作成します。

以下の例では、2 つの埋め込み SQL プログラムを使用して INSERT のこの使用方法を示します。最初の例で新しいテーブル Sample.Students を作成し、2 番目の例でこのテーブルに Sample.Person から抽出したデータを追加します。

この動作をはっきり示すために、2 つの埋め込み SQL プログラムは示されている順序で実行してください (埋め込み SQL では参照されるテーブルがすでに存在していなければ INSERT 文をコンパイルすることができないため、ここでは 2 つの埋め込み SQL プログラムを使用する必要があります)。

   WRITE !,"starting up"
  &sql(CREATE TABLE Sample.Students (
    StudentName VARCHAR(16),
    StudentAge INTEGER))
  IF SQLCODE=0 {
    WRITE !,"Created table, SQLCODE=",SQLCODE }
  ELSEIF SQLCODE=-201 {
    WRITE !,"Table already exists, SQLCODE=",SQLCODE }

   WRITE !,"inserting data"
  &sql(INSERT INTO Sample.Students (StudentName,StudentAge)
     SELECT Name,Age
     FROM Sample.Person WHERE Age <= '21')
  IF SQLCODE=0 {
    WRITE !,"Inserted record, SQLCODE=",SQLCODE }
  ELSE {
    WRITE !,"Insert failed, SQLCODE=",SQLCODE }

データを表示するには、システム管理ポータルで SAMPLES ネームスペースの [グローバル] オプションを選択します。"Sample.StudentD" までスクロールし、[データ] オプションをクリックします。

INSERT クエリ結果の操作はアトミック処理です。指定された行がすべてテーブルに挿入されるか、1 行も挿入されないかのいずれかです。例えば、指定された行のいずれかの挿入が外部キーの参照整合性に違反する場合、INSERT は失敗し、1 行も挿入されません。

%NOLOCK を指定しない場合、Caché は、INSERT、UPDATE、および DELETE 操作時に標準のロックを実行します。一意フィールドの値は、現行のトランザクションの間、ロックされます。

既定のロックしきい値は、テーブルごとに 1000 ロックです。つまり、トランザクション時に 1000 行を超える行 (一意フィールド値) をテーブルに挿入する場合は、ロックしきい値に到達し、Caché はロック・レベルを自動的に一意フィールド値ロックからテーブル・ロックへと上げます。これによってトランザクション時に、ロック・テーブルをオーバーフローすることなく、大規模な挿入を実行できます。このロックしきい値は設定可能です。トランザクションでのロックの詳細は、このドキュメントの "SQL の概念" の "トランザクション" を参照してください。

  &sql(INSERT INTO Sample.Person (Name,DOB,SSN) VALUES 
   ('David Vanderbilt', 46639,'123-45-6789'))
  WRITE !,"Error code=",SQLCODE,!,"Row count=",%ROWCOUNT

   &sql(INSERT INTO Sample.Employee VALUES :emp("profile",))
   WRITE !,"SQL Error code: ",SQLCODE," Row Count: ",%ROWCOUNT

INSERT INTO StudentRoster (NAME,GPA,ID_NUM)
     SELECT FullName,GradeAvg,ID
     FROM temp WHERE SchoolYear = '2004'