All Products
Search
Document Center

Database Autonomy Service:GetDasSQLLogHotData

Last Updated:Mar 12, 2026

Mengambil data hot dari log audit.

Deskripsi operasi

Sebelum menggunakan API ini, pastikan persyaratan berikut terpenuhi:

  • Anda menggunakan versi terbaru Alibaba Cloud SDK atau DAS SDK.

  • Saat memanggil layanan DAS dengan SDK, atur wilayah ke cn-shanghai.

  • Engine database adalah salah satu dari berikut: PolarDB MySQL, RDS MySQL, RDS PostgreSQL, atau RDS SQL Server.

  • Pengindeksan log diaktifkan untuk instans tersebut.

Catatan

Waktu mulai kueri tidak boleh lebih awal dari 7 hari yang lalu. Interval antara waktu mulai dan waktu akhir tidak boleh melebihi 1 hari. API ini mengembalikan maksimal 10.000 catatan.

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 instans database.

rm-2ze1jdv45i7l6****

Start

integer

Yes

Waktu mulai kueri dalam format Stempel waktu UNIX, dalam milidetik.

Catatan

Anda hanya dapat mengkueri data yang dihasilkan setelah mengaktifkan DAS Edisi Perusahaan. Waktu mulai kueri tidak boleh lebih awal dari 7 hari sebelum waktu saat ini.

1684734297000

End

integer

Yes

Waktu akhir kueri dalam format Stempel waktu UNIX, dalam milidetik.

Catatan

Waktu akhir kueri harus lebih baru daripada waktu mulai kueri. Interval antara waktu mulai dan waktu akhir kueri tidak boleh melebihi 1 hari.

1684820697000

QueryKeyword

string

No

Kata kunci.

Catatan

Kueri fuzzy didukung. Anda dapat menggabungkan hingga 10 kata kunci, dipisahkan dengan spasi. Contoh: a1 b2 c3.

a1 b2

AccountName

string

No

Akun database.

Catatan

Mendukung penggabungan beberapa akun database untuk kueri, dengan akun dipisahkan oleh spasi. Contoh: user1 user2 user3.

testuser

DBName

string

No

Nama database.

Catatan

Mendukung penggabungan beberapa nama database untuk kueri, dengan nama dipisahkan oleh spasi. Contoh: DB1 DB2 DB3.

testDB

HostAddress

string

No

Alamat IP client.

Catatan

Mendukung penggabungan beberapa alamat IP client untuk kueri, dengan alamat dipisahkan oleh spasi. Contoh: IP1 IP2 IP3.

47.100.XX.XX

LogicalOperator

string

No

Hubungan logis antara beberapa kata kunci.

  • or: OR.

  • and: AND.

or

MaxLatancy

integer

No

Durasi eksekusi maksimum dalam mikrodetik. Mengkueri pernyataan SQL dengan durasi eksekusi kurang dari nilai ini.

100

MaxScanRows

integer

No

Jumlah maksimum baris yang dipindai. Mengkueri pernyataan SQL dengan jumlah baris yang dipindai kurang dari nilai ini.

10000

MinLatancy

integer

No

Durasi eksekusi minimum dalam mikrodetik. Mengkueri pernyataan SQL dengan durasi eksekusi lebih besar dari atau sama dengan nilai ini.

10

MinScanRows

integer

No

Jumlah minimum baris yang dipindai. Mengkueri pernyataan SQL dengan jumlah baris yang dipindai lebih besar dari atau sama dengan nilai ini.

10

SqlType

string

No

Jenis pernyataan SQL. Nilai yang valid:

  • select

  • update

  • delete

Valid values:

  • select :

    Query

  • update :

    Update

  • delete :

    Delete

select

State

string

No

Hasil eksekusi. Masukkan 0 untuk mengkueri pernyataan SQL yang berhasil dieksekusi. Anda juga dapat memasukkan kode kesalahan tertentu untuk mengkueri pernyataan SQL yang sesuai.

0

ThreadID

string

No

ID thread.

Catatan

Mendukung penggabungan beberapa ID thread untuk kueri, dengan ID dipisahkan oleh spasi. Contoh: Thread ID1 Thread ID2 Thread ID3.

657

PageNumbers

integer

No

Nomor halaman untuk kueri berhalaman, dimulai dari 1. Nilai default: 1.

2

MaxRecordsPerPage

integer

No

Jumlah maksimum catatan per halaman untuk kueri berhalaman. Nilai yang valid: 5 hingga 100.

10

SortKey

string

No

Basis pengurutan.

  • ScanRows: Jumlah baris yang dipindai.

  • UpdateRows: Jumlah baris yang diperbarui.

  • Consume: Durasi eksekusi.

  • OriginTime: Waktu eksekusi.

  • ReturnRows: Jumlah baris yang dikembalikan.

ScanRows

SortMethod

string

No

Metode pengurutan.

  • ASC: Urutan menaik.

  • DESC: Urutan menurun.

ASC

ChildDBInstanceIDs

string

No

ID node.

Catatan

Wajib diisi untuk instans PolarDB MySQL.

pi-bp179lg03445l****

Role

string

No

Parameter cadangan. Saat ini tidak didukung.

None

TraceId

string

No

Parameter cadangan. Saat ini tidak didukung.

None

MinRows

integer

No

Parameter cadangan. Saat ini tidak didukung.

None

MaxRows

integer

No

Parameter cadangan. Saat ini tidak didukung.

None

MinSpillCnt

integer

No

Parameter cadangan. Saat ini tidak didukung.

None

MaxSpillCnt

integer

No

Parameter cadangan. Saat ini tidak didukung.

None

TransactionId

string

No

ID transaksi.

0

Fail

string

No

Kode kesalahan eksekusi SQL. Panggil GetAsyncErrorRequestStatByCode untuk mendapatkan kode kesalahan.

1064

Elemen respons

Element

Type

Description

Example

object

Code

string

Kode status.

200

Message

string

Pesan respons.

Catatan

Jika permintaan berhasil, parameter ini mengembalikan Successful. Jika permintaan gagal, parameter ini mengembalikan informasi pengecualian seperti kode kesalahan.

Successful

RequestId

string

ID permintaan unik yang dihasilkan oleh Alibaba Cloud.

0A74B755-98B7-59DB-8724-1321B394****

Success

string

Menunjukkan apakah permintaan berhasil:

  • true: Permintaan berhasil.

  • false: Permintaan gagal.

true

Data

object

Data yang dikembalikan.

List

array<object>

Daftar informasi yang dikembalikan.

object

Data insight SQL dan audit yang dikembalikan.

Latancy

integer

Durasi eksekusi dalam mikrodetik.

10000

Ext

string

Bidang informasi tambahan. Parameter cadangan.

None

ExecuteTime

string

Waktu eksekusi dalam format UTC: yyyy-MM-ddTHH:mm:ssZ.

2023-05-23 T12:11:20Z

OriginTime

string

Waktu eksekusi dalam format UTC: yyyy-MM-ddTHH:mm:ss.SSSZ.

2023-05-23 T12:11:20.999Z

HostAddress

string

Alamat IP client.

47.100.XX.XX

UpdateRows

integer

Jumlah baris yang diperbarui.

30

LogicRead

integer

Bacaan logis.

12

SQLText

string

Detail pernyataan SQL.

select 1

LockTime

integer

Waktu tunggu lock dalam mikrodetik.

1

ScanRows

integer

Jumlah baris yang dipindai.

29

ThreadID

integer

ID thread.

657

State

string

Status. Mengembalikan 0 untuk eksekusi yang berhasil. Jika tidak, mengembalikan kode kesalahan.

0

DBName

string

Nama database.

testDB

SqlType

string

Jenis SQL. Nilai yang valid:

  • select

  • update

  • delete

select

AccountName

string

Akun database.

testuser

PhysicSyncRead

integer

Bacaan sinkron fisik.

0

PhysicAsyncRead

integer

Bacaan asinkron fisik.

0

TransactionId

string

ID transaksi yang diinisiasi.

0

ReturnRows

integer

Jumlah baris yang dikembalikan.

1

NodeId

string

Total

integer

Total jumlah catatan yang dikembalikan.

20

PageNo

integer

Nomor halaman.

2

PageSize

integer

Jumlah entri per halaman.

10

Extra

any

Parameter cadangan.

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": ""
      }
    ],
    "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.