Procedure archiviate per database RDS per Db2 - Amazon Relational Database Service
rdsadmin.create_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_retention

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 RDS per Db2

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

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, consultate Scelta della tabella codici, del territorio e delle regole di confronto per il database nella IBM Db2 documentazione.

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, consulta 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 (EBCDICinglese americano).

  • EBCDIC_819_500— Tabella codici ISO in latino, fascicolazione; CCSID 500 (EBCDICinternazionale).

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

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

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

  • EBCDIC_932_5035— Tabella codici ASCII giapponese, fascicolazione; CCSID 500 (EBCDICinternazionale).

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

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

  • 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 per Db2 supporta i seguenti gruppi di regole di confronto: e. language-aware-collation locale-sensitive-collation Per ulteriori informazioni, vedere Scelta di un confronto per un database Unicode nel IBM Db2 documentazione.

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 AUTOCONFIGURE comando in IBM Db2 documentazione.

Note per l'utilizzo

Puoi creare un database chiamando rdsadmin.create_database se non hai specificato il nome del database quando hai creato l'istanza DB RDS for Db2 utilizzando la RDS console Amazon o il AWS CLI. Per ulteriori informazioni, consulta Creazione di un'istanza database.

Considerazioni speciali:

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

  • RDSsolo per usi Db2. AUTOMATIC STORAGE

  • RDSper Db2 utilizza i valori predefiniti per NUMSEGS e. DFT_EXTENT_SZ

  • RDSper Db2 utilizza la crittografia dello storage e non supporta la crittografia del database.

Per ulteriori informazioni su queste considerazioni, vedere CREATE DATABASE comando in IBM Db2 documentazione.

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

db2 connect to rdsadmin user master_username using master_password

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

Esempi

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

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

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 RDS console Amazon 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 relative all'istanza DB RDS per 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

Esempi

L'esempio seguente elimina un database chiamatoTESTDB:

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

Esempi di risposta

Se si passa un nome di database errato, la stored procedure restituisce il seguente esempio di risposta:

SQL0438N Application raised error or warning with diagnostic text: "Cannot
drop database. Database with provided name does not exist". SQLSTATE=99993

Se hai creato il database utilizzando la RDS console Amazon o AWS CLI, la stored procedure restituisce il seguente esempio di risposta:

Return Status = 0

Dopo la ricezioneReturn Status = 0, richiama la rdsadmin.get_task_status stored procedure. Una risposta simile all'esempio seguente spiega lo stato:

1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started.
2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task. 
Reason Dropping database created via rds CreateDBInstance api is not allowed. 
Only database created using rdsadmin.create_database can be dropped

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 Amazon RDS per parametri 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.

Esempi

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

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

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

Esempi di risposta

Se si tenta di modificare un parametro di configurazione del database che non è supportato o modificabile, la stored procedure restituisce il seguente esempio di risposta:

SQL0438N Application raised error or warning with diagnostic text: "Parameter
is either not supported or not modifiable to customers". SQLSTATE=99993

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, consultare la .IBM Db2 documentazione.

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 dell'istanza vCPUs DB. Se questa impostazione non è configurata, Db2 determina il valore da utilizzare durante l'operazione di ripristino. Per ulteriori informazioni, consultare la .IBM Db2 documentazione.

Esempi

L'esempio seguente imposta la RESTORE_DATABASE_PARALLELISM configurazione su8.

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

L'esempio seguente imposta la RESTORE_DATABASE_NUM_BUFFERS configurazione su150.

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.

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 da ripristinare. Questo nome deve corrispondere al nome del database nell'immagine di backup. 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 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

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

  • Puoi ripristinare un database chiamando rdsadmin.restore_database solo se non hai specificato il nome del database quando hai creato l'istanza DB RDS for Db2 utilizzando la RDS console Amazon o il AWS CLI. Per ulteriori informazioni, consulta Creazione di un'istanza database.

  • Prima di ripristinare un database, devi fornire uno spazio di archiviazione RDS per l'istanza DB Db2 uguale 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 pesare almeno 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.20230615010101ripristina 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

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

  • RDSfor 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. 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

Esempi

L'esempio seguente ripristina un backup offline con un singolo file o più file che dispongono del 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 in linea 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, 
    'rollfoward_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

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

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

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

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 offline. 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 riporta il TESTDB database online:

db2 "call rdsadmin.complete_rollfoward(
    ?,
    '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 nel IBM Db2 documentazione.

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 di stacks non è supportato, ad esempio,db2pd -edus interval=5 top=10 stacks.

Note per l'utilizzo

Questa procedura memorizzata raccoglie informazioni che possono aiutare nel monitoraggio e nella risoluzione dei problemi RDS per i database Db2.

La stored procedure utilizza il IBM db2pdutilità per eseguire vari comandi. L'db2pdutilità richiede SYSADM l'autorizzazione, che l'utente master RDS for Db2 non ha. Tuttavia, con la procedura RDS memorizzata di Amazon, l'utente principale è in grado di utilizzare l'utilità per eseguire vari comandi. Per ulteriori informazioni sull'utilità, consulta db2pd - Monitora e risolvi i problemi del database Db2 nel IBM Db2 documentazione.

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

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

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

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

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

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

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

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

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

rdsadmin.force_application

Forza le applicazioni a uscire 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 vuoi forzare la disattivazione di 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 APPLICATIONcomando. Il FORCE APPLICATION comando richiede un'SYSADMSYSCTRLautorizzazione che l'utente master RDS for Db2 non ha. SYSMAINT Tuttavia, con la procedura RDS memorizzata di Amazon, l'utente principale è in grado di utilizzare il comando. Per ulteriori informazioni, consulta FORCEAPPLICATIONil comando in IBM Db2 documentazione.

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

Esempi

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

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

L'esempio seguente impone la 1192 disattivazione e la disattivazione degli handle 9991 delle applicazioni RDS per un database 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 specificato RDS per Db2.

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 per Db2 conserva i log per 5 minuti. Se si utilizzano strumenti di replica, ad AWS DMS esempio Change Data Capture () o CDC IBM Q Replication, è possibile impostare la conservazione dei log in tali strumenti per più di 5 minuti.

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

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

Esempi

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

L'esempio seguente disattiva la conservazione dei registri di archivio per un database chiamatoTESTDB.

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