Procedure archiviate per database per RDS for Db2 - Amazon Relational Database Service
rdsadmin.create_databaserdsadmin.deactivate_databaserdsadmin.activate_databaserdsadmin.reactivate_databaserdsadmin.drop_databaserdsadmin.update_db_paramrdsadmin.set_configurationrdsadmin.show_configurationrdsadmin.restore_databaserdsadmin.rollforward_databaserdsadmin.complete_rollforwardrdsadmin.db2pd_commandrdsadmin.force_applicationrdsadmin.set_archive_log_retentionrdsadmin.show_archive_log_retentionrdsadmin.list_archive_log_information

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à.

Procedure archiviate per database per RDS for Db2

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

Queste stored procedure vengono utilizzate in diverse attività. L'elenco non è completo.

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

rdsadmin.create_database

Crea un database.

Sintassi

db2 "call rdsadmin.create_database('database_name')"

Parametri

Nota

Questa procedura memorizzata non convalida la combinazione dei parametri richiesti. Quando si chiamardsadmin.get_task_status, la funzione definita dall'utente potrebbe restituire un errore a causa di una combinazione didatabase_codeset,database_territory, e database_collation tale errore non è valido. Per ulteriori informazioni, consulta Scelta della tabella codici, del territorio e delle regole di confronto per il database nella documentazione. IBM Db2

Il parametro seguente è obbligatorio:

database_name

Il nome del database da creare. Il tipo di dati èvarchar.

I parametri seguenti sono facoltativi:

database_page_size

La dimensione di pagina predefinita del database. Valori validi: 4096, 8192, 16384, 32768. Il tipo di dati èinteger. Il valore predefinito è 8192.

Importante

Amazon RDS supporta l'atomicità di scrittura per pagine da 4 KiB, 8 KiB e 16 KiB. Al contrario, le pagine da 32 KB rischiano scritture strappate o dati parziali che vengano scritti sulla scrivania. 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 e Ripristino di un'istanza DB a un'ora specificata per Amazon RDS.

database_code_set

Il set di codici per il database. Il tipo di dati èvarchar. Il valore predefinito è UTF-8.

database_territory

Il codice del paese a due lettere per il database. Il tipo di dati èvarchar. Il valore predefinito è US.

database_collation

La sequenza di confronto che determina il modo in cui le stringhe di caratteri memorizzate nel database vengono ordinate e confrontate. Il tipo di dati è. varchar

Valori validi:

  • COMPATIBILITY— Una sequenza di confronto IBM Db2 versione 2.

  • EBCDIC_819_037— Tabella codici ISO in latino, fascicolazione; CCSID 037 (EBCDIC US English).

  • EBCDIC_819_500— Tabella codici ISO in latino, raccolta; CCSID 500 (EBCDIC International).

  • EBCDIC_850_037— Tabella codici latini ASCII, fascicolazione; CCSID 037 (EBCDIC US English).

  • EBCDIC_850_500— Tabella codici in alfabeto latino ASCII, fascicolazione; CCSID 500 (EBCDIC International).

  • EBCDIC_932_5026— Tabella codici in giapponese ASCII, fascicolazione; CCSID 037 (EBCDIC in inglese americano).

  • EBCDIC_932_5035— Tabella codici in giapponese ASCII, fascicolazione; CCSID 500 (EBCDIC International).

  • EBCDIC_1252_037— Tabella codici in latino di Windows, confronto; CCSID 037 (EBCDIC in inglese americano).

  • EBCDIC_1252_500— Tabella codici in latino di Windows, confronto; CCSID 500 (EBCDIC International).

  • IDENTITY— Collazione predefinita. Le stringhe vengono confrontate byte per byte.

  • IDENTITY_16BIT— Lo schema di codifica di compatibilità per UTF-16: sequenza di confronto a 8 bit (CESU-8). Per ulteriori informazioni, vedere Unicode Technical Report #26 sul sito Web di Unicode Consortium.

  • NLSCHAR— Da utilizzare solo con la tabella codici thailandese (). CP874

  • SYSTEM— Se si utilizzaSYSTEM, il database utilizza automaticamente la sequenza di confronto per database_codeset edatabase_territory.

Il valore predefinito è IDENTITY.

