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',
    'tablespace_prefetch_size')"

パラメータ

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

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

使用に関する注意事項

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

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

例

例 1: テーブルスペースを作成してバッファプールを割り当てる

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

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

例 2: 一時テーブルスペースを作成してバッファプールを割り当てる

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

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

例 3: テーブルスペースを作成し、プリフェッチページサイズを割り当てる

次の例では、TESTDB というデータベースの SP8 というテーブルスペースを作成します。テーブルスペースの初期テーブルスペース増加サイズは 50、プリフェッチページサイズは 800 です。

db2 "call rdsadmin.create_tablespace(
    'TESTDB',
    'SP8',
    NULL,
    NULL,
    NULL,
    50,
    NULL,
    '800')"

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',
    'tablespace_prefetch_size')"

パラメータ

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

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

使用に関する注意事項

ストアドプロシージャを呼び出す前に、以下の考慮事項を確認してください。

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

ストアドプロシージャを呼び出すときに返されるエラーメッセージについては、「ストアドプロシージャエラー」を参照してください。

例

例 1: ハイウォーターマークを下げる

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

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

例 2: ハイウォーターマークを減らす

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

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

例 3: コマンドを中断して高いウォーターマークを減らす

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

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

例 4: 既存のプリフェッチページサイズの変更

次の例では、TSBP_TEST というテーブルスペースに対して 64 コマンドを実行し、既存のプリフェッチページサイズを ALTER TABLESPACE SWITCH ONLINE に変更します。

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

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')"