ALTER TABLE

呼び出し

このステートメントは、アプリケーション・プログラムに組み込むことができ、また対話式に呼び出すこともできます。 これは、動的に準備できる実行可能ステートメントです。

権限

このステートメントの権限 ID が保持する特権には、少なくとも以下の 1 つ が含まれていなければなりません。

• ステートメントで識別される表に対して、
  • その表の ALTER 特権、および
  • 表が含まれるスキーマに対する USAGE 特権
• データベース管理者権限

外部キーを定義する場合、ステートメントの権限 ID が保持する特権には、親表に関して少なくとも次の 1 つが含まれていなければなりません。

• 該当の表に対する REFERENCES 特権またはオブジェクト管理権限。
• 指定された親キーの各列に対する REFERENCES 特権。
• データベース管理者権限

フィールド・プロシージャーを定義する場合は、ステートメントの権限 ID によって保持される特権に、少なくとも次のいずれか 1 つが含まれなければなりません。

• 次のシステム権限
  • プログラムに対する *EXECUTE システム権限、および
  • プログラムが含まれるスキーマに対する USAGE 特権
• データベース管理者権限

選択ステートメント を指定する場合は、ステートメントの権限 ID によって保持される 特権に、少なくとも次のいずれか 1 つがこれらの文節で指定された表またはビューにおいて含まれなければなりません。

• 表またはビューに対する SELECT 特権
• データベース管理者権限

特殊タイプを参照する場合は、ステートメントの権限 ID によって保持される 特権に、少なくとも次のいずれか 1 つが含まれなければなりません。

• ステートメント内で識別された、それぞれの特殊タイプごとに、
  • その特殊タイプに対する USAGE 特権、および
  • 特殊タイプが含まれるスキーマに対する USAGE 特権
• データベース管理者権限

行の許可がアクティブ になっている表から DELETE ROWS でパーティションを削除するには、 このステートメントの権限 ID には次の 1 つ以上が含まれなければなりません。

• 表についての *OBJOPR および *OBJEXIST システ ム権限。
• データベース管理者権限

パーティションをアタッチするには、ステートメントの権限 ID によって保持される特権に、少なくとも次のいずれか 1 つも含まれなければなりません。

• ステートメントで識別されるソース表に対して、
  • SELECT 特権、および
  • *OBJEXIST システム権限、および
  • ソース表が含まれるスキーマに対する USAGE 特権
• データベース管理者権限

パーティションをデタッチするには、ステートメントの権限 ID によって保持される特権にも、少なくとも次のいずれか 1 つが含まれなければなりません。

• ステートメントで識別されるソース表に対して、
  • SELECT、DELETE、ALTER 特権、および
  • ソース表が含まれるスキーマに対する USAGE 特権
• データベース管理者権限

パーティションをデタッチするには、ステートメントの権限 ID によって保持される特権に、少なくとも次のいずれか 1 つが含まれなければなりません。

• スキーマ内に作成する特権。詳しくは、スキーマ内で作成する必要のある権限を参照してください。
• データベース管理者権限

表をシステム期間テンポラル表になるように変更する場合 (ADD VERSIONING 節を使用)、関連する履歴表にも変更が発生するような変更を 1 つ以上含む、システム期間テンポラル表への変更を行う場合、または、DROP VERSIONING を実行する場合、ステートメントの許可 ID の保持する特権に、以下の権限も少なくとも 1 つ含まれている必要があります。

• 次のシステム権限
  • 履歴表の ALTER 特権、および
  • 履歴表が含まれるスキーマに対する USAGE 特権
• データベース管理者権限

SQL 特権に対応するシステム権限の説明については、『表またはビューへの権限を検査する際の対応するシステム権限』および『特殊タイプへの権限を検査する際の対応するシステム権限』を参照してください。

説明

table-name

変更する表を指定します。table-name は、 現行サーバーに存在する表を識別していなければなりません。この表は、ビュー、カタログ表、または宣言済み一時表であってはなりません。表名 がマテリアライズ照会表または履歴表を識別する場合、ADD 列定義、ALTER 列変更、または DROP COLUMN は使用できません。table-name がマテリアライズ照会表またはテンポラル表を識別する場合、 ATTACH PARTITION および DETACH PARTITION は使用できません。

ADD COLUMN column-definition

表に列を追加します。この表は履歴表にすることはできません。 表に行がある場合は、列の値はすべて、そのデフォルト値に設定されます。ただし、列が ROWID 列、または 生成列である場合を除きます。ROWID 列および生成列のデフォルト値は、データベース・マネージャーが生成します。 表に既に n 個の列がある場合、新規の列の順番 は n+1 になります。n+1 の 値は 8000 以下でなければなりません。

1 つの表には、1 つの ROWID と生成列の各タイプの 1 つのみを含められます。

FILE LINK CONTROL を指定した DataLink 列は、CASCADE の削除規則を伴う参照制約で従属表である表や、システム期間テンポラル表には追加できません。 ROWID 列は、システム期間テンポラル表に追加できません。

ALTER COLUMN column-alteration

既存の ID 列の属性など、列の定義を変更します。 指定した属性だけが変更されます。それ以外のものは、未変更のままになります。表がシステム期間テンポラル表である場合は、対応する履歴表に変更が加えられます。ただし、ID や行変更タイム・スタンプなどの生成列属性はコピーされません。

DROP COLUMN

識別された列を表から除去します。

column-name

除去したい列を識別します。 列名は修飾してはなりません。 この名前は、指定した表の列を識別するものでなければなりません。 以下のものを示す名前であってはなりません。

• この ALTER TABLE ステートメントで既に追加または変更された列
• 表の唯一の列
• 表の列の中で非表示であるものを除いた最後の列
• パーティション表または分散表のパーティション・キー
• システム期間テンポラル表の列
• 履歴表の列
• 期間の定義で参照される列

列が除去されると、その列に対して定義された列マスクはすべて 除去されます。列が、別の列の行の許可または列マスクの定義で参照されている場合、その列を除去することは できません。

CASCADE

除去される列に従属しているビュー、索引、トリガー、または制約もすべて 除去されることを指定します。¹

RESTRICT

ビュー、索引、トリガー、マテリアライズ照会表、または制約が列に依存している場合、その列を除去できないことを指定します。 ¹

ある制約で参照されている列がすべて同一の ALTER TABLE ステートメントで除去される場合は、その除去が RESTRICT で妨げられることはありません。

ADD ユニーク制約

CONSTRAINT constraint-name

制約の名前を指定します。制約名 は、既に ALTER TABLE ステートメントで指定され、かつ既に現行サーバーに存在している制約名と同じであってはなりません。制約名は、スキーマ内で固有でなければなりません。

指定しない場合は、固有の制約名がデータベース・マネージャーによって生成されます。

UNIQUE (column-name,…)