Inoltre, RDS for Db2 supporta i seguenti gruppi di regole di confronto: e. language-aware-collation locale-sensitive-collation Per ulteriori informazioni, consulta Scelta di un confronto per un database Unicode nella documentazione. IBM Db2

database_autoconfigure_str

La sintassi del AUTOCONFIGURE comando, ad esempio,. 'AUTOCONFIGURE APPLY DB' Il tipo di dati èvarchar. L'impostazione predefinita è una stringa vuota o nulla.

Per ulteriori informazioni, consulta AUTOCONFIGUREil comando nella IBM Db2 documentazione.

Note per l'utilizzo

Se intendi modificare il db2_compatibility_vector parametro, modifica il parametro prima di creare un database. Per ulteriori informazioni, consulta Impostazione del parametro db2_compatibility_vector.

Considerazioni speciali:

  • Il CREATE DATABASE comando inviato all'istanza Db2 utilizza l'RESTRICTIVEopzione.

  • RDS per Db2 utilizza solo tablespace. AUTOMATIC STORAGE

  • RDS for Db2 utilizza i valori predefiniti per e. NUMSEGS DFT_EXTENT_SZ

  • RDS per Db2 utilizza la crittografia dell'archiviazione e non supporta la crittografia del database.

Per ulteriori informazioni su queste considerazioni, consulta il CREATE DATABASEcomando nella documentazione. IBM Db2

Prima di chiamarerdsadmin.create_database, è necessario connettersi al rdsadmin database. Nell'esempio seguente, sostituisci master_username e master_password con le informazioni sull'istanza DB RDS for Db2:

db2 connect to rdsadmin user master_username using master_password

Per informazioni sulla verifica dello stato della creazione di un database, vedere. rdsadmin.get_task_status

Per i messaggi di errore restituiti durante la chiamatardsadmin.create_database, vedereRisoluzione degli errori relativi alle stored procedure.

Esempi

L'esempio seguente crea un database chiamato TESTJP con una combinazione corretta di database_code_setdatabase_territory, e database_collation parametri per il Giappone:

db2 "call rdsadmin.create_database('TESTJP', 4096, 'IBM-437', 'JP', 'SYSTEM')"

rdsadmin.deactivate_database

Disattiva un database.

Sintassi

db2 "call rdsadmin.deactivate_database(
    ?,
    'database_name')"

Parametri

È richiesto il seguente parametro di output:

?

Un indicatore di parametro che emette un messaggio di errore. Questo parametro accetta solo. ?

È richiesto il seguente parametro di input:

database_name

Il nome del database da disattivare. Il tipo di dati èvarchar.

Note per l'utilizzo

È possibile disattivare i database per risparmiare risorse di memoria o per apportare altre modifiche alla configurazione del database. Per riportare online i database disattivati, richiama la rdsadmin.activate_database stored procedure.

Per informazioni sulla verifica dello stato di disattivazione di un database, vedere. rdsadmin.get_task_status

Per i messaggi di errore restituiti durante la chiamatardsadmin.deactivate_database, vedere. Risoluzione degli errori relativi alle stored procedure

Esempi

L'esempio seguente disattiva un database chiamato. TESTDB

db2 "call rdsadmin.deactivate_database(?, 'TESTDB')"

rdsadmin.activate_database

Attiva un database.

Per ulteriori informazioni sulla differenza tra rdsadmin.reactivate_database e rdsadmin.activate_database, consulta Note per l'utilizzo.

Sintassi

db2 "call rdsadmin.activate_database(
    ?,
    'database_name')"

Parametri

È richiesto il seguente parametro di output:

?

Un indicatore di parametro che emette un messaggio di errore. Questo parametro accetta solo. ?

È richiesto il seguente parametro di input:

database_name

Il nome del database da attivare. Il tipo di dati èvarchar.

Note per l'utilizzo

Tutti i database vengono attivati per impostazione predefinita al momento della creazione. Se si disattiva un database su un'istanza DB autonoma per risparmiare risorse di memoria o apportare altre modifiche alla configurazione del database, richiama la rdsadmin.activate_database stored procedure per riattivare il database.

Per informazioni sulla verifica dello stato di attivazione di un database, vedere. rdsadmin.get_task_status

Per i messaggi di errore restituiti durante la chiamatardsadmin.activate_database, vedereRisoluzione degli errori relativi alle stored procedure.

