GetFullRequestStatResultByInstanceId - Database Autonomy Service

Mengumpulkan statistik permintaan lengkap secara asinkron dari hasil Penjelajah SQL suatu instansiasi basis data berdasarkan ID SQL.

Deskripsi operasi

Catatan

GetFullRequestStatResultByInstanceId merupakan operasi asinkron. Setelah permintaan dikirim, hasil lengkap tidak langsung dikembalikan. Jika nilai parameter isFinish dalam respons adalah false, tunggu selama 1 detik lalu kirim ulang permintaan. Jika nilai parameter isFinish adalah true, hasil lengkap akan dikembalikan.

Fitur Penjelajah SQL memungkinkan Anda memeriksa status kesehatan pernyataan SQL dan memecahkan masalah performa. Untuk informasi selengkapnya, lihat SQL Explorer.

Untuk informasi lebih lanjut mengenai instansiasi basis data yang mendukung fitur ini, lihat Ikhtisar DAS Edisi Perusahaan.
Jika Anda menggunakan SDK untuk memanggil operasi API Database Autonomy Service (DAS), Anda harus menetapkan ID wilayah ke cn-shanghai.
Saat memanggil operasi ini, nilai parameter SqlId berubah akibat optimasi algoritma templat SQL mulai 1 September 2024. Untuk informasi selengkapnya, lihat [Pemberitahuan] Optimasi algoritma templat SQL.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

hdm:GetFullRequestStatResultByInstanceId

get

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
UserId	string	No	ID akun Alibaba Cloud yang digunakan untuk membuat instansiasi basis data. Catatan Parameter ini bersifat opsional. Sistem dapat secara otomatis memperoleh ID akun Alibaba Cloud berdasarkan nilai InstanceId saat Anda memanggil operasi GetFullRequestOriginStatByInstanceId.	196278346919****
InstanceId	string	Yes	ID instans.	rm-2ze8g2am97624****
NodeId	string	No	ID node. Catatan Anda harus menentukan ID node jika instansiasi basis data Anda merupakan kluster PolarDB for MySQL.	pi-bp12v7243x012****
SqlId	string	No	ID SQL. Catatan Jika parameter ini ditentukan, statistik permintaan lengkap dari kueri SQL yang ditentukan akan dikumpulkan. Jika parameter ini dikosongkan, statistik permintaan lengkap dari seluruh instansiasi basis data akan dikumpulkan.	d71f82be1eef72bd105128204d2e****
OriginHost	string	No	Alamat IP client yang mengeksekusi pernyataan SQL. Catatan Parameter ini bersifat opsional. Jika parameter ini ditentukan, statistik permintaan lengkap dari alamat IP yang ditentukan akan dikumpulkan. Jika parameter ini dikosongkan, statistik permintaan lengkap dari seluruh instansiasi basis data akan dikumpulkan.	172.26.XX.XXX
Keyword	string	No	Kata kunci yang digunakan untuk kueri.	dbtest01
Start	integer	Yes	Awal rentang waktu untuk dikueri. Tetapkan parameter ini sebagai stempel waktu UNIX yang merepresentasikan jumlah milidetik sejak 1 Januari 1970 pukul 00:00:00 UTC. Catatan Waktu mulai dapat mencapai maksimal 90 hari sebelum waktu saat ini.	1645581813000
End	integer	Yes	Akhir rentang waktu untuk dikueri. Tetapkan parameter ini sebagai stempel waktu UNIX yang merepresentasikan jumlah milidetik sejak 1 Januari 1970 pukul 00:00:00 UTC. Catatan Waktu akhir harus lebih baru daripada waktu mulai. Interval tidak boleh melebihi satu hari.	1645668213000
OrderBy	string	No	Bidang yang digunakan untuk mengurutkan entri yang dikembalikan. Nilai default: count. Nilai yang valid: count: jumlah eksekusi. avgRt: durasi eksekusi rata-rata. rtRate: persentase durasi eksekusi. rowsExamined: total jumlah baris yang dipindai. avgRowsExamined: jumlah rata-rata baris yang dipindai. avgRowsReturned: jumlah rata-rata baris yang dikembalikan.	count
Asc	boolean	No	Menentukan apakah hasil diurutkan secara ascending. Secara default, hasil tidak diurutkan secara ascending.	Disabled
PageNo	integer	Yes	Nomor halaman. Halaman dimulai dari halaman 1. Nilai default: 1.	1
PageSize	integer	Yes	Jumlah entri per halaman. Nilai default: 20.	20
SqlType	string	No	Tipe pernyataan SQL. Nilai yang valid: SELECT, INSERT, UPDATE, DELETE, LOGIN, LOGOUT, MERGE, ALTER, CREATEINDEX, DROPINDEX, CREATE, DROP, SET, DESC, REPLACE, CALL, BEGIN, DESCRIBE, ROLLBACK, FLUSH, USE, SHOW, START, COMMIT, dan RENAME. Catatan Jika instansiasi basis data Anda merupakan instans ApsaraDB RDS for MySQL, kluster PolarDB for MySQL, atau instans PolarDB-X 2.0, statistik dapat dikumpulkan berdasarkan tipe pernyataan SQL.	SELECT
DbName	string	No	Nama database.	dbtest01
Role	string	No	Peran node dalam instans PolarDB-X 2.0. Nilai yang valid: polarx_cn: node komputasi. polarx_dn: node data.	polarx_cn

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
Message	string	Pesan yang dikembalikan. Catatan Jika permintaan berhasil, Successful dikembalikan. Jika permintaan gagal, pesan kesalahan yang berisi informasi seperti kode kesalahan dikembalikan.	Successful
RequestId	string	ID permintaan.	7172BECE-588A-5961-8126-C216E16B****
Data	object	Data yang dikembalikan.
Result	object	Data permintaan lengkap yang dikembalikan.
List	array<object>	Data permintaan lengkap.
	object
