WHILE

グローバル変数は 2 つの @ マーク（@@）で始まります。すべてのグローバル変数は、接続ごとの変数です。データベース接続ごとにそれぞれ固有の @@IDENTITY、@@BIGIDENTITY、@@ROWCOUNT、および @@SPID 値を持ちます。@@VERSION の値は、この変数が使用されているステートメントを実行するエンジンのバージョンに関する情報です。

@@IDENTITY および @@BIGIDENTITY

これらの変数は、一番最後に挿入された列値を返します。値は符号付き整数値になります。初期値はヌルです。

変数は単一列のみ参照することができます。ターゲットテーブルに 2 つ以上の IDENTITY 列が含まれている場合、この変数の値は、テーブルの主キーとなる IDENTITY 列を参照します。このような列が存在しない場合には、この変数の値はテーブル内の最初の IDENTITY 列を参照します。

一番最後の挿入が IDENTITY 列を含まないテーブルに対して行われたものであった場合、@@IDENTITY の値はヌルに設定されます。

BIGIDENTITY 値の場合は、@@BIGIDENTITY を使用します。SMALLIDENTITY 値の場合は、@@IDENTITY を使用します。

例

SELECT @@IDENTITY

現在の接続でレコードが挿入されていない場合はヌルを返し、そうでない場合は、一番最後に挿入された行の IDENTITY 列の値を返します。

SELECT * FROM t1 WHERE @@IDENTITY = 12

一番最後に挿入された行の IDENTITY 列の値が 12 の場合はその行を返し、そうでない場合は行を返しません。

INSERT INTO t1(c2) VALUES (@@IDENTITY)

最後に挿入された行の IDENTITY 値を新しい行の C2 列に挿入します。

UPDATE t1 SET t1.c1 = (SELECT @@IDENTITY) WHERE t1.c1 = @@IDENTITY + 10

C1 列の値が最後に挿入された行の IDENTITY 列の値より 10 大きい場合は、C1 列をこの IDENTITY 値で更新します。

UPDATE t1 SET t1.c1 = (SELECT NULL FROM t2 WHERE t2.c1 = @@IDENTITY)

C1 列の値が最後に挿入された行の IDENTITY 列の値と等しい場合は、C1 列をヌル値で更新します。

以下の例では、ストアドプロシージャを作成し、それを呼び出します。プロシージャは、最後に更新された行の IDENTITY 列の値と入力値の合計を変数 V1 に設定します。プロシージャは次に、C1 列が V1 と等しい行をテーブルから削除し、その後で何行削除されたかを示すメッセージを出力します。

CREATE PROCEDURE TEST (IN :P1 INTEGER);

BEGIN

DECLARE :V1 INTERGER;

SET :V1 = :P1 + @@IDENTITY;

DELETE FROM t1 WHERE t1.c1 = :V1;

IF (@@ROWCOUNT = 0) THEN

PRINT '行は削除されませんでした';

ELSE

PRINT CONVERT(@@ROWCOUNT, SQL_CHAR) + ' 行が削除されました';

END IF;

END;

CALL TEST (@@IDENTITY)

@@ROWCOUNT

この変数は、現在の接続で一番最後に行った操作により影響を受けた行の数を返します。値は符号なし整数になります。初期値はゼロです。

@@ROWCOUNT 変数は、INSERT、UPDATE、または DELETE ステートメント後に使用した場合にのみ有効になります。

例

SELECT @@ROWCOUNT

現在の接続で直前に行った操作により影響を受けたレコードがない場合はゼロを返し、そうでない場合は、直前の操作により影響を受けた行数を返します。

CREATE TABLE t1 (c1 INTEGER, c2 INTEGER)

INSERT INTO t1 (c1, c2) VALUES (100,200)

INSERT INTO t1(c1, c2) VALUES (300, @@ROWCOUNT)

SELECT @@ROWCOUNT

結果：

1（@@ROWCOUNT 変数の値）

4 番目の行で、@@ROWCOUNT 変数の値は 1 になります。これは、直前の INSERT 操作が影響を与えたのは 1 行だからです。