Esempi

L'esempio seguente attiva un database chiamatoTESTDB.

db2 "call rdsadmin.activate_database(?, 'TESTDB')"

rdsadmin.reactivate_database

Riattiva un database.

Per informazioni sulle differenze tra rdsadmin.activate_database erdsadmin.reactivate_database, vedere. Note per l'utilizzo

Sintassi

db2 "call rdsadmin.reactivate_database(
    ?,
    'database_name')"

Parametri

È richiesto il seguente parametro di output:

?

Un indicatore di parametro che emette un messaggio di errore. Questo parametro accetta solo. ?

È richiesto il seguente parametro di input:

database_name

Il nome del database da riattivare. Il tipo di dati èvarchar.

Note per l'utilizzo

Quando si chiama la rdsadmin.reactivate_database stored procedure, la stored procedure disattiva innanzitutto il database chiamando la rdsadmin.deactivate_database stored procedure, quindi attiva il database chiamando la stored procedure. rdsadmin.activate_database

Dopo aver apportato modifiche alle configurazioni del database, potrebbe essere necessario riattivare un database su un'istanza DB RDS for Db2. Per determinare se è necessario riattivare un database, connettiti al database ed esegui. db2 get db cfg show detail

Per un database su un'istanza DB autonoma, è possibile utilizzare la procedura rdsadmin.reactivate_database store per riattivare il database. Oppure, se hai già chiamato la rdsadmin.deactivate_database stored procedure, puoi invece chiamare la rdsadmin.activate_database stored procedure.

Per informazioni sulla verifica dello stato della riattivazione di un database, vedere. rdsadmin.get_task_status

Per i messaggi di errore restituiti durante la chiamatardsadmin.reactivate_database, vedere. Risoluzione degli errori relativi alle stored procedure

Esempi

L'esempio seguente riattiva un database chiamato. TESTDB

db2 "call rdsadmin.reactivate_database(?, 'TESTDB')"

rdsadmin.drop_database

Rimuove un database.

Sintassi

db2 "call rdsadmin.drop_database('database_name')"

Parametri

Il parametro seguente è obbligatorio:

database_name

Il nome del database da eliminare. Il tipo di dati èvarchar.

Note per l'utilizzo

È possibile eliminare un database chiamando rdsadmin.drop_database solo se sono soddisfatte le seguenti condizioni:

  • Non hai specificato il nome del database quando hai creato l'istanza DB RDS for Db2 utilizzando la console Amazon RDS o il. AWS CLI Per ulteriori informazioni, consulta Creazione di un'istanza database.

  • Hai creato il database chiamando la rdsadmin.create_database stored procedure.

  • È stato ripristinato il database da un'immagine offline o di cui è stato eseguito il backup richiamando la rdsadmin.restore_database stored procedure.

Prima di chiamarerdsadmin.drop_database, è necessario connettersi al rdsadmin database. Nell'esempio seguente, sostituisci master_username e master_password con le informazioni sull'istanza DB RDS for Db2:

db2 connect to rdsadmin user master_username using master_password

Per informazioni sulla verifica dello stato dell'eliminazione di un database, consulta. rdsadmin.get_task_status

Per i messaggi di errore restituiti durante la chiamatardsadmin.drop_database, vedereRisoluzione degli errori relativi alle stored procedure.

Esempi

L'esempio seguente elimina un database chiamatoTESTDB:

db2 "call rdsadmin.drop_database('TESTDB')"

rdsadmin.update_db_param

Aggiorna i parametri del database.

Sintassi

db2 "call rdsadmin.update_db_param(
    'database_name', 
    'parameter_to_modify', 
    'changed_value)"

Parametri

I parametri seguenti sono obbligatori:

database_name

Il nome del database per cui eseguire l'attività. Il tipo di dati èvarchar.

parameter_to_modify

Il nome del parametro da modificare. Il tipo di dati èvarchar. Per ulteriori informazioni, consulta Parametri Amazon RDS per Db2.

changed_value

Il valore in cui modificare il valore del parametro. Il tipo di dati èvarchar.

Note per l'utilizzo

Per informazioni sulla verifica dello stato dell'aggiornamento dei parametri del database, vedererdsadmin.get_task_status.

