Riferimento alle funzioni definite dall'utente di Amazon RDS for Db2 - Amazon Relational Database Service
Verifica dello stato di un'attività

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

Riferimento alle funzioni definite dall'utente di Amazon RDS for Db2

L'argomento seguente descrive le funzioni definite dall'utente disponibili per le istanze Amazon RDS DB che eseguono il motore Db2.

Verifica dello stato di un'attività

Puoi utilizzare la funzione rdsadmin.get_task_status definita dall'utente per verificare lo stato delle seguenti attività per Amazon RDS for Db2. L'elenco non è completo.

  • Creare, modificare o eliminare un pool di buffer

  • Creare, modificare o eliminare una tablespace

  • Creare o eliminare un database

  • Ripristino di un backup del database da Amazon S3

  • Inoltro dei log del database da Amazon S3

rdsadmin.get_task_status

Restituisce lo stato di un'attività.

Sintassi

db2 "select task_id, task_type, database_name, lifecycle,
    varchar(bson_to_json(task_input_params), 500) as task_params,
    cast(task_output as varchar(500)) as task_output
    from table(rdsadmin.get_task_status(task_id,'database_name','task_type'))"

Parametri

I seguenti parametri sono opzionali. Se non si fornisce alcun parametro, la funzione definita dall'utente restituisce lo stato di tutte le attività per tutti i database. Amazon RDS conserva la cronologia delle attività per 35 giorni.

task_id

L'ID dell'attività in esecuzione. Questo ID viene restituito quando si esegue un'attività. Default: 0.

database_name

Il nome del database per il quale viene eseguita l'attività.

task_type

Il tipo di attività da interrogare. Valori validi: ADD_GROUPSADD_USER,ALTER_BUFFERPOOL,ALTER_TABLESPACE,CHANGE_PASSWORD,COMPLETE_ROLLFORWARD,CREATE_BUFFERPOOL, CREATE_DATABASECREATE_ROLE,CREATE_TABLESPACE,DROP_BUFFERPOOL,DROP_DATABASE,DROP_TABLESPACE,LIST_USERS,REMOVE_GROUPS,REMOVE_USER,RESTORE_DB,ROLLFORWARD_DB_LOG,ROLLFORWARD_STATUS,UPDATE_DB_PARAM.

Esempi

L'esempio seguente visualizza le colonne restituite quando rdsadmin.get_task_status viene chiamato.

db2 "describe select * from table(rdsadmin.get_task_status())"

L'esempio seguente elenca lo stato di tutte le attività.

db2 "select task_id, task_type, database_name, lifecycle, 
    varchar(bson_to_json(task_input_params), 500) as task_params, 
    cast(task_output as varchar(500)) as task_output 
    from table(rdsadmin.get_task_status(null,null,null))"

L'esempio seguente elenca lo stato di un'attività specifica.

db2 "select task_id, task_type, database_name, 
    varchar(bson_to_json(task_input_params), 500) as task_params 
    from table(rdsadmin.get_task_status(1,null,null))"

L'esempio seguente elenca lo stato di un'attività e di un database specifici.

db2 "select task_id, task_type, database_name, 
    varchar(bson_to_json(task_input_params), 500) as task_params 
    from table(rdsadmin.get_task_status(2,'SAMPLE',null))"

L'esempio seguente elenca lo stato di tutte le ADD_GROUPS attività.

db2 "select task_id, task_type, database_name, 
    varchar(bson_to_json(task_input_params), 500) as task_params 
    from table(rdsadmin.get_task_status(null,null,'add_groups'))"

L'esempio seguente elenca lo stato di tutte le attività per un database specifico. 

db2 "select task_id, task_type, database_name, 
    varchar(bson_to_json(task_input_params), 500) as task_params 
    from table(rdsadmin.get_task_status(null,'testdb', null))"

L'esempio seguente restituisce i JSON valori come colonne.

db2 "select varchar(r.task_type,25) as task_type, varchar(r.lifecycle,10) as lifecycle, r.created_at, u.* from 
    table(rdsadmin.get_task_status(null,null,'restore_db')) as r, json_table(r.task_input_params, 'strict $' columns(s3_prefix varchar(500) 
    null on empty, s3_bucket_name varchar(500) null on empty) error on error ) as U"

Risposta

La funzione rdsadmin.get_task_status definita dall'utente restituisce le seguenti colonne:

TASK_ID

L'ID dell'attività.

TASK_TYPE

