# Procedimentos armazenados para grupos de buffer do RDS para Db2
<a name="db2-sp-managing-buffer-pools"></a>

Os procedimentos armazenados integrados descritos neste tópico gerenciam pools de buffer para bancos de dados do Amazon RDS para Db2. Para executar esses procedimentos, o usuário principal deve primeiro se conectar ao banco de dados `rdsadmin`. 

Esses procedimentos armazenados são usados em diversas tarefas. Essa lista não é exaustiva.
+ [Tarefas comuns para grupos de buffer](db2-managing-buffer-pools.md)
+ [Gerar relatórios de performance](db2-managing-databases.md#db2-generating-performance-reports)
+ [Cópia de metadados do banco de dados com db2look](db2-native-db2-tools-db2look.md)
+ [Criação de um banco de dados de repositório para IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md#db2-creating-repo-db-monitoring-dmc)

Consulte os seguintes procedimentos integrados armazenados para obter informações sobre sintaxe, parâmetros, notas de uso e exemplos.

**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>

Cria um grupo de buffers.

### Sintaxe
<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)"
```

### Parâmetros
<a name="db2-sp-create-buffer-pool-parameters"></a>

Os seguintes parâmetros são obrigatórios:

*database\$1name*  
O nome do banco de dados no qual executar o comando. O tipo de dados é `varchar`.

*buffer\$1pool\$1name*  
O nome do grupo de buffers a ser criado. O tipo de dados é `varchar`.

Os seguintes parâmetros são opcionais:

*buffer\$1pool\$1size*  
O tamanho do grupo de buffers em número de páginas. O tipo de dados é `integer`. O padrão é `-1`.

*immediate*  
Especifica se o comando é executado imediatamente. O tipo de dados é `char`. O padrão é `Y`.

*automatic*  
Especifica se o grupo de buffers deve ser definido como automático. O tipo de dados é `char`. O padrão é `Y`.

*page\$1size*  
O tamanho da página do grupo de buffers. O tipo de dados é `integer`. Valores válidos: `4096`, `8192`, `16384`, `32768`. O padrão é `8192`.

*number\$1block\$1pages*  
O tamanho de páginas de blocos nos grupos de buffers. O tipo de dados é `integer`. O padrão é `0`.

*block\$1size*  
O tamanho do bloco para as páginas de blocos. O tipo de dados é `integer`. Valores válidos: `2` a `256`. O padrão é `32`.

### Observações de uso
<a name="db2-sp-create-buffer-pool-usage-notes"></a>

Para ter informações sobre como conferir o status de criação de um grupo de buffers, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

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

**Exemplo 1: criação de um pool de buffer com parâmetros padrão**

O exemplo a seguir cria um grupo de buffers chamado `BP8` para um banco de dados chamado `TESTDB` com parâmetros padrão, de forma que o grupo de buffers use um tamanho de página de 8 KB. 

```
db2 "call rdsadmin.create_bufferpool(
    'TESTDB', 
    'BP8')"
```

**Exemplo 2: criação de um pool de buffer para execução imediata com alocação automática**

O exemplo a seguir cria um grupo de buffers chamado `BP16` para um banco de dados chamado `TESTDB` que usa um tamanho de página de 16 KB com uma contagem inicial de páginas de 1.000 e é definido como automático. O Db2 executa o comando imediatamente. Se você usar uma contagem inicial de páginas de -1, o Db2 usará a alocação automática de páginas.

```
db2 "call rdsadmin.create_bufferpool(
    'TESTDB', 
    'BP16', 
    1000, 
    'Y', 
    'Y', 
    16384)"
```

**Exemplo 3: criação de um pool de buffer para execução imediata usando páginas em bloco**

O exemplo a seguir cria um grupo de buffers chamado `BP16` para um banco de dados chamado `TESTDB`. Esse grupo de buffer tem um tamanho de página de 16 KB com uma contagem inicial de páginas de 10.000. O Db2 executa o comando imediatamente usando 500 páginas de bloco com um tamanho de bloco de 512.

```
db2 "call rdsadmin.create_bufferpool(
    'TESTDB', 
    'BP16',
    10000, 
    'Y', 
    'Y', 
    16384, 
    500, 
    512)"
```

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

Altera um grupo de buffers.

### Sintaxe
<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)"
```

### Parâmetros
<a name="db2-sp-alter-buffer-pool-parameters"></a>

Os seguintes parâmetros são obrigatórios:

*database\$1name*  
O nome do banco de dados no qual executar o comando. O tipo de dados é `varchar`.

*buffer\$1pool\$1name*  
O nome do grupo de buffers a ser alterado. O tipo de dados é `varchar`.

*buffer\$1pool\$1size*  
O tamanho do grupo de buffers em número de páginas. O tipo de dados é `integer`.

Os seguintes parâmetros são opcionais:

*immediate*  
Especifica se o comando é executado imediatamente. O tipo de dados é `char`. O padrão é `Y`.

*automatic*  
Especifica se o grupo de buffers deve ser definido como automático. O tipo de dados é `char`. O padrão é `N`.

*change\$1number\$1blocks*  
Especifica se há uma alteração no número de páginas de blocos no grupo de buffers. O tipo de dados é `char`. O padrão é `N`.

*number\$1block\$1pages*  
O tamanho de páginas de blocos nos grupos de buffers. O tipo de dados é `integer`. O padrão é `0`.

*block\$1size*  
O tamanho do bloco para as páginas de blocos. O tipo de dados é `integer`. Valores válidos: `2` a `256`. O padrão é `32`.

### Observações de uso
<a name="db2-sp-alter-buffer-pool-usage-notes"></a>

Para ter informações sobre como conferir o status de alteração de um grupo de buffers, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

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

O exemplo a seguir altera um grupo de buffers chamado `BP16` para um banco de dados chamado `TESTDB` para não automático e altera o tamanho para 10.000 páginas. O Db2 executa o comando imediatamente. 

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

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

Descarta um grupo de buffers.

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

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

### Parâmetros
<a name="db2-sp-drop-buffer-pool-parameters"></a>

Os seguintes parâmetros são obrigatórios:

*database\$1name*  
O nome do banco de dados ao qual o grupo de buffers pertence. O tipo de dados é `varchar`.

*buffer\$1pool\$1name*  
O nome do grupo de buffers a ser descartado. O tipo de dados é `varchar`.

### Observações de uso
<a name="db2-sp-drop-buffer-pool-usage-notes"></a>

Para ter informações sobre como conferir o status de descarte de um grupo de buffers, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

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

O exemplo a seguir descarta um grupo de buffers denominado `BP16` para um banco de dados chamado `TESTDB`.

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