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
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\_bufferpool](#db2-sp-create-buffer-pool)
+ [rdsadmin.alter\_bufferpool](#db2-sp-alter-buffer-pool)
+ [rdsadmin.drop\_bufferpool](#db2-sp-drop-buffer-pool)
## rdsadmin.create\_bufferpool
Crea un pool di buffer.
### Sintassi
```
db2 "call rdsadmin.create_bufferpool(
'{{database_name}}',
'{{buffer_pool_name}}',
{{buffer_pool_size}},
'{{immediate}}',
'{{automatic}}',
{{page_size}},
{{number_block_pages}},
{{block_size}})"
```
### Parameters
I parametri seguenti sono obbligatori:
{{database\_name}}
Il nome del database su cui eseguire il comando. Il tipo di dati è `varchar`.
{{buffer\_pool\_name}}
Il nome del pool di buffer da creare. Il tipo di dati è `varchar`.
I parametri seguenti sono facoltativi:
{{buffer\_pool\_size}}
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\_size}}
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\_block\_pages}}
Il numero di pagine di blocco nei pool di buffer. Il tipo di dati è `integer`. Il valore predefinito è `0`.
{{block\_size}}
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
Per informazioni su come verificare lo stato della creazione di un pool di buffer, consulta [rdsadmin.get\_task\_status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
**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\_bufferpool
Modifica un pool di buffer.
### Sintassi
```
db2 "call rdsadmin.alter_bufferpool(
'{{database_name}}',
'{{buffer_pool_name}}',
{{buffer_pool_size}},
'{{immediate}}',
'{{automatic}}',
{{change_number_blocks}},
{{number_block_pages}},
{{block_size}})"
```
### Parameters
I parametri seguenti sono obbligatori:
{{database\_name}}
Il nome del database su cui eseguire il comando. Il tipo di dati è `varchar`.
{{buffer\_pool\_name}}
Il nome del pool di buffer da modificare. Il tipo di dati è `varchar`.
{{buffer\_pool\_size}}
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\_number\_blocks}}
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\_block\_pages}}
Il numero di pagine di blocco nei pool di buffer. Il tipo di dati è `integer`. Il valore predefinito è `0`.
{{block\_size}}
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
Per informazioni su come verificare lo stato della modifica di un pool di buffer, consulta [rdsadmin.get\_task\_status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
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\_bufferpool
Elimina un pool di buffer.
### Sintassi
```
db2 "call rdsadmin.drop_bufferpool(
'{{database_name}}',
'{{buffer_pool_name}}'"
```
### Parameters
I parametri seguenti sono obbligatori:
{{database\_name}}
Il nome del database a cui appartiene il pool di buffer. Il tipo di dati è `varchar`.
{{buffer\_pool\_name}}
Il nome del pool di buffer da eliminare. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato dell’eliminazione di un pool di buffer, consulta [rdsadmin.get\_task\_status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente elimina un pool di buffer denominato `BP16` per il database `TESTDB`.
```
db2 "call rdsadmin.drop_bufferpool(
'TESTDB',
'BP16')"
```