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 ai tablespace per RDS per Db2
Le stored procedure integrate descritte in questo argomento gestiscono i tablespace 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 tablespace](db2-managing-tablespaces.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\$1tablespace](#db2-sp-create-tablespace)
+ [rdsadmin.alter\$1tablespace](#db2-sp-alter-tablespace)
+ [rdsadmin.rename\$1tablespace](#db2-sp-rename-tablespace)
+ [rdsadmin.drop\$1tablespace](#db2-sp-drop-tablespace)
## rdsadmin.create\$1tablespace
Crea un tablespace.
### Sintassi
```
db2 "call rdsadmin.create_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_page_size,
tablespace_initial_size,
tablespace_increase_size,
'tablespace_type',
'tablespace_prefetch_size')"
```
### Parameters
I parametri seguenti sono obbligatori:
*database\$1name*
Il nome del database in cui creare il tablespace. Il tipo di dati è `varchar`.
*tablespace\$1name*
Il nome del tablespace da creare. Il tipo di dati è `varchar`.
Il nome del tablespace presenta le seguenti limitazioni:
+ Non può essere uguale al nome di un tablespace esistente nel database.
+ Può contenere solo i caratteri `_$#@a-zA-Z0-9`.
+ Non può iniziare con `_` o `$`.
+ Non può iniziare con `SYS`.
I parametri seguenti sono facoltativi:
*buffer\$1pool\$1name*
Il nome del pool di buffer a cui assegnare il tablespace. Il tipo di dati è `varchar`. L'impostazione predefinita è una stringa vuota.
È necessario disporre già di un pool di buffer della stessa dimensione di pagina da associare al tablespace.
*tablespace\$1page\$1size*
La dimensione di pagina del tablespace, espressa in byte. Il tipo di dati è `integer`. Valori validi: `4096`, `8192`, `16384`, `32768`. L’impostazione predefinita è la dimensione di pagina utilizzata al momento della creazione del database chiamando [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
Amazon RDS supporta l’atomicità di scrittura per pagine da 4 KiB, 8 KiB e 16 KiB. Per contro, le pagine da 32 KiB rischiano di causare scritture incomplete o la scrittura parziale dei dati sul desktop. Se utilizzi pagine da 32 KiB, ti consigliamo di abilitare il point-in-time ripristino e i backup automatici. Altrimenti, corri il rischio di non riuscire a recuperare le pagine danneggiate. Per ulteriori informazioni, consultare [Introduzione ai backup](USER_WorkingWithAutomatedBackups.md) e [Ripristino di un’istanza database a un punto temporale specifico per Amazon RDS](USER_PIT.md).
*tablespace\$1initial\$1size*
La dimensione iniziale del tablespace in kilobyte (KB). Il tipo di dati è `integer`. Valori validi: `48` o superiore. Il valore predefinito è null.
Se non imposti un valore, Db2 imposta automaticamente un valore appropriato.
Questo parametro non è applicabile per i tablespace temporanei poiché questi vengono gestiti dal sistema.
*tablespace\$1increase\$1size*
La percentuale in base alla quale aumentare la dimensione del tablespace quando è pieno. Il tipo di dati è `integer`. Valori validi: `1`-`100`. Il valore predefinito è null.
Se non imposti un valore, Db2 imposta automaticamente un valore appropriato.
Questo parametro non è applicabile per i tablespace temporanei poiché questi vengono gestiti dal sistema.
*tablespace\$1type*
Il tipo di tablespace. Il tipo di dati è `char`. Valori validi: `U` (per i dati dell’utente), `T` (per i dati temporanei dell’utente) o `S` (per i dati temporanei del sistema). Il valore predefinito è `U`.
*tablespace\$1prefetch\$1size*
La dimensione di pagina di prefetch del tablespace. Il tipo di dati è `char`. Valori validi: `AUTOMATIC` (senza distinzione tra maiuscole e minuscole) o numeri interi positivi diversi da zero minori o uguali a 32.767.
### Note per l’utilizzo
RDS per Db2 crea sempre un database di grandi dimensioni per i dati.
Per informazioni su come verificare lo stato della creazione di un tablespace, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
**Esempio 1: creazione di un tablespace e assegnazione di un pool di buffer**
L’esempio seguente crea un tablespace denominato `SP8` e assegna il pool di buffer `BP8` per il database `TESTDB`. Il tablespace ha una dimensione di pagina di 4.096 byte, una dimensione di pagina di 1.000 KB e una percentuale di incremento della dimensione di tabella del 50%.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
'BP8',
4096,
1000,
50)"
```
**Esempio 2: creazione di un tablespace temporaneo e assegnazione di un pool di buffer**
L’esempio seguente crea un tablespace temporaneo denominato `SP8`. Assegna un pool di buffer denominato `BP8` della dimensione di 8 KiB per il database `TESTDB`.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
'BP8',
8192,
NULL,
NULL,
'T')"
```
**Esempio 3: creazione di un tablespace e assegnazione di una dimensione di pagina di prefetch**
L’esempio seguente crea un tablespace denominato `SP8` per il database `TESTDB`. Il tablespace ha una dimensione di incremento iniziale pari a `50` e una dimensione di pagina di prefetch pari a `800`.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
NULL,
NULL,
NULL,
50,
NULL,
'800')"
```
## rdsadmin.alter\$1tablespace
Modifica un tablespace.
### Sintassi
```
db2 "call rdsadmin.alter_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_increase_size,
'max_size',
'reduce_max',
'reduce_stop',
'reduce_value',
'lower_high_water',
'lower_high_water_stop',
'switch_online',
'tablespace_prefetch_size')"
```
### Parameters
I parametri seguenti sono obbligatori:
*database\$1name*
Il nome del database che utilizza il tablespace. Il tipo di dati è `varchar`.
*tablespace\$1name*
Il nome del tablespace da modificare. Il tipo di dati è `varchar`.
I parametri seguenti sono facoltativi:
*buffer\$1pool\$1name*
Il nome del pool di buffer a cui assegnare il tablespace. Il tipo di dati è `varchar`. L'impostazione predefinita è una stringa vuota.
È necessario disporre già di un pool di buffer della stessa dimensione di pagina da associare al tablespace.
*tablespace\$1increase\$1size*
La percentuale in base alla quale aumentare la dimensione del tablespace quando è pieno. Il tipo di dati è `integer`. Valori validi: `1`-`100`. Il valore predefinito è `0`.
*max\$1size*
La dimensione massima per il tablespace. Il tipo di dati è `varchar`. Valori validi: *integer* `K` \$1 `M` \$1`G`, or`NONE`. Il valore predefinito è `NONE`.
*reduce\$1max*
Specifica se ridurre il limite massimo consentito. Il tipo di dati è `char`. Il valore predefinito è `N`.
*reduce\$1stop*
Specifica se interrompere un comando `reduce_max` o `reduce_value` precedente. Il tipo di dati è `char`. Il valore predefinito è `N`.
*reduce\$1value*
Il numero o la percentuale in base a cui ridurre il limite massimo per il tablespace. Il tipo di dati è `varchar`. Valori validi: *integer* `K` `M` \$1 \$1 `G` o `1` —`100`. Il valore predefinito è `N`.
*lower\$1high\$1water*
Specifica se eseguire il comando `ALTER TABLESPACE LOWER HIGH WATER MARK`. Il tipo di dati è `char`. Il valore predefinito è `N`.
*lower\$1high\$1water\$1stop*
Specifica se eseguire il comando `ALTER TABLESPACE LOWER HIGH WATER MARK STOP`. Il tipo di dati è `char`. Il valore predefinito è `N`.
*switch\$1online*
Specifica se eseguire il comando `ALTER TABLESPACE SWITCH ONLINE`. Il tipo di dati è `char`. Il valore predefinito è `N`.
*tablespace\$1prefetch\$1size*
La dimensione di pagina di prefetch del tablespace. Il tipo di dati è `char`. Valori validi: `AUTOMATIC` (senza distinzione tra maiuscole e minuscole) o numeri interi positivi diversi da zero minori o uguali a 32.767.
Questo parametro funziona solo con `buffer_pool_name`, `table_increase_size`, `max_size` e `switch_online`. Non funziona con `reduce_max`, `reduce_stop`, `reduce_value`, `lower_high_water` e `lower_high_water_stop`.
### Note per l’utilizzo
Prima di chiamare la stored procedure, esamina le seguenti considerazioni:
+ La stored procedure `rdsadmin.alter_tablespace` non funziona su un tablespace con `tablespace_type` impostato su `T` per i dati temporanei dell’utente.
+ I parametri facoltativi `reduce_max`, `reduce_stop`, `reduce_value`, `lower_high_water`, `lower_high_water_stop` e `switch_online` si escludono a vicenda. Non puoi combinarli con altri parametri facoltativi, ad esempio `buffer_pool_name`, nel comando `rdsadmin.alter_tablespace`. Per ulteriori informazioni, consulta [Statement not valid](db2-troubleshooting.md#alter-tablespace-sp-statement-not-valid).
Per informazioni su come verificare lo stato della modifica di un tablespace, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Per i messaggi di errore restituiti durante le chiamate alle stored procedure, consulta [Errori delle stored procedure](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Esempi
**Esempio 1: diminuzione del valore del limite massimo**
L’esempio seguente modifica un tablespace denominato `SP8` e assegna il pool di buffer `BP8` per il database `TESTDB` al fine di diminuire il valore del limite massimo.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'SP8',
'BP8',
NULL,
NULL,
'Y')"
```
**Esempio 2: riduzione del limite massimo**
L’esempio seguente esegue il comando `REDUCE MAX` su un tablespace denominato `TBSP_TEST` nel database `TESTDB`.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
'Y')"
```
**Esempio 3: interruzione dei comandi per la riduzione del limite massimo**
L’esempio seguente esegue il comando `REDUCE STOP` su un tablespace denominato `TBSP_TEST` nel database `TESTDB`.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
NULL,
'Y')"
```
**Esempio 4: modifica della dimensione di pagina di prefetch esistente**
L’esempio seguente esegue il comando `ALTER TABLESPACE SWITCH ONLINE` su un tablespace denominato `TSBP_TEST` e modifica la dimensione di pagina di prefetch esistente in `64`.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
‘Y’,
‘64’)"
```
## rdsadmin.rename\$1tablespace
Rinomina un tablespace.
### Sintassi
```
db2 "call rdsadmin.rename_tablespace(
?,
'database_name',
'source_tablespace_name',
'target_tablespace_name')"
```
### Parameters
I parametri seguenti sono obbligatori:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo ?.
*database\$1name*
Il nome del database a cui appartiene il tablespace. Il tipo di dati è `varchar`.
*source\$1tablespace\$1name*
Il nome del tablespace da rinominare. Il tipo di dati è `varchar`.
*target\$1tablespace\$1name*
Il nuovo nome del tablespace. Il tipo di dati è `varchar`.
Il nuovo nome presenta le seguenti limitazioni:
+ Non può essere uguale al nome di un tablespace esistente.
+ Può contenere solo i caratteri `_$#@a-zA-Z0-9`.
+ Non può iniziare con `_` o `$`.
+ Non può iniziare con `SYS`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato della ridenominazione di un tablespace, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Non è possibile rinominare i tablespace che appartengono al database `rdsadmin`.
### Esempi
L’esempio seguente rinomina in `SP9` un tablespace denominato `SP8` nel database `TESTDB`.
```
db2 "call rdsadmin.rename_tablespace(
?,
'TESTDB',
'SP8',
'SP9')"
```
## rdsadmin.drop\$1tablespace
Elimina un tablespace.
### Sintassi
```
db2 "call rdsadmin.drop_tablespace(
'database_name',
'tablespace_name')"
```
### Parameters
I parametri seguenti sono obbligatori:
*database\$1name*
Il nome del database a cui appartiene il tablespace. Il tipo di dati è `varchar`.
*tablespace\$1name*
Il nome del tablespace da eliminare. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato dell’eliminazione di un tablespace, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente elimina un tablespace denominato `SP8` dal database `TESTDB`.
```
db2 "call rdsadmin.drop_tablespace(
'TESTDB',
'SP8')"
```