DescribeSlowLogRecords - Database Autonomy Service

Menampilkan catatan log kueri lambat dari sebuah instans database. Anda dapat memfilter dan mengurutkan catatan tersebut berdasarkan berbagai kondisi.

Deskripsi operasi

Parameter InstanceId wajib diisi dan menentukan ID instans.
Parameter StartTime dan EndTime wajib diisi dan menentukan rentang waktu untuk kueri.
Anda dapat mengatur parameter PageNumber dan PageSize untuk melakukan paginasi pada hasil.
Gunakan parameter OrderBy untuk mengurutkan hasil. Untuk informasi lebih lanjut mengenai bidang yang dapat diurutkan, lihat dokumentasi.
Anda dapat menggunakan parameter Filters untuk mempersempit kondisi kueri, seperti memfilter berdasarkan alamat host atau SQL ID.
Penting
Beberapa tipe database, seperti RDS for PostgreSQL dan PolarDB for PostgreSQL, tidak mendukung metode pengurutan tertentu. Pilih parameter yang sesuai berdasarkan tipe database Anda.

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:DescribeSlowLogRecords

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instans.	rm-8vbk4xz99su8****
NodeId	string	No	ID node.	pi-d9j9fe7wq7t9i****
StartTime	integer	Yes	Awal rentang waktu untuk kueri. Ini adalah stempel waktu UNIX dalam milidetik.	1596177993000
EndTime	integer	Yes	Akhir rentang waktu untuk kueri. Ini adalah stempel waktu UNIX dalam milidetik.	1634972640000
PageNumber	integer	No	Nomor halaman. Halaman dimulai dari 1.	1
PageSize	integer	No	Jumlah entri per halaman.	10
Filters	array<object>	No	Daftar kondisi filter.
	object	No	Daftar kondisi filter.
Key	string	No	Kunci filter. Catatan Untuk informasi lebih lanjut, lihat bagian parameter Key yang didukung di bawah ini.	None
Value	string	No	Nilai untuk kunci filter.	None
OrderBy	string	No	MySQL QueryTimeSeconds: Waktu eksekusi kueri dalam detik. LockTimeSeconds: Durasi penguncian dalam detik. RowsSent: Jumlah baris yang dikirim. RowsExamined: Jumlah baris yang dipindai. Redis QueryTime: Waktu eksekusi kueri. Timestamp: Waktu saat eksekusi kueri berakhir. MongoDB QueryTime: Waktu eksekusi kueri. Timestamp: Waktu saat eksekusi kueri berakhir. KeysExamined: Jumlah entri indeks yang dipindai. DocExamined: Jumlah dokumen yang dipindai. ReturnNum: Jumlah baris yang dikembalikan. Penting Pengurutan tidak didukung untuk RDS for PostgreSQL, PolarDB for PostgreSQL, dan RDS for SQL Server.	QueryTimeSeconds
Asc	boolean	No	Menentukan apakah hasil diurutkan secara ascending. Nilai default adalah true. true: Hasil diurutkan secara ascending. false: Hasil diurutkan secara descending.	true

Nilai berikut didukung untuk parameter Key:

RDS for MySQL, PolarDB for MySQL, RDS for PostgreSQL, dan PolarDB for PostgreSQL
- hostAddress: Alamat IP sumber. Pisahkan beberapa nilai dengan koma.
- sqlId: ID SQL. Pisahkan beberapa nilai dengan koma.
- user: Pengguna. Pisahkan beberapa nilai dengan koma.
- dbName: Nama database. Pisahkan beberapa nilai dengan koma.
- tags: Tag. Pisahkan beberapa nilai dengan koma.
MongoDB
- hostInsId: ID role. Pisahkan beberapa nilai dengan koma.
- insRole: Role instans. Pisahkan beberapa nilai dengan koma.
- opType: Tipe operasi. Pisahkan beberapa nilai dengan koma.
- namespace: Namespace. Pisahkan beberapa nilai dengan koma.
- nodeType: Tipe komponen. Pisahkan beberapa nilai dengan koma.
- queryId: ID kueri. Pisahkan beberapa nilai dengan koma.
Tair
- hostAddress: Alamat IP sumber.
- user: Pengguna.
- dbName: Nama database.
- nodeType: Tipe node.
RDS for SQL Server
- hostAddress: Alamat IP sumber. Pisahkan beberapa nilai dengan koma.
- sqlId: ID SQL. Pisahkan beberapa nilai dengan koma.
- user: Pengguna. Pisahkan beberapa nilai dengan koma.
- dbName: Nama database. Pisahkan beberapa nilai dengan koma.
- tags: Tag. Pisahkan beberapa nilai dengan koma.
PolarDB-X
- traceId: ID trace instans.
- role: Role node. Kunci ini wajib diisi. Nilai yang valid: CN (compute node) dan DN (data node).
- hostAddress: Alamat IP sumber. Pisahkan beberapa nilai dengan koma.
- sqlId: ID SQL. Pisahkan beberapa nilai dengan koma.
- user: Pengguna. Pisahkan beberapa nilai dengan koma.
- dbName: Nama database. Pisahkan beberapa nilai dengan koma.
- tags: Tag. Pisahkan beberapa nilai dengan koma.

Catatan

Untuk mesin SQL, Anda dapat mengkueri data berdasarkan sqlId. Anda dapat menentukan hingga 20 nilai sqlId, dipisahkan dengan koma.
Untuk MongoDB, Anda dapat mengkueri data berdasarkan queryId. Anda dapat menentukan hingga 20 nilai queryId, dipisahkan dengan koma.

Elemen respons

Element	Type	Description	Example
	object
Code	string	Kode status HTTP.	200
Message	string	Pesan yang dikembalikan. Catatan Jika permintaan berhasil, Successful dikembalikan. Jika permintaan gagal, pesan kesalahan dikembalikan, seperti kode kesalahan.	Successful
RequestId	string	ID permintaan.	A1C79EE2-D04D-571B-8C60-961FAF8E****
Success	string	Menunjukkan apakah permintaan berhasil. true: Permintaan berhasil. false: Permintaan gagal.	true
Data	object	Daftar catatan log kueri lambat.
DbInstanceName	string	ID instans.	rm-bp157g54vy772****
NodeId	string	ID node.	node123
ItemsNumbers	integer	Jumlah catatan log lambat pada halaman saat ini.	10
StartTime	string	Waktu mulai kueri.	1672531200000
EndTime	string	Waktu akhir kueri.	1672617600000
DbInstanceId	integer	ID numerik instans.	100
TotalRecords	integer	Total jumlah catatan log lambat.	100
PageNumbers	integer	Nomor halaman. Halaman dimulai dari 1. Nilai default adalah 1.	1
MaxRecordsPerPage	integer	Jumlah maksimum entri per halaman. Nilai yang valid: 5 hingga 100.	20
Logs	array<object>	Data yang dikembalikan oleh kueri.
	array<object>	Data yang dikembalikan.
SqlId	string	ID templat SQL.	sqlId
Scheme	string	Skema data.	HTTPS
SubInstanceId	string	ID sub-instans.	r-8vb219d10038****
DbInstanceName	string	ID instans.	rm-2zebg30mk056g****
InsName	string	Nama instans.	test
AccountName	string	Username.	user1
HostAddress	string	Alamat IP sumber.	192.168.1.1
QueryStartTime	string	Waktu mulai kueri. Waktu dalam format `yyyy-MM-dd hh:mm:ss` dan dalam UTC.	2024-04-01 11:00:00
SQLText	string	Pernyataan SQL.	SELECT * FROM my_table WHERE ROWNUM <= 10
Psql	string	Templat SQL.	SELECT * FROM my_table WHERE ROWNUM <= 10
DBName	string	Nama database.	test
QueryTime	integer	Waktu eksekusi kueri.	121
ReturnItemNumbers	string	Jumlah item yang dikembalikan.	test
DocsExamined	string	Jumlah dokumen yang dipindai selama operasi. Parameter ini hanya dikembalikan untuk instans MongoDB.	100
KeysExamined	string	Jumlah entri indeks yang dipindai. Parameter ini hanya dikembalikan untuk instans MongoDB.	valueA
TableName	string	Nama tabel.	tableNameExample
LockTime	number	Waktu tunggu penguncian.	100
RowsExamined	integer	Jumlah baris yang dipindai.	100
RowsSent	integer	Jumlah baris yang dikembalikan.	10
ThreadId	string	ID thread.	57472578
Timestamp	integer	Stempel waktu UNIX.	1747118812
SqlTag	object	Tag.
SqlId	string	ID SQL.	8ad7069f236bcdaaa9b3ae4b6299****
Tags	string	Tag. Beberapa tag dipisahkan dengan koma.	DAS_IMPORTANT,DAS_IN_PLAN
Comments	string	Komentar.	test
LockTimeSeconds	number	Waktu tunggu penguncian dalam detik.	100
QueryTimeSeconds	number	Waktu eksekusi kueri dalam detik.	100
SqlType	string	Tipe pernyataan SQL. SELECT UPDATE DELETE	SELECT
CPUTime	number	Waktu CPU yang dikonsumsi oleh kueri. Catatan Parameter ini hanya dikembalikan untuk instans RDS for SQL Server.	50
IOWrites	integer	Jumlah penulisan I/O. Catatan Parameter ini hanya dikembalikan untuk instans RDS for SQL Server.	1
LastRowsCountAffected	integer	Jumlah baris yang terpengaruh oleh pernyataan terakhir. Catatan Parameter ini hanya dikembalikan untuk instans RDS for SQL Server.	10
LogicalIOReads	integer	Jumlah pembacaan logis. Catatan Parameter ini hanya dikembalikan untuk instans RDS for SQL Server.	1
PhysicalIOReads	integer	Jumlah pembacaan fisik. Catatan Parameter ini hanya dikembalikan untuk instans RDS for SQL Server.	1
RowsCountAffected	integer	Jumlah baris yang terpengaruh. Catatan Parameter ini hanya dikembalikan untuk instans RDS for SQL Server.	10
Command	string	Pernyataan kueri lambat. Catatan Parameter ini hanya dikembalikan untuk instans Tair.	SELECT
Namespace	string	Namespace. Catatan Parameter ini hanya dikembalikan untuk instans MongoDB.	pro-test
QueryId	string	ID kueri. Catatan Parameter ini hanya dikembalikan untuk instans MongoDB.	sq-1pzcdMwRb
ReturnNum	string	Jumlah baris yang dikembalikan. Catatan Parameter ini hanya dikembalikan untuk instans MongoDB.	20
ApplicationName	string	Nama aplikasi. Catatan Parameter ini hanya dikembalikan untuk instans RDS for SQL Server.	MyApp
CPUTimeSeconds	number	Waktu CPU yang dikonsumsi oleh kueri, dalam detik. Catatan Parameter ini hanya dikembalikan untuk instans RDS for SQL Server.	100
Rows	integer	Total jumlah baris yang diperbarui atau dikembalikan oleh compute node instans PolarDB-X 2.0. Catatan Parameter ini hanya dikembalikan untuk instans PolarDB-X 2.0.	20
Frows	integer	Jumlah baris yang ditarik oleh compute node (CN) instans PolarDB-X 2.0. Catatan Parameter ini hanya dikembalikan untuk instans PolarDB-X 2.0.	10
Scnt	integer	Jumlah permintaan yang dikirim dari compute node (CN) ke data node (DN) dalam instans PolarDB-X 2.0. Catatan Parameter ini hanya dikembalikan untuk instans PolarDB-X 2.0.	10
TraceId	string	ID trace instans PolarDB-X 2.0. ID trace adalah ID eksekusi pernyataan SQL pada data node. Catatan Parameter ini hanya dikembalikan untuk instans PolarDB-X 2.0.	074ce334-5247-40b9-b0c1-158aea5d****
TemplateId	string	ID templat instans PolarDB-X 2.0. Catatan Parameter ini hanya dikembalikan untuk instans PolarDB-X 2.0.	6a63b6ac4572abfaef7d1163f684****
NodeId	string
Cmd	string
Rt	integer
RequestSize	integer
ResponseSize	integer
ClientIp	string
DbId	string
OriginTime	string
OpType	string

Contoh

Respons sukses

JSONformat

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "A1C79EE2-D04D-571B-8C60-961FAF8E****",
  "Success": "true",
  "Data": {
    "DbInstanceName": "rm-bp157g54vy772****",
    "NodeId": "node123",
    "ItemsNumbers": 10,
    "StartTime": "1672531200000",
    "EndTime": "1672617600000",
    "DbInstanceId": 100,
    "TotalRecords": 100,
    "PageNumbers": 1,
    "MaxRecordsPerPage": 20,
    "Logs": [
      {
        "SqlId": "sqlId",
        "Scheme": "HTTPS",
        "SubInstanceId": "r-8vb219d10038****",
        "DbInstanceName": "rm-2zebg30mk056g****",
        "InsName": "test",
        "AccountName": "user1",
        "HostAddress": "192.168.1.1",
        "QueryStartTime": "2024-04-01 11:00:00",
        "SQLText": "SELECT * FROM my_table WHERE ROWNUM <= 10",
        "Psql": "SELECT * FROM my_table WHERE ROWNUM <= 10\n",
        "DBName": "test",
        "QueryTime": 121,
        "ReturnItemNumbers": "test",
        "DocsExamined": "100",
        "KeysExamined": "valueA",
        "TableName": "tableNameExample",
        "LockTime": 100,
        "RowsExamined": 100,
        "RowsSent": 10,
        "ThreadId": "57472578",
        "Timestamp": 1747118812,
        "SqlTag": {
          "SqlId": "8ad7069f236bcdaaa9b3ae4b6299****",
          "Tags": "DAS_IMPORTANT,DAS_IN_PLAN",
          "Comments": "test"
        },
        "LockTimeSeconds": 100,
        "QueryTimeSeconds": 100,
        "SqlType": "SELECT",
        "CPUTime": 50,
        "IOWrites": 1,
        "LastRowsCountAffected": 10,
        "LogicalIOReads": 1,
        "PhysicalIOReads": 1,
        "RowsCountAffected": 10,
        "Command": "SELECT",
        "Namespace": "pro-test",
        "QueryId": "sq-1pzcdMwRb",
        "ReturnNum": "20",
        "ApplicationName": "MyApp",
        "CPUTimeSeconds": 100,
        "Rows": 20,
        "Frows": 10,
        "Scnt": 10,
        "TraceId": "074ce334-5247-40b9-b0c1-158aea5d****",
        "TemplateId": "6a63b6ac4572abfaef7d1163f684****",
        "NodeId": "",
        "Cmd": "",
        "Rt": 0,
        "RequestSize": 0,
        "ResponseSize": 0,
        "ClientIp": "",
        "DbId": "",
        "OriginTime": "",
        "OpType": ""
      }
    ]
  }
}

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.