Per i messaggi di errore restituiti durante la chiamatardsadmin.update_db_param, vedereRisoluzione degli errori relativi alle stored procedure.

Esempi

Esempio 1: aggiornamento di un parametro

L'esempio seguente aggiorna il archretrydelay parametro 100 per un database chiamatoTESTDB:

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'archretrydelay', 
    '100')"

Esempio 2: rinvio della convalida degli oggetti

L'esempio seguente posticipa la convalida degli oggetti creati su un database chiamato TESTDB per evitare il controllo delle dipendenze:

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'auto_reval', 
    'deferred_force')"

rdsadmin.set_configuration

Configura impostazioni specifiche per il database.

Sintassi

db2 "call rdsadmin.set_configuration(
    'name',  
    'value')"

Parametri

I parametri seguenti sono obbligatori:

name

Il nome dell'impostazione di configurazione. Il tipo di dati èvarchar.

value

Il valore per l'impostazione di configurazione. Il tipo di dati èvarchar.

Note per l'utilizzo

La tabella seguente mostra le impostazioni di configurazione con cui è possibile controllarerdsadmin.set_configuration.

Nome Descrizione

RESTORE_DATABASE_NUM_BUFFERS

Il numero di buffer da creare durante un'operazione di ripristino. Questo valore deve essere inferiore alla dimensione totale della memoria della classe di istanze DB. Se questa impostazione non è configurata, Db2 determina il valore da utilizzare durante l'operazione di ripristino. Per ulteriori informazioni, consulta la documentazione relativa ad IBM Db2.

RESTORE_DATABASE_PARALLELISM

Il numero di manipolatori di buffer da creare durante un'operazione di ripristino. Questo valore deve essere inferiore al doppio del numero di v CPUs per l'istanza DB. Se questa impostazione non è configurata, Db2 determina il valore da utilizzare durante l'operazione di ripristino. Per ulteriori informazioni, consulta la documentazione relativa ad IBM Db2.

Esempi

Esempio 1: Specificazione del numero di manipolatori di buffer da creare

L'esempio seguente imposta la configurazione su. RESTORE_DATABASE_PARALLELISM 8

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_PARALLELISM', 
    '8')"

Esempio 2: Specificazione del numero di buffer da creare

L'esempio seguente imposta la RESTORE_DATABASE_NUM_BUFFERS configurazione su. 150

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_NUM_BUFFERS', 
    '150')"

rdsadmin.show_configuration

Restituisce le impostazioni correnti che è possibile impostare utilizzando la stored procedurerdsadmin.set_configuration.

Sintassi

db2 "call rdsadmin.show_configuration(
    'name')"

Parametri

Il parametro seguente è facoltativo:

name

Il nome dell'impostazione di configurazione su cui restituire informazioni. Il tipo di dati èvarchar.

I seguenti nomi di configurazione sono validi:

  • RESTORE_DATABASE_NUM_BUFFERS — Il numero di buffer da creare durante un'operazione di ripristino.

  • RESTORE_DATABASE_PARALLELISM — Il numero di manipolatori di buffer da creare durante un'operazione di ripristino.

Note per l'utilizzo

Se non si specifica il nome di un'impostazione di configurazione, rdsadmin.show_configuration restituisce informazioni per tutte le impostazioni di configurazione che è possibile impostare utilizzando la stored procedure. rdsadmin.set_configuration

Esempi

L'esempio seguente restituisce informazioni sulla RESTORE_DATABASE_PARALLELISM configurazione corrente.

db2 "call rdsadmin.show_configuration(
    'RESTORE_DATABASE_PARALLELISM')"

rdsadmin.restore_database

Ripristina un database da un bucket Amazon S3 nella tua istanza DB RDS for Db2.

Sintassi

db2 "call rdsadmin.restore_database(
    ?,
    'database_name', 
    's3_bucket_name', 
    's3_prefix', 
    restore_timestamp, 
    'backup_type')"

Parametri

È richiesto il seguente parametro di output:

?

Un indicatore di parametro che emette un messaggio di errore. Questo parametro accetta solo. ?

Sono richiesti i seguenti parametri di input:

database_name

Il nome del database di destinazione da ripristinare in RDS for Db2. Il tipo di dati è. varchar

Ad esempio, se il nome del database di origine era TESTDB impostato database_name suNEWDB, Amazon RDS esegue il ripristino NEWDB come database di origine.

