All Products
Search
Document Center

Database Autonomy Service:GetDasSQLLogHotData

Last Updated:Jun 10, 2026

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.

Catatan

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

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: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: user1 user2 user3.

testuser

DBName

string

No

Nama database.

Catatan

Anda dapat menentukan beberapa nama database. Pisahkan beberapa nama dengan spasi. Contoh: DB1 DB2 DB3.

testDB

HostAddress

string

No

Alamat IP klien.

Catatan

Anda dapat menentukan beberapa alamat IP klien. Pisahkan beberapa alamat IP dengan spasi. Contoh: IP1 IP2 IP3.

47.100.XX.XX

LogicalOperator

string

No

Operator logika yang digunakan dengan beberapa kata kunci. Nilai valid:

  • or

  • and.

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 :

    Pernyataan SELECT.

  • update :

    Pernyataan UPDATE.

  • delete :

    Pernyataan DELETE.

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 658 659.

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: baris yang dipindai.

  • UpdateRows: baris yang diperbarui.

  • Consume: pengatur waktu eksekusi.

  • OriginTime: Waktu mulai eksekusi.

  • ReturnRows: baris yang dikembalikan.

ScanRows

SortMethod

string

No

Pesanan pengurutan. Nilai valid:

  • ASC: menaik

  • DESC: menurun.

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: The request succeeded.

  • false: The request failed.

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: yyyy-MM-ddTHH:mm:ssZ.

2023-05-23 T12:11:20Z

OriginTime

string

Execution time in UTC format: yyyy-MM-ddTHH:mm:ss.SSSZ.

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

  • update

  • delete

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.