Bir örneğin SQL denetim günlüklerini sorgulama - - Alibaba Cloud Dokümantasyon Merkezi

Bu işlemi çağırmadan önce, örneğin aşağıdaki veritabanı altyapılarından birini çalıştırdığından emin olun:

MySQL
SQL Server
PostgreSQL

Not

Bu işlemi, hesap başına dakikada en fazla 1.000 kez çağırabilirsiniz. Alibaba Cloud hesabınız ve bu hesap altındaki RAM kullanıcıları aracılığıyla yapılan çağrıların tümü bu sınıra dahildir.
Bu işlem, bir ApsaraDB RDS for MySQL örneği için SQL Explorer Trial Edition tarafından oluşturulan günlükleri sorgulamak için kullanılamaz.
Bu işlemi çağırırken Form parametresini File olarak ayarlayıp bir denetim dosyası oluşturduğunuzda, denetim dosyasına en fazla 1 milyon günlük kaydı yazılabilir ve günlük kayıtları anahtar kelimeye göre filtelenemez.

Hata Ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	DescribeSQLLogRecords	Gerçekleştirmek istediğiniz işlem. Değeri DescribeSQLLogRecords olarak ayarlayın.
ClientToken	String	Hayır	ETnLKlblzczshOTUbOCzxxxxxxx	İsteğin tekil çalışmasını (idempotence) sağlamak için kullanılan istemci belirteci. Değer istemci tarafından oluşturulabilir; ancak oluşturulan belirtecin farklı istekler arasında benzersiz olduğundan emin olmanız gerekir. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz.
DBInstanceId	String	Evet	rm-uf6wjk5xxxxxxx	Örneğin ID değeri.
SQLId	Long	Hayır	25623548	SQL ifadesinin benzersiz ID değeri.
QueryKeywords	String	Hayır	table_name	Sorguda kullanılacak anahtar kelime. Bu işlemi çağırırken Form parametresini File olarak ayarlayıp bir denetim dosyası oluşturduğunuzda, günlük kayıtları anahtar kelimeye göre filtelenemez. En fazla 10 anahtar kelime belirtebilirsiniz. Anahtar kelimeler mantıksal AND operatörüyle birleştirilir. Birden fazla anahtar kelimeyi boşlukla ayırın. Belirtilen SQL ifadesindeki bir alan adı ters tırnak (`) ile çevriliyse ve bu alan adını anahtar kelime olarak kullanmak istiyorsanız, ters tırnakları (`) alan adının bir parçası olarak girmelisiniz. Örneğin, alan adı `id` ise, id yerine `id` girmelisiniz. Not Bir anahtar kelime girdiğinizde sistem, bu anahtar kelimeyi Database, User ve QueryKeywords parametrelerine göre eşleştirir. Parametreler mantıksal OR operatörüyle birleştirilir.
StartTime	String	Evet	2011-06-01T15:00:00Z	Sorgulanacak zaman aralığının başlangıcı. Son 30 gün içinde oluşturulan günlükleri sorgulayabilirsiniz. Zamanı, UTC cinsinden ISO 8601 standardında yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin.
Database	String	Hayır	Database	Veritabanının adı. Yalnızca bir veritabanı adı girebilirsiniz. Bu parametreyi belirtirseniz işlem yalnızca belirtilen veritabanı için oluşturulan günlükleri döndürür. Bu parametreyi belirtmezseniz işlem, örnek üzerindeki tüm veritabanları için oluşturulan günlükleri döndürür.
User	String	Hayır	user	Hesabın kullanıcı adı. Yalnızca bir kullanıcı adı girebilirsiniz. Bu parametreyi belirtirseniz işlem yalnızca belirtilen hesap için oluşturulan günlükleri döndürür. Bu parametreyi belirtmezseniz işlem, örnek üzerindeki tüm hesaplar için oluşturulan günlükleri döndürür.
Form	String	Hayır	Stream	Bir SQL denetim günlüğü dosyasının oluşturulup oluşturulmayacağını veya SQL denetim günlük kayıtlarının döndürülüp döndürülmeyeceğini belirtir. Geçerli değerler: File: Bu parametreyi File olarak ayarlarsanız işlem bir SQL denetim günlüğü dosyası oluşturur ve yalnızca ortak yanıt parametrelerini döndürür. Bu işlemi çağırdıktan sonra SQL denetim günlüğü dosyasının indirme URL'sini almak için DescribeSQLLogFiles işlemini çağırmanız gerekir. Stream: Bu parametreyi Stream olarak ayarlarsanız işlem SQL denetim günlük kayıtlarını döndürür. Bu, varsayılan değerdir. Not Bu parametreyi File olarak ayarlarsanız yalnızca yerel SSD kullanan ApsaraDB RDS for MySQL örnekleri ve ApsaraDB RDS for SQL Server örnekleri desteklenir ve en fazla 1 milyon günlük kaydı döndürülür.
EndTime	String	Evet	2011-06-11T15:00:00Z	Sorgulanacak zaman aralığının bitişi. Bitiş zamanı, başlangıç zamanından sonra olmalıdır. Başlangıç ve bitiş zamanları arasındaki süre 30 günden az olmalıdır. Zamanı, UTC cinsinden ISO 8601 standardında yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin.
PageSize	Integer	Hayır	30	Her sayfada döndürülecek kayıt sayısı. Geçerli değerler: 30 ile 100 arası. Varsayılan değer: 30.
PageNumber	Integer	Hayır	1	Döndürülecek sayfanın numarası. Geçerli değerler: sıfır dışındaki tüm pozitif tam sayılar. Varsayılan değer: 1.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	08A3B71B-FE08-4B03-974F-CC7EA6DB1828	İsteğin ID değeri.
PageNumber	Integer	1	Döndürülen sayfanın sayfa numarası.
PageRecordCount	Integer	30	Geçerli sayfadaki SQL denetim günlük kayıtlarının sayısı.
TotalRecordCount	Long	100	Döndürülen toplam kayıt sayısı.
Items	Array of SQLRecord		Her bir SQL denetim günlük kaydının ayrıntılarını içeren bir dizi.
SQLRecord
HostAddress	String	192.168.0.121	Örneğe bağlı olan istemcinin IP adresi.
SQLText	String	update test.zxb set id=0 limit 1	Sorguda yürütülen SQL ifadesi.
ReturnRowCounts	Long	30	Döndürülen SQL denetim günlük kayıtlarının sayısı.
DBName	String	testDB	Veritabanının adı.
ExecuteTime	String	2011-06-11T15:00:23Z	SQL ifadesinin yürütülme zamanı. Zaman, yyyy-MM-dd T HH:mm:ss Z biçimini izler. Zaman UTC olarak görüntülenir.
ThreadID	String	1025865428	İş parçacığının ID değeri.
TotalExecutionTimes	Long	600	SQL ifadesinin yürütme süresi. Birim: mikrosaniye.
AccountName	String	accounttest	SQL denetim günlük kaydında kaydedilen hesabın kullanıcı adı.

Örnekler

Örnek istekler

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>

Örnek başarılı yanıt

XML biçimi

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 biçimi

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"
}

Hata kodları

Hata kodlarının listesi için bkz. Hizmet hata kodları.