SqlId	string	ID SQL.	d71f82be1eef72bd105128204d2e****
AvgFetchRows	integer	Jumlah rata-rata baris yang diambil oleh node komputasi dari node data pada instans PolarDB-X 2.0.	0
AvgLockWaitTime	number	Latensi tunggu kunci rata-rata. Satuan: detik.	0.00009589874265269765
AvgLogicalRead	number	Jumlah rata-rata pembacaan logis.	654.4470327860251
AvgPhysicalAsyncRead	integer	Jumlah rata-rata pembacaan fisik asinkron.	0
AvgPhysicalSyncRead	integer	Jumlah rata-rata pembacaan fisik sinkron.	0
AvgExaminedRows	number	Jumlah rata-rata baris yang dipindai. Catatan Parameter ini hanya dikembalikan untuk database ApsaraDB RDS for MySQL, ApsaraDB RDS for PostgreSQL, dan PolarDB for MySQL.	10000
AvgReturnedRows	number	Jumlah rata-rata baris yang dikembalikan.	10000
AvgUpdatedRows	integer	Jumlah rata-rata baris yang diperbarui. Catatan Parameter ini hanya dikembalikan untuk database ApsaraDB RDS for MySQL dan PolarDB-X 2.0.	10000
AvgRt	number	Durasi eksekusi rata-rata.	2.499
AvgSqlCount	integer	Jumlah rata-rata pernyataan SQL.	10000
Count	integer	Total jumlah eksekusi.	100000
CountRate	number	Persentase dari total jumlah eksekusi.	0.0586
Database	string	Nama database.	dbtest01
ErrorCount	integer	Jumlah eksekusi yang gagal.	1
FetchRows	integer	Jumlah baris yang diambil oleh node komputasi dari node data pada instans PolarDB-X 2.0.	0
Ip	string	Alamat IP instansiasi basis data.	rm-uf6dyi58dm6**.mysql.rds.aliy**.com
LockWaitTime	number	Latensi tunggu kunci. Satuan: detik.	1089.4177720290281
LogicalRead	integer	Jumlah pembacaan logis.	7.434573266E9
PhysicalAsyncRead	integer	Jumlah pembacaan fisik asinkron.	0
PhysicalSyncRead	integer	Jumlah pembacaan fisik sinkron.	0
Port	integer	Nomor port yang digunakan untuk menghubungkan ke instansiasi basis data.	3306
Psql	string	Templat SQL.	select * from dbtest01 where ****
Rows	integer	Total jumlah baris yang diperbarui atau dikembalikan oleh node komputasi instans PolarDB-X 2.0.	0
ExaminedRows	integer	Total jumlah baris yang dipindai. Catatan Parameter ini hanya dikembalikan untuk database ApsaraDB RDS for MySQL, ApsaraDB RDS for PostgreSQL, dan PolarDB for MySQL.	10000
RtGreaterThanOneSecondCount	integer	Jumlah pernyataan SQL yang memerlukan waktu eksekusi lebih dari 1 detik.	20
RtRate	number	Persentase durasi eksekusi.	2.499
SqlCount	integer	Jumlah pernyataan SQL.	200
SumUpdatedRows	integer	Total jumlah baris yang diperbarui.	100
Tables	array	Nama tabel dalam database.
	string	Nama tabel dalam database.	tabletest01,tabletest02
