GetDasSQLLogHotData - Database Autonomy Service

Mengambil data hot dari log audit SQL untuk memungkinkan analisis interaktif yang cepat terhadap aktivitas SQL terbaru.

Deskripsi operasi

Sebelum memanggil operasi ini, pastikan persyaratan berikut terpenuhi:

Engine yang didukung: PolarDB MySQL, ApsaraDB RDS for MySQL, ApsaraDB RDS for PostgreSQL, dan ApsaraDB RDS for SQLServer.
Versi SDK: Gunakan versi terbaru Alibaba Cloud SDK.
Region: Jika Anda memanggil API melalui SDK, atur ID wilayah ke cn-shanghai.
Pengindeksan log harus diaktifkan untuk instans target.

Catatan

(Waktu mulai) kueri tidak boleh lebih awal dari 7 hari sebelumnya, dan durasi antara (waktu mulai) kueri dan waktu akhir kueri 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

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instansiasi basis data.	rm-2ze1jdv45i7l6****
Start	integer	Yes	Waktu mulai kueri dalam format Stempel waktu UNIX, dalam milidetik. Catatan Anda hanya dapat mengkueri data yang dihasilkan setelah DAS Enterprise Edition diaktifkan. 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 lambat dari waktu mulai kueri, dan durasi antara waktu mulai kueri dan waktu akhir kueri tidak boleh melebihi 1 hari.	1684820697000
QueryKeyword	string	No	Kata kunci kueri. Catatan Mendukung kueri fuzzy. Anda dapat menggabungkan hingga 10 kata kunci untuk satu kueri, dengan kata kunci dipisahkan oleh 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 database 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 IP 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	Waktu eksekusi maksimum dalam mikrodetik. Mengkueri pernyataan SQL dengan waktu eksekusi kurang dari nilai parameter ini.	100
MaxScanRows	integer	No	Jumlah maksimum baris yang dipindai. Mengkueri pernyataan SQL dengan jumlah baris yang dipindai kurang dari nilai parameter ini.	10000
MinLatancy	integer	No	Waktu eksekusi minimum dalam mikrodetik. Mengkueri pernyataan SQL dengan waktu eksekusi lebih besar dari atau sama dengan nilai parameter 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 parameter ini.	10
SqlType	string	No	Jenis pernyataan SQL. Nilai yang valid: select update delete Valid values: select : kueri update : modifikasi delete : hapus	select
State	string	No	Hasil eksekusi. 0 berarti mengkueri pernyataan SQL yang dieksekusi berhasil. Anda juga dapat menentukan kode kesalahan untuk mengkueri pernyataan SQL yang sesuai.	0
ThreadID	string	No	ID thread. Catatan Mendukung penggabungan beberapa ID thread untuk kueri, dengan ID thread 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	Dasar pengurutan. ScanRows: Jumlah baris yang dipindai. UpdateRows: Jumlah baris yang diperbarui. Consume: Waktu eksekusi. OriginTime: Waktu eksekusi. ReturnRows: Jumlah baris yang dikembalikan.	ScanRows
SortMethod	string	No	Metode pengurutan. ASC: Urutan naik. DESC: Urutan turun.	ASC
ChildDBInstanceIDs	string	No	ID node. Catatan Diperlukan 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. Anda dapat memanggil GetAsyncErrorRequestStatByCode untuk mendapatkan kode kesalahan tersebut.	1064

Elemen respons

Element	Type	Description	Example
	object
Code	string	Kode status.	200
Message	string	Pesan respons. Catatan Saat permintaan berhasil, parameter ini mengembalikan Successful. Saat permintaan gagal, parameter ini mengembalikan informasi pengecualian (seperti kode kesalahan).	Successful
RequestId	string	ID permintaan unik.	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	Waktu 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	Baca 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, selain itu 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	Baca sinkron fisik.	0
PhysicAsyncRead	integer	Baca 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.