Informazioni di riferimento sulle funzioni definite dall’utente di Amazon RDS per Db2 - Amazon Relational Database Service
rdsadmin.get_task_statusrdsadmin.list_databases

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

Informazioni di riferimento sulle funzioni definite dall’utente di Amazon RDS per Db2

Le funzioni definite dall’utente descritte di seguito sono disponibili per le istanze database Amazon RDS che eseguono il motore Db2.

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 parametri seguenti sono facoltativi. Se non è specificato alcun parametro, la funzione definita dall’utente restituisce lo stato di tutte le attività per tutti i database. Amazon RDS mantiene la cronologia delle attività per 35 giorni.

task_id

L’ID dell’attività in esecuzione. Questo ID viene restituito durante l’esecuzione di un’attività. Default: 0.

database_name

Il nome del database per cui viene eseguita l’attività.

task_type

Il tipo di attività su cui eseguire query. 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.

Note per l’utilizzo

È possibile utilizzare la funzione rdsadmin.get_task_status definita dall’utente per verificare lo stato delle seguenti attività in Amazon RDS per Db2. Questo elenco non è completo.

  • Creazione, modifica o eliminazione di un pool di buffer

  • Creazione, modifica o eliminazione di un tablespace

  • Creazione o eliminazione di un database

  • Ripristino di un backup di database da Amazon S3

  • Roll forward dei log di database da Amazon S3

Esempi

L’esempio seguente mostra le colonne restituite quando viene chiamata la funzione rdsadmin.get_task_status.

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

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 valori JSON 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 pool di buffer.

  • ALTER_TABLESPACE: modifica un tablespace.

  • CHANGE_PASSWORD : modifica la password di un utente.

  • COMPLETE_ROLLFORWARD: completa un’attività rdsadmin.rollforward_database 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 pool di buffer.

  • DROP_DATABASE: elimina un database.

  • DROP_TABLESPACE: elimina un tablespace.

  • LIST_USERS: elenca tutti gli utenti.

  • REMOVE_GROUPS: rimuove gruppi.

  • REMOVE_USER: rimuove un utente.

  • RESTORE_DB: ripristina un database completo.

  • ROLLFORWARD_DB_LOG: esegue un’attività rdsadmin.rollforward_database sui log del database.

  • ROLLFORWARD_STATUS : restituisce lo stato di un’attività rdsadmin.rollforward_database.

  • 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’attività.

DURATION_MINS

Il tempo necessario per completare l’attività.

LIFECYCLE

Lo stato dell'attività. Stati possibili:

  • CREATED: dopo l’invio di un’attività ad Amazon RDS, lo stato viene impostato su CREATED.

  • IN_PROGRESS: dopo l’avvio di un’attività, lo stato viene impostato su IN_PROGRESS. Possono essere necessari fino a 5 minuti perché lo stato passi da CREATED a IN_PROGRESS.

  • SUCCESS: al termine di un’attività, lo stato viene impostato su SUCCESS.

  • ERROR: se un’attività di ripristino non riesce, lo stato viene impostato su ERROR. Per ulteriori informazioni sull’errore, consulta TASK_OUPUT.

CREATED_BY

L’authid che ha creato il comando.

CREATED_AT

La data e l’ora di creazione dell’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 oggetto JSON. Ad esempio, le chiavi JSON per l’attività RESTORE_DB 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 contiene informazioni sull’errore.

Esempi di risposta

Il seguente esempio di risposta mostra l’esito positivo della creazione di un database denominato TESTJP. Per ulteriori informazioni, consulta la stored procedure rdsadmin.create_database.

`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 illustra il motivo per cui l’eliminazione di un database non è riuscita. Per ulteriori informazioni, consulta la stored procedure rdsadmin.drop_database.

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 l’esito positivo del ripristino di un database. Per ulteriori informazioni, consulta la stored procedure rdsadmin.restore_database.

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

rdsadmin.list_databases

Restituisce un elenco di tutti i database in esecuzione su un’istanza database RDS per Db2.

Sintassi

db2 "select * from table(rdsadmin.list_databases())"

Note per l’utilizzo

Questa funzione definita dall’utente non specifica se i database sono in stato attivato o disattivato.

Se i database non sono visualizzati nell’elenco, chiama la funzione rdsadmin.get_task_status definita dall’utente e cerca i messaggi di errore.

Risposta

La funzione rdsadmin.list_databases definita dall’utente restituisce le seguenti colonne:

DATABASE_NAME

Il nome di un database.

CREATE_TIME

La data e l’ora di creazione del database.

Esempi di risposta

Il seguente esempio di risposta mostra un elenco di database e l’ora in cui sono stati creati. rdsadmin è un database gestito da Amazon RDS e appare sempre nell’output.

DATABASE_NAME   CREATE_TIME
--------------- --------------------------
rdsadmin        2024-10-22-03.37.48.535671
TEST            2024-10-22-03.39.36.818679
TEST1           2024-10-22-03.57.15.218009
TEST2           2024-10-22-03.59.28.029556