Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Stored procedure relative a pool di buffer per RDS per Db2
<a name="db2-sp-managing-buffer-pools"></a>

Le stored procedure integrate descritte in questo argomento gestiscono i pool di buffer per i database Amazon RDS per Db2. Per eseguire queste procedure, l’utente master deve prima connettersi al database `rdsadmin`. 

Queste stored procedure vengono utilizzate in diverse attività. L'elenco non è completo.
+ [Attività comuni per i pool di buffer](db2-managing-buffer-pools.md)
+ [Generazione di report sulle prestazioni](db2-managing-databases.md#db2-generating-performance-reports)
+ [Copia dei metadati del database con db2look](db2-native-db2-tools-db2look.md)
+ [Creazione di un database di repository per IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md#db2-creating-repo-db-monitoring-dmc)

Fai riferimento alle seguenti stored procedure integrate per informazioni sulla sintassi, i parametri, le note per l’utilizzo e gli esempi.

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

Crea un pool di buffer.

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

### Parameters
<a name="db2-sp-create-buffer-pool-parameters"></a>

I parametri seguenti sono obbligatori:

*database\$1name*  
Il nome del database su cui eseguire il comando. Il tipo di dati è `varchar`.

*buffer\$1pool\$1name*  
Il nome del pool di buffer da creare. Il tipo di dati è `varchar`.

I parametri seguenti sono facoltativi:

*buffer\$1pool\$1size*  
La dimensione del pool di buffer espressa in numero di pagine. Il tipo di dati è `integer`. Il valore predefinito è `-1`.

*immediate*  
Specifica se il comando viene eseguito immediatamente. Il tipo di dati è `char`. Il valore predefinito è `Y`.

*automatic*  
Specifica se impostare il pool di buffer in modalità automatica. Il tipo di dati è `char`. Il valore predefinito è `Y`.

*page\$1size*  
Aumenta la dimensione di pagina del pool di buffer. Il tipo di dati è `integer`. Valori validi: `4096`, `8192`, `16384`, `32768`. Il valore predefinito è `8192`.

*number\$1block\$1pages*  
Il numero di pagine di blocco nei pool di buffer. Il tipo di dati è `integer`. Il valore predefinito è `0`.

*block\$1size*  
La dimensione di blocco per le pagine di blocco. Il tipo di dati è `integer`. Valori validi: da `2` a `256`. Il valore predefinito è `32`.

### Note per l’utilizzo
<a name="db2-sp-create-buffer-pool-usage-notes"></a>

Per informazioni su come verificare lo stato della creazione di un pool di buffer, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

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

**Esempio 1: creazione di un pool di buffer con parametri predefiniti**

L’esempio seguente crea un pool di buffer denominato `BP8` per il database `TESTDB` con parametri predefiniti, pertanto il pool di buffer utilizza una dimensione di pagina pari a 8 KB. 

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

**Esempio 2: creazione di un pool di buffer da eseguire immediatamente con allocazione automatica**

L’esempio seguente crea un pool di buffer denominato `BP16` per il database `TESTDB` che utilizza una dimensione di pagina di 16 KB con un numero iniziale di pagine pari a 1.000 ed è impostato in modalità automatica. Db2 esegue il comando immediatamente. Se il numero iniziale di pagine è pari a -1, Db2 utilizzerà l’allocazione automatica delle pagine.

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

**Esempio 3: creazione di un pool di buffer da eseguire immediatamente utilizzando pagine di blocco**

L’esempio seguente crea un pool di buffer denominato `BP16` per il database `TESTDB`. Questo pool di buffer ha una dimensione di pagina di 16 KB con un numero iniziale di pagine pari a 10.000. Db2 esegue immediatamente il comando utilizzando 500 pagine di blocco con una dimensione di blocco pari a 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>

Modifica un pool di buffer.

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

### Parameters
<a name="db2-sp-alter-buffer-pool-parameters"></a>

I parametri seguenti sono obbligatori:

*database\$1name*  
Il nome del database su cui eseguire il comando. Il tipo di dati è `varchar`.

*buffer\$1pool\$1name*  
Il nome del pool di buffer da modificare. Il tipo di dati è `varchar`.

*buffer\$1pool\$1size*  
La dimensione del pool di buffer espressa in numero di pagine. Il tipo di dati è `integer`.

I parametri seguenti sono facoltativi:

*immediate*  
Specifica se il comando viene eseguito immediatamente. Il tipo di dati è `char`. Il valore predefinito è `Y`.

*automatic*  
Specifica se impostare il pool di buffer in modalità automatica. Il tipo di dati è `char`. Il valore predefinito è `N`.

*change\$1number\$1blocks*  
Specifica se è stata apportata una modifica al numero di pagine di blocco nel pool di buffer. Il tipo di dati è `char`. Il valore predefinito è `N`.

*number\$1block\$1pages*  
Il numero di pagine di blocco nei pool di buffer. Il tipo di dati è `integer`. Il valore predefinito è `0`.

*block\$1size*  
La dimensione di blocco per le pagine di blocco. Il tipo di dati è `integer`. Valori validi: da `2` a `256`. Il valore predefinito è `32`.

### Note per l’utilizzo
<a name="db2-sp-alter-buffer-pool-usage-notes"></a>

Per informazioni su come verificare lo stato della modifica di un pool di buffer, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

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

L’esempio seguente modifica un pool di buffer denominato `BP16` per il database `TESTDB` impostando la modalità automatica e la dimensione pari a 10.000 pagine. Db2 esegue il comando immediatamente. 

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

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

Elimina un pool di buffer.

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

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

### Parameters
<a name="db2-sp-drop-buffer-pool-parameters"></a>

I parametri seguenti sono obbligatori:

*database\$1name*  
Il nome del database a cui appartiene il pool di buffer. Il tipo di dati è `varchar`.

*buffer\$1pool\$1name*  
Il nome del pool di buffer da eliminare. Il tipo di dati è `varchar`.

### Note per l’utilizzo
<a name="db2-sp-drop-buffer-pool-usage-notes"></a>

Per informazioni su come verificare lo stato dell’eliminazione di un pool di buffer, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

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

L’esempio seguente elimina un pool di buffer denominato `BP16` per il database `TESTDB`.

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