Version	integer	Nomor versi.	1
VpcId	string	ID virtual private cloud (VPC).	vpc-2zentqj1sk4qmolci****
Total	integer	Total jumlah entri yang dikembalikan.	1
Fail	boolean	Menunjukkan apakah permintaan asinkron gagal. Nilai yang valid: true false	false
IsFinish	boolean	Menunjukkan apakah permintaan asinkron telah selesai. Nilai yang valid: true false	true
ResultId	string	ID permintaan.	9CB97BC4-6479-55D0-B9D0-EA925AFE****
State	string	Status permintaan asinkron. Nilai yang valid: RUNNING SUCCESS FAIL	SUCCESS
Timestamp	integer	Waktu saat permintaan asinkron dikirim. Nilainya berupa stempel waktu UNIX yang merepresentasikan jumlah milidetik sejak 1 Januari 1970 pukul 00:00:00 UTC.	1645668213000
Code	integer	Kode status HTTP yang dikembalikan.	200
Success	boolean	Menunjukkan apakah permintaan berhasil. Nilai yang valid: true false	true

Contoh

Respons sukses

JSONformat

{
  "Message": "Successful",
  "RequestId": "7172BECE-588A-5961-8126-C216E16B****",
  "Data": {
    "Result": {
      "List": [
        {
          "SqlId": "d71f82be1eef72bd105128204d2e****",
          "AvgFetchRows": 0,
          "AvgLockWaitTime": 0.00009589874265269765,
          "AvgLogicalRead": 654.4470327860251,
          "AvgPhysicalAsyncRead": 0,
          "AvgPhysicalSyncRead": 0,
          "AvgExaminedRows": 10000,
          "AvgReturnedRows": 10000,
          "AvgUpdatedRows": 10000,
          "AvgRt": 2.499,
          "AvgSqlCount": 10000,
          "Count": 100000,
          "CountRate": 0.0586,
          "Database": "dbtest01",
          "ErrorCount": 1,
          "FetchRows": 0,
          "Ip": "rm-uf6dyi58dm6****.mysql.rds.aliy****.com",
          "LockWaitTime": 1089.4177720290281,
          "LogicalRead": 7434573266,
          "PhysicalAsyncRead": 0,
          "PhysicalSyncRead": 0,
          "Port": 3306,
          "Psql": "select * from dbtest01 where ****",
          "Rows": 0,
          "ExaminedRows": 10000,
          "RtGreaterThanOneSecondCount": 20,
          "RtRate": 2.499,
          "SqlCount": 200,
          "SumUpdatedRows": 100,
          "Tables": [
            "tabletest01,tabletest02"
          ],
          "Version": 1,
          "VpcId": "vpc-2zentqj1sk4qmolci****"
        }
      ],
      "Total": 1
    },
    "Fail": false,
    "IsFinish": true,
    "ResultId": "9CB97BC4-6479-55D0-B9D0-EA925AFE****",
    "State": "SUCCESS",
    "Timestamp": 1645668213000
  },
  "Code": 200,
  "Success": true
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidParams	The request parameters are invalid.
403	NoPermission	You are not authorized to do this action.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.