Referensi fungsi yang ditentukan pengguna Amazon RDS untuk Db2 - Layanan Basis Data Relasional Amazon
rdsadmin.get_task_statusrdsadmin.list_databases

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Referensi fungsi yang ditentukan pengguna Amazon RDS untuk Db2

Fungsi yang ditentukan pengguna berikut tersedia untuk instans Amazon RDS DB yang menjalankan mesin Db2.

rdsadmin.get_task_status

Menghasilkan status tugas.

Sintaks

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

Parameter-parameter

Parameter-parameter berikut bersifat opsional. Jika Anda tidak memberikan parameter sama sekali, fungsi buatan pengguna ini akan menghasilkan status semua tugas untuk semua basis data. Amazon RDS mempertahankan riwayat tugas selama 35 hari.

task_id

ID tugas yang sedang dijalankan. ID ini dihasilkan saat Anda menjalankan sebuah tugas. Default: 0.

database_name

Nama basis data yang menjalankan tugas.

task_type

Jenis tugas untuk dikueri. Nilai yang valid: ADD_GROUPSADD_USER,ALTER_BUFFERPOOL,ALTER_TABLESPACE,CHANGE_PASSWORD,COMPLETE_ROLLFORWARD,CREATE_BUFFERPOOL,CREATE_DATABASE,,CREATE_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.

Catatan penggunaan

Anda dapat menggunakan fungsi yang rdsadmin.get_task_status ditentukan pengguna untuk memeriksa status tugas berikut untuk Amazon RDS untuk Db2. Daftar ini tidak lengkap.

  • Membuat, mengubah, atau mengedrop kolam penyangga

  • Membuat, mengubah, atau mengedrop ruang tabel

  • Membuat atau mengedrop basis data

  • Memulihkan cadangan basis data dari Amazon S3

  • Menggulir maju log basis data dari Amazon S3

Contoh

Contoh berikut menampilkan kolom-kolom yang dihasilkan saat rdsadmin.get_task_status dipanggil.

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

Contoh berikut memerinci status semua tugas.

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

Contoh berikut memerinci status tugas tertentu.

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

Contoh berikut memerinci status tugas dan basis data tertentu.

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

Contoh berikut memerinci status semua tugas 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'))"

Contoh berikut memerinci status semua tugas untuk basis data tertentu. 

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

Contoh berikut menampilkan JSON nilai-nilai sebagai kolom.

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"

Respons

Fungsi buatan pengguna rdsadmin.get_task_status menghasilkan kolom-kolom berikut:

TASK_ID

ID tugas.

TASK_TYPE

Bergantung pada parameter-parameter input.

  • ADD_GROUPS – Menambahkan grup.

  • ADD_USER – Menambahkan pengguna.

  • ALTER_BUFFERPOOL – Mengubah kolam penyangga.

  • ALTER_TABLESPACE – Mengubah ruang tabel.

  • CHANGE_PASSWORD – Mengubah kata sandi pengguna.

  • COMPLETE_ROLLFORWARD – Menyelesaikan tugas rdsadmin.rollforward_database dan mengaktifkan basis data.

  • CREATE_BUFFERPOOL – Membuat kolam penyangga.

  • CREATE_DATABASE – Membuat basis data.

  • CREATE_ROLE – Membuat peran Db2 untuk pengguna.

  • CREATE_TABLESPACE – Membuat ruang tabel.

  • DROP_BUFFERPOOL – Mengedrop kolam penyangga.

  • DROP_DATABASE – Menghapus basis data.

  • DROP_TABLESPACE – Mengedrop ruang tabel.

  • LIST_USERS – Memerinci semua pengguna.

  • REMOVE_GROUPS – Menghapus grup.

  • REMOVE_USER – Menghapus pengguna.

  • RESTORE_DB – Memulihkan basis data lengkap.

  • ROLLFORWARD_DB_LOG – Melakukan tugas rdsadmin.rollforward_database pada log basis data.

  • ROLLFORWARD_STATUS – Menghasilkan status tugas rdsadmin.rollforward_database.

  • UPDATE_DB_PARAM – Memperbarui parameter data.

DATABASE_NAME

Nama basis data yang terkait dengan tugas.

COMPLETED_WORK_BYTES

Jumlah byte yang dipulihkan oleh tugas.

DURATION_MINS

Waktu yang dibutuhkan untuk menyelesaikan tugas.

LIFECYCLE

Status tugas. Status yang mungkin:

  • CREATED— Setelah tugas dikirimkan ke AmazonRDS, Amazon RDS menetapkan statusnyaCREATED.

  • IN_PROGRESS— Setelah tugas dimulai, Amazon RDS menetapkan statusnyaIN_PROGRESS. Diperlukan hingga 5 menit agar status berubah dari CREATED ke IN_PROGRESS.

  • SUCCESS— Setelah tugas selesai, Amazon RDS menetapkan statusnya. SUCCESS

  • ERROR— Jika tugas pemulihan gagal, Amazon RDS menyetel statusnyaERROR. Lihat informasi yang lebih lengkap tentang kesalahan ini di TASK_OUPUT.

CREATED_BY

authid yang membuat perintah.

CREATED_AT

Tanggal dan waktu ketika tugas dibuat.

LAST_UPDATED_AT

Tanggal dan waktu ketika tugas terakhir diperbarui.

TASK_INPUT_PARAMS

Parameter-parameter berbeda-beda berdasarkan jenis tugas. Semua parameter input direpresentasikan sebagai JSON objek. Misalnya, JSON kunci untuk RESTORE_DB tugas tersebut adalah sebagai berikut:

  • DBNAME

  • RESTORE_TIMESTAMP

  • S3_BUCKET_NAME

  • S3_PREFIX

TASK_OUTPUT

Informasi tambahan tentang tugas. Jika terjadi kesalahan selama pemulihan asli, kolom ini mencakup informasi tentang kesalahan itu.

Contoh respons

Contoh respons berikut menunjukkan bahwa basis data bernama TESTJP berhasil dibuat. Lihat informasi yang lebih lengkap di prosedur tersimpan 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`.

Contoh respons berikut menjelaskan alasan gagalnya pengedropan basis data. Lihat informasi yang lebih lengkap di prosedur tersimpan 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

Contoh respon berikut menunjukkan keberhasilan pemulihan database. Lihat informasi yang lebih lengkap di prosedur tersimpan 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

Mengembalikan daftar semua database yang berjalan pada contoh RDS untuk Db2 DB.

Sintaks

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

Catatan penggunaan

Fungsi yang ditentukan pengguna ini tidak menentukan apakah database berada dalam keadaan diaktifkan atau dinonaktifkan.

Jika Anda tidak melihat database dalam daftar, panggil fungsi yang rdsadmin.get_task_status ditentukan pengguna dan cari pesan kesalahan.

Respons

Fungsi buatan pengguna rdsadmin.list_databases menghasilkan kolom-kolom berikut:

DATABASE_NAME

Nama database.

CREATE_TIME

Tanggal dan waktu ketika database dibuat.

Contoh respons

Contoh respon berikut menunjukkan daftar database dan waktu ketika mereka dibuat. rdsadminadalah database yang RDS dikelola Amazon dan selalu muncul di 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