DescribeSqlInsightStatistic - Database Autonomy Service - Alibaba Cloud Documentation Center

Memanggil operasi DescribeSqlInsightStatistic untuk mengagregasi dan mengumpulkan statistik data Penjelajah SQL untuk instans tertentu dalam jendela waktu tertentu, berdasarkan dimensi seperti templat SQL, sumber akses, atau pengguna database.

Deskripsi operasi

Sebelum memulai:

Saat menggunakan SDK Alibaba Cloud atau DAS, gunakan versi terbaru.
Saat memanggil DAS menggunakan SDK, atur wilayah ke cn-shanghai.
Penjelajah SQL harus diaktifkan untuk instans target. Jika Penjelajah SQL tidak diaktifkan, operasi akan mengembalikan error.

Catatan penggunaan:

Ini adalah operasi asinkron. Panggilan pertama mengembalikan ResultId dan State. Lakukan polling dengan parameter permintaan yang sama persis hingga State menjadi SUCCESS untuk mendapatkan hasil statistik di Data.
StartTime dan EndTime adalah stempel waktu tingkat milidetik. StartTime harus berada dalam 30 hari terakhir, dan rentang antara StartTime dan EndTime tidak boleh melebihi 7 hari.
Karena agregasi data melibatkan latensi, EndTime secara otomatis dipangkas hingga beberapa menit sebelum waktu saat ini. Data dari beberapa menit terakhir mungkin tidak tersedia.
StartTime secara otomatis disesuaikan agar tidak lebih awal dari waktu saat Penjelajah SQL diaktifkan untuk instans.

Deskripsi tanggapan:

