RDS for Db2 のバッファプールのストアドプロシージャ
このトピックで説明した組み込みのストアドプロシージャは、Amazon RDS for Db2 データベースのバッファプールを管理します。これらのプロシージャを実行する場合、マスターユーザーはまず rdsadmin データベースに接続する必要があります。
これらのストアドプロシージャは、さまざまなタスクで使用されます。これはすべてを網羅したリストではありません。
構文、パラメータ、使用上の注意、例については、以下の組み込みストアドプロシージャを参照してください。
rdsadmin.create_bufferpool
バッファプールを作成します。
構文
db2 "call rdsadmin.create_bufferpool( 'database_name', 'buffer_pool_name',buffer_pool_size, 'immediate', 'automatic',page_size,number_block_pages,block_size)"
パラメータ
以下のパラメータは必須です。
database_name-
コマンドを実行する対象のデータベース名。データ型は
varcharです。 buffer_pool_name-
作成するバッファプールの名前。データ型は
varcharです。
以下のパラメータはオプションです。
buffer_pool_size-
ページ数でのバッファプールのサイズ。データ型は
integerです。デフォルト:-1。 immediate-
コマンドをすぐに実行するかどうかを指定します。データ型は
charです。デフォルト:Y。 automatic-
バッファプールを自動的に設定するかを指定します。データ型は
charです。デフォルト:Y。 page_size-
バッファプールのページサイズ。データ型は
integerです。有効な値は、4096、8192、16384、32768です。デフォルト:8192。 number_block_pages-
バッファプールのブロックページ数。データ型は
integerです。デフォルト:0。 block_size-
ブロックページのブロックサイズ。データ型は
integerです。有効な値:2から256。デフォルト:32。
使用に関する注意事項
バッファプールの作成ステータスを確認する方法については、「rdsadmin.get_task_status」を参照してください。
例
例 1: デフォルトパラメータを使用してバッファプールを作成する
次の例では、デフォルトのパラメータを使用して TESTDB というデータベースに BP8 というバッファプールを作成するため、バッファプールでは 8 KB のページサイズが使用されます。
db2 "call rdsadmin.create_bufferpool( 'TESTDB', 'BP8')"
例 2: 自動割り当てを使用してバッファプールを作成し、すぐに実行する
次の例では、TESTDB という名前のデータベースのために BP16 という名前のバッファプールを作成します。設定は、ページサイズが 16 KB、初期ページ数は 1,000 で、自動と指定しています。Db2 はこのコマンドを直ちに実行します。初期ページ数 -1 を使用すると、Db2 ではページの自動割り当てを使用します。
db2 "call rdsadmin.create_bufferpool( 'TESTDB', 'BP16', 1000, 'Y', 'Y', 16384)"
例 3: ブロックページを使用してバッファプールを作成し、すぐに実行する
次の例では、TESTDB という名前のデータベースのために BP16 という名前のバッファプールを作成します。このバッファプールのページサイズは 16 KB で、初期ページ数は 10,000 ページです。Db2 は、ブロックサイズ 512 の 500 ブロックページを使用して、このコマンドを直ちに実行します。
db2 "call rdsadmin.create_bufferpool( 'TESTDB', 'BP16', 10000, 'Y', 'Y', 16384, 500, 512)"
rdsadmin.alter_bufferpool
バッファプールを変更します。
構文
db2 "call rdsadmin.alter_bufferpool( 'database_name', 'buffer_pool_name',buffer_pool_size, 'immediate', 'automatic',change_number_blocks,number_block_pages,block_size)"
パラメータ
以下のパラメータは必須です。
database_name-
コマンドを実行する対象のデータベース名。データ型は
varcharです。 buffer_pool_name-
変更するバッファプールの名前。データ型は
varcharです。 buffer_pool_size-
ページ数でのバッファプールのサイズ。データ型は
integerです。
以下のパラメータはオプションです。
immediate-
コマンドをすぐに実行するかどうかを指定します。データ型は
charです。デフォルト:Y。 automatic-
バッファプールを自動的に設定するかを指定します。データ型は
charです。デフォルト:N。 change_number_blocks-
バッファプール内のブロックページ数を変更するかどうかを指定します。データ型は
charです。デフォルト:N。 number_block_pages-
バッファプールのブロックページ数。データ型は
integerです。デフォルト:0。 block_size-
ブロックページのブロックサイズ。データ型は
integerです。有効な値:2から256。デフォルト:32。
使用に関する注意事項
バッファプールの変更ステータスを確認する方法については、「rdsadmin.get_task_status」を参照してください。
例
次の例では、TESTDB というデータベースの BP16 というバッファプールを「非自動」に変更し、サイズを 10,000 ページに変更します。Db2 はこのコマンドを直ちに実行します。
db2 "call rdsadmin.alter_bufferpool( 'TESTDB', 'BP16', 10000, 'Y', 'N')"
rdsadmin.drop_bufferpool
バッファプールを削除します。
構文
db2 "call rdsadmin.drop_bufferpool( 'database_name', 'buffer_pool_name'"
パラメータ
以下のパラメータは必須です。
database_name-
バッファプールが属するデータベースの名前。データ型は
varcharです。 buffer_pool_name-
削除するバッファプールの名前。データ型は
varcharです。
使用に関する注意事項
バッファプールの削除ステータスを確認する方法については、「rdsadmin.get_task_status」を参照してください。
例
次の例では、TESTDB というデータベースの BP16 というバッファプールを削除します。
db2 "call rdsadmin.drop_bufferpool( 'TESTDB', 'BP16')"