Tüm Ürünler
Search
Belge Merkezi

PolarDB:dbms_sql.add_trace

Son Güncelleme:Oct 07, 2026

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_INDEX plan ipucuyla tanımlanan tam tablo taraması (ALL). Bu plan 100 satırı inceledi ve 487 mikrosaniye sürdü.

  • 3. Satır (PLAN): i_c1 dizinini 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.