Dipende dai parametri di input.

  • ADD_GROUPS— Aggiunge gruppi.

  • ADD_USER— Aggiunge un utente.

  • ALTER_BUFFERPOOL— Modifica un buffer pool.

  • ALTER_TABLESPACE— Modifica una tablespace.

  • CHANGE_PASSWORD — Modifica la password di un utente.

  • COMPLETE_ROLLFORWARD— Completa un'rdsadmin.rollforward_databaseattività e attiva un database.

  • CREATE_BUFFERPOOL— Crea un pool di buffer.

  • CREATE_DATABASE— Crea un database.

  • CREATE_ROLE— Crea un ruolo Db2 per un utente.

  • CREATE_TABLESPACE— Crea un tablespace.

  • DROP_BUFFERPOOL— Elimina un buffer pool.

  • DROP_DATABASE— Elimina un database.

  • DROP_TABLESPACE— Elimina un tablespace.

  • LIST_USERS— Elenca tutti gli utenti.

  • REMOVE_GROUPS— Rimuove i gruppi.

  • REMOVE_USER— Rimuove un utente.

  • RESTORE_DB— Ripristina un database completo.

  • ROLLFORWARD_DB_LOG— Esegue un'rdsadmin.rollforward_databaseoperazione sui registri del database.

  • ROLLFORWARD_STATUS — Restituisce lo stato di un'rdsadmin.rollforward_databaseattività.

  • UPDATE_DB_PARAM— Aggiorna i parametri dei dati.

DATABASE_NAME

Il nome del database a cui è associata l'attività.

COMPLETED_WORK_BYTES

Il numero di byte ripristinati dall'operazione.

DURATION_MINS

Il tempo impiegato per completare l'operazione.

LIFECYCLE

Lo stato dell'attività. Stati possibili:

  • CREATED— Dopo che un'attività è stata inviata ad AmazonRDS, Amazon RDS imposta lo stato suCREATED.

  • IN_PROGRESS— Dopo l'avvio di un'attività, Amazon RDS imposta lo stato suIN_PROGRESS. La modifica dello stato da a può richiedere fino a 5 minutiIN_PROGRESS. CREATED

  • SUCCESS— Al termine di un'attività, Amazon RDS imposta lo stato su. SUCCESS

  • ERROR— Se un'operazione di ripristino fallisce, Amazon RDS imposta lo stato suERROR. Per ulteriori informazioni sull'errore, consultaTASK_OUPUT.

CREATED_BY

Quello authid che ha creato il comando.

CREATED_AT

La data e l'ora in cui è stata creata l'attività.

LAST_UPDATED_AT

La data e l'ora dell'ultimo aggiornamento dell'attività.

TASK_INPUT_PARAMS

I parametri variano in base al tipo di attività. Tutti i parametri di input sono rappresentati come un JSON oggetto. Ad esempio, le JSON chiavi per l'RESTORE_DBoperazione sono le seguenti:

  • DBNAME

  • RESTORE_TIMESTAMP

  • S3_BUCKET_NAME

  • S3_PREFIX

TASK_OUTPUT

Ulteriori informazioni sull'attività. Se si verifica un errore durante il ripristino nativo, questa colonna include informazioni sull'errore.

Esempi di risposte

Il seguente esempio di risposta mostra che un database chiamato TESTJP è stato creato con successo. Per ulteriori informazioni, vedere la rdsadmin.create_database stored procedure.

`1 SUCCESS CREATE_DATABASE RDSDB 2023-10-24-18.32.44.962689 2023-10-24-18.34.50.038523 1 TESTJP { "CODESET" : "IBM-437", "TERRITORY" : "JP", "COLLATION" : "SYSTEM", "AUTOCONFIGURE_CMD" : "", "PAGESIZE" : 4096 } 
2023-10-24-18.33.30.079048 Task execution has started.

2023-10-24-18.34.50.038523 Task execution has completed successfully`.

Il seguente esempio di risposta spiega perché l'eliminazione di un database non è riuscita. Per ulteriori informazioni, vedere la rdsadmin.drop_database stored procedure.

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

Il seguente esempio di risposta mostra il corretto ripristino di un database. Per ulteriori informazioni, vedere la rdsadmin.restore_database stored procedure.

1 RESTORE_DB  SAMPLE  SUCCESS   
                                         
{ "S3_BUCKET_NAME" : "amzn-s3-demo-bucket", "S3_PREFIX" : "SAMPLE.0.rdsdb3.DBPART000.20230413183211.001", "RESTORE_TIMESTAMP" : "20230413183211", "BACKUP_TYPE" : "offline" }                                                                                                                                                                                                                                                                                                                                                   

2023-11-06-18.31.03.115795 Task execution has started.
2023-11-06-18.31.04.300231 Preparing to download
2023-11-06-18.31.08.368827 Download complete. Starting Restore
2023-11-06-18.33.13.891356 Task Completed Successfully