@@IDENTITY の例も参照してください。

@@SESSIONID

この変数は、Zen サーバーエンジン、レポートエンジン、またはワークグループエンジンへの接続を識別する 8 バイトの整数値を返します。この整数は時刻の値と増分カウンターの組み合わせです。この変数は Zen 接続をそれぞれ一意に識別するために使用できます。

@@SESSIONID が値を返すには、データベースエンジンに接続されていることが必要です。データベースエンジンへの接続が失われた場合、変数は ID を返すことができません。

例

SELECT @@SESSIONID

この例は、26552653137523 などの整数の ID を返します。

@@SPID

この変数、サーバープロセス ID は、Zen 接続のシステムスレッドの ID を示す整数値を返します。

データベースエンジンへの接続が失われた場合、SPID 変数は ID を返すことができません。代わりに、ステートメントが SqlState 08S01 を示すエラーを返します。

例

SELECT @@SPID

この例は、402 などの整数の ID を返します。

@@VERSION

この変数を使用する SQL ステートメントは、セッションが接続されている Zen サーバーエンジン、レポートエンジン、またはワークグループエンジンに基づいて値を返します。

•

Zen サーバーの場合、この値はローカルエンジンのバージョン、およびローカルオペレーティングシステムのビット数、名前、およびバージョンになります。

•

Zen Client Reporting Engine の場合は、ローカルレポートエンジンのバージョン、およびローカルオペレーティングシステムのビット数、名前、およびバージョンになります。

•

Zen Client の場合は、クライアントの接続先であるリモート Zen サーバー上のエンジンのバージョン、およびそのサーバーが実行されているオペレーティングシステムのビット数、名前、およびバージョンになります。

•

Zen Workgroup Engine の場合、この値はローカルエンジンのバージョン、およびローカルオペレーティングシステムのビット数、名前、およびバージョンになります。

例

SELECT @@version

この例は、次のようなテキスト情報を返します。

Actian Zen - 14.10.020.000 (x86_64) Server Engine - Copyright (C) Actian Corporation 2019 on (64-bit) Windows NT 6.2 7d

ほかの特性

このトピックでは、SQL 文法のその他の特性について説明します。この章は、以下のセクションに分かれています。

•

•

•

•

•

Zen は、指定されたクエリを処理するためにテンポラリテーブルを生成する必要がある場合は、次のいずれかの方法で決定された場所にそのファイルを作成します。

•

文字列キー値の PervasiveEngineOptions\TempFileDirectory を ODBC.INI に手動で追加した場合、Zen は TempFileDirectory に設定されたパスを使用します。Windows における 32 ビットおよび 64 ビット Zen インストレーションに対するレジストリの場所は、どちらも HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI です。Linux、macOS、および Raspbian の場合、ODBC.INI ファイルは /usr/local/actianzen/etc にあります。

•

ZenCC または bcfg を使用して Zen エンジンのテンポラリファイルディレクトリのプロパティを設定した場合、Zen はこの場所を使用します。詳細については、『Advanced Operations Guide』の「テンポラリファイル」を参照してください。

•

ここに挙げた最初の 2 つのオプションのいずれも使用していない場合、Zen は Windows プラットフォームでは以下の順序でファイルの場所を調べます。

1 TMP 環境変数で指定されたパス

2 TEMP 環境変数で指定されたパス

3 USERPROFILE 環境変数で指定されたパス

4 Windows ディレクトリ

たとえば、TMP 環境変数が定義されていない場合、Zen は TEMP 環境変数、その次の環境変数という順に指定されているパスを使用します。

Linux および macOS ディストリビューションでは、Zen はサーバープロセスの現在のディレクトリを使用します。TMP の使用を試みることはありません。

Zen はクエリが完了すると、そのクエリの処理に使用されたすべてのテンポラリファイルを削除します。クエリが SELECT ステートメントの場合には、テンポラリファイルは結果セットがアクティブである間、つまり、結果セットが呼び出し元のアプリケーションによって解放されるまでは存在します。

テンポラリファイルはどのような場合に作成されるか