Stored procedure relative a pool di buffer per RDS per Db2 - Amazon Relational Database Service

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.

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

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)"

Parametri

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.

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)"

Parametri

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.

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'"

Parametri

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.

Esempi

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

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