Gerenciar grupos de buffers - Amazon Relational Database Service
rdsadmin.create_bufferpoolrdsadmin.alter_bufferpoolrdsadmin.drop_bufferpool

Gerenciar grupos de buffers

Os procedimentos armazenados a seguir gerenciam grupos de buffers 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.

rdsadmin.create_bufferpool

Cria um grupo de buffers.

Sintaxe

db2 "call rdsadmin.create_bufferpool(
    'database_name', 
    'buffer_pool_name', 
    buffer_pool_size, 
    'immediate', 
    'automatic', 
    page_size, 
    number_block_pages, 
    block_size)"

Parâmetros

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

database_name

O nome do banco de dados no qual executar o comando. O tipo de dados é varchar.

buffer_pool_name

O nome do grupo de buffers a ser criado. O tipo de dados é varchar.

Os seguintes parâmetros são opcionais:

buffer_pool_size

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_size

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_block_pages

O tamanho de páginas de blocos nos grupos de buffers. O tipo de dados é integer. O padrão é 0.

block_size

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

Para ter informações sobre como conferir o status de criação de um grupo de buffers, consulte rdsadmin.get_task_status.

Exemplos

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

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

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_bufferpool

Altera um grupo de buffers.

Sintaxe

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

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

database_name

O nome do banco de dados no qual executar o comando. O tipo de dados é varchar.

buffer_pool_name

O nome do grupo de buffers a ser alterado. O tipo de dados é varchar.

buffer_pool_size

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_number_blocks

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_block_pages

O tamanho de páginas de blocos nos grupos de buffers. O tipo de dados é integer. O padrão é 0.

block_size

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

Para ter informações sobre como conferir o status de alteração de um grupo de buffers, consulte rdsadmin.get_task_status.

Exemplos

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_bufferpool

Descarta um grupo de buffers.

Sintaxe

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

Parâmetros

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

database_name

O nome do banco de dados ao qual o grupo de buffers pertence. O tipo de dados é varchar.

buffer_pool_name

O nome do grupo de buffers a ser descartado. O tipo de dados é varchar.

Observações de uso

Para ter informações sobre como conferir o status de descarte de um grupo de buffers, consulte rdsadmin.get_task_status.

Exemplos

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