# RDS for Db2 のバッファプールのストアドプロシージャ
<a name="db2-sp-managing-buffer-pools"></a>

このトピックで説明した組み込みのストアドプロシージャは、Amazon RDS for Db2 データベースのバッファプールを管理します。これらのプロシージャを実行する場合、マスターユーザーはまず `rdsadmin` データベースに接続する必要があります。

これらのストアドプロシージャは、さまざまなタスクで使用されます。これはすべてを網羅したリストではありません。
+ [バッファプールの一般的なタスク](db2-managing-buffer-pools.md)
+ [パフォーマンスレポートの生成](db2-managing-databases.md#db2-generating-performance-reports)
+ [db2look を使用してデータベースメタデータをコピーする](db2-native-db2-tools-db2look.md)
+ [IBM Db2 Data Management Console 用のリポジトリデータベースの作成](db2-connecting-with-ibm-data-management-console.md#db2-creating-repo-db-monitoring-dmc)

構文、パラメータ、使用上の注意、例については、以下の組み込みストアドプロシージャを参照してください。

**Topics**
+ [rdsadmin.create\$1bufferpool](#db2-sp-create-buffer-pool)
+ [rdsadmin.alter\$1bufferpool](#db2-sp-alter-buffer-pool)
+ [rdsadmin.drop\$1bufferpool](#db2-sp-drop-buffer-pool)

## rdsadmin.create\$1bufferpool
<a name="db2-sp-create-buffer-pool"></a>

バッファプールを作成します。

### 構文
<a name="db2-sp-create-buffer-pool-syntax"></a>

```
db2 "call rdsadmin.create_bufferpool(
    'database_name', 
    'buffer_pool_name', 
    buffer_pool_size, 
    'immediate', 
    'automatic', 
    page_size, 
    number_block_pages, 
    block_size)"
```

### パラメータ
<a name="db2-sp-create-buffer-pool-parameters"></a>

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

*database\$1name*  
コマンドを実行する対象のデータベース名。データ型は `varchar` です。

*buffer\$1pool\$1name*  
作成するバッファプールの名前。データ型は `varchar` です。

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

*buffer\$1pool\$1size*  
ページ数でのバッファプールのサイズ。データ型は `integer` です。デフォルトは `-1` です。

*immediate*  
コマンドをすぐに実行するかどうかを指定します。データ型は `char` です。デフォルトは `Y` です。

*automatic*  
バッファプールを自動的に設定するかを指定します。データ型は `char` です。デフォルトは `Y` です。

*page\$1size*  
バッファプールのページサイズ。データ型は `integer` です。有効な値は、`4096`、`8192`、`16384`、`32768` です。デフォルトは `8192` です。

*number\$1block\$1pages*  
バッファプールのブロックページ数。データ型は `integer` です。デフォルトは `0` です。

*block\$1size*  
ブロックページのブロックサイズ。データ型は `integer` です。有効な値: `2` から `256`。デフォルトは `32` です。

### 使用に関する注意事項
<a name="db2-sp-create-buffer-pool-usage-notes"></a>

バッファプールの作成ステータスを確認する方法については、「[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status)」を参照してください。

### 例
<a name="db2-sp-create-buffer-pool-examples"></a>

**例 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\$1bufferpool
<a name="db2-sp-alter-buffer-pool"></a>

バッファプールを変更します。

### 構文
<a name="db2-sp-alter-buffer-pool-syntax"></a>

```
db2 "call rdsadmin.alter_bufferpool(
    'database_name', 
    'buffer_pool_name', 
    buffer_pool_size, 
    'immediate', 
    'automatic', 
    change_number_blocks, 
    number_block_pages, 
    block_size)"
```

### パラメータ
<a name="db2-sp-alter-buffer-pool-parameters"></a>

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

*database\$1name*  
コマンドを実行する対象のデータベース名。データ型は `varchar` です。

*buffer\$1pool\$1name*  
変更するバッファプールの名前。データ型は `varchar` です。

*buffer\$1pool\$1size*  
ページ数でのバッファプールのサイズ。データ型は `integer` です。

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

*immediate*  
コマンドをすぐに実行するかどうかを指定します。データ型は `char` です。デフォルトは `Y` です。

*automatic*  
バッファプールを自動的に設定するかを指定します。データ型は `char` です。デフォルトは `N` です。

*change\$1number\$1blocks*  
バッファプール内のブロックページ数を変更するかどうかを指定します。データ型は `char` です。デフォルトは `N` です。

*number\$1block\$1pages*  
バッファプールのブロックページ数。データ型は `integer` です。デフォルトは `0` です。

*block\$1size*  
ブロックページのブロックサイズ。データ型は `integer` です。有効な値: `2` から `256`。デフォルトは `32` です。

### 使用に関する注意事項
<a name="db2-sp-alter-buffer-pool-usage-notes"></a>

バッファプールの変更ステータスを確認する方法については、「[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status)」を参照してください。

### 例
<a name="db2-sp-alter-buffer-pool-examples"></a>

次の例では、`TESTDB` というデータベースの `BP16` というバッファプールを「非自動」に変更し、サイズを 10,000 ページに変更します。Db2 はこのコマンドを直ちに実行します。

```
db2 "call rdsadmin.alter_bufferpool(
    'TESTDB',
    'BP16', 
    10000, 
    'Y', 
    'N')"
```

## rdsadmin.drop\$1bufferpool
<a name="db2-sp-drop-buffer-pool"></a>

バッファプールを削除します。

### 構文
<a name="db2-sp-drop-buffer-pool-syntax"></a>

```
db2 "call rdsadmin.drop_bufferpool(
    'database_name', 
    'buffer_pool_name'"
```

### パラメータ
<a name="db2-sp-drop-buffer-pool-parameters"></a>

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

*database\$1name*  
バッファプールが属するデータベースの名前。データ型は `varchar` です。

*buffer\$1pool\$1name*  
削除するバッファプールの名前。データ型は `varchar` です。

### 使用に関する注意事項
<a name="db2-sp-drop-buffer-pool-usage-notes"></a>

バッファプールの削除ステータスを確認する方法については、「[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status)」を参照してください。

### 例
<a name="db2-sp-drop-buffer-pool-examples"></a>

次の例では、`TESTDB` というデータベースの `BP16` というバッファプールを削除します。

```
db2 "call rdsadmin.drop_bufferpool(
    'TESTDB',
    'BP16')"
```