Mengambil data hot dari log audit SQL.
Deskripsi operasi
Before you call this API, ensure that you meet the following requirements:
-
Use the latest version of the Alibaba Cloud SDK or DAS SDK.
-
When using an SDK to call the DAS service, specify the region as
cn-shanghai. -
Supported engines: PolarDB MySQL, ApsaraDB RDS for MySQL, ApsaraDB RDS for PostgreSQL, and ApsaraDB RDS for SQLServer.
-
Enable log indexing for the instance.
The query start time must be within the last 7 days. The query duration cannot exceed 1 day. The API returns up to 10,000 records.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
hdm:GetDasSQLLogHotData |
get |
*全部资源
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceId |
string |
Yes |
ID instansiasi basis data. |
rm-2ze1jdv45i7l6**** |
| Start |
integer |
Yes |
Awal rentang pengatur waktu yang akan dikueri. Nilai ini harus berupa stempel waktu UNIX dalam milidetik. Catatan
Anda hanya dapat mengkueri data yang dihasilkan setelah Anda mengaktifkan DAS Edisi Perusahaan. Waktu mulai tidak boleh lebih awal dari tujuh hari sebelum waktu saat ini. |
1684734297000 |
| End |
integer |
Yes |
Akhir pengatur waktu yang akan dikueri. Nilai ini harus berupa stempel waktu UNIX dalam milidetik. Catatan
Waktu akhir harus lebih lambat dari waktu mulai. Pengatur waktu tidak boleh melebihi satu hari. |
1684820697000 |
| QueryKeyword |
string |
No |
Kata kunci kueri. Catatan
Pencarian fuzzy didukung. Anda dapat menentukan hingga 10 kata kunci. Pisahkan beberapa kata kunci dengan spasi. Contoh: a1 b2 c3. |
a1 b2 |
| AccountName |
string |
No |
Akun database. Catatan
Anda dapat menentukan beberapa akun database. Pisahkan beberapa akun dengan spasi. Contoh: |
testuser |
| DBName |
string |
No |
Nama database. Catatan
Anda dapat menentukan beberapa nama database. Pisahkan beberapa nama dengan spasi. Contoh: |
testDB |
| HostAddress |
string |
No |
Alamat IP klien. Catatan
Anda dapat menentukan beberapa alamat IP klien. Pisahkan beberapa alamat IP dengan spasi. Contoh: |
47.100.XX.XX |
| LogicalOperator |
string |
No |
Operator logika yang digunakan dengan beberapa kata kunci. Nilai valid:
|
or |
| MaxLatancy |
integer |
No |
Pengatur waktu eksekusi maksimum dalam mikrodetik. Mengembalikan pernyataan SQL yang memiliki pengatur waktu eksekusi kurang dari nilai ini. |
100 |
| MaxScanRows |
integer |
No |
Jumlah maksimum baris yang dipindai. Mengembalikan pernyataan SQL yang memindai baris kurang dari jumlah ini. |
10000 |
| MinLatancy |
integer |
No |
Pengatur waktu eksekusi minimum dalam mikrodetik. Mengembalikan pernyataan SQL dengan pengatur waktu eksekusi lebih besar dari atau sama dengan nilai ini. |
10 |
| MinScanRows |
integer |
No |
Jumlah minimum baris yang dipindai. Mengembalikan pernyataan SQL yang memindai setidaknya sejumlah baris ini. |
10 |
| SqlType |
string |
No |
Tipe SQL. Valid values:
|
select |
| State |
string |
No |
Status eksekusi. Atur parameter ini ke 0 untuk mengkueri pernyataan SQL yang berhasil dieksekusi. Anda juga dapat menentukan kode kesalahan untuk mengkueri pernyataan SQL yang sesuai. |
0 |
| ThreadID |
string |
No |
ID thread. Catatan
Anda dapat menentukan beberapa ID thread. Pisahkan beberapa ID dengan spasi. Contoh: |
657 |
| PageNumbers |
integer |
No |
Nomor halaman yang dikembalikan. Halaman dimulai dari 1. Nilai default adalah 1. |
2 |
| MaxRecordsPerPage |
integer |
No |
Jumlah maksimum entri per halaman. Nilai valid: 5 hingga 100. |
10 |
| SortKey |
string |
No |
Kunci pengurutan. Nilai valid:
|
ScanRows |
| SortMethod |
string |
No |
Pesanan pengurutan. Nilai valid:
|
ASC |
| ChildDBInstanceIDs |
string |
No |
ID node. Catatan
Parameter ini wajib diisi jika instansiasi basis data adalah Kluster PolarDB Basis Data Relasional Cloud-Native for MySQL. |
pi-bp179lg03445l**** |
| Role |
string |
No |
Parameter yang dicadangkan. |
None |
| TraceId |
string |
No |
Parameter yang dicadangkan. |
None |
| MinRows |
integer |
No |
Parameter yang dicadangkan. |
None |
| MaxRows |
integer |
No |
Parameter yang dicadangkan. |
None |
| MinSpillCnt |
integer |
No |
Parameter yang dicadangkan. |
None |
| MaxSpillCnt |
integer |
No |
Parameter yang dicadangkan. |
None |
| TransactionId |
string |
No |
ID transaksi. |
0 |
| Fail |
string |
No |
Kode kesalahan eksekusi SQL. Anda dapat memanggil operasi GetAsyncErrorRequestStatByCode untuk memperoleh kode kesalahan. |
1064 |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| Code |
string |
The status code. |
200 |
| Message |
string |
The response message. Catatan
If the request succeeds, Successful is returned. If the request fails, an error message is returned, which may include an error code. |
Successful |
| RequestId |
string |
The unique request ID generated by Alibaba Cloud. |
0A74B755-98B7-59DB-8724-1321B394**** |
| Success |
string |
Indicates whether the request succeeded:
|
true |
| Data |
object |
The returned data. |
|
| List |
array<object> |
A list of the returned data. |
|
|
object |
The SQL insight and audit data. |
||
| Latancy |
integer |
Execution time in microseconds. |
10000 |
| Ext |
string |
Extended information field, reserved parameter. |
None |
| ExecuteTime |
string |
Execution time in UTC format: |
2023-05-23 T12:11:20Z |
| OriginTime |
string |
Execution time in UTC format: |
2023-05-23 T12:11:20.999Z |
| HostAddress |
string |
Client IP address. |
47.100.XX.XX |
| UpdateRows |
integer |
Number of updated rows. |
30 |
| LogicRead |
integer |
Logical read. |
12 |
| SQLText |
string |
SQL statement details. |
select 1 |
| LockTime |
integer |
Lock wait time in microseconds. |
1 |
| ScanRows |
integer |
Number of scanned rows. |
29 |
| ThreadID |
integer |
Thread ID. |
657 |
| State |
string |
Status. Returns 0 for successful execution, otherwise returns an error code. |
0 |
| DBName |
string |
Database name. |
testDB |
| SqlType |
string |
SQL type. Valid values:
|
select |
| AccountName |
string |
Database account. |
testuser |
| PhysicSyncRead |
integer |
Physical synchronous read. |
0 |
| PhysicAsyncRead |
integer |
Physical asynchronous read. |
0 |
| TransactionId |
string |
Initiated transaction ID. |
0 |
| ReturnRows |
integer |
Number of returned rows. |
1 |
| NodeId |
string |
pi-bp120roy76f3qbd84 |
|
| Total |
integer |
The total number of records. |
20 |
| PageNo |
integer |
The page number. |
2 |
| PageSize |
integer |
The page size. |
10 |
| Extra |
any |
A reserved parameter. |
None |
Contoh
Respons sukses
JSONformat
{
"Code": "200",
"Message": "Successful",
"RequestId": "0A74B755-98B7-59DB-8724-1321B394****",
"Success": "true",
"Data": {
"List": [
{
"Latancy": 10000,
"Ext": "None",
"ExecuteTime": "2023-05-23 T12:11:20Z",
"OriginTime": "2023-05-23 T12:11:20.999Z",
"HostAddress": "47.100.XX.XX",
"UpdateRows": 30,
"LogicRead": 12,
"SQLText": "select 1",
"LockTime": 1,
"ScanRows": 29,
"ThreadID": 657,
"State": "0",
"DBName": "testDB",
"SqlType": "select",
"AccountName": "testuser",
"PhysicSyncRead": 0,
"PhysicAsyncRead": 0,
"TransactionId": "0",
"ReturnRows": 1,
"NodeId": "pi-bp120roy76f3qbd84"
}
],
"Total": 20,
"PageNo": 2,
"PageSize": 10,
"Extra": "None"
}
}
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.