All Products
Search

This Product

    :Kueri log audit SQL suatu instans

    Document Center

    :Kueri log audit SQL suatu instans

    Last Updated:May 26, 2026

    Anda dapat memanggil operasi DescribeSQLLogRecords untuk mengkueri log yang dihasilkan oleh fitur SQL Explorer (SQL Audit) pada suatu instans.

    Sebelum memanggil operasi ini, pastikan instans menggunakan salah satu engine database berikut:

    • MySQL
    • SQL Server
    • PostgreSQL
    Catatan
    • Anda dapat memanggil operasi ini hingga 1.000 kali per menit per akun. Pemanggilan yang dilakukan baik melalui Akun Alibaba Cloud maupun Pengguna RAM dalam Akun Alibaba Cloud Anda akan dihitung.
    • Operasi ini tidak dapat digunakan untuk mengkueri log yang dihasilkan oleh SQL Explorer Trial Edition untuk instans ApsaraDB RDS for MySQL.
    • Saat Anda memanggil operasi ini dan mengatur parameter Form ke File untuk menghasilkan file audit, maksimal 1 juta entri log dapat direkam dalam file tersebut, dan Anda tidak dapat menyaring entri log berdasarkan kata kunci.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

    Parameter permintaan

    Parameter Type Wajib Contoh Deskripsi
    Action String Ya DescribeSQLLogRecords

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeSQLLogRecords.

    ClientToken String Tidak ETnLKlblzczshOTUbOCzxxxxxxx

    Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan nilainya, tetapi harus memastikan bahwa token yang dihasilkan unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.

    DBInstanceId String Ya rm-uf6wjk5xxxxxxx

    ID instans.

    SQLId Long Tidak 25623548

    ID unik dari pernyataan SQL.

    QueryKeywords String Tidak table_name

    Kata kunci yang digunakan untuk kueri.

    • Saat Anda memanggil operasi ini dan mengatur parameter Form ke File untuk menghasilkan file audit, Anda tidak dapat menyaring entri log berdasarkan kata kunci.
    • Anda dapat menentukan hingga 10 kata kunci. Kata kunci tersebut menggunakan logika AND. Pisahkan beberapa kata kunci dengan spasi.
    • Jika nama field dalam pernyataan SQL yang ditentukan diapit tanda backtick (`) dan Anda ingin menggunakan nama field tersebut sebagai kata kunci, Anda harus memasukkan tanda backtick (`) sebagai bagian dari nama field tersebut. Misalnya, jika nama field-nya adalah `id`, Anda harus memasukkan `id` dan bukan id.
    Catatan Setelah Anda memasukkan kata kunci, sistem akan mencocokkan kata kunci tersebut berdasarkan parameter Database, User, dan QueryKeywords. Parameter-parameter tersebut menggunakan logika OR.
    StartTime String Ya 2011-06-01T15:00:00Z

    Awal rentang waktu untuk dikueri. Anda dapat mengkueri log yang dihasilkan dalam 30 hari terakhir. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    Database String Tidak Database

    Nama database. Anda hanya dapat memasukkan satu nama database. Jika Anda menentukan parameter ini, operasi ini hanya akan mengembalikan log yang dihasilkan untuk database yang ditentukan. Jika Anda tidak menentukan parameter ini, operasi ini akan mengembalikan log yang dihasilkan untuk semua database pada instans.

    User String Tidak user

    Username akun. Anda hanya dapat memasukkan satu username. Jika Anda menentukan parameter ini, operasi ini hanya akan mengembalikan log yang dihasilkan untuk akun yang ditentukan. Jika Anda tidak menentukan parameter ini, operasi ini akan mengembalikan log yang dihasilkan untuk semua akun pada instans.

    Form String Tidak Stream

    Menentukan apakah akan menghasilkan file log audit SQL atau mengembalikan entri log audit SQL. Nilai yang valid:

    • File: Jika Anda mengatur parameter ini ke File, operasi ini akan menghasilkan file log audit SQL dan hanya mengembalikan parameter respons umum. Setelah memanggil operasi ini, Anda harus memanggil operasi DescribeSQLLogFiles untuk mendapatkan URL unduhan file log audit SQL tersebut.
    • Stream: Jika Anda mengatur parameter ini ke Stream, operasi ini akan mengembalikan entri log audit SQL. Ini adalah nilai default.
    Catatan Jika Anda mengatur parameter ini ke File, hanya instans ApsaraDB RDS for MySQL yang menggunakan SSD lokal dan instans ApsaraDB RDS for SQL Server yang didukung, serta maksimal 1 juta entri log akan dikembalikan.
    EndTime String Ya 2011-06-11T15:00:00Z

    Akhir rentang waktu untuk dikueri. Waktu akhir harus lebih baru daripada waktu mulai. Rentang waktu antara waktu mulai dan waktu akhir harus kurang dari 30 hari. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    PageSize Integer Tidak 30

    Jumlah entri yang dikembalikan per halaman. Nilai yang valid: 30 hingga 100. Nilai default: 30.

    PageNumber Integer Tidak 1

    Nomor halaman yang dikembalikan. Nilai yang valid: bilangan bulat positif bukan nol apa pun.

    Nilai default: 1.

    Parameter respons

    Parameter Type Contoh Deskripsi
    RequestId String 08A3B71B-FE08-4B03-974F-CC7EA6DB1828

    ID permintaan.

    PageNumber Integer 1

    Nomor halaman yang dikembalikan.

    PageRecordCount Integer 30

    Jumlah entri log audit SQL pada halaman saat ini.

    TotalRecordCount Long 100

    Total jumlah catatan yang dikembalikan.

    Items Array of SQLRecord

    Array yang berisi detail setiap entri log audit SQL.

    SQLRecord
    HostAddress String 192.168.0.121

    Alamat IP client yang terhubung ke instans.

    SQLText String update test.zxb set id=0 limit 1

    Pernyataan SQL yang dieksekusi dalam kueri.

    ReturnRowCounts Long 30

    Jumlah entri log audit SQL yang dikembalikan.

    DBName String testDB

    Nama database.

    ExecuteTime String 2011-06-11T15:00:23Z

    Waktu eksekusi pernyataan SQL. Waktu mengikuti format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

    ThreadID String 1025865428

    ID thread.

    TotalExecutionTimes Long 600

    Durasi eksekusi pernyataan SQL. Satuan: mikrodetik.

    AccountName String accounttest

    Username akun yang tercatat dalam entri log audit SQL.

    Contoh

    Contoh permintaan

    http(s)://rds.aliyuncs.com/?Action=DescribeSQLLogRecords
&DBInstanceId=rm-uf6wjk5xxxxxx
&StartTime=2011-06-01T15:00:00Z
&EndTime=2011-06-11T15:00:00Z
&<Common request parameters>

    Contoh respons sukses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeSQLLogRecordsResponse>
	<PageNumber>1</PageNumber>
	<TotalRecordCounts>1</TotalRecordCounts>
	<ItemsCounts>1</ItemsCounts>
	<SQLItems>
		<SQLItem>
			<DBName>test</DBName>
			<AccountName>accounttest</AccountName>
			<HostAddress>192.168.0.121</HostAddress>
			<SQLText>update test.zxb set id=0 limit 1</SQLText>
			<TotalExecutionTimes>12</TotalExecutionTimes>
			<ReturnRowCounts>34</ReturnRowCounts>
			<ExecuteTime>2011-06-11T15:00:23Z</ExecuteTime>
		</SQLItem>
	</SQLItems>
	<RequestId>08A3B71B-FE08-4B03-974F-CC7EA6DB1828</RequestId>
</DescribeSQLLogRecordsResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageNumber" : 1,
  "TotalRecordCounts" : 1,
  "ItemsCounts" : 1,
  "SQLItems" : {
    "SQLItem" : [ {
      "DBName" : "test",
      "AccountName" : "accounttest",
      "HostAddress" : "192.168.0.121",
      "SQLText" : "update test.zxb set id=0 limit 1",
      "TotalExecutionTimes" : 12,
      "ReturnRowCounts" : 34,
      "ExecuteTime" : "2011-06-11T15:00:23Z"
    } ]
  },
  "RequestId" : "08A3B71B-FE08-4B03-974F-CC7EA6DB1828"
}

    Kode kesalahan

    Untuk daftar kode kesalahan, lihat Service error codes.