s3_bucket_name

Il nome del bucket Amazon S3 in cui risiede il backup. Il tipo di dati è. varchar

s3_prefix

Il prefisso da utilizzare per la corrispondenza dei file durante il download. Il tipo di dati èvarchar.

Se questo parametro è vuoto, verranno scaricati tutti i file nel bucket Amazon S3. Di seguito è riportato un esempio di prefisso:

backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101
restore_timestamp

Il timestamp dell'immagine di backup del database. Il tipo di dati è. varchar

Il timestamp è incluso nel nome del file di backup. Ad esempio, 20230615010101 è il timestamp del nome del file. SAMPLE.0.rdsdb.DBPART000.20230615010101.001

backup_type

Il tipo di backup. Il tipo di dati èvarchar. Valori validi: OFFLINE, ONLINE.

Utilizzalo ONLINE per migrazioni con tempi di inattività prossimi allo zero. Per ulteriori informazioni, consulta Migrazione da Linux in Linux con tempi di inattività quasi nulli per Amazon for Db2 RDS.

Note per l'utilizzo

È possibile utilizzare questa stored procedure per migrare un database Db2 in un'istanza DB RDS for Db2. Per ulteriori informazioni, consulta Utilizzo AWS dei servizi per migrare i dati da Db2 ad Amazon RDS for Db2. È inoltre possibile utilizzare questa stored procedure per creare più copie dello stesso database con nomi di database diversi che utilizzano la stessa immagine di ripristino.

Prima di richiamare la stored procedure, esamina le seguenti considerazioni:

  • Prima di ripristinare un database, è necessario fornire uno spazio di archiviazione per l'istanza DB RDS for Db2 pari o superiore alla somma delle dimensioni del backup e del database Db2 originale su disco. Per ulteriori informazioni, consulta Insufficient disk space.

  • Quando ripristini il backup, Amazon RDS estrae il file di backup sulla tua istanza DB RDS for Db2. Ogni file di backup deve avere una dimensione pari o inferiore a 5 TB. Se un file di backup supera i 5 TB, devi dividerlo in file più piccoli.

  • Per ripristinare tutti i file utilizzando la procedura rdsadmin.restore_database memorizzata, non includere il suffisso numerico del file dopo il timestamp nei nomi dei file. Ad esempio, s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101 ripristina i seguenti file:

    SAMPLE.0.rdsdb.DBPART000.20230615010101.001
SAMPLE.0.rdsdb.DBPART000.20230615010101.002
SAMPLE.0.rdsdb.DBPART000.20230615010101.003
SAMPLE.0.rdsdb.DBPART000.20230615010101.004
SAMPLE.0.rdsdb.DBPART000.20230615010101.005

  • RDS per Db2 non supporta l'archiviazione non automatica. Per ulteriori informazioni, consulta Tablespaces not restored.

  • RDS per Db2 non supporta routine non recintate. Per ulteriori informazioni, consulta Non-fenced routines not allowed.

  • Per migliorare le prestazioni delle operazioni di ripristino del database, è possibile configurare il numero di buffer e manipolatori di buffer da utilizzare con RDS. Per verificare la configurazione corrente, utilizzare. rdsadmin.show_configuration Per modificare la configurazione, utilizzarerdsadmin.set_configuration.

Per portare il database online e applicare registri delle transazioni aggiuntivi dopo il ripristino del database, vedere. rdsadmin.rollforward_database

Per informazioni sulla verifica dello stato del ripristino del database, vedere. rdsadmin.get_task_status

Per i messaggi di errore restituiti durante la chiamatardsadmin.restore_database, vedereRisoluzione degli errori relativi alle stored procedure.

Esempi

L'esempio seguente ripristina un backup offline con un singolo file o più file con: s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101

db2 "call rdsadmin.restore_database(
    ?,
    'SAMPLE',
    'amzn-s3-demo-bucket',
    'backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101',
    20230615010101,
    'OFFLINE')"

rdsadmin.rollforward_database

Porta il database online e applica registri delle transazioni aggiuntivi dopo aver ripristinato un database tramite chiamata. rdsadmin.restore_database

Sintassi