識別された列で構成されるユニーク制約を定義します。 それぞれの column-name は、該当の表の列を識別する非修飾の名前でなければなりません。同じ列を複数回指定することはできません。この列は、LOB 列、DATALINK 列、または XML 列であってはなりません。ソート・シーケンスを指定する場合、列にフィールド・プロシージャーを含めることはできません。指定できる列の数は 120 を超えてはならず、その長さの合計は 32766-n を超えてはなりません。ここで、n は NULL が許されると指定された列の数です。表が履歴表である場合は、UNIQUE を使用できません。

指定する列のセットは、その表の他の UNIQUE 制約または PRIMARY KEY に指定されている列のセットと同じであってはなりません。 例えば、UNIQUE(A,B) は、UNIQUE(B,A) あるいは PRIMARY KEY(A,B) が該当の表に既に存在する場合には許されません。 一連の列に指定されている既存のどの非 NULL 値も固有の値にする必要があります。複数の NULL 値が許されます。

識別された列に固有索引が既に存在する場合は、その索引が固有制約索引として指定されます。 それ以外の場合は、固有キーの固有性をサポートするために固有索引が作成されます。 固有索引は、別個のシステム論理ファイルとしてではなく、システム物理ファイルの一部として作成されます。

PRIMARY KEY (column-name,…)

指定した列で構成される基本キーを定義します。それぞれの column-name は、該当の表の列を識別する非修飾の名前でなければなりません。同じ列を複数回指定することはできません。この列は、LOB 列、DATALINK 列、または XML 列であってはなりません。ソート・シーケンスを指定する場合、列にフィールド・プロシージャーを含めることはできません。指定する列の数は 120 を超えてはならず、それらの列の長さの合計は 32766 を超えてはなりません。 該当の表に既に基本キーが存在していてはなりません。表が履歴表である場合は、PRIMARY KEY を使用できません。

指定する列は、その表の他の UNIQUE 制約に指定されている列と同じであってはなりません。 例えば、PRIMARY KEY(A,B) は、その表に UNIQUE(B,A) が既に存在する場合には許されません。 指定した一連の列の既存の値は、固有でなければなりません。

基本キーを追加すると、CHECK 制約が 暗黙的に追加され、その基本キーを構成するどの列でも NULL を使用するこ とはできないという規則が適用されます。

指定した列に固有索引が既に存在している場合には、その索引は、基本索引として扱われます。 このような場合以外は、基本キーの固有性をサポートする 基本索引が作成されます。固有索引は、別個のシステム論理ファイルとしてではなく、システム物理 ファイルの一部として作成されます。

ADD referential-constraint

CONSTRAINT constraint-name

制約の名前を指定します。制約名 は、現行サーバーに既に存在している制約を識別するものであってはなりません。

指定しない場合は、固有の制約名がデータベース・マネージャーによって生成されます。

FOREIGN KEY

参照制約を定義します。 表が宣言済みグローバル一時表、分散表、または履歴表である場合は、FOREIGN KEY を使用することはできません。

以下の説明で T1 は、変更したい表を表しています。

(column-name,…)

参照制約の外部キーは、指定した列で構成されます。 各 column-name は、T1 の列を指定する非修飾名でなければなりません。同じ列を複数回指定することはできません。この列は、LOB 列、DATALINK 列、または XML 列であってはならず、また行変更タイム・スタンプ列であってもなりません。ソート・シーケンスを指定する場合、列にフィールド・プロシージャーを含めることはできません。 指定できる列の数は 120 を超えてはならず、その長さの合計は 32766-n を超えてはなりません。ここで、n は NULL が許可されるように指定された列の数です。

REFERENCES table-name

REFERENCES 文節で指定する表名 は、現行サーバー上に存在する基本表を示すものでなければなりませんが、カタログ表、宣言済み一時表、分散表、または履歴表を示すものであってはなりません。親がパーティション表の場合は、親のユニーク制約を適用するユニーク索引がパーティション化されていてはなりません。この表は、制約関係における親表と呼ばれます。

参照制約の外部キー、親キー、および親表が表にある既存の参照制約の外部キー、親キー、および親表と同じである場合は、その参照制約は重複 します。 重複する参照制約は許されますが、お勧めできません。

以下の説明で、T2 は親表を示しています。

(column-name,…)

参照制約の親キーは、ここで指定する列によって構成されます。 各 column-name は、T2 の列を指定する非修飾名でなければなりません。 同じ列を複数回指定することはできません。この列は、LOB 列、DATALINK 列、または XML 列であってはならず、また行変更タイム・スタンプ列であってもなりません。ソート・シーケンスを指定する場合、列にフィールド・プロシージャーを含めることはできません。指定できる列の数は 120 を超えてはならず、その長さの合計は 32766-n を超えてはなりません。ここで、n は NULL が許されると指定された列の数です。

この列名のリストは、T2 の基本キーまたは T2 に存在する UNIQUE 制約の列名のリストと同一でなければなりません。 名前はどのような順序で指定しても構いません。 例えば、(A,B) を指定すると、UNIQUE(B,A) として定義された固有制約はこの要件を満たします。 列名のリストの指定がない場合、T2 は基本キーを持たなければなりません。 列名のリストの省略は、基本キーの列の暗黙の指定を意味しています。

指定した外部キーは、T2 の親キーと同じ数の列を持たなければなりません。 外部キーの n 番目の列と親キーの n 番目の列の記述は、同一のデータ・タイプ、長さ、CCSID、および FIELDPROC を持つ必要があります。

表が空である場合を除き、表の使用に先立って、外部キーの値の妥当性を検査する必要があります。 外部キーの値は、ALTER TABLE ステートメントの実行中に妥当性を検査されます。 したがって、外部キーの NULL 以外の値はすべて、T2 の親キーの値と一致している必要があります。

FOREIGN KEY 文節によって指定する参照制約は、T2 が親で、T1 が従属の関係を定義します。

ON DELETE

親表の行が削除される時点で、従属表について行うアクションを指定します。 可能なアクションには以下の 5 つがあります。

• NO ACTION (デフォルト)
• RESTRICT
• CASCADE
• SET NULL
• SET DEFAULT

外部キーの列に NULL が許される列がある場合を除いて、SET NULL を指定してはなりません。 T1 が更新トリガーを持つ場合には、SET NULL および SET DEFAULT を指定してはなりません。

T1 が削除トリガーを持つ場合には、CASCADE を指定してはなりません。

FILE LINK CONTROL を指定した DATALINK 列が T1 に含まれる場合には、CASCADE を指定してはなりません。

削除規則は、T2 の行が DELETE または波及削除操作の対象で、しかもその行が T1 に従属する行を持っている場合に適用されます。 p は、そのような T2 の行を表すと想定します。

• RESTRICT または NO ACTION を指定した場合、エラーが生じ、行の削除は行われません。
• CASCADE を指定すると、 T1 の p の従属行に削除操作が伝搬します。
• SET NULL が指定された場合、T1 の p のそれぞれの従属行の外部キーの NULL 可能な列が NULL 値に設定されます。
• SET DEFAULT を指定した場合、T1 の p の各従属行の外部キーの各列は、そのデフォルト値に設定されます。

ON UPDATE

親表の行が更新される時点で、従属表で行うアクションを指定します。

更新規則は、T2 の行が UPDATE または波及更新操作の対象で、しかもその行が T1 に従属行を持つ場合に適用されます。 p は、そのような T2 の行を表すと想定します。

• RESTRICT または NO ACTION を指定した場合、エラーが生じ、行の更新は行われません。

ADD 検査制約

CONSTRAINT constraint-name

制約の名前を指定します。制約名 は、現行サーバーに既に存在している制約を識別するものであってはなりません。制約名は、スキーマ内で固有でなければなりません。

指定しない場合は、固有の制約名がデータベース・マネージャーによって生成されます。

CHECK (check-condition)

検査制約を定義します。表のどの行についても、検査条件 は真または不明のいずれかでなければなりません。

検査条件 は、検索条件 です。ただし、下記の条件は除きます。

• 参照できるのは表の列だけであり、列名を修飾してはなりません。
• check-condition で指定する式の結果を、ROWID、XML の各データ・タイプ、または FILE LINK CONTROL を伴う DATALINK データ・タイプにすることはできません。
• 次のいずれも含めることはできません。
  • 副照会
  • 集約関数
  • 変数
  • グローバル変数
  • パラメーター・マーカー
  • シーケンス参照
  • LOB を含む複合式 (連結など)
  • OLAP の指定
  • ROW CHANGE 式
  • IS JSON、JSON_EXISTS、または REGEXP_LIKE の述部
  • 特殊レジスター
  • deterministic でない関数
  • 特殊タイプの作成に伴って暗黙に生成された関数以外のユーザー定義関数
  • 以下の組み込みスカラー関数

    ATAN2	DLURLSCHEME	JSON_TO_BSON	ROUND_TIMESTAMP
    BSON_TO_JSON	DLURLSERVER	JSON_VALUE	RPAD
    CARDINALITY	DLVALUE	LOCATE_IN_STRING	SCORE
    CONTAINS	ENCRYPT_AES	LPAD	SOUNDEX
    CURDATE	ENCRYPT_RC2	MAX_CARDINALITY	TABLE_NAME
    CURTIME	ENCRYPT_TDES	MONTHNAME	TABLE_SCHEMA
    DATAPARTITIONNAME	GENERATE_UNIQUE	MONTHS_BETWEEN	TIMESTAMP_FORMAT
    DATAPARTITIONNUM	GETHINT	NEXT_DAY	TIMESTAMPDIFF
    DAYNAME	HASH	NOW	TRUNC_TIMESTAMP
    DBPARTITIONNAME	HASH_MD5	OVERLAY	VARCHAR_FORMAT
    DECRYPT_BINARY	HASH_SHA1	RAISE_ERROR	VERIFY_GROUP_FOR_USER
    DECRYPT_BIT	HASH_SHA256	RAND	WEEK_ISO
    DECRYPT_CHAR	HASH_SHA512	REGEXP_COUNT	WRAP
    DECRYPT_DB	IDENTITY_VAL_LOCAL	REGEXP_INSTR	XMLPARSE
    DIFFERENCE	INSERT	REGEXP_REPLACE	XMLVALIDATE
    DLURLCOMPLETE 1	JSON_ARRAY	REGEXP_SUBSTR	XSLTRANSFORM
    DLURLPATH	JSON_OBJECT	REPEAT
    DLURLPATHONLY	JSON_QUERY	REPLACE
    1 FILE LINK CONTROL と READ PERMISSION DB の属性が指定されたデータ・リンクの場合。

ON INSERT VIOLATION

挿入される行の check-condition が false の場合の処置 を指定します。この節が指定されていないと、 挿入の check-condition が false の場合はエラーが発生します。

SET column-name = DEFAULT

挿入操作で提供される値の代わりに、column-name のデフォルト値が表に 挿入されます。

column-name は check-condition 内で参照されている必要があります。

ON UPDATE VIOLATION

更新される行に対する check-condition が false の場合の処置 を指定します。この節が指定されていないと、 更新の check-condition が false の場合はエラーが発生します。

PRESERVE column-name

column-name の現行値は、更新操作によって提供される値で置き換えられるのではなく、表に 残ります。

column-name は check-condition 内で参照されている必要があります。

DROP

PRIMARY KEY

基本キーの定義、およびその基本キーが親キーである参照制約すべてを除去します。 該当の表は、基本キーを持っていなければなりません。

UNIQUE constraint-name

制約名 で指定した固有制約、およびこの固有制約に依存する参照制約すべてを除去します。 制約名 は、該当の表の固有制約を識別していなければなりません。DROP UNIQUE は、PRIMARY KEY 固有制約を除去することはありません。

FOREIGN KEY constraint-name

制約名が constraint-name の参照制約をドロップします。 制約名 は、該当の表が従属している参照制約を識別していなければなりません。

CHECK constraint-name

検査制約 constraint-name をドロップします。制約名 では、表の検査制約を識別する必要があります。

CONSTRAINT constraint-name

制約 constraint-name をドロップします。制約名 では、表の固有、参照、または検査制約を識別する必要があります。 この制約が、PRIMARY KEY または UNIQUE の制約である場合、その基本キーまたは固有キーが親キーである参照制約もすべて除去されます。

CASCADE

固有制約に関して、除去される制約に従属している参照制約があれば、それもすべて除去されることを指定します。

RESTRICT

固有制約に関して、それに従属している参照制約がある場合は、その固有制約は除去できないことを指定します。

ADD パーティション化文節

パーティション化されていない表をパーティション化された表に変更します。 指定した表が分散表または既にパーティション化された表である場合は、エラーが戻されます。 DDS で作成された物理ファイルをパーティション化することはできません。パーティション化文節 の説明については、CREATE TABLEを参照してください。

データを含むパーティション化されていない表をパーティション化された表に変更する場合、 データ・パーティション間のデータ移動が必要になります。 範囲パーティションを使用する場合、表内のすべての既存のデータは、 指定された範囲パーティションに割り当て可能でなければなりません。

DROP PARTITIONING

パーティション化された表をパーティション化されていない表に変更します。 指定した表が既にパーティション化されていない表である場合は、エラーが戻されます。

データを含むパーティション化された表をパーティション化されていない表に変更する場合、 データ・パーティション間のデータ移動が必要になります。

ADD PARTITION add-partition

1 つ以上のパーティションをパーティション化された表に追加します。 指定する表は、パーティション表でなければなりません。パーティションの数は、256 以下でなければなりません。

データを含むパーティション化された表のハッシュ・パーティションの数を変更する場合、 データ・パーティション間のデータ移動が必要になります。

partition-name

パーティションに名前を付けます。 パーティション名 で、表内に既に存在するデータ・パーティションを識別してはなりません。

この文節の指定がない場合、固有のパーティション名がデータベース・マネージャーによって生成されます。

boundary-spec

範囲パーティションの境界を指定します。 指定した表が範囲パーティション化された表でない場合、エラーが戻されます。 開始文節 および終了文節 の両方を必ず指定する必要があります。境界スペック の説明については、CREATE TABLEを参照してください。

整数 HASH PARTITIONS

追加するハッシュ・パーティションの数を指定します。 指定した表がハッシュ・パーティション化された表でない場合は、エラーが戻されます。

ALTER PARTITION

範囲パーティション化された表のパーティションの境界を変更します。 指定した表が範囲パーティション化された表でない場合、エラーが戻されます。

データを含む表の複数のパーティションの境界を変更する場合、 データ・パーティション間でデータを移動する必要があります。 表内のすべての既存のデータは、指定された範囲パーティションに割り当て可能でなければなりません。

partition-name

変更するパーティションの名前を指定します。 パーティション名 で、表内に存在するデータ・パーティションを識別しなければなりません。

boundary-spec

範囲パーティションの新規の境界を指定します。 開始文節 および終了文節 の両方を必ず指定する必要があります。境界スペック の説明については、CREATE TABLEを参照してください。

DROP PARTITION

パーティション化された表のパーティションを除去します。 指定した表がパーティション化された表でない場合、エラーが戻されます。 パーティション化された表の最後に残ったパーティションを指定すると、エラーが戻されます。 PRESERVE ROWS オプションが指定されている場合とパーティションが空である場合を除き、システム期間テンポラル表からパーティションをドロップすることはできません。

partition-name

除去するパーティションの名前を指定します。 パーティション名 で、表内に存在するデータ・パーティションを識別しなければなりません。

DELETE ROWS

指定したパーティションのすべてのデータを廃棄することを指定します。 パーティションに保管されているすべてのデータは、削除トリガーを処理せずに表から削除されます。

PRESERVE ROWS

指定したパーティションのすべてのデータを残りのパーティションに移動することによって、 削除または挿入トリガーを処理せずにそのデータを保存することを指定します。 指定した表が範囲パーティション化された表である場合、PRESERVE ROWS を指定してはなりません。 ハッシュ・パーティションを除去すると、残りのデータ・パーティション間でデータの移動が必要になります。

ATTACH PARTITION

他の表を新規のデータ・パーティションとしてアタッチします。 アタッチされる表のデータは、アタッチ先の表の新規パーティションになります。 データ移動は一切ありません。 指定したターゲット表がパーティション化された表でない場合、エラーが戻されます。 ターゲット表に既に最大数のパーティションがある場合、エラーが戻されます。 表がハッシュ・パーティション化されている場合、エラーが戻されます。

アタッチされる表で、行レベルのアクセス制御または列レベルのアクセス制御のいずれかがアクティブになっている場合、アタッチ先の表の同じ制御をアクティブにする必要があります。 行権限や列マスクは、アタッチされる表からターゲット表に自動的に引き継がれるわけではありません。 列マスクおよび行権限は、必ずしも両方の表で厳密に同じである必要はありません。ただし、セキュリティーの観点では、同じであるのが最善です。 しかし、アタッチされる表の行レベルのアクセス制御がアクティブになっている場合には、アタッチ先の表でも行レベルのアクセス制御をアクティブにする必要があります。同様に、アタッチする表の列レベルのアクセス制御がアクティブになっており、 少なくとも 1 つの列マスクが使用可能になっている場合には、 アタッチ先の表でも列レベルのアクセス制御をアクティブにし、 対応する列の列マスクを使用可能にする必要があります。

partition-name

データ・パーティションの名前を指定します。 表の他のデータ・パーティションと同じ名前を指定することはできません。この文節が指定されず、ソース表がパーティション化されている場合は、 ソース表のパーティション名が使用されます。 その他の場合は、この文節が指定されていないと、固有のパーティション名がデータベース・マネージャーによって生成されます。

boundary-spec

新規パーティションの境界を指定します。 boundary-spec が指定されていない場合は、次のようになります。

• ソース表は、単一パーティションでパーティション化された表でなければなりません。 そのパーティションの boundary-spec が暗黙的に使用されます。
• ソース表のパーティション・キーの数とパーティション・キー名は、ターゲット表のものと同じでなければなりません。

範囲は、暗黙的であれ明示的であれ、既存のデータ・パーティションの範囲と重なり合ってはなりません。 境界スペック の説明については、CREATE TABLEを参照してください。 boundary-spec が指定された場合、 ソース表のデータは、指定された範囲に適合する必要があります。そうでないと、後続の SQL 操作が予測不能になる可能性があります。

FROM table-name1

新規パーティションのデータのソースとして使用する表を指定します。 表は、ターゲット表と同じリレーショナル・データベースに存在しなければなりません。指定した表がパーティション化された表でない場合、エラーが戻されます。 表がハッシュ・パーティション化されている場合、エラーが戻されます。 表は、ビュー、マテリアライズ照会表、宣言済みグローバル一時表、システム期間テンポラル表、履歴表、およびシステム表であってはなりません。 表に NOT LOGGED INITIALLY 属性があってはなりません。table-name1 の表定義は、複数のパーティションを持つことができず、以下の形で、変更される表と一致していなくてはなりません。

• 列数が同じ。
• 表内の同じ位置 (順に並べた時の同じ位置) にある列のデータ・タイプ、属性、フィールド・プロシージャー、生成式、デフォルト値、および CCSID が同じ。
• 表内の同じ位置 (順に並べた時の同じ位置) にある列の NULL 可能特性が同じ。
• ターゲット表に行変更タイム・スタンプ列がある場合、それに対応するソース表の列は、行変更タイム・スタンプ列でなければなりません。
• 可変長または LOB データ・タイプの場合、表内の同じ位置 (順に並べた時の同じ位置) にある列の ALLOCATE 長が同じ。

table-name1 のデータが正しくアタッチされた後は、DROP TABLE table-name1 CASCADE と同等の操作が実行され、この表はデータを持たなくなり、データベースから削除されます。

DETACH PARTITION

パーティション化された表のパーティションをデタッチします。指定した表がパーティション化された表でない場合、エラーが戻されます。 1 つのパーティションを含む新しいパーティション化された表 table-name1 が作成され、デタッチされたパーティション・データが入ります。 partition-name を変更される表の最後に残ったデータ・パーティションにすることはできません。 変更する表は、システム期間テンポラル表や、強制される参照制約の親表であってはなりません。また、変更する表がハッシュ・パーティションを使用してはなりません。

ソース表が ID 列を含む場合、作成された表で対応する列は ID 列になりません。 ソース表のその他の列属性はすべて、作成された表の対応する列に定義されます。 ソース表に制約がある場合、作成された表に同様の制約は追加されません。

行レベルのアクセス制御または列レベルのアクセス制御のいずれかがアクティブである表からパーティションがデタッチされる場合、デタッチされたデータ用に作成される新しい表では、デタッチされたデータを保護するために、自動的に行レベルのアクセス制御がアクティブになります。 この新しい表に対して適切な行権限を定義するか、表の行レベルのアクセス制御を非アクティブにするまで、この表に直接アクセスしても行は返されません。

ソース表に対する特権は、作成された表に伝搬されません。

partition-name

デタッチするパーティションの名前を指定します。 partition-name は、表内に存在するデータ・パーティションを識別しなければなりません。

table-name1

表の名前を指定します。 暗黙的または明示的修飾子も含め、この名前で、現行サーバーに既に存在している別名、ファイル、 索引、表、またはビューを識別することはできません。

SQL 名が指定されている場合、表は、暗黙的または明示的修飾子で指定し ているスキーマ内に作成されます。

システム名が指定されている場合、表名は、修飾子で指定しているスキーマ内に作成されます。 修飾されない場合:

• CURRENT SCHEMA 特殊レジスターの値が *LIBL である場合、表は、現行ライブラリー (*CURLIB) 内に作成されます。
• そうでない場合、表は現行スキーマ内に作成されます。

指定されたパーティション表がジャーナルに記録された場合は、新しい表も同じジャーナルに記録されます。 そうでない場合は、新しい表もジャーナルに記録されません。

ADD MATERIALIZED QUERY マテリアライズ照会定義

基本表をマテリアライズ照会表に変更します。 指定した表が既にマテリアライズ照会表である場合、 あるいはその表が他のマテリアライズ照会表で参照されている場合は、エラーが戻されます。

選択ステートメント

表の基礎となる照会を定義します。 既存の表の列は、以下の特性を満たしていなければなりません。

• 表の列の数は、選択ステートメント の結果列の数と同じでなければなりません。
• 表の各列の列属性は、選択ステートメント 内の対応する結果列の列属性と互換性がなければなりません。

マテリアライズ照会表の選択ステートメント には、変更する表の参照、 変更する表に対するビュー、または他のマテリアライズ照会表を含めてはなりません。 マテリアライズ照会表の選択ステートメント を指定することについての詳細は、 CREATE TABLEを参照してください。

refreshable-table-options

基本表をマテリアライズ照会表に変更するためのマテリアライズ照会表オプションを指定します。

DATA INITIALLY DEFERRED

表内のデータを ALTER TABLE ステートメントの一部として検証しないことを指定します。 REFRESH TABLE ステートメントを使用して、マテリアライズ照会表にあるデータが、 その表を基礎とする照会の結果と同じになることを確証できます。

DATA INITIALLY IMMEDIATE

ALTER TABLE ステートメントの処理の一部として、 データを照会の結果から表内に挿入することを指定します。

REFRESH DEFERRED

表内のデータを REFRESH TABLE ステートメントを使用していつでもリフレッシュできるように指定します。 表内のデータは、REFRESH TABLE ステートメントの処理時または最後に更新された時のスナップショットとしての照会の結果のみを反映します。

MAINTAINED BY USER

マテリアライズ照会表がユーザーによって保守されるように指定します。 ユーザーは表に対して INSERT、DELETE、UPDATE、または REFRESH TABLE ステートメントを使用できます。

ENABLE QUERY OPTIMIZATION または DISABLE QUERY OPTIMIZATION

このマテリアライズ照会表を照会の最適化に使用できるかどうかを指定します。

ENABLE QUERY OPTIMIZATION

マテリアライズ照会表を照会最適化に使用できます。

DISABLE QUERY OPTIMIZATION

マテリアライズ照会表は照会最適化に使用されません。それでもその表を直接照会することはできます。

select-statement 内で直接または間接に参照されている 表で行レベルまたは列レベルのアクセス制御がアクティブになっていて、変更される表では行アクセス制御 がアクティブになっていない場合、変更される表に対して行アクセス制御が暗黙的にアクティブ化 されます。これにより、マテリアライズ照会表の内容への直接アクセスが制限されます。 表を明示的に参照する照会では、表内にデータがないことを示す警告が 戻されます。マテリアライズ照会表にアクセスするには、適切な行権限を作成します。またはふさわしいようであれば、マテリアライズ照会表に対する ALTER TABLE DEACTIVATE ROW ACCESS CONTROL を発行して、行レベルの保護を除去します。

ALTER MATERIALIZED QUERY マテリアライズ照会表変更

マテリアライズ照会表の属性を変更します。 表名でマテリアライズ照会表を識別する必要があります。

選択ステートメント

表の基礎となる照会を定義します。 既存の表の列は、以下の特性を満たしていなければなりません。

• 表の列の数は、選択ステートメント の結果列の数と同じでなければなりません。
• 表の各列の列属性は、選択ステートメント 内の対応する結果列の列属性と互換性がなければなりません。

マテリアライズ照会表の選択ステートメント には、変更する表の参照、 変更する表に対するビュー、または他のマテリアライズ照会表を含めてはなりません。 マテリアライズ照会表の選択ステートメント を指定することについての詳細は、 CREATE TABLEを参照してください。

refreshable-table-options

基本表をマテリアライズ照会表に変更するためのマテリアライズ照会表オプションを指定します。

DATA INITIALLY DEFERRED

表内のデータを ALTER TABLE ステートメントの一部としてリフレッシュも検証もしないことを指定します。 REFRESH TABLE ステートメントを使用して、マテリアライズ照会表にあるデータが、 その表を基礎とする照会の結果と同じになることを確証できます。

DATA INITIALLY IMMEDIATE

ALTER TABLE ステートメントの処理の一部として、 データを照会の結果から表内に挿入することを指定します。

REFRESH DEFERRED

表内のデータを REFRESH TABLE ステートメントを使用していつでもリフレッシュできるように指定します。 表内のデータは、REFRESH TABLE ステートメントの処理時または最後に更新された時のスナップショットとしての照会の結果のみを反映します。

MAINTAINED BY USER

マテリアライズ照会表がユーザーによって保守されるように指定します。 ユーザーは表に対して INSERT、DELETE、UPDATE、または REFRESH TABLE ステートメントを使用できます。

ENABLE QUERY OPTIMIZATION または DISABLE QUERY OPTIMIZATION

このマテリアライズ照会表を照会の最適化に使用できるかどうかを指定します。

ENABLE QUERY OPTIMIZATION

マテリアライズ照会表を照会最適化に使用できます。

DISABLE QUERY OPTIMIZATION

マテリアライズ照会表は照会最適化に使用されません。それでもその表を直接照会することはできます。

SET refreshable-table-alteration

表を保守する方法、または表を照会最適化に使用するかどうかを変更します。

MAINTAINED BY USER

マテリアライズ照会表がユーザーによって保守されるように指定します。 ユーザーは表に対して INSERT、DELETE、UPDATE、または REFRESH TABLE ステートメントを使用できます。

REFRESH DEFERRED

表内のデータを REFRESH TABLE ステートメントを使用していつでもリフレッシュできるように指定します。 表内のデータは、REFRESH TABLE ステートメントの処理時または最後に更新された時のスナップショットとしての照会の結果のみを反映します。

ENABLE QUERY OPTIMIZATION または DISABLE QUERY OPTIMIZATION

このマテリアライズ照会表を照会の最適化に使用できるかどうかを指定します。

ENABLE QUERY OPTIMIZATION

マテリアライズ照会表を照会最適化に使用できます。

DISABLE QUERY OPTIMIZATION

マテリアライズ照会表は照会最適化に使用されません。それでもその表を直接照会することはできます。

DROP MATERIALIZED QUERY

マテリアライズ照会表を変更して、その表がマテリアライズ照会表ではなくなるようにします。table-name によって指定される表は、マテリアライズ照会表として定義されている必要があります。列の定義は変更されませんが、この表はもはや照会最適化には使用できなくなり、 REFRESH TABLE ステートメントでの使用は無効になります。 表に対する行レベルと列レベルのアクセスは、 現在のアクティブ状態または非アクティブ状態のままになります。

ACTIVATE NOT LOGGED INITIALLY

この現行作業単位に対して表の NOT LOGGED INITIALLY 属性を活動化します。

このステートメントによって変更された表に対して同一作業単位内の INSERT、 DELETE、または UPDATE ステートメントによって行われた変更は、ログ (ジャーナル) に記録されません。

現行作業単位の完了時に NOT LOGGED INITIALLY 属性が非活動化され、後続の作業単位で表に対して行われるすべての操作はログ (ジャーナル) に記録されます。

表名 に対するデータ変更操作が保留中の場合、または表名 を参照するカーソルがコミット下で現在オープン状態である場合、トランザクション内の ACTIVATE NOT LOGGED INITIALLY は許可されません。

表がシステム期間テンポラル表または履歴表の場合、ACTIVATE NOT LOGGED INITIALLY は使用できません。 表に FILE LINK CONTROL が指定された DATALINK 列 がある場合や、表が分離レベル No Commit (NC) で実行されている場合、それは無視されます。

WITH EMPTY TABLE

表に現在あるすべてのデータが除去されます。この ALTER ステートメントが発行された作業単位がロールバックされると、表データは元の状態に戻らなくなります。 このアクションが要求されると、影響を受ける表に定義された DELETE トリガーは起動しません。

マテリアライズ照会表、または参照制約内の親には、WITH EMPTY TABLE を指定することはできません。 表が分離レベル No Commit (NC) を指定されて実行されている場合は、WITH EMPTY TABLE は無視されます。

WHERE 文節を使用しない DELETE ステートメントは一般に ACTIVATE NOT LOGGED INITIALLY WITH EMPTY TABLE と同等以上のパフォーマンスを示すうえ、ROLLBACK を使用して表の行の削除をロールバックすることを可能にします。

ADD PERIOD FOR period-definition

期間定義を表に追加します。

SYSTEM_TIME (begin-column-name, end-column-name)

システム期間を SYSTEM_TIME という名前で定義します。 表内に名前 SYSTEM_TIME の列があってはなりません。表に指定できる SYSTEM_TIME 期間は 1 つのみです。begin-column-name は ROW BEGIN として定義し、end-column-name は ROW END として定義する必要があります。

DROP PERIOD SYSTEM_TIME

SYSTEM_TIME 期間を表からドロップします。 表がシステム期間テンポラル表である場合、期間 SYSTEM_TIME はドロップできません。

ADD VERSIONING USE HISTORY TABLE history-table-name

これを指定すると、表はシステム期間テンポラル表になります。 表はシステム期間テンポラル表かまたは履歴表として既に定義されていてはなりません。表に SYSTEM_TIME 期間とトランザクション開始 ID 列が定義されている必要があります。 表をマテリアライズ照会表および分散表にすることはできません。 また、表に ROWID 列および FILE LINK CONTROL を指定した DATALINK 列が含まれてはなりません。 この表および履歴表で、NOT LOGGED INITIALLY 属性をアクティブにすることはできません。

この表の行の履歴バージョンは、データベース・マネージャーによって保持されます。 関連履歴表は、表の履歴行を保管するために使用されます。データベース・マネージャーは、行が表に挿入された時期とそれが更新または削除された時期を示す追加情報を記録します。 システム期間テンポラル表の行が更新されると、その行の直前のバージョンが保持されます。 システム期間テンポラル表のデータが削除されると、その行の古いバージョンが履歴レコードとして挿入されます。

この表に対する参照には、戻すデータのバージョンを指示する期間指定を含めることができます。

履歴表にデータが含まれている場合、データが履歴行を正確に表すようにしてください。 データが履歴行の結果を正確に表さない場合、テンポラル照会が予期しない結果になる可能性があります。

行アクセス制御または列アクセス制御がシステム期間テンポラル表においてアクティブであるが、行アクセス制御が履歴表でアクティブでない場合、データベース・マネージャーは自動的に、履歴表での行アクセス制御をアクティブにし、デフォルトの行権限を履歴表に作成します。

DROP VERSIONING

表がもはやシステム期間テンポラル表でないことを指定します。 表はシステム期間テンポラル表でなければなりません。この表では、履歴データの記録と保守が行われなくなります。 列の定義および表のデータは変更されませんが、表はシステム期間テンポラル表としては扱われません。 SYSTEM_TIME 期間は保持されます。これ以降、この表を参照する照会では、表の SYSTEM_TIME 期間指定を指定することはできません。 システム期間テンポラル表と、関連する履歴表との関係は解除されます。履歴表はドロップされず、履歴表の内容は影響を受けません。

ACTIVATE ROW ACCESS CONTROL または DEACTIVATE ROW ACCESS CONTROL

有効な行の許可 が表内のアクセス可能な行のセットを制御するために Db2 によって 適用されるかどうかを指定します。

ACTIVATE ROW ACCESS CONTROL

表の行アクセス制御を活動化することを指定します。表が別名である場合は、基本表の行アクセス制御が活動化されます。宣言されたグローバル一時表 または QTEMP 中の表に対して行アクセス制御を活動化することはできません。

有効な行の許可が存在していて、行の許可の定義に指定された 権限 ID またはグループ・プロファイルにアクセス権を認めている場合を除いて、 デフォルトの行の許可が暗黙的に作成され、表のどの列へのアクセスも許可されません。 そのような行の許可がまだ存在していない状態で表を参照する照会では、 表内にデータがないことを示す警告が戻されます。

表に対するトリガーが存在 する場合、そのトリガーは SECURED 属性を指定して定義される 必要があり、READ トリガーであってはなりません。

ビューに関して、NOT SECURED 属性を指定して定義された INSTEAD OF トリガーが存在する場合、 そのビューの定義内で、この表を参照してはなりません。

この表がデータ操作ステートメントで参照されるとき、その表に対して作成されたすべての有効な行権限 (デフォルトの行権限を含む) が Db2 によって適用され、表の中でアクセス可能な行セットが制御されます。 活動化しようとするとエラーになる許可は、 許可定義にあるエラーがすべて解決されるまで活動化 できません。これには、 許可を除去し、変更した定義で再作成することが必要になることがあります。

マテリアライズ照会表が、行レベルのアクセス制御が活動化されている表に (直接的に、またはビューを介して間接的に) 依存しており、そのマテリアライズ照会表の行レベルのアクセス制御がまだ活動化されていない場合、 そのマテリアライズ照会表に対して行レベルのアクセス制御が暗黙的に 活動化されます。これにより、マテリアライズ照会表の内容への直接アクセスが制限されます。 行に対するそのような行権限が定義される前に表を照会で明示的に参照すると、表にデータがないことを示す警告が返されます。 マテリアライズ照会表にアクセスするには、適切な行権限を作成します。またはふさわしいようであれば、マテリアライズ照会表に対する ALTER TABLE DEACTIVATE ROW ACCESS CONTROL を発行して、行レベルの保護を除去します。

この表において行アクセス制御が既にアクティブとして定義されている場合、ACTIVATE ROW ACCESS CONTROL は無視されます。

表がシステム期間テンポラル表で、行アクセス制御が履歴表でまだアクティブでない場合、データベース・マネージャーは自動的に、履歴表での行アクセス制御をアクティブにし、履歴表に対してデフォルトの行権限を作成します。

DEACTIVATE ROW ACCESS CONTROL

表の行アクセス制御を非活動化することを指定します。この表がデータ操作ステートメントで参照されるとき、その表に対して定義された有効な行権限は Db2 によって適用されないため、表の中でアクセス可能な行セットは制御されません。

DEACTIVATE ROW ACCESS CONTROL は、行アクセス制御をこの表に対して活動化しないよう既に定義されている場合は、無視されます。

ACTIVATE COLUMN ACCESS CONTROL または DEACTIVATE COLUMN ACCESS CONTROL

有効な列マスク が、表から戻された列値をマスクするために Db2 によって 適用されるかどうかを指定します。

ACTIVATE COLUMN ACCESS CONTROL

表の列アクセス制御を活動化することを指定します。表が別名である場合は、基本表の列アクセス制御が活動化されます。

表に対するトリガーが存在 する場合、そのトリガーは SECURED 属性を指定して定義される 必要があり、READ トリガーであってはなりません。

ビューに関して、NOT SECURED 属性を指定して定義された INSTEAD OF トリガーが存在する場合、 そのビューの定義内で、この表を参照してはなりません。

表へのアクセスは制限されませんが、 この表がデータ操作ステートメントで参照されるときには、表に対して作成されたすべての有効な列マスク が Db2 によって適用されて、 照会の最終結果表で参照される列について戻される値のマスクや、 データ変更ステートメントで使用される新しい値の判別が行われます。 活動化しようとするとエラーになる列マスクは、 マスク定義にあるエラーがすべて解決されるまで活動化できません。これには、 列マスクを除去し、変更した定義で再作成することが必要になることがあります。

列レベルのアクセス制御が活動化中の表 に依存している (直接的に、またはビューを介して間接的に) マテリアライズ照会表があり、 そのマテリアライズ照会表では行レベルのアクセス制御がまだ活動化されていない場合、 そのマテリアライズ照会表に対して行レベルのアクセス制御が暗黙的に活動化されます。これにより、マテリアライズ照会表の内容への直接アクセスが制限されます。 行に対するそのような行権限が定義される前に表を照会で明示的に参照すると、表にデータがないことを示す警告が返されます。 マテリアライズ照会表にアクセスするには、適切な行権限を作成します。またはふさわしいようであれば、マテリアライズ照会表に対する ALTER TABLE DEACTIVATE ROW ACCESS CONTROL を発行して、行レベルの保護を除去します。

ACTIVATE COLUMN ACCESS CONTROL は、表に対して列アクセス制御を活動化するよう既に定義されている場合は無視されます。

表がシステム期間テンポラル表で、行アクセス制御が履歴表でまだアクティブでない場合、データベース・マネージャーは自動的に、履歴表での行アクセス制御をアクティブにし、履歴表に対してデフォルトの行権限を作成します。

DEACTIVATE COLUMN ACCESS CONTROL

表の列アクセス制御を非活動化することを指定します。表が データ操作ステートメント内で参照されるときに、表に対して定義されている有効な列マスク は Db2 によって適用されず、照会の最終結果表内で参照される列について戻される値が制御されたり、データ変更ステートメント で新しい値が使用可能かどうかが判別されることはありません。

DEACTIVATE COLUMN ACCESS CONTROL は、列アクセス制御をこの表に対して活動化しないよう既に定義されている場合は、無視されます。

VOLATILE または NOT VOLATILE

表表名 のカーディナリティーを実行時に大きく変えることができるかをオプティマイザーに示します。揮発性は表の行数に適用され、表そのものに適用されるわけではありません。 デフォルトは NOT VOLATILE です。

VOLATILE

実行時に表名 のカーディナリティーを空から大規模に大きく変えることができることを指定します。 オプティマイザーは表にアクセスするとき、可能であれば通常は索引を使用します。

NOT VOLATILE

table-name のカーディナリティーが揮発性でないことを指定します。 この表を参照するアクセス・プランは、アクセス・プランが構築された時点の表のカーディナリティーに基づいたものになります。

media-preference

表またはパーティションの優先ストレージ・メディアを指定します。

UNIT ANY

どのストレージ・メディアも優先しません。使用可能なストレージ・メディアであればどのストレージ・メディアからでも表またはパーティションのストレージが割り振られます。表で UNIT ANY を指定すると、パーティションで指定する media-preference が使用されます。現時点で表またはパーティションがソリッド・ステート・ディスクのストレージに存在する場合に、他のメディアが使用可能な状態になっていれば、その表またはパーティションが非同期モードで他のメディアに移動することもあります。

UNIT SSD

ソリッド・ステート・ディスク・ストレージ・メディア を優先します。ソリッド・ステート・ディスクのストレージ・メディアが使用可能になっていれば、そのソリッド・ステート・ディスクのストレージ・メディアから表またはパーティションのストレージが割り振られます。 表で UNIT SSD を指定すると、パーティションで指定する media-preference は無視されます。現時点で表またはパーティションがソリッド・ステート・ディスクのストレージに存在しない場合に、ソリッド・ステート・ディスクのストレージ・メディアが使用可能な状態になっていれば、その表またはパーティションが非同期モードでソリッド・ステート・ディスクのストレージ・メディアに移動することもあります。

memory-preference

KEEP IN MEMORY

表のデータ が照会で使用されるときに、データを主記憶域プールに入れるかどうかを指定します。

NO

データは主記憶域プールに入れられません。

YES

データは主記憶域プールに入れられます。

注

列参照: ALTER TABLE ステートメントの ADD、ALTER、または DROP COLUMN 文節では、1 つの列を 1 回 だけ参照できます。 ただし、同じ ALTER TABLE ステートメント内で制約を追加またはドロップする場合は、同じ列を複数回参照できます。

カスケード効果

列を追加しても、SQL ビュー、マテリアライズ照会表、または大部分の論理ファイルに対するカスケード効果はありません。例えば、表に列を追加しても、従属するビューに列は追加されません (これらのビューが SELECT * 文節を指定して作成された場合でも)。

列を追加しても、その新しい列を組み込むために SQL トリガーが再作成されることはありません。

列アクセス制御の例

例 1: SELECT DISTINCT ステートメントは、CUSTOMER 表にあるデータに基づいて、SALARY 値が 100,000 の行を 1 つ戻します。SALARY 値をマスクするために、列マスク SALARY_MASK が作成されます。CUSTOMER 表の列アクセス制御が活動化されると、SALARY 列に列マスクが適用されます。「MGR」権限 ID を 持つユーザーが SELECT DISTINCT ステートメントを発行します。SELECT DISTINCT ステートメントは、重複の除去は SALARY 列のマスクされない値に基づいているため、依然として 1 つの行を戻しますが、その行で戻される値は、マスクされた SALARY 値 (125,000 か 110,000 のいずれか) に基づきます。

CREATE MASK SALARY_MASK ON CUSTOMER
   FOR COLUMN SALARY RETURN
      CASE WHEN(SESSION_USER = 'MGR')
              THEN SALARY + COMMISSION
           ELSE SALARY
      END
   ENABLE;

COMMIT;

ALTER TABLE CUSTOMER
   ACTIVATE COLUMN ACCESS CONTROL;

COMMIT;

SELECT DISTINCT SALARY FROM CUSTOMER;

例 2: SELECT DISTINCT ステートメントは、T1 表および T2 表のデータに基づき、COALESCE 関数を使用して T1.C1 値が 1 の 1 つの行を戻します。T1.C1 の値をマスクするために列マスク C1_MASK が作成されます。 表 T1 の列アクセス制御が活動化されると、表 T1 の列 C1 に列マスクが適用されます。「EMP」権限 ID を 持つユーザーが SELECT DISTINCT ステートメントを発行します。SELECT DISTINCT ステートメントは、重複の除去は COALESCE 関数からの T1.C1 のマスクされない値に基づいているため、依然として 1 つの行を戻しますが、この行で戻される値は、COALESCE 関数からの T1.C1 のマスクされた値に基づきます。戻される値は、2 または 3 のいずれかです。

INSERT INTO T1(C1) VALUES(1);
INSERT INTO T1(C1) VALUES(1);

INSERT INTO T2(C1) VALUES(2);
INSERT INTO T2(C1) VALUES(3);

CREATE MASK C1_MASK ON T1
   FOR COLUMN C1 RETURN
      CASE WHEN(SESSION_USER = 'EMP')
         THEN NULL
         ELSE C1
      END
   ENABLE;

COMMIT;

ALTER TABLE T1
   ACTIVATE COLUMN ACCESS CONTROL;

COMMIT;

SELECT DISTINCT COALESCE(T1.C1, T2.C1) FROM T1, T2;

例 3: CUSTOMER 表のデータに基づくと、カリフォルニア (CA) とイリノイ (IL) 州の最大収入は同じで、50,000 です。このため、SELECT DISTINCT ステートメントは 1 つの行を戻します。収入値をマスクするために列マスク INCOME_MASK が作成されます。CUSTOMER 表の列アクセス制御が活動化されると、INCOME 列に列マスクが適用され、MAX 集約関数が評価されます。ただし、列マスク INCOME_MASK は、イリノイ州では収入値 0 を 100,000 としてマスクします。このため、イリノイ州では最大収入は 100,000 になりますが、カリフォルニア州の最大収入は 50,000 のままです。SELECT DISTINCT ステートメントの述部で X.B が使用されています。このため、MAX(INCOME) 関数のオリジナルの INCOME 値とオリジナルの結果を保存しておく必要があります。したがって、SELECT DISTINCT ステートメントは依然として 1 つの行を戻しますが、この行の値は deterministic でない場合があります。つまり、この値は 'CA' 行からの 50,000、または 'IL' 行からの 100,000 である場合があります。

CUSTOMER 表は、以下のようになっています。

CREATE MASK INCOME_MASK ON CUSTOMER
   FOR COLUMN INCOME RETURN
      CASE WHEN(INCOME = 0)
         THEN 100000
         ELSE INCOME
      END
   ENABLE;

COMMIT;

ALTER TABLE CUSTOMER
   ACTIVATE COLUMN ACCESS CONTROL;

COMMIT;

SELECT DISTINCT B FROM
   (SELECT STATE, MAX(INCOME) FROM CUSTOMER
      GROUP BY STATE)
      X(A, B)
   WHERE B > 10000;

例 4: 式 INCOME + RAND() は、RAND 関数が非 deterministic 関数であるため、非 deterministic です。SELECT DISTINCT ステートメントは、CUSTOMER 表のデータに基づいて 2 つの特殊行を戻す可能性が高くなります。しかし、1 つの行のみを戻すことがあります。収入値をマスクするために列マスク INCOME_MASK が作成されます。CUSTOMER 表の列アクセス制御が活動化されると、INCOME 列に列マスクが適用されます。これによって、両方の行のマスク値が同じになります。RAND 関数は非 deterministic 関数であるため、SELECT DISTINCT ステートメントは、依然として 2 つの特殊行を戻す可能性が高いですが、1 行のみを戻すことがあります。RAND 関数によって生じた不確実性によって SELECT DISTINCT ステートメントの結果が非 deterministic になります。

CUSTOMER 表は、以下のようになっています。

CREATE MASK INCOME_MASK ON CUSTOMER
   FOR COLUMN INCOME RETURN
      CASE WHEN(INCOME = 40,000)
         THEN 50000
         ELSE INCOME
      END
   ENABLE;

COMMIT;

ALTER TABLE CUSTOMER
   ACTIVATE COLUMN ACCESS CONTROL;

COMMIT;

SELECT DISTINCT A FROM
   (SELECT INCOME + RAND() FROM CUSTOMER)
      X(A)
   WHERE A > 10000;

例 5: 市が SJ、SFO、または OKLD の場合に州と市の名前を示す値を戻すために、CUSTOMER 表の STATE 列に対して列マスク STATE_MASK が作成されます。これ以外の場合、市は戻されず、州のみが戻されます。CUSTOMER 表の列アクセス制御が活動化されると、STATE 列を使用して結果をグループ化する SELECT ステートメントが発行されます。ただし、列マスク STATE_MASK で参照される CITY 列はグループ化列でないため、列マスク STATE_MASK がこのステートメントには適切でないことを示すエラーが戻されます。

CUSTOMER 表は、以下のようになっています。

CREATE MASK STATE_MASK ON CUSTOMER
   FOR COLUMN STATE RETURN
      CASE WHEN(CITY = 'SJ')
          THEN CITY||', '||STATE
        WHEN(CITY = 'SFO')
          THEN CITY||', '||STATE
        WHEN(CITY = 'OKLD')
          THEN CITY||', '||STATE
        ELSE STATE
      END
   ENABLE;

COMMIT;

ALTER TABLE CUSTOMER
   ACTIVATE COLUMN ACCESS CONTROL;

COMMIT;

SELECT STATE, AVG(INCOME) FROM CUSTOMER
   GROUP BY STATE
   HAVING STATE = 'CA';