dbms_sql.add_trace prosedürü, SQL Trace özelliği tarafından talep üzerine izlenmek üzere belirli SQL deyimlerini kaydeder.
Önkoşullar
Bu prosedürü çağırmadan önce loose_sql_trace_type parametresini DEMAND olarak ayarlayın.
Söz dizimi
dbms_sql.add_trace('<schema>', '<query>')
Prosedür çalıştırıldıktan sonra PolarDB, SQL deyiminin içindeki sabit değerleri normalleştirerek bir şablon oluşturur. Bu şablonla eşleşen deyimler otomatik olarak izlenir.
Parametreler
| Parametre | Açıklama |
|---|---|
schema |
Şema adı. |
query |
Çalıştırılacak SQL deyimi. |
Kullanım notları
Prosedürün davranışı, çalıştığı düğüm türüne göre değişir.
Birincil düğüm: İzleme kaydı kalıcı hale getirilir. mysql.sql_sharing tablosundaki ilgili kayıtlar silinir ve tüm salt okunur düğümlere senkronize edilir.
Salt okunur düğümler: İzleme kaydı kalıcı değildir. Saklı yordam yalnızca bu düğümlerde yürütülebilir. Veritabanına küme uç noktası üzerinden eriştiğinizde, şablonlu SQL deyimleri otomatik olarak birincil düğüme yönlendirilir.
Örnek
Bu örnekte bir aralık sorgusu izlenir; ardından şablonu ve yürütme istatistiklerini incelemek amacıyla her iki sistem tablosunda da sorgulama yapılır.
Adım 1: SQL deyimini izleme için kaydedin
call dbms_sql.add_trace('test', 'select * from t where c1 > 1 and c1 < 10');
Adım 2: mysql.sql_sharing içindeki izleme şablonunu doğrulayın
Deyimin kaydedildiğini ve şablona dönüştürüldüğünü onaylamak için mysql.sql_sharing tablosunu sorgulayın:
select * from mysql.sql_sharing\G
Beklenen çıktı:
*************************** 1. row ***************************
Id: (id number)
Sql_id: 82t4dswtqjg02
Schema_name: test
Type: SQL_TRACE
Digest_text: SELECT * FROM `t` WHERE `c1` > ? AND `c1` < ?
Plan_id: NULL
Plan: NULL
Version: 0
Create_time: 2022-11-07 19:05:27.980605
Update_time: 2022-11-07 19:05:27.980605
Extra_info: NULL
Digest_text alanı normalleştirilmiş şablonu gösterir; sabit değerler 1 ve 10 yerine ? işaretleri kullanılır. Bu desene uyan tüm deyimler, kullanılan sabit değerlerden bağımsız olarak artık izlenmektedir.
Adım 3: Şablonla eşleşen deyimleri çalıştırın
select * from t where c1 > 1 and c1 < 10;
select * from t where c1 > 1 and c1 < 100;
Adım 4: İzleme verilerini ve yürütme planı istatistiklerini inceleyin
Yürütme istatistiklerini ve kullanılan yürütme planlarını görmek için information_schema.sql_sharing tablosunu sorgulayın:
select * from information_schema.sql_sharing\G
Beklenen çıktı:
*************************** 1. row ***************************
TYPE: SQL
SQL_ID: 82t4dswtqjg02
SCHEMA_NAME: test
DIGEST_TEXT: SELECT * FROM `t` WHERE `c1` > ? AND `c1` < ?
PLAN_ID: NULL
PLAN: NULL
PLAN_EXTRA: NULL
ERROR_CODE: NULL
REF_BY: SQL_TRACE(DEMAND)
FIRST_LOAD_TIME: 2022-11-07 19:05:28
LAST_HIT_TIME: 2022-11-07 19:17:24
EXECUTIONS: 2
SUM_WAIT_TIME: 363
MIN_WAIT_TIME: 179
MAX_WAIT_TIME: 184
SUM_EXEC_TIME: 925
MIN_EXEC_TIME: 438
MAX_EXEC_TIME: 487
SUM_ROWS_SENT: 106
MIN_ROWS_SENT: 8
MAX_ROWS_SENT: 98
SUM_ROWS_EXAMINED: 108
MIN_ROWS_EXAMINED: 8
MAX_ROWS_EXAMINED: 100
SUM_ROWS_AFFECTED: 0
MIN_ROWS_AFFECTED: 0
MAX_ROWS_AFFECTED: 0
SUM_LOGICAL_READ: 122
MIN_LOGICAL_READ: 19
MAX_LOGICAL_READ: 103
SUM_PHY_SYNC_READ: 0
MIN_PHY_SYNC_READ: 0
MAX_PHY_SYNC_READ: 0
SUM_PHY_ASYNC_READ: 0
MIN_PHY_ASYNC_READ: 0
MAX_PHY_ASYNC_READ: 0
EXTRA: {TRACE_ROW_ID:10}
*************************** 2. row ***************************
TYPE: PLAN
SQL_ID: 82t4dswtqjg02
SCHEMA_NAME: test
DIGEST_TEXT: NULL
PLAN_ID: 5a4cvp4gjqgfj
PLAN: /*+ NO_INDEX(`t`@`select#1`) */
PLAN_EXTRA: {`t`@`select#1`:ALL}
ERROR_CODE: 0
REF_BY: SQL_TRACE(DEMAND)
FIRST_LOAD_TIME: 2022-11-07 19:17:24
LAST_HIT_TIME: 2022-11-07 19:17:24
EXECUTIONS: 1
SUM_WAIT_TIME: 184
MIN_WAIT_TIME: 184
MAX_WAIT_TIME: 184
SUM_EXEC_TIME: 487
MIN_EXEC_TIME: 487
MAX_EXEC_TIME: 487
SUM_ROWS_SENT: 98
MIN_ROWS_SENT: 98
MAX_ROWS_SENT: 98
SUM_ROWS_EXAMINED: 100
MIN_ROWS_EXAMINED: 100
MAX_ROWS_EXAMINED: 100
SUM_ROWS_AFFECTED: 0
MIN_ROWS_AFFECTED: 0
MAX_ROWS_AFFECTED: 0
SUM_LOGICAL_READ: 103
MIN_LOGICAL_READ: 103
MAX_LOGICAL_READ: 103
SUM_PHY_SYNC_READ: 0
MIN_PHY_SYNC_READ: 0
MAX_PHY_SYNC_READ: 0
SUM_PHY_ASYNC_READ: 0
MIN_PHY_ASYNC_READ: 0
MAX_PHY_ASYNC_READ: 0
EXTRA: NULL
*************************** 3. row ***************************
TYPE: PLAN
SQL_ID: 82t4dswtqjg02
SCHEMA_NAME: test
DIGEST_TEXT: NULL
PLAN_ID: 463zszw4mbv3w
PLAN: /*+ INDEX(`t`@`select#1` `i_c1`) */
PLAN_EXTRA: {`t`@`select#1`:range}
ERROR_CODE: 0
REF_BY: SQL_TRACE(DEMAND)
FIRST_LOAD_TIME: 2022-11-07 19:17:21
LAST_HIT_TIME: 2022-11-07 19:17:21
EXECUTIONS: 1
SUM_WAIT_TIME: 179
MIN_WAIT_TIME: 179
MAX_WAIT_TIME: 179
SUM_EXEC_TIME: 438
MIN_EXEC_TIME: 438
MAX_EXEC_TIME: 438
SUM_ROWS_SENT: 8
MIN_ROWS_SENT: 8
MAX_ROWS_SENT: 8
SUM_ROWS_EXAMINED: 8
MIN_ROWS_EXAMINED: 8
MAX_ROWS_EXAMINED: 8
SUM_ROWS_AFFECTED: 0
MIN_ROWS_AFFECTED: 0
MAX_ROWS_AFFECTED: 0
SUM_LOGICAL_READ: 19
MIN_LOGICAL_READ: 19
MAX_LOGICAL_READ: 19
SUM_PHY_SYNC_READ: 0
MIN_PHY_SYNC_READ: 0
MAX_PHY_SYNC_READ: 0
SUM_PHY_ASYNC_READ: 0
MIN_PHY_ASYNC_READ: 0
MAX_PHY_ASYNC_READ: 0
EXTRA: NULL
Çıktıda, aynı SQL_ID değerine sahip bir SQL satırı ve iki PLAN satırı bulunur. Bu durum, izlenen iki yürütmenin farklı yürütme planları kullandığını gösterir:
2. Satır (PLAN):
NO_INDEXplan ipucuyla tanımlanan tam tablo taraması (ALL). Bu plan 100 satırı inceledi ve 487 mikrosaniye sürdü.3. Satır (PLAN):
i_c1dizinini kullanan dizin aralık taraması (range). Bu plan yalnızca 8 satırı inceledi ve 438 mikrosaniye sürdü.
Şablonla eşleşen SQL deyimleri, i_c1 dizin aralık taramaları ve tam tablo taramalarına karşılık gelen yürütme planlarıyla ilişkilidir.