db2 "call rdsadmin.rollforward_database(
    ?,
    'database_name',
    's3_bucket_name', 
    s3_prefix, 
    'rollforward_to_option', 
    'complete_rollforward')"

Parametri

È richiesto il seguente parametro di output:

?

Un indicatore di parametro che emette un messaggio di errore. Questo parametro accetta solo. ?

Sono richiesti i seguenti parametri di input:

database_name

Il nome del database su cui eseguire l'operazione. Il tipo di dati èvarchar.

s3_bucket_name

Il nome del bucket Amazon S3 in cui risiede il backup. Il tipo di dati è. varchar

s3_prefix

Il prefisso da utilizzare per la corrispondenza dei file durante il download. Il tipo di dati èvarchar.

Se questo parametro è vuoto, verranno scaricati tutti i file nel bucket S3. L'esempio seguente è un esempio di prefisso:

backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101

I seguenti parametri di input sono opzionali:

rollforward_to_option

Il punto verso il quale vuoi rotolare in avanti. Il tipo di dati èvarchar. Valori validi: END_OF_LOGS, END_OF_BACKUP. Il valore predefinito è END OF LOGS.

complete_rollforward

Speciifica se completare il processo di roll-forward. Il tipo di dati è. varchar Il valore predefinito è TRUE.

SeTRUE, dopo il completamento, il database è online e accessibile. SeFALSE, allora il database rimane in uno ROLL-FORWARD PENDING stato.

Note per l'utilizzo

Dopo la chiamatardsadmin.restore_database, è necessario chiamare rollforward_database per applicare i log di archivio da un bucket S3. È inoltre possibile utilizzare questa procedura memorizzata per ripristinare i registri delle transazioni aggiuntivi dopo la chiamata. rdsadmin.restore_database

Se lo complete_rollforward impostiFALSE, il database è in uno ROLL-FORWARD PENDING stato e non in linea. Per portare il database online, è necessario chiamarerdsadmin.complete_rollforward.

Per informazioni sulla verifica dello stato del rollforward del database, vedererdsadmin.get_task_status.

Esempi

Esempio 1: Mettere online il database con i registri delle transazioni

L'esempio seguente passa a un backup online del database con i registri delle transazioni e quindi porta il database online:

db2 "call rdsadmin.rollforward_database(
    ?,
    null,
    null,
    'END_OF_LOGS',
    'TRUE')"

Esempio 2: Mettere online il database senza i registri delle transazioni

L'esempio seguente passa a un backup online del database senza registri delle transazioni, quindi porta il database online:

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'amzn-s3-demo-bucket',
    'logsfolder/,
    'END_OF_BACKUP',
    'TRUE')"

Esempio 3: non portare online il database con i registri delle transazioni

L'esempio seguente passa a un backup online del database con i registri delle transazioni e quindi non porta il database online:

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    null,
    'onlinebackup/TESTDB',
    'END_OF_LOGS',
    'FALSE')"

Esempio 4: non portare online il database con registri delle transazioni aggiuntivi

L'esempio seguente passa a un backup online del database con registri delle transazioni aggiuntivi e quindi non porta il database online:

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'amzn-s3-demo-bucket',
    'logsfolder/S0000155.LOG',
    'END_OF_LOGS',
    'FALSE')"

rdsadmin.complete_rollforward

Porta il database online da uno ROLL-FORWARD PENDING stato.

Sintassi

db2 "call rdsadmin.complete_rollforward(
    ?,
    'database_name')"

Parametri

È richiesto il seguente parametro di output:

?

Un indicatore di parametro che emette un messaggio di errore. Questo parametro accetta solo. ?

È richiesto il seguente parametro di input:

database_name

Il nome del database che desideri portare online. Il tipo di dati èvarchar.

Note per l'utilizzo

Se hai chiamato rdsadmin.rollforward_database con complete_rollforward set toFALSE, il database è in uno ROLL-FORWARD PENDING stato e non in linea. Per completare il processo di roll-forward e portare il database online, chiama. rdsadmin.complete_rollforward

Per informazioni sulla verifica dello stato del completamento della procedura di roll-forward, vedere. rdsadmin.get_task_status

Esempi

L'esempio seguente porta il TESTDB database online:

db2 "call rdsadmin.complete_rollforward(
    ?,
    'TESTDB')"

rdsadmin.db2pd_command

