RENAME

呼び出し

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

権限

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

• 次のシステム権限
  • オブジェクト名を変更する場合、
    • 名前を変更する表、ビュー、または索引に対する *OBJMGT システム権限。
    • 名前を変更する表、ビュー、または索引が入っているスキーマに対する USAGE 特権。
  • オブジェクトのシステム名を変更する場合、
    • 名前を変更する表、ビュー、または索引に対する *OBJMGT システム権限。
    • 名前を変更する表、ビュー、または索引が入っているスキーマに対する USAGE 特権および *UPD システム権限。
• データベース管理者権限

説明

TABLE table-name または view-name

名前の変更をする表またはビューを示します。table-name または view-name は、 現行サーバーにある表またはビューを示すものでなければなりません。しかし、カタログ表または宣言済み一時表を示すものであってはなりません。 指定された名前が別名であっても構いません。指定した表またはビューは、新しい名前に変更されます。 その表あるいはビューに関する特権、制約、索引、トリガー、ビュー、および論理ファイルはすべてそのままの状態に保持されます。

該当の表あるいはビューを参照するアクセス・プランはいずれも、 そのアクセス・プランを使用するプログラムが次回実行される時に再度暗黙的に準備されます。 プログラムは元の名前で表あるいはビューを参照するので、その時に元の名前の表あるいはビューが存在しない場合、 エラーが戻されます。

INDEX index-name

名前を変更する索引を示します。この索引名 は、現行サーバーに存在している索引を示すものでなければなりません。指定した索引は、 新しい名前に変更されます。

この索引を参照するアクセス・プランは、名前変更によって影響は受けません。

target-identifier

それぞれ、表、ビュー、索引の新しい表名、ビュー名、索引名 を 示します。target-identifier は、現行サーバーに既に存在する表、ビュー、別名、または索引と同一であってはなりません。target-identifier は、非修飾 SQL ID でなければなりません。

SYSTEM NAME system-object-identifier

それぞれ、表、ビュー、索引の、新しいシステム・オブジェクト ID を示します。 システム・オブジェクト ID は、現行サーバーに 既に存在する表、ビュー、別名、または索引と同一であってはなりません。 システム・オブジェクト ID は、非修飾システム ID でなければなりません。

オブジェクトの名前とオブジェクトのシステム名が同一であり、 target-identifier が指定されていない場合、 system-object-identifier を指定すると、 それが新規の名前およびシステム・オブジェクト名になります。 それ以外の場合には、システム・オブジェクト ID の指定は、オブジェクトのシステム名だけに影響を与え、オブジェクトの名 前には影響を与えません。

target-identifier と system-object-identifier の両方が指定されている場合、両方を有効なシステム・オブジェクト名にすることはできません。

注

ステートメントの効果: 指定した表、ビュー、または索引が新しい名前に変更されます。名前変更された表では、その表のすべての特権と索引が保持されます。 名前変更された索引では、すべての特権が保持されます。

例

例 1: EMPLOYEE 表の名前を CURRENT_EMPLOYEES に変更します。