配列エレメントの削除 (ARRAY_DELETE)

ARRAY_DELETE 関数を使用すると、配列からエレメントを永続的に削除することができます。

始める前に

  • 『配列データ・タイプ』を読んでください
  • 『配列データ・タイプに関する制約事項』を読んでください
  • SET ステートメントを実行するのに必要な特権

このタスクについて

配列の中のエレメントを削除するには、SQL PL コード内でこのタスクを実行します。

手順

  1. 次のようにして SET ステートメントを定義します。
    1. 配列エレメントと同じタイプの変数を宣言して指定します。
    2. 割り当て記号「=」を指定します。
    3. ARRAY_DELETE 関数の名前を指定し、必須の括弧の中に、配列の名前、および削除対象のエレメントの範囲を定義する副索引を指定します。
  2. SET ステートメントを実行します。

タスクの結果

SET ステートメントが正常に実行されると、phones 配列に含まれる値が更新されます。

電話番号の配列が以下のように定義されているとします。
phones		index		0		           1		           2		           3 				
         phone		'416-223-2233'	'416-933-9333'	'416-887-8887'	'416-722-7227'   	
次のような SQL ステートメントを実行した後、
SET phones = ARRAY_DELETE ( phones,  1, 2 );
配列 phones は次のように定義されます。
phones		index		0		           3 				
         phone		'416-223-2233'	'416-722-7227'

次のタスク

SET ステートメントが正常に実行されなかった場合、以下を行ってください。
  • SET ステートメントの SQL ステートメント構文を確認して、SET ステートメントを再度実行する。
  • ローカル変数のデータ・タイプが正しいことを確認する。
  • 配列が正常に作成されており、存在していることを確認する。