Raccoglie informazioni su un database RDS for Db2.

Sintassi

db2 "call rdsadmin.db2pd_command('db2pd_cmd')"

Parametri

È richiesto il seguente parametro di input:

db2pd_cmd

Il nome del db2pd comando che si desidera eseguire. Il tipo di dati èvarchar.

Il parametro deve iniziare con un trattino. Per un elenco di parametri, vedere db2pd - Monitora e risolvi i problemi del comando del database Db2 nella documentazione. IBM Db2

Le seguenti opzioni non sono supportate:

  • -addnode

  • -alldatabases

  • -alldbp

  • -alldbs

  • -allmembers

  • -alm_in_memory

  • -cfinfo

  • -cfpool

  • -command

  • -dbpartitionnum

  • -debug

  • -dump

  • -everything

  • -file | -o

  • -ha

  • -interactive

  • -member

  • -pages

    Nota

    -pages summary è supportato.

  • -pdcollection

  • -repeat

  • -stack

  • -totalmem

L'fileopzione secondaria non è supportata, db2pd -db testdb -tcbstats file=tcbstat.out ad esempio.

L'uso dell'stacksopzione non è supportato, db2pd -edus interval=5 top=10 stacks ad esempio.

Note per l'utilizzo

Questa stored procedure raccoglie informazioni che possono contribuire al monitoraggio e alla risoluzione dei problemi dei database RDS per Db2.

La stored procedure utilizza l'IBMdb2pdutilità per eseguire vari comandi. L'db2pdutilità richiede SYSADM l'autorizzazione, che l'utente master RDS for Db2 non dispone. Tuttavia, con la stored procedure di Amazon RDS, l'utente principale è in grado di utilizzare l'utilità per eseguire vari comandi. Per ulteriori informazioni sull'utilità, consulta db2pd - Monitoraggio e risoluzione dei problemi del comando del database Db2 nella documentazione. IBM Db2

L'output è limitato a un massimo di 2 GB.

Per informazioni sulla verifica dello stato della raccolta di informazioni sul database, vedererdsadmin.get_task_status.

Esempi

Esempio 1: ripristino dell'operatività dell'istanza DB

L'esempio seguente restituisce l'uptime di un'istanza DB RDS for Db2:

db2 "call rdsadmin.db2pd_command('-')"

Esempio 2: Restituzione dell'uptime del database

L'esempio seguente restituisce l'uptime di un database chiamato: TESTDB

db2 "call rdsadmin.db2pd_command('-db TESTDB -')"

Esempio 3: restituzione dell'utilizzo della memoria di un'istanza DB

L'esempio seguente restituisce l'utilizzo della memoria di un'istanza DB RDS per Db2:

db2 "call rdsadmin.db2pd_command('-dbptnmem')"

Esempio 4: restituzione di set di memoria dell'istanza DB e del database

L'esempio seguente restituisce i set di memoria di un'istanza DB RDS for Db2 e di un database chiamato: TESTDB

db2 "call rdsadmin.db2pd_command('-inst -db TESTDB -memsets')"

rdsadmin.force_application

Forza la disattivazione delle applicazioni da un database RDS for Db2.

Sintassi

db2 "call rdsadmin.force_application(
    ?,
    'applications')"

Parametri

È richiesto il seguente parametro di output:

?

Un indicatore di parametro che emette un messaggio di errore. Questo parametro accetta solo. ?

È richiesto il seguente parametro di input:

applications

Le applicazioni che si desidera forzare la disattivazione da un database RDS for Db2. Il tipo di dati è. varchar Valori validi: ALL o application_handle.

Separare i nomi di più applicazioni con virgole. Esempio: 'application_handle_1,application_handle_2'.

Note per l'utilizzo

Questa stored procedure obbliga tutte le applicazioni a uscire da un database in modo da poter eseguire la manutenzione.

La stored procedure utilizza il IBM FORCE APPLICATION comando. Il FORCE APPLICATION comando richiede SYSADMSYSMAINT, o SYSCTRL autorizza, che l'utente master RDS for Db2 non dispone. Tuttavia, con la stored procedure di Amazon RDS, l'utente principale è in grado di utilizzare il comando. Per ulteriori informazioni, consulta il comando FORCE APPLICATION nella IBM Db2 documentazione.

