RDS for Db2 のテーブルスペースのストアドプロシージャ

以下のストアドプロシージャでは、Amazon RDS for Db2 データベースのテーブルスペースを管理します。これらのプロシージャを実行する場合、マスターユーザーはまず rdsadmin データベースに接続する必要があります。

rdsadmin.create_tablespace

テーブルスペースを作成します。

構文

db2 "call rdsadmin.create_tablespace(
    'database_name', 
    'tablespace_name',
    'buffer_pool_name', 
    tablespace_page_size,
    tablespace_initial_size, 
    tablespace_increase_size, 
    'tablespace_type')"

パラメータ

以下のパラメータは必須です。

以下のパラメータはオプションです。

使用に関する注意事項

RDS for Db2 は常にデータ用の大規模なデータベースを作成します。

テーブルスペースの作成ステータスを確認する方法については、「rdsadmin.get_task_status」を参照してください。

例

次の例では、SP8 という名前のテーブルスペースを作成し、TESTDB という名前のデータベースに BP8 という名前のバッファプールを割り当てます。このテーブルスペースでは、初期テーブルスペースページサイズは 4,096 バイト、初期テーブルスペースは 1,000 KB、テーブルサイズの増加は 50% に設定されています。

db2 "call rdsadmin.create_tablespace(
    'TESTDB',
    'SP8',
    'BP8',
    4096,
    1000,
    50)"

次の例では、SP8 という名前の一時テーブルスペースを作成します。TESTDB というデータベースに対して、サイズが 8 KiB の BP8 というバッファプールを割り当てます。

db2 "call rdsadmin.create_tablespace(
    'TESTDB',
    'SP8',
    'BP8', 
    8192, 
    NULL, 
    NULL, 
    'T')"

rdsadmin.alter_tablespace

テーブルスペースを変更します。

構文

db2 "call rdsadmin.alter_tablespace(
    'database_name', 
    'tablespace_name', 
    'buffer_pool_name', 
    tablespace_increase_size, 
    'max_size', 
    'reduce_max', 
    'reduce_stop', 
    'reduce_value', 
    'lower_high_water', 
    'lower_high_water_stop', 
    'switch_online')"

パラメータ

以下のパラメータは必須です。

以下のパラメータはオプションです。

使用に関する注意事項

オプションパラメータ reduce_max、reduce_stop、reduce_value、lower_high_water、lower_high_water_stop、switch_online は、相互に排他的です。rdsadmin.alter_tablespace コマンドで、buffer_pool_name などの他のオプションパラメータと組み合わせることはできません。これらのパラメータを rdsadmin.alter_tablespace コマンドの他のオプションパラメータと組み合わせると、rdsadmin.get_task_status を実行する際に Db2 は次のようなエラーを返します。

DB21034E  The command was processed as an SQL statement because it was not a valid Command Line Processor command.  During SQL processing it returned:
SQL1763N  Invalid ALTER TABLESPACE statement for table space "TBSP_TEST" due to reason "12"

テーブルスペースの変更ステータスを確認する方法については、「rdsadmin.get_task_status」を参照してください。

例

次の例では、SP8 というテーブルスペースを変更し、BP8 というデータベースに TESTDB というバッファプールを割り当てて、ハイウォーターマークを下げます。

db2 "call rdsadmin.alter_tablespace(
    'TESTDB',
    'SP8',
    'BP8', 
    NULL, 
    NULL, 
    'Y')"

次の例では、データベース TBSP_TEST の TESTDB というテーブルスペースで REDUCE MAX コマンドを実行します。

db2 "call rdsadmin.alter_tablespace(
    'TESTDB',
    'TBSP_TEST',
    NULL,
    NULL,
    NULL,
    'Y')"

次の例では、データベース TBSP_TEST の TESTDB というテーブルスペースで REDUCE STOP コマンドを実行します。

db2 "call rdsadmin.alter_tablespace(
    'TESTDB',
    'TBSP_TEST',
    NULL,
    NULL,
    NULL,
    NULL,
    'Y')"

rdsadmin.rename_tablespace

テーブルスペース名を変更します。

構文

db2 "call rdsadmin.rename_tablespace(
    ?,
    'database_name', 
    'source_tablespace_name',
    'target_tablespace_name')"

パラメータ

以下のパラメータは必須です。

使用に関する注意事項

テーブルスペースの名前変更ステータスを確認する方法については、「rdsadmin.get_task_status」を参照してください。

rdsadmin データベースに属するテーブルスペースの名前を変更することはできません。

例

次の例は、TESTDB というデータベース内の SP8 という名前のテーブルスペースを SP9 に変更します。

db2 "call rdsadmin.rename_tablespace(
    ?,
    'TESTDB',
    'SP8'.
    'SP9')"

rdsadmin.drop_tablespace

テーブルスペースを削除します。

構文

db2 "call rdsadmin.drop_tablespace(
    'database_name', 
    'tablespace_name')"

パラメータ

以下のパラメータは必須です。

使用に関する注意事項

テーブルスペースの削除ステータスを確認する方法については、「rdsadmin.get_task_status」を参照してください。

例

次の例では、TESTDB というデータベースの SP8 というテーブルスペースを削除します。

db2 "call rdsadmin.drop_tablespace(
    'TESTDB',
    'SP8')"