DECLARE variable-name [, ... ] data-type
[ { = | DEFAULT } initial-value ]

initial-value :
special-value
| string
| [ - ] number
| ( constant-expression )
| built-in-function ( constant-expression )
| NULL

special-value :
CURRENT { 
  DATABASE
  | DATE 
  | PUBLISHER 
  | TIME 
  | TIMESTAMP
  | USER 
  | UTC TIMESTAMP }
| USER

DECLARE exception-name EXCEPTION
FOR SQLSTATE [ VALUE ] string

「DECLARE variable-name：」プロシージャ、トリガ、またはバッチの本体で使用される変数は DECLARE 文で構文 1 を使用して宣言できます。変数は、宣言される複合文の間持続します。initial-value を指定すると、変数はその値に設定されます。initial-value を指定しなかった場合、SET 文によって別の値が割り当てられるまで、変数には NULL 値が入っています。

Watcom SQL プロシージャの本文またはトリガは複合文です。また、カーソルの宣言 (DECLARE CURSOR) など他の宣言では、BEGIN キーワードの直後に変数を宣言する必要があります。Transact-SQL プロシージャまたはトリガには、そのような制約はありません。

initial-value を指定する場合は、data-type で定義したデータ型とデータ型を一致させてください。

「DECLARE exception-name EXCEPTION:」 この構文を使用して、複合文 (BEGIN...END) 内で SQL 言語の例外の変数を宣言します。この変数は、たとえば、実行中に取得される SQLSTATE との比較に使用したり、SIGNAL 文で使用したり、例外ハンドラ内の例外ケースの一部として使用したりできます。

なし。

なし。

• SQL データ型
• DECLARE 文
• DECLARE CURSOR 文 [ESQL] [SP]
• BEGIN 文
• SQLSTATE 特別値
• 特別値
• 例外ハンドラ

次のバッチは、DECLARE 文の使用法を示し、メッセージをデータベースサーバメッセージウィンドウに表示します。

BEGIN
  DECLARE varname CHAR(61);
  SET varname = 'Test name';
  MESSAGE varname;
END

次の例は、以下の変数を宣言します。

• INT、初期設定値 5 の v1。
• CHAR(10)、初期値 abc の v2 と v3。

BEGIN
   DECLARE v1 INT = 5;
   DECLARE v2, v3 CHAR(10) = 'abc';
			// ...
END

次のプロシージャは SQLSTATE 比較で使用する例外を宣言します。

CREATE PROCEDURE HighSales (IN cutoff INT, OUT HighValues INT)
BEGIN
   DECLARE err_notfound EXCEPTION FOR
      SQLSTATE '02000';
   DECLARE curThisCust CURSOR FOR
      SELECT CAST( sum( SalesOrderItems.Quantity *
            Products.UnitPrice ) AS INTEGER) VALUE
      FROM Customers
            LEFT OUTER JOIN SalesOrders
            LEFT OUTER JOIN SalesOrderItems
            LEFT OUTER JOIN Products
      GROUP BY CompanyName;
   DECLARE ThisValue INT;
   SET HighValues = 0;
   OPEN curThisCust;
   CustomerLoop:
   LOOP
      FETCH NEXT curThisCust
         INTO ThisValue;
      IF SQLSTATE = err_notfound THEN
         LEAVE CustomerLoop;
      END IF;
      IF ThisValue > cutoff THEN
         SET HighValues = HighValues + ThisValue;
      END IF;
END LOOP CustomerLoop;
   CLOSE curThisCust;
END;

次の複合文は、SIGNAL および例外ハンドラで使用する例外を宣言します。

BEGIN
   DECLARE err_div_by_0 EXCEPTION FOR
      SQLSTATE '22012';
   DECLARE curQuantity CURSOR FOR
      SELECT Quantity
      FROM SalesOrderItems
      WHERE ProductID = 300;
   DECLARE Quantities INT;
   DECLARE altogether INT;
   SET Quantities = 0;
   SET altogether = 0;
   OPEN curQuantity;
   LOOP
      FETCH NEXT curQuantity
         INTO Quantities;
      IF SQLSTATE = '02000' THEN
         SIGNAL err_div_by_0;
      END IF;
      SET altogether = altogether + Quantities;
   END LOOP;
EXCEPTION
   WHEN err_div_by_0 THEN
	CLOSE curQuantity;
	SELECT altogether;
    return;
   WHEN OTHERS THEN
	RESIGNAL;
END;