Per informazioni sulla verifica dello stato dell'esclusione forzata delle applicazioni da un database, consultardsadmin.get_task_status.

Esempi

Esempio 1: Specificazione di tutte le applicazioni

L'esempio seguente forza la disattivazione di tutte le applicazioni da un database RDS for Db2:

db2 "call rdsadmin.force_application(
    ?,
    'ALL')"

Esempio 2: Specificazione di più applicazioni

L'esempio seguente impone la 1192 disattivazione degli handle 9991 delle applicazioni da un database RDS for Db2: 8891

db2 "call rdsadmin.force_application(
    ?,
    '9991, 8891, 1192')"

rdsadmin.set_archive_log_retention

Configura la quantità di tempo (in ore) per conservare i file di registro di archivio per il database RDS for Db2 specificato.

Sintassi

db2 "call rdsadmin.set_archive_log_retention(
    ?,            
    'database_name',  
    'archive_log_retention_hours')"

Parametri

È richiesto il seguente parametro di output:

?

Un indicatore di parametro che emette un messaggio di errore. Questo parametro accetta solo. ?

Sono richiesti i seguenti parametri di input:

database_name

Il nome del database per cui configurare la conservazione dei registri di archivio. Il tipo di dati èvarchar.

archive_log_retention_hours

Il numero di ore di conservazione dei file di registro dell'archivio. Il tipo di dati èsmallint. L'impostazione predefinita è 0 e il massimo è 168 (7 giorni).

Se il valore è0, Amazon RDS non conserva i file di log di archivio.

Note per l'utilizzo

Per impostazione predefinita, RDS for Db2 conserva i log per 5 minuti. Si consiglia di utilizzare strumenti di replica come CDC (Change Data Capture) o IBM Q Replication di impostare la conservazione dei log in tali strumenti AWS DMS per più di 5 minuti.

È possibile visualizzare l'impostazione corrente di conservazione dei registri di archivio chiamando. rdsadmin.show_archive_log_retention

Non è possibile configurare l'impostazione di conservazione dei log di archivio nel rdsadmin database.

Esempi

Esempio 1: impostazione del tempo di conservazione

L'esempio seguente imposta il tempo di conservazione dei log di archivio per un database chiamato TESTDB a 24 ore.

db2 "call rdsadmin.set_archive_log_retention(
    ?,
    'TESTDB', 
    '24')"

Esempio 2: disabilitazione del tempo di conservazione

L'esempio seguente disabilita la conservazione dei registri di archivio per un database chiamato. TESTDB

db2 "call rdsadmin.set_archive_log_retention(
    ?,
    'TESTDB', 
    '0')"

rdsadmin.show_archive_log_retention

Restituisce l'impostazione corrente di conservazione dei registri di archivio per il database specificato.

Sintassi

db2 "call rdsadmin.show_archive_log_retention(
    ?,
    'database_name')"

Parametri

È richiesto il seguente parametro di output:

?

Un indicatore di parametro che emette un messaggio di errore. Questo parametro accetta solo. ?

È richiesto il seguente parametro di input:

database_name

Il nome del database per cui mostrare l'impostazione di conservazione dei log di archivio. Il tipo di dati èvarchar.

Esempi

L'esempio seguente mostra l'impostazione di conservazione dei registri di archivio per un database chiamatoTESTDB.

db2 "call rdsadmin.show_archive_log_retention(
    ?
    'TESTDB')"

rdsadmin.list_archive_log_information

Restituisce dettagli sui file di registro dell'archivio, come la dimensione, la data e l'ora di creazione e il nome dei singoli file di registro per il database specificato. Restituisce inoltre la quantità totale di archiviazione utilizzata dai file di registro nel database.

Sintassi

db2 "call rdsadmin.list_archive_log_information(
    ?,
    'database_name')"

Parametri

È richiesto il seguente parametro di output:

?

Un indicatore di parametro che emette un messaggio di errore. Questo parametro accetta solo. ?

È richiesto il seguente parametro di input:

database_name

Il nome del database per cui elencare le informazioni del registro di archivio. Il tipo di dati èvarchar.

Esempi

L'esempio seguente restituisce le informazioni del registro di archivio per un database chiamatoTESTDB.

db2 "call rdsadmin.list_archive_log_information(
    ?
    'TESTDB')"