Data.Data.List berisi hasil statistik yang dikelompokkan berdasarkan dimensi agregasi. Setiap elemen sesuai dengan templat SQL atau kunci agregasi, bukan catatan eksekusi individual.
Scnt, AvgScnt, Rows, AvgRows, Frows, dan AvgFrows adalah metrik eksklusif untuk node komputasi PolarDB Basis Data Relasional Cloud-Native-X dan hanya dikembalikan ketika Role adalah polarx_cn.
Writes, AvgWrites, MaxWrites, MinWrites, PhysicalRead, AvgPhysicalRead, MaxPhysicalRead, MinPhysicalRead, CpuTime, AvgCpuTime, MaxCpuTime, dan MinCpuTime adalah metrik eksklusif untuk instans SQL Server.
Trend hanya dikembalikan ketika parameter permintaan DoFillTrend diatur ke true dan kemampuan pengisian tren diaktifkan untuk instans. Interval irisan waktu ditentukan secara otomatis oleh rentang kueri.
Bidang dimensi sampel SQL seperti SqlNew, Params, FirstTime, dan Extra tidak dikembalikan oleh operasi ini. Operasi ini menyediakan statistik agregat tingkat templat.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
ConsoleContext	string	No	Parameter yang dicadangkan.	null
InstanceId	string	Yes	ID instans database. Catatan Operasi ini mendukung instans RDS for MySQL, PolarDB Basis Data Relasional Cloud-Native for MySQL, PolarDB Basis Data Relasional Cloud-Native-X, RDS for PostgreSQL, PolarDB Basis Data Relasional Cloud-Native for PostgreSQL, RDS for SQL Server, dan Lindorm yang memiliki Penjelajah SQL diaktifkan. Instans MongoDB dan Redis tidak didukung. Memanggil operasi ini untuk instans yang tidak didukung akan mengembalikan error yang menunjukkan bahwa operasi tidak didukung.	rm-bp1q6f9z5xxxxxxxx
NodeId	string	No	ID node instans. Parameter ini mempersempit cakupan statistik ke node yang ditentukan. Hanya satu ID node yang didukung. Anda tidak dapat menentukan beberapa ID node yang dipisahkan koma. Catatan Parameter ini hanya diperlukan untuk instans yang terdiri dari beberapa node, seperti instans PolarDB Basis Data Relasional Cloud-Native-X dan Lindorm. Anda dapat mengabaikan parameter ini untuk instans node tunggal.	pi-bp1xxxxxxxxxxxx
Type	string	No	Dimensi agregasi atau filter untuk statistik. Nilai tidak peka huruf besar/kecil. Jika parameter ini tidak ditentukan, statistik diagregasi berdasarkan templat SQL secara default. Nilai valid: FullRequestOrigin: Agregasi berdasarkan alamat sumber akses. FullRequestUser: Agregasi berdasarkan pengguna database. SQL: Filter berdasarkan templat SQL. Anda juga harus menentukan TemplateId sebagai ID templat SQL. OriginHost: Filter berdasarkan sumber akses. Anda juga harus menentukan TemplateId sebagai alamat sumber. User: Filter berdasarkan pengguna database. Anda juga harus menentukan TemplateId sebagai nama pengguna. Catatan Menentukan nilai selain nilai yang disebutkan sebelumnya akan mengembalikan error InvalidParams.	SQL
TemplateId	string	No	Pengidentifikasi objek statistik. Maknanya bervariasi tergantung pada nilai Type. Nilai valid: Ketika Type diatur ke SQL: ID templat SQL, yang sesuai dengan SqlId di tanggapan. Ketika Type diatur ke OriginHost: alamat sumber akses. Ketika Type diatur ke User: nama pengguna database. Catatan Parameter ini tidak berlaku ketika Type tidak ditentukan, atau diatur ke FullRequestOrigin atau FullRequestUser. Catatan Ketika Type diatur ke SQL, Anda dapat menentukan beberapa ID templat yang dipisahkan koma. Dalam hal ini, parameter Keyword tidak berlaku.	9f8e7d6c5b4a3210
Keyword	string	No	Kata kunci untuk pencarian fuzzy pada konten templat SQL. Pisahkan beberapa kata kunci dengan spasi. Sistem pertama-tama melakukan pencocokan kata kunci untuk menemukan templat SQL yang sesuai (hingga 1.000 templat), lalu melakukan statistik agregasi berdasarkan templat tersebut. Jika tidak ada templat yang cocok, daftar kosong dikembalikan. Catatan Parameter ini tidak berlaku ketika Type diatur ke SQL dan TemplateId ditentukan.	t_order
StartTime	integer	Yes	Waktu mulai kueri. Tentukan stempel waktu UNIX dalam milidetik. Sistem membulatkan ke bawah ke menit terdekat. Catatan Nilai harus berada dalam 30 hari terakhir. Jika nilai lebih awal dari waktu saat Penjelajah SQL diaktifkan untuk instans, nilai tersebut secara otomatis disesuaikan ke waktu saat Penjelajah SQL diaktifkan.	1718000000000
EndTime	integer	Yes	Waktu akhir kueri. Tentukan stempel waktu UNIX dalam milidetik. Sistem membulatkan ke atas ke menit terdekat. Catatan Rentang antara nilai ini dan StartTime tidak boleh melebihi 7 hari. Jika EndTime lebih awal dari waktu saat Penjelajah SQL diaktifkan untuk instans, error yang menunjukkan bahwa waktu kueri lebih awal dari waktu yang tersedia akan dikembalikan. Catatan Karena agregasi data melibatkan latensi, nilai efektif sebenarnya dipangkas hingga beberapa menit sebelum waktu saat ini. Data dari beberapa menit terakhir mungkin tidak tersedia.	1718600000000
OrderBy	string	No	Bidang yang digunakan untuk pengurutan. Jika parameter ini tidak ditentukan atau nilai yang tidak didukung ditentukan, hasil diurutkan berdasarkan rt (total pengatur waktu tanggapan). Nilai valid: Pengatur waktu tanggapan: rt, avgRt, maxRt, minRt, rtRate. Eksekusi: count, countRate, timestamp. Baris yang dipindai: rowsExamined, avgRowsExamined. Baris yang dikembalikan: rowsReturned, totalRowsReturned, avgRowsReturned, maxRowsReturned, minRowsReturned, maxRowReturned, minRowReturned. Baca logis: logicalRead, totalLogicalRead, avgLogicalRead, maxLogicalRead, minLogicalRead. Baca fisik: physicalRead, totalPhysicalRead, avgPhysicalRead, maxPhysicalRead, minPhysicalRead. Tulis logis (hanya valid untuk instans SQL Server): writes, totalWrites, avgWrites, maxWrites, minWrites. Pengatur waktu CPU (hanya valid untuk instans SQL Server): totalCpuTime, avgCpuTime, maxCpuTime, minCpuTime. Metrik node komputasi PolarDB Basis Data Relasional Cloud-Native-X (hanya valid ketika Role diatur ke polarx_cn): scnt, avgScnt, rows, avgRows, frows, avgFrows. Baris yang terpengaruh (hanya valid untuk instans Lindorm): totalAffectRows, avgAffectRows. Catatan timestamp mengurutkan berdasarkan pengatur waktu data, yang merupakan stempel waktu UNIX tingkat milidetik. Catatan Hanya huruf pertama yang tidak peka huruf besar/kecil. Karakter yang tersisa harus persis sama dengan nilai yang disebutkan sebelumnya. Misalnya, AvgRt valid tetapi avgrt tidak.	rt
Asc	boolean	No	Arah pengurutan. Nilai default: false (menurun). Nilai valid: true: menaik. false: menurun.	false
PageNo	integer	No	Nomor halaman. Halaman dimulai dari halaman 1. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri statistik per halaman. Nilai default: 10. Nilai maksimum: 2000. Catatan Nilai yang lebih besar dari 2000 akan mengembalikan error InvalidParams alih-alih dipangkas. Catatan Saat mengagregasi berdasarkan sumber akses atau pengguna database (Type diatur ke FullRequestOrigin atau FullRequestUser), nilai yang lebih besar dari 100 dapat diatur ulang ke 10 di pipeline penyimpanan agregasi tertentu.	20
DoFillTrend	boolean	No	Apakah akan mengisi data tren deret waktu untuk setiap entri statistik, yang sesuai dengan bidang Trend di tanggapan. Nilai default: true. Nilai valid: true: Mengisi data tren. false: Tidak mengisi data tren. Catatan Mengaktifkan opsi ini memicu kueri tambahan untuk setiap irisan waktu per entri, yang secara signifikan meningkatkan overhead kueri. Jika kemampuan pengisian tren tidak diaktifkan untuk instans, parameter ini tidak berlaku.	true
SqlType	string	No	Tipe SQL yang digunakan untuk filter. Nilai valid: select insert update delete Catatan Nilai menggunakan huruf kecil. Di pipeline penyimpanan agregasi tertentu, Anda dapat menentukan beberapa nilai yang dipisahkan koma. Di pipeline lain, hanya satu nilai yang didukung.	select
DbName	string	No	Nama database yang digunakan untuk filter. Catatan Di pipeline penyimpanan agregasi tertentu, Anda dapat menentukan beberapa nama database yang dipisahkan koma. Di pipeline lain, hanya satu nama database yang didukung.	db_test
Role	string	No	Peran node instans. Nilai tidak peka huruf besar/kecil. Jika parameter ini tidak ditentukan, peran secara otomatis diselesaikan dari InstanceId. Nilai valid: polarx_cn: Node komputasi PolarDB Basis Data Relasional Cloud-Native-X. polarx_dn: Node penyimpanan PolarDB Basis Data Relasional Cloud-Native-X. Catatan Nilai ini memengaruhi cakupan bidang yang dikembalikan. Misalnya, Scnt, Rows, dan Frows hanya dikembalikan ketika nilainya adalah polarx_cn.	polarx_cn
JobId	string	No	ID idempotensi untuk kueri data Penjelajah SQL. Parameter ini tidak diperlukan untuk kueri reguler.	9a4f5c4494dbd6713185d87a97aa53e8
Filters	array<object>	No	Daftar kondisi filter terstruktur, ditentukan sebagai pasangan Key/Value. Format POP adalah Filters.N.Key dan Filters.N.Value, dengan maksimum 100 pasangan. Key tidak peka huruf besar/kecil. Entri dengan Value kosong diabaikan. Nilai valid Key untuk operasi ini: keyWord: kata kunci. Nilai dilakukan pemisahan oleh spasi menjadi beberapa kata dan berlaku bersama dengan parameter Keyword. hostAddress: alamat sumber akses. Pisahkan beberapa nilai dengan koma. Ini berlaku bersama dengan TemplateId ketika Type diatur ke OriginHost. accountName: nama pengguna database. Pisahkan beberapa nilai dengan koma. dbName: nama database. Pisahkan beberapa nilai dengan koma. Ini berlaku bersama dengan parameter DbName. sqlType: tipe SQL. Pisahkan beberapa nilai dengan koma. Ini berlaku bersama dengan parameter SqlType. sqlId: ID templat SQL. Pisahkan beberapa nilai dengan koma. Ini berlaku bersama dengan TemplateId ketika Type diatur ke SQL. insRole: peran primer/sekunder. Nilai valid: master dan slave. Nilai ini peka huruf besar/kecil. Catatan Nilai Key selain nilai yang disebutkan sebelumnya diabaikan. Catatan Parameter ini hanya berlaku di pipeline penyimpanan agregasi tertentu. Di pipeline lain, parameter ini sepenuhnya diabaikan.
	object	No
Key	string	No	Kunci kondisi filter. Nilai tidak peka huruf besar/kecil. Untuk nilai valid, lihat deskripsi parameter Filters.	sqlType
Value	string	No	Nilai kondisi filter. Jika nilai null atau string kosong, kondisi filter diabaikan. Pisahkan beberapa nilai dengan koma. Batas atas spesifik bergantung pada kunci yang sesuai.	select

Elemen respons

Element	Type	Description	Example
	object
Code	string	Kode status tanggapan.	200
Data	object	Pembungkus untuk hasil kueri asinkron. Panggilan pertama mengembalikan ResultId dan State. Lakukan polling dengan parameter permintaan yang sama persis hingga State menjadi SUCCESS, lalu ambil detail statistik dari List.
Data	object	Hasil kueri statistik Penjelajah SQL. Catatan Dikembalikan hanya ketika State adalah SUCCESS.
Extra	any	Informasi tambahan. Catatan Bidang ini tidak dikembalikan oleh operasi ini.	{}
List	array<object>	Daftar hasil statistik Penjelajah SQL. Setiap elemen adalah entri statistik di bawah dimensi agregasi.
	array<object>
AffectRows	integer	Jumlah baris yang terpengaruh untuk satu pernyataan SQL. Untuk pernyataan SELECT, ini menunjukkan jumlah baris yang dipindai. Untuk pernyataan DML, ini menunjukkan jumlah baris yang terpengaruh. Catatan Dikembalikan hanya untuk instans Lindorm.	30
AggKey	string	Nilai dimensi agregasi untuk entri statistik ini, yang bervariasi berdasarkan parameter permintaan Type. Nilai valid: Saat diagregasi berdasarkan templat SQL: ID templat SQL, yang sama dengan SqlId. Saat Type diatur ke FullRequestOrigin: alamat sumber akses. Saat Type diatur ke FullRequestUser: nama pengguna database.	651b56fe9418d48edb8fdf0980ec****
AvgAffectRows	number	Jumlah rata-rata baris yang terpengaruh. Catatan Dikembalikan hanya untuk instans Lindorm. Nilainya null untuk mesin database lainnya.	30.2
AvgCpuTime	number	Waktu CPU rata-rata yang dikonsumsi oleh eksekusi SQL, dalam mikrodetik. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin database lainnya.	12.5
AvgFrows	number	Jumlah rata-rata baris yang diambil oleh node komputasi PolarDB Basis Data Relasional Cloud-Native dari node data. Catatan Data deret waktu ini eksklusif untuk node komputasi PolarDB Basis Data Relasional Cloud-Native. Nilainya null atau 0 untuk mesin database lainnya.	10
AvgLockWaitTime	number	Waktu tunggu kunci rata-rata per eksekusi, dalam milidetik. Catatan Data hanya tersedia ketika Version diatur ke 1.	0.00009589874265269765
AvgLogicalRead	number	Jumlah rata-rata pembacaan logis per eksekusi. Catatan Data hanya tersedia ketika Version diatur ke 1.	654.4470327860251
AvgPhysicalAsyncRead	number	Jumlah rata-rata pembacaan asinkron fisik per eksekusi. Catatan Data hanya tersedia ketika Version diatur ke 1.	0
AvgPhysicalRead	number	Jumlah rata-rata pembacaan fisik. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin database lainnya.	654.4
AvgPhysicalSyncRead	number	Jumlah rata-rata pembacaan sinkron fisik per eksekusi. Catatan Data hanya tersedia ketika Version diatur ke 1.	0
AvgRows	number	Jumlah rata-rata baris yang diperbarui dan baris yang dikembalikan untuk node komputasi PolarDB Basis Data Relasional Cloud-Native. Catatan Data deret waktu ini eksklusif untuk node komputasi PolarDB Basis Data Relasional Cloud-Native. Nilainya null atau 0 untuk mesin database lainnya.	10
AvgRowsExamined	number	Jumlah rata-rata baris yang dipindai per eksekusi.	53421.0
AvgRowsReturned	number	Jumlah rata-rata baris yang dikembalikan per eksekusi.	14
AvgRowsUpdated	number	Jumlah rata-rata baris yang diperbarui per eksekusi.	30.2
AvgRt	number	Waktu eksekusi rata-rata per eksekusi, dalam milidetik.	2.499
AvgScanRows	number	Jumlah rata-rata baris yang dipindai. Catatan Bidang ini tidak dikembalikan oleh operasi ini. Gunakan AvgRowsExamined untuk jumlah rata-rata baris yang dipindai.	53421.0
AvgScnt	number	Jumlah rata-rata permintaan yang dikirim oleh node komputasi PolarDB Basis Data Relasional Cloud-Native ke node data. Catatan Data deret waktu ini eksklusif untuk node komputasi PolarDB Basis Data Relasional Cloud-Native. Nilainya null atau 0 untuk mesin database lainnya.	10
AvgWrites	number	Jumlah rata-rata penulisan logis. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin database lainnya.	10
Count	integer	Jumlah total eksekusi templat SQL dalam interval statistik.	127
CountRate	number	Rasio jumlah eksekusi entri statistik ini terhadap jumlah total eksekusi semua pernyataan SQL pada instans. Nilainya berkisar dari 0 hingga 1.	0.0586
CpuTime	integer	Total waktu CPU yang dikonsumsi oleh eksekusi SQL, dalam mikrodetik. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin database lainnya.	100
Database	string	Nama database tempat pernyataan SQL dieksekusi.	dbtest01
ErrorCode	string	Kode kesalahan yang dikembalikan oleh eksekusi SQL. Catatan Kode kesalahan adalah detail dari satu pernyataan SQL. Operasi ini mengembalikan statistik agregat tingkat templat dan tidak mengembalikan bidang ini. Gunakan ErrorCount untuk informasi kesalahan.	1146
ErrorCount	integer	Jumlah kesalahan eksekusi untuk templat SQL dalam interval statistik.	1
FirstTime	integer	Waktu ketika templat SQL pertama kali muncul. Catatan Bidang ini tidak dikembalikan oleh operasi ini.	1659308149000
Frows	integer	Jumlah total baris yang diambil oleh node komputasi PolarDB Basis Data Relasional Cloud-Native dari node data. Catatan Data deret waktu ini eksklusif untuk node komputasi PolarDB Basis Data Relasional Cloud-Native. Nilainya null atau 0 untuk mesin database lainnya.	10
Hash	string	Nilai hash templat SQL, dikembalikan bersama dengan templat SQL. Catatan Nilai ini dihasilkan oleh kernel node komputasi PolarDB Basis Data Relasional Cloud-Native. Nilainya kosong untuk instans non-node komputasi PolarDB Basis Data Relasional Cloud-Native.	2e8147b5ca2dfc640dfd5e43d96a****
Ip	string	Titik akhir instans tempat data statistik berada. Catatan Apakah bidang ini dikembalikan bergantung pada tautan penyimpanan agregat instans. Nilainya null untuk beberapa tautan.	rm-2ze1jdv45i7l6****.mysql.rds.aliyuncs.com
LockWaitTime	number	Total waktu tunggu kunci, dalam milidetik. Catatan Data hanya tersedia ketika Version diatur ke 1.	1089.4177720290281
LogicalRead	number	Jumlah total pembacaan logis. Catatan Data hanya tersedia ketika Version diatur ke 1.	165848
MaxCpuTime	integer	Waktu CPU maksimum dalam satu eksekusi, dalam mikrodetik. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin database lainnya.	30
MaxLogicalRead	integer	Jumlah maksimum pembacaan logis dalam satu eksekusi. Catatan Data hanya tersedia ketika Version diatur ke 1.	3186
MaxPhysicalRead	integer	Jumlah maksimum pembacaan fisik dalam satu eksekusi. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin database lainnya.	3186
MaxRowsExamined	integer	Jumlah maksimum baris yang dipindai dalam satu eksekusi. Catatan Bidang ini tidak dikembalikan oleh operasi ini. Gunakan RowsExamined dan AvgRowsExamined untuk jumlah baris yang dipindai.	318613
MaxRowsReturned	integer	Jumlah maksimum baris yang dikembalikan dalam satu eksekusi.	20
MaxRt	number	Waktu eksekusi maksimum dalam satu eksekusi, dalam milidetik.	12.499
MaxWrites	integer	Jumlah maksimum penulisan logis dalam satu eksekusi. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin database lainnya.	12
MinCpuTime	integer	Waktu CPU minimum dalam satu eksekusi, dalam mikrodetik. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin database lainnya.	5
MinLogicalRead	integer	Jumlah minimum pembacaan logis dalam satu eksekusi. Catatan Data hanya tersedia ketika Version diatur ke 1.	12
MinPhysicalRead	integer	Jumlah minimum pembacaan fisik dalam satu eksekusi. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin database lainnya.	12
MinRowsReturned	integer	Jumlah minimum baris yang dikembalikan dalam satu eksekusi.	1
MinRt	number	Waktu eksekusi minimum dalam satu eksekusi, dalam milidetik.	0.409789
MinWrites	integer	Jumlah minimum penulisan logis dalam satu eksekusi. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin database lainnya.	8
OriginAlias	string	Alias tampilan yang dikonfigurasi untuk alamat sumber akses. Catatan Dikembalikan hanya saat diagregasi berdasarkan sumber akses (saat Type diatur ke FullRequestOrigin). Nilainya null dalam skenario lainnya.	order-1
OriginHost	string	Alamat sumber klien yang memulai pernyataan SQL. Catatan Saat Type diatur ke FullRequestOrigin, bidang ini berfungsi sebagai dimensi agregasi untuk entri statistik.	172.26.XX.XXX
Params	string	Konten parameter sampel SQL. Catatan Operasi ini mengembalikan statistik agregat tingkat templat dan tidak mengembalikan bidang ini.	[1, "das"]
PhysicalAsyncRead	number	Jumlah total pembacaan asinkron fisik. Catatan Data hanya tersedia ketika Version diatur ke 1.	0
PhysicalRead	integer	Jumlah total pembacaan fisik. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin database lainnya.	165848
PhysicalSyncRead	number	Jumlah total pembacaan sinkron fisik. Catatan Data hanya tersedia ketika Version diatur ke 1.	0
Port	integer	Port instans tempat data statistik berada. Catatan Apakah bidang ini dikembalikan bergantung pada tautan penyimpanan teragregasi instans. Nilainya null untuk beberapa tautan.	3306
Psql	string	Teks templat SQL terparameterisasi, yaitu pernyataan dengan konstanta dalam SQL yang diganti oleh placeholder.	select * from t_order where id = ?
Rows	integer	Jumlah total baris yang diperbarui dan dikembalikan untuk node komputasi PolarDB-X. Catatan Data deret waktu ini eksklusif untuk node komputasi PolarDB-X. Nilainya null atau 0 untuk mesin lainnya.	10
RowsExamined	integer	Jumlah total baris yang diperiksa oleh templat SQL dalam interval statistik.	2048576
RowsReturned	integer	Jumlah total baris yang dikembalikan oleh templat SQL dalam interval statistik.	14
Rt	number	Durasi eksekusi total templat SQL dalam interval statistik. Unit: milidetik. Catatan Untuk node komputasi PolarDB-X (di mana Role adalah polarx_cn) dengan versi kernel lebih awal dari 5.4.13, nilai ini dikonversi dari mikrodetik ke milidetik.	0.409789
RtGreaterThanOneSecondCount	integer	Jumlah kali durasi eksekusi melebihi 1 detik. Catatan Apakah bidang ini dikembalikan bergantung pada tautan penyimpanan agregasi instans. Nilainya null untuk tautan tertentu.	20
RtRate	number	Rasio durasi eksekusi total entri ini terhadap durasi eksekusi total semua pernyataan SQL pada instans. Nilai valid: 0 hingga 1.	0.1384
SampleType	string	Pengidentifikasi tipe data sampel. Catatan Operasi ini mengembalikan statistik teragregasi dan tidak mengembalikan bidang ini.	sql
ScanRows	integer	Jumlah baris yang dipindai oleh satu pernyataan SQL. Catatan Operasi ini mengembalikan statistik teragregasi tingkat templat dan tidak mengembalikan bidang ini. Gunakan data deret waktu teragregasi RowsExamined dan AvgRowsExamined sebagai gantinya.	29
Scnt	integer	Jumlah total permintaan yang dikirim dari node komputasi PolarDB-X ke node data. Catatan Data deret waktu ini eksklusif untuk node komputasi PolarDB-X. Nilainya null atau 0 untuk mesin lainnya.	10
Sql	string	Teks SQL asli. Catatan Hasil statistik mengembalikan templat SQL (Psql) dan tidak mengembalikan bidang ini.	select * from t_order where id = 1
SqlId	string	ID templat SQL yang mengidentifikasi secara unik satu tipe pernyataan SQL terparameterisasi. Beberapa eksekusi di bawah templat yang sama diagregasi menjadi satu entri statistik. Anda dapat menggunakan ID ini untuk mengorelasikan tipe SQL yang sama di seluruh kueri multidimensi.	651b56fe9418d48edb8fdf0980ec****
SqlNew	string	Teks SQL dengan nilai parameter yang diproses secara seragam, digunakan dalam skenario data sampel. Catatan Operasi ini tidak mengembalikan bidang ini.	select * from t_order where id = ?
SqlTextFeature	string	Nilai fitur teks SQL, digunakan dalam skenario analisis SQL. Catatan Operasi ini tidak mengembalikan bidang ini.	select_from_t_order
SqlType	string	Tipe SQL. Nilai valid: select insert update delete other	select
SumRowsUpdated	number	Jumlah total baris yang diperbarui oleh templat SQL dalam interval statistik.	3810
Tables	array	Daftar nama tabel yang terlibat dalam pernyataan SQL.
	string	Nama tabel yang terlibat dalam pernyataan SQL.	t_order
ThreadId	string	ID thread database yang mengeksekusi pernyataan SQL. Catatan ID thread adalah detail dari satu pernyataan SQL. Operasi ini mengembalikan statistik teragregasi tingkat templat dan tidak mengembalikan bidang ini.	57472578
TimeRate	number	Rasio durasi eksekusi. Catatan Operasi ini mengembalikan rasio durasi eksekusi melalui RtRate dan tidak mengembalikan bidang ini.	0.1384
Timestamp	integer	Stempel waktu data. Nilai ini adalah Stempel waktu UNIX. Unit: milidetik. Catatan Hasil statistik diagregasi pada tingkat templat SQL dan tidak mengembalikan bidang ini.	1718600000000
TotalAffectRows	integer	Jumlah total baris yang terpengaruh. Catatan Bidang ini hanya dikembalikan untuk instans Lindorm. Nilainya null untuk mesin lainnya.	3810
TotalRt	integer	Durasi eksekusi SQL total. Catatan Operasi ini tidak mengembalikan bidang ini. Gunakan Rt untuk durasi eksekusi total.	310
TotalScanRows	integer	Jumlah total baris yang dipindai. Catatan Operasi ini tidak mengembalikan bidang ini. Gunakan RowsExamined untuk jumlah total baris yang dipindai.	2048576
Trend	array<object>	Urutan tren jumlah eksekusi templat SQL, dibagi menjadi pengatur waktu dalam jendela waktu kueri. Catatan Bidang ini hanya dikembalikan ketika parameter permintaan DoFillTrend diatur ke true dan kemampuan padding tren diaktifkan untuk instans. Interval pengatur waktu ditentukan secara otomatis oleh rentang kueri. Pengatur waktu tanpa data dapat diisi dengan nol.
	object
Timestamp	integer	Stempel waktu titik data tren. Nilai ini adalah Stempel waktu UNIX. Unit: milidetik.	1718000000000
Value	any	Jumlah eksekusi SQL dalam irisan waktu.	12
UpdateRows	integer	Jumlah baris yang diperbarui oleh satu pernyataan SQL. Catatan Operasi ini mengembalikan statistik teragregasi tingkat templat dan tidak mengembalikan bidang ini. Gunakan data deret waktu teragregasi SumRowsUpdated dan AvgRowsUpdated sebagai gantinya.	30
User	string	Nama pengguna database yang mengeksekusi pernyataan SQL. Catatan Ketika Type diatur ke FullRequestUser, bidang ini berfungsi sebagai dimensi agregasi untuk entri statistik.	testUser
Version	integer	Versi tautan pengumpulan data Penjelajah SQL. Nilai 1 dikembalikan ketika instans mengumpulkan data baca logis atau tunggu kunci. Jika tidak, nilai 0 dikembalikan. Nilai valid: 0: Tautan pengumpulan dasar V0. 1: Tautan pengumpulan V1, yang secara tambahan mengumpulkan empat data deret waktu (LockWaitTime, LogicalRead, PhysicalSyncRead, dan PhysicalAsyncRead) di atas V0. Catatan Ketika nilainya 0, data deret waktu yang diperluas tidak berisi data.	1
VpcId	string	ID VPC instans tempat data statistik berada. Catatan Apakah bidang ini dikembalikan bergantung pada tautan penyimpanan agregasi instans. Nilainya null untuk tautan tertentu.	vpc-2zentqj1sk4qmolci****
Writes	integer	Jumlah total tulis logis. Catatan Data deret waktu ini eksklusif untuk instans SQL Server. Nilainya null untuk mesin lainnya.	10
PageNo	integer	Nomor halaman saat ini, sesuai dengan parameter permintaan PageNo.	1
PageSize	integer	Jumlah entri per halaman, sesuai dengan parameter permintaan PageSize.	10
Total	integer	Jumlah total entri statistik yang sesuai dengan kondisi kueri. Anda dapat menggunakan nilai ini untuk perhitungan paginasi.	10
ErrorCode	integer	Kode kesalahan kegagalan kueri asinkron. Catatan Bidang ini hanya dikembalikan ketika kueri gagal.	-10200020
IsFinish	boolean	Apakah kueri asinkron telah selesai. Nilai valid: true: State adalah SUCCESS atau FAIL. false: State adalah RUNNING.
Message	string	Deskripsi kesalahan kegagalan kueri asinkron. Catatan Bidang ini hanya dikembalikan ketika kueri gagal.	startTime must be in 30 days and the interval must be within 7 day
RequestKey	string	Pengidentifikasi hash parameter permintaan. Catatan Operasi ini tidak mengembalikan bidang ini. Gunakan ResultId untuk mengidentifikasi kueri asinkron.	507044db6c4eadfa2dab9b084e80****
ResultId	string	ID hasil kueri asinkron, dalam format awalan async_ diikuti oleh nilai hash yang dihitung dari semua parameter bisnis permintaan. Catatan Panggilan berulang dengan parameter yang sama mengembalikan hasil kueri yang sama. Oleh karena itu, saat melakukan polling, Anda harus menggunakan parameter permintaan yang persis sama dengan panggilan awal. Setiap perubahan pada parameter menghasilkan ResultId yang berbeda dan memicu kueri baru.	async__507044db6c4eadfa2dab9b084e80****
State	string	Status saat ini kueri asinkron. Nilai valid: RUNNING: Kueri sedang berlangsung. Lanjutkan polling. SUCCESS: Kueri berhasil. Bidang Data berisi data hanya pada status ini. FAIL: Kueri gagal. Catatan Ketika kueri gagal, operasi langsung mengembalikan kode kesalahan dan Paket kesalahan alih-alih badan respons normal dengan State diatur ke FAIL.	SUCCESS
Timestamp	integer	Waktu ketika kueri asinkron dikirim. Nilai ini adalah Stempel waktu UNIX. Unit: milidetik. Catatan Ketika kueri gagal, nilai ini menunjukkan waktu ketika kegagalan terjadi.	1718600000000
Message	string	Paket tanggapan. Deskripsi kesalahan dikembalikan jika permintaan gagal.	Successful
RequestId	string	ID unik permintaan yang dapat digunakan untuk pemecahan masalah.	B6D17591-B48B-4D31-9CD6-9B9796B2****
Success	string	Apakah permintaan berhasil. Nilai valid: true: Permintaan berhasil. false: Permintaan gagal. Periksa bidang Code dan Message untuk menentukan penyebabnya.	true

Contoh

Respons sukses

JSONformat

{
  "Code": "200",
  "Data": {
    "Data": {
      "Extra": "{}",
      "List": [
        {
          "AffectRows": 30,
          "AggKey": "651b56fe9418d48edb8fdf0980ec****",
          "AvgAffectRows": 30.2,
          "AvgCpuTime": 12.5,
          "AvgFrows": 10,
          "AvgLockWaitTime": 0.00009589874265269765,
          "AvgLogicalRead": 654.4470327860251,
          "AvgPhysicalAsyncRead": 0,
          "AvgPhysicalRead": 654.4,
          "AvgPhysicalSyncRead": 0,
          "AvgRows": 10,
          "AvgRowsExamined": 53421,
          "AvgRowsReturned": 14,
          "AvgRowsUpdated": 30.2,
          "AvgRt": 2.499,
          "AvgScanRows": 53421,
          "AvgScnt": 10,
          "AvgWrites": 10,
          "Count": 127,
          "CountRate": 0.0586,
          "CpuTime": 100,
          "Database": "dbtest01",
          "ErrorCode": "1146",
          "ErrorCount": 1,
          "FirstTime": 1659308149000,
          "Frows": 10,
          "Hash": "2e8147b5ca2dfc640dfd5e43d96a****",
          "Ip": "rm-2ze1jdv45i7l6****.mysql.rds.aliyuncs.com",
          "LockWaitTime": 1089.4177720290281,
          "LogicalRead": 165848,
          "MaxCpuTime": 30,
          "MaxLogicalRead": 3186,
          "MaxPhysicalRead": 3186,
          "MaxRowsExamined": 318613,
          "MaxRowsReturned": 20,
          "MaxRt": 12.499,
          "MaxWrites": 12,
          "MinCpuTime": 5,
          "MinLogicalRead": 12,
          "MinPhysicalRead": 12,
          "MinRowsReturned": 1,
          "MinRt": 0.409789,
          "MinWrites": 8,
          "OriginAlias": "order-1",
          "OriginHost": "172.26.XX.XXX",
          "Params": "[1, \"das\"]",
          "PhysicalAsyncRead": 0,
          "PhysicalRead": 165848,
          "PhysicalSyncRead": 0,
          "Port": 3306,
          "Psql": "select * from t_order where id = ?",
          "Rows": 10,
          "RowsExamined": 2048576,
          "RowsReturned": 14,
          "Rt": 0.409789,
          "RtGreaterThanOneSecondCount": 20,
          "RtRate": 0.1384,
          "SampleType": "sql",
          "ScanRows": 29,
          "Scnt": 10,
          "Sql": "select * from t_order where id = 1",
          "SqlId": "651b56fe9418d48edb8fdf0980ec****",
          "SqlNew": "select * from t_order where id = ?",
          "SqlTextFeature": "select_from_t_order",
          "SqlType": "select",
          "SumRowsUpdated": 3810,
          "Tables": [
            "t_order"
          ],
          "ThreadId": "57472578",
          "TimeRate": 0.1384,
          "Timestamp": 1718600000000,
          "TotalAffectRows": 3810,
          "TotalRt": 310,
          "TotalScanRows": 2048576,
          "Trend": [
            {
              "Timestamp": 1718000000000,
              "Value": "12"
            }
          ],
          "UpdateRows": 30,
          "User": "testUser",
          "Version": 1,
          "VpcId": "vpc-2zentqj1sk4qmolci****",
          "Writes": 10
        }
      ],
      "PageNo": 1,
      "PageSize": 10,
      "Total": 10
    },
    "ErrorCode": -10200020,
    "IsFinish": false,
    "Message": "startTime must be in 30 days and the interval must be within 7 day",
    "RequestKey": "507044db6c4eadfa2dab9b084e80****",
    "ResultId": "async__507044db6c4eadfa2dab9b084e80****",
    "State": "SUCCESS",
    "Timestamp": 1718600000000
  },
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidParams	The request parameters are invalid.	Parameter permintaan tidak valid.
403	NoPermission	You are not authorized to do this action.	Anda tidak memiliki izin untuk melakukan operasi ini.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.