ALTER NICKNAME ステートメント

ALTER NICKNAME ステートメントは、データ・ソース・オブジェクト (表、 ビュー、またはファイルなど) に関連したニックネーム情報を変更します。

このステートメントは、以下の方法でフェデレーテッド・データベースに保管されている情報を変更します。
  • データ・ソース・オブジェクトの列のローカル列名を変更する
  • データ・ソース・オブジェクトの列のローカル・データ・タイプを変更する
  • ニックネーム・オプションおよび列オプションを追加、設定、またはドロップする
  • 主キーを追加またはドロップする
  • 1 つ以上のユニーク制約、参照制約、またはチェック制約を追加またはドロップする
  • 1 つ以上の参照制約属性またはチェック制約属性を変更する
  • フェデレーテッド・サーバーでのデータのキャッシングを変更する

呼び出し

このステートメントは、アプリケーション・プログラムに組み込んだり、動的 SQL ステートメントを使用して発行したりすることができます。 これは、DYNAMICRULES の実行動作がパッケージに効力を持つ場合にのみ、動的に準備できる実行可能ステートメントです (SQLSTATE 42509)。

許可

ステートメントの許可 ID によって保持されている特権には、少なくとも以下のいずれかの権限が含まれていなければなりません。

  • ステートメントで指定したニックネームに対する ALTER 特権
  • ステートメントで指定したニックネームに対する CONTROL 特権
  • スキーマに対する ALTERIN 特権 (ニックネームのスキーマ名が存在する場合)。
  • スキーマに対する SCHEMAADM 権限 (ニックネームのスキーマ名が存在する場合)
  • SYSCAT.TABLES カタログ・ビューの OWNER 列に記録されているそのニックネームの所有者
  • DBADM 権限

構文

構文図を読む構文図をスキップするALTER NICKNAMEnicknameOPTIONS(,ADDSETnickname-option-namestring-constantDROP nickname-option-name)ALTERCOLUMNcolumn-name1,LOCAL NAMEcolumn-nameLOCAL TYPElocal-data-typefederated-column-options2ADDunique-constraintreferential-constraintcheck-constraintALTERFOREIGN KEYCHECKconstraint-nameconstraint-alterationDROPPRIMARY KEYFOREIGN KEYUNIQUECHECKCONSTRAINTconstraint-nameALLOW CACHINGDISALLOW CACHING
注:
  • 1 ALTER COLUMN 節と、ADD、ALTER、または DROP インフォメーショナル制約節との両方を同じ ALTER NICKNAME ステートメント内に指定することはできません。
  • 2 LOCAL NAME パラメーターまたは LOCAL TYPE パラメーター、 あるいはその両方にフェデレーテッド列オプション (federated-column-options) 節を指定する必要がある場合、 この federated-column-options 節は最後に指定しなければなりません。

説明

nickname
変更される列を含むデータ・ソース・オブジェクト (表、ビュー、 またはファイルなど) のニックネームを指定します。 ニックネームはカタログに記述されている必要があります。
OPTIONS
ニックネームを変更したときに追加、設定、またはドロップされるニックネーム・オプションを指示します。
ADD
ニックネーム・オプションを追加します。
SET
ニックネーム・オプションの設定を変更します。
nickname-option-name
追加または設定するニックネーム・オプション。 指定可能なオプションは、ニックネームの作成対象オブジェクトのデータ・ソースによって異なります。 データ・ソースとそれぞれに当てはまるニックネーム・オプションのリストについては、データ・ソース・オプションを参照してください。
string-constant
単一引用符で囲まれた文字ストリング定数として設定するニックネーム・オプション。
DROP nickname-option-name
ニックネーム・オプションをドロップします。
ALTER COLUMN column-name
変更する列を指定します。 column-name は、フェデレーテッド・サーバーでのデータ・ソースにある表またはビューの列の、 現在の名前です。 column-name は、ニックネームの既存の列を指定するものでなければなりません (SQLSTATE 42703)。 同一の ALTER NICKNAME ステートメントで、同じ列名を複数回は参照できません (SQLSTATE 42711)。
LOCAL NAME column-name
変更された列を参照するフェデレーテッド・サーバーによって指定される新しい名前は column-name です。 新しい名前を修飾したり、ニックネームの複数の列に対して同じ名前を使用することはできません (SQLSTATE 42711)。
LOCAL TYPE local-data-type
変更する列のデータ・タイプをマップする、新しいローカル・データ・タイプを指定します。 新しいタイプは local-data-type に示されます。

一部のラッパーは、SQL データ・タイプのサブセットのみをサポートします。 特定のデータ・タイプの説明は、CREATE TABLE ステートメントの説明を参照してください。

built-in-type
組み込みデータ・タイプの説明については、『CREATE TABLE』を参照してください。
ADD unique-constraint
ユニーク制約を定義します。 『CREATE NICKNAME』ステートメントの説明を参照してください。
ADD referential-constraint
参照制約を定義します。 『CREATE NICKNAME』ステートメントの説明を参照してください。
ADD check-constraint
チェック制約を定義します。『CREATE NICKNAME』ステートメントの説明を参照してください。
ALTER FOREIGN KEY constraint-name
参照制約 constraint-name の制約属性を変更します。 制約属性の説明については、「CREATE NICKNAME」ステートメントを参照してください。 constraint-name は既存の参照制約を指定する必要があります (SQLSTATE 42704)。
ALTER CHECK constraint-name
チェック制約 constraint-name の制約属性を変更します。 constraint-name には既存のチェック制約を指定する必要があります (SQLSTATE 42704)。
constraint-alteration
参照制約またはチェック制約に関連付けられた属性の変更のオプションを指定します。
ENABLE QUERY OPTIMIZATION
適切な状況下では、制約を照会最適化に使用することができます。
DISABLE QUERY OPTIMIZATION
制約を照会の最適化に使用できません。
NOT ENFORCED
挿入、更新、削除などの通常の操作中に、 データベース・マネージャーによって制約が課せられないことを指定します。
TRUSTED
データは、制約に適合しているものとして信頼できます。 TRUSTED は、表のデータが個別に制約に適合していることが分かっている場合のみに使用してください。データが実際には制約に適合していない場合、照会結果が予測不能になる可能性があります。これはデフォルト・オプションです。
NOT TRUSTED
データは、制約に適合しているものとして信頼することはできません。 NOT TRUSTED の使用目的としては、データがほとんどの行では制約に適合しているものの、すべての行または将来追加される行が制約に適合することは個別には認識されない場合のためのものです。 制約が NOT TRUSTED で、照会最適化においてこれが有効になっている場合、その制約に完全に適合するデータに依存するような最適化は実行されません。 NOT TRUSTED は、参照整合性制約のみにしか指定できません (SQLSTATE 42613)。
DROP PRIMARY KEY
主キーの定義、およびその主キーに従属するすべての参照制約をドロップします。 ニックネームには主キーがなければなりません。
DROP FOREIGN KEY constraint-name
制約名が constraint-name の参照制約をドロップします。 constraint-name には、 ニックネームに定義されている既存の参照制約を指定する必要があります。
DROP UNIQUE constraint-name
ユニーク制約 constraint-name の定義、 およびこのユニーク制約に従属するすべての参照制約をドロップします。 constraint-name には、既存のユニーク制約を指定する必要があります。
DROP CHECK constraint-name
制約名が constraint-name のチェック制約をドロップします。 constraint-name には、 ニックネームに定義されている既存のチェック制約を指定する必要があります。
DROP CONSTRAINT constraint-name
制約名が constraint-name の制約をドロップします。 constraint-name には、ニックネームに定義されている既存のチェック制約、 参照制約、主キー、またはユニーク制約のいずれかを指定する必要があります。
ALLOW CACHING または DISALLOW CACHING
マテリアライズ照会表を定義する照会でニックネームを参照できるかどうか指定します。 これは、フェデレーテッド・サーバーでデータ・ソースからのデータをキャッシュに入れるために使用できます。
ALLOW CACHING
マテリアライズ照会表を定義する照会でニックネームを参照できることを指定します。これにより、フェデレーテッド・サーバーのマテリアライズ照会表で、データ・ソースからのデータをキャッシュに入れることができます。 マテリアライズ照会表に対して定義されるリフレッシュ可能オプションは、マテリアライズ照会表のキャッシュ・データを保守する方法を指定します。
DISALLOW CACHING
マテリアライズ照会表を定義する照会でニックネームを参照できないことを指定します。 DISALLOW CACHING は、マテリアライズ照会表の定義の全選択で参照されるニックネームに対して指定できません (SQLSTATE 42917)。

規則

  • ニックネームがビュー、SQL メソッド、または SQL 関数に使用されている場合、 またはそれらにインフォメーショナル制約が定義されている場合、 そのニックネーム内の列のローカル名やデータ・タイプを変更するために、 ALTER NICKNAME ステートメントを使用することはできません (SQLSTATE 42893)。 しかし、列オプション、ニックネーム・オプション、またはインフォメーショナル制約を追加、 設定、またはドロップするときには、このステートメントを使えます。
  • ニックネームがマテリアライズ照会表定義によって参照されている場合、 ローカル名、データ・タイプ、列オプション、またはニックネーム・オプションを変更するために、 ALTER NICKNAME ステートメントを使用することはできません (SQLSTATE 42893)。 さらに、キャッシングを使用不可にするためにこのステートメントを使用することはできません (SQLSTATE 42917)。 しかし、インフォメーショナル制約を追加、変更、またはドロップするときには、このステートメントを使えます。
  • 列オプションは、 同じ ALTER NICKNAME ステートメントに複数回指定することはできません (SQLSTATE 42853)。 列オプションを使用可能にする、リセットする、あるいはドロップする場合、 使用中の他の列オプションには影響はありません。
  • 所定の作業単位 (UOW) 内の ALTER NICKNAME ステートメントは、以下のいずれかの条件の下では処理できません (SQLSTATE 55007)。
    • このステートメントで参照されているニックネームには、同じ UOW 内でオープンされているカーソルがある。
    • このステートメントで参照されているニックネームに対して、 同じ UOW 内で既に INSERT、DELETE、または UPDATE ステートメントのいずれかが出されている。

注

  • ALTER NICKNAME ステートメントを使用して ニックネームの列のローカル名を変更する場合、 その列に対する照会ではその名前を新しい名前で参照する必要があります。
  • 列のデータ・タイプのローカル仕様を変更すると、データベース・マネージャーは、 その列に関して収集されたすべての統計 (HIGH2KEY、LOW2KEY、など) を無効にします。
  • キャッシング・オブジェクトおよび保護オブジェクト: データ・ソース・オブジェクトが保護されたニックネームには、DISALLOW CACHING を指定してください。 これにより、ニックネームが使用されるたび、照会の実行時に適切な許可 ID のデータがデータ・ソースから戻されるようになります。 これは、フェデレーテッド・サーバーのマテリアライズ照会表の定義でのニックネームの使用を制限することによって行えます。ニックネーム・データをキャッシュに入れるためにそれが使用されている可能性があります。
  • フェデレーテッド・システムでは、BINARY と VARBINARY のタイプはサポートされていません。

例

  1. Oracle 表において、データ・タイプが VARCHAR の列には、末尾ブランクがないことを示します。この表のニックネームは NICK2 で、この列のローカル名は COL1 です。 
       
   ALTER NICKNAME NICK2
     ALTER COLUMN COL1
     OPTIONS (ADD VARCHAR_NO_TRAILING_BLANKS 'Y')
  2. ニックネーム DRUGDATA1 の表構造化ファイル drugdata1.txt の 完全修飾パスを変更します。FILE_PATH ニックネーム・オプションを使用して、 パスを現行値 '/user/pat/drugdata1.txt' から '/usr/kelly/data/drugdata1.txt' に変更します。
       
   ALTER NICKNAME DRUGDATA1
     OPTIONS (SET FILE_PATH '/usr/kelly/data/drugdata1.txt')