Tüm Ürünler
Search
Belge Merkezi

PolarDB:TTL kullanımı

Son Güncelleme:Oct 21, 2026

Bu konu, PolarDB for MySQL içindeki süresi dolmuş veri temizleme özelliğini açıklar.

Sürüm kısıtlamaları

PolarDB for MySQL aşağıdaki veritabanı altyapısı sürümlerini destekler:

  • MySQL 8.0.1 için küçük sürüm 8.0.1.1.49.2 veya üzeri gerekir.

  • MySQL 8.0.2 için küçük sürüm 8.0.2.2.29.2 veya üzeri gerekir.

Çekirdek sürümünü görüntülemek için bkz. Altyapı sürümleri.

Kullanım notları

  • Geçici tablolar (yerel ve genel geçici tablolar dahil) üzerinde TTL (time to live) özellikleri yapılandıramazsınız.

  • TTL özelliklerine sahip tablolar Genel İkincil Dizinleri (GSI) kullanamaz.

  • TTL özelliklerine sahip bir tablo, yabancı anahtar kısıtlamasında başka tablolar tarafından birincil tablo olarak referans gösterilemez.

  • TTL özelliklerine sahip bir tablo tetikleyici içeremez.

  • Süresi dolan tüm verilerin hemen silineceği garanti edilmez. Süresi dolan verilerin silinme zamanı, arka plandaki temizleme görevinin zamanlama döngüsüne bağlıdır.

  • Veritabanlarını ve tabloları geri yüklediğinizde veya yedeklemelerden geri yükleme yaptığınızda, TTL süresi dolmuş verilerin temizlenmesini devre dışı bırakmak için loose_innodb_enable_ttl_purge parametresini OFF olarak ayarlayın. Geri yükleme işleminden sonra tüm verilerin süresi dolmuş olabilir.

  • TTL özelliklerine sahip bir sütun TIMESTAMP veya DATETIME türünde olmalıdır.

  • TTL ile temizlenen veriler ikili günlükte (binary log) kaydedilmez. Veri senkronizasyonu için ikili günlüğü kullandığınızda ve kaynak veritabanındaki bir tabloda TTL etkinleştirildiğinde, veriler ikincil veritabanına senkronize edilirken anahtar değeri çakışmaları oluşabilir.

Sözdizimi

Bir tablo için TTL yapılandırmak üzere CREATE TABLE veya ALTER TABLE deyimlerini kullanabilirsiniz.

TTL özelliklerine sahip bir tablo oluşturma

TTL özelliklerine sahip bir tablo oluşturmak için aşağıdaki yöntemlerden birini kullanabilirsiniz:

TTL sütunu olarak created_at (veri oluşturma zamanını temsil eder) belirtilen t1 adlı bir tablo oluşturun. Verilerin silinip silinmeyeceğini belirlemek için created_at sütununun TTL değerini ayarlayın.

  • created_at için maksimum TTL değerini 100 saniye olarak ayarlayın.

    CREATE TABLE `t1` (
      `a` INT PRIMARY KEY,
      `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
      KEY idx_created_at (`created_at`)
    )ENGINE=InnoDB  TTL='created_at@100';
    Not

    TTL='created_at@100' ayarı, tablodaki satırların maksimum TTL değerini 100 saniye olarak belirler. Bu süreyi aşan süresi dolmuş veriler daha sonra silinir.

  • created_at için maksimum TTL değerini 3 saat olarak ayarlayın.

    CREATE TABLE `t1` (
      `a` INT PRIMARY KEY,
      `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
      KEY idx_created_at (`created_at`)
    )ENGINE=InnoDB  TTL='created_at' + INTERVAL 3 HOUR;
    Not
    • TTL ='created_at'+ INTERVAL 3 HOUR ayarıyla, tablodaki verilerin maksimum TTL değerini 3 saat olarak belirleyebilirsiniz. Bu süreyi aşan süresi dolmuş veriler otomatik olarak silinir.

    • Bu TTL ayarı YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE ve SECOND gibi birden çok zaman birimini destekler. Bu esneklik, gereksinimlerinize göre uygun bir zaman birimi seçerek verimli veri yönetimi ve bakımı yapmanızı sağlar.

Bir tablonun TTL özelliklerini değiştirme

Bir tablonun TTL özelliklerini değiştirmek için aşağıdaki yöntemlerden birini kullanabilirsiniz:

t1 tablosunda, verilerin silinip silinmeyeceğini belirlemek için created_at sütununun TTL değerini değiştirebilirsiniz.

  • created_at için maksimum TTL değerini 10.000 saniye olarak ayarlayın.

    ALTER TABLE `t1` TTL='created_at@10000';
    Not

    created_at alanının TTL değerini 10.000 saniye olarak ayarlamak, verilerin oluşturma zamanından sonra 10.000 saniye boyunca geçerli kalmasını sağlar. 10.000 saniyeden eski veriler otomatik olarak silinir.

  • created_at için maksimum TTL değerini 3 gün olarak ayarlayın.

    ALTER TABLE `t1` TTL='created_at' + INTERVAL 3 DAY;
    Not

    TTL özelliklerinde created_at zaman damgasını kullanın ve veri sona erme süresini 3 gün olarak ayarlamak için 3 günlük bir geçerlilik süresi ekleyin. Bu sayede verilerin oluşturma tarihinden itibaren 3 günü aşmaması sağlanır. 3 günden eski veriler otomatik olarak silinir.

Bir tablonun TTL özelliklerini temizleme

ALTER TABLE t1 TTL = '';

Bir tablonun TTL özelliklerini sorgulama

SHOW CREATE TABLE `t1` FULL;

CREATE TABLE `t1` (  
`a` INT PRIMARY KEY,  
`created_at` TIMESTAMP DEFAULT 
CURRENT_TIMESTAMP,  
 KEY idx_created_at (`created_at`)
)ENGINE=InnoDB  TTL='created_at@259200';
Not

Bir tablonun TTL bilgisi içerip içermediğini sorgulamak için önceki deyimi kullanın.

Parametreler

TTL süresi dolmuş verilerin temizlenmesini kontrol etmek için aşağıdaki global parametreler de eklenmiştir:

Not

PolarDB konsolunda aşağıdaki global parametreleri değiştirerek TTL süresi dolmuş verilerin temizlenmesini kontrol edebilirsiniz.

Parametre adı

Açıklama

loose_innodb_enable_ttl_purge

TTL süresi dolmuş verilerin temizlenmesinin etkinleştirilip etkinleştirilmeyeceğini belirtir.

Geçerli değerler:

  • ON: TTL süresi dolmuş verilerin temizlenmesini etkinleştirir.

  • OFF (varsayılan): TTL süresi dolmuş verilerin temizlenmesini devre dışı bırakır.

Not

TTL süresi dolmuş verilerin temizlenmesini konsolda etkinleştirmeniz gerekir.

loose_innodb_ttl_min_interval

Veri sona erme süresi ayarlarken izin verilen minimum süre. Varsayılan değer 100'dür. Varsayılan birim saniyedir.

loose_innodb_ttl_purge_thread

TTL süresi dolmuş verileri temizlemek için kullanılan iş parçacığı sayısı. Değişikliğin etkili olması için değişiklikten sonra innodb_enable_ttl_purge parametresini sıfırlayın. Varsayılan değer 4'tür.

loose_innodb_ttl_cluster_index_purge_batch_size

Belirtilen TTL sütununda dizin yoksa, TTL süresi dolmuş veriler taranırken birincil anahtar taranır. Her seferinde taranan varsayılan birincil anahtar satırı sayısı 10.000'dir.

loose_innodb_ttl_index_purge_batch_size

Belirtilen TTL sütununda dizin varsa, TTL süresi dolmuş veriler taranırken dizin taranır. Her seferinde taranan varsayılan dizin satırı sayısı 500'dür.

loose_innodb_ttl_purge_start_hour

TTL temizleme görevinin başlangıç saati. Varsayılan değer 0'dır. Değer 0 ile 23 arasında olabilir ve innodb_ttl_purge_end_hour değerini aşamaz.

loose_innodb_ttl_purge_end_hour

TTL temizleme görevinin bitiş saati. Varsayılan değer 0'dır. Değer 0 ile 23 arasında olabilir ve innodb_ttl_purge_start_hour değerinden küçük olamaz.

loose_innodb_ttl_finished_job_expired_days

mysql. ttl_job_history tablosundaki verilerin sona erme süresini kontrol eder. Varsayılan değer 90'dır. Değer 1 ile 365 arasında olabilir. Varsayılan birim gündür.

TTL izleme

Sistem, TTL için çalışma zamanı bilgilerini periyodik olarak toplar ve TTL temizleme görevlerinin ayrıntılı yürütme durumunu gösteren bir sistem tablosu sağlar. Aşağıdaki tabloda mysql.ttl_job_history tablosundaki alanlar açıklanmaktadır:


Sütun adı


Açıklama


job_id


TTL temizleme görevinin ID'si; genellikle milisaniye cinsinden bir zaman damgasıdır.


table_name


Bu TTL göreviyle ilişkili tablonun adı.


state


TTL görevinin yürütme durumu: pending (beklemede), executing (yürütülüyor) veya completed (tamamlandı).


start_time


Görevin başlangıç zamanı.


finished_time


Görevin tamamlanma zamanı.


expire_time


Bu TTL görevi tarafından temizlenen verilerin sona erme zamanı.


scan_cost


Bu partinin taranması için gereken süre.


purge_cost


Bu partinin temizlenmesi için gereken süre.


purge_rows


Bu TTL görevi tarafından temizlenen veri satırı sayısı.