30.4. SQL コマンドの実行

すべての SQL コマンドは、埋め込み SQL アプリケーション内で実行できます。 以下に例をいくつか示します。

テーブルを作成します。

EXEC SQL CREATE TABLE foo (number integer, ascii char(16));
EXEC SQL CREATE UNIQUE INDEX num1 ON foo(number);
EXEC SQL COMMIT;

行を挿入します。

EXEC SQL INSERT INTO foo (number, ascii) VALUES (9999, 'doodad');
EXEC SQL COMMIT;

行を削除します。

EXEC SQL DELETE FROM foo WHERE number = 9999;
EXEC SQL COMMIT;

単一行を選択します。

EXEC SQL SELECT foo INTO :FooBar FROM table1 WHERE ascii = 'doodad';

カーソルを使用して選択します。

EXEC SQL DECLARE foo_bar CURSOR FOR
    SELECT number, ascii FROM foo
    ORDER BY ascii;
EXEC SQL OPEN foo_bar;
EXEC SQL FETCH foo_bar INTO :FooBar, DooDad;
...
EXEC SQL CLOSE foo_bar;
EXEC SQL COMMIT;

更新します。

EXEC SQL UPDATE foo
    SET ascii = 'foobar'
    WHERE number = 9999;
EXEC SQL COMMIT;

:somethingという形のトークンはホスト変数です。 つまり、Cプログラム内の変数を参照するものです。 これについては項30.6で説明します。

デフォルトモードでは、文は EXEC SQL COMMIT が発行されることのみによりコミットされます。 埋め込み SQL インタフェースでも、(他のさまざまなインタフェース同様、)トランザクションの自動コミットをサポートしています。 自動コミットは、ecpg コマンド (以下を参照) の-tコマンドラインオプション、あるいは EXEC SQL SET AUTOCOMMIT TO ON 文によって可能になります。 自動コミットモードでは、問い合わせが明示的なトランザクションブロックの内部にある場合を除き、すべての問い合わせが自動的にコミットされます。 自動コミットモードは、EXEC SQL SET AUTOCOMMIT TO OFF を使用して明示的に無効にすることができます。