> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> توثيق التعامل مع TTL على مستوى الجدول

# التعامل مع TTL على مستوى الجدول

<Note>
  إذا كنت تبحث عن تفاصيل حول استخدام TTL لإدارة البيانات القديمة، فاطّلع على دليل المستخدم [إدارة البيانات باستخدام TTL](/ar/concepts/features/operations/delete/ttl). توضّح الوثائق أدناه كيفية تعديل قاعدة TTL حالية أو إزالتها.
</Note>

<div id="modify-ttl">
  ## تعديل TTL
</div>

يمكنك تغيير [TTL على مستوى الجدول](/ar/reference/engines/table-engines/mergetree-family/mergetree#mergetree-table-ttl) باستخدام طلب بالصيغة التالية:

```sql theme={null}
ALTER TABLE [db.]table_name [ON CLUSTER cluster] MODIFY TTL ttl_expression;
```

<div id="remove-ttl">
  ## إزالة خاصية TTL
</div>

يمكن إزالة خاصية TTL من الجدول باستخدام الاستعلام التالي:

```sql theme={null}
ALTER TABLE [db.]table_name [ON CLUSTER cluster] REMOVE TTL
```

**مثال**

لننظر إلى الجدول ذي `TTL` على مستوى الجدول:

```sql theme={null}
CREATE TABLE table_with_ttl
(
    event_time DateTime,
    UserID UInt64,
    Comment String
)
ENGINE MergeTree()
ORDER BY tuple()
TTL event_time + INTERVAL 3 MONTH
SETTINGS min_bytes_for_wide_part = 0;

INSERT INTO table_with_ttl VALUES (now(), 1, 'username1');

INSERT INTO table_with_ttl VALUES (now() - INTERVAL 4 MONTH, 2, 'username2');
```

نفّذ `OPTIMIZE` لفرض تطبيق تنظيف `TTL`:

```sql theme={null}
OPTIMIZE TABLE table_with_ttl FINAL;
SELECT * FROM table_with_ttl FORMAT PrettyCompact;
```

تم حذف الصف الثاني من الجدول.

```text theme={null}
┌─────────event_time────┬──UserID─┬─────Comment──┐
│   2020-12-11 12:44:57 │       1 │    username1 │
└───────────────────────┴─────────┴──────────────┘
```

الآن احذف `TTL` من الجدول باستخدام الاستعلام التالي:

```sql theme={null}
ALTER TABLE table_with_ttl REMOVE TTL;
```

أعد إدراج الصف المحذوف ونفّذ تنظيف `TTL` قسرًا مرة أخرى باستخدام `OPTIMIZE`:

```sql theme={null}
INSERT INTO table_with_ttl VALUES (now() - INTERVAL 4 MONTH, 2, 'username2');
OPTIMIZE TABLE table_with_ttl FINAL;
SELECT * FROM table_with_ttl FORMAT PrettyCompact;
```

لم يعد `TTL` موجودًا، لذا لا يُحذَف الصف الثاني:

```text theme={null}
┌─────────event_time────┬──UserID─┬─────Comment──┐
│   2020-12-11 12:44:57 │       1 │    username1 │
│   2020-08-11 12:44:57 │       2 │    username2 │
└───────────────────────┴─────────┴──────────────┘
```

**راجع أيضًا**

* مزيد من المعلومات حول [TTL-expression](/ar/reference/statements/create/table#ttl-expression).
* عدّل العمود [باستخدام TTL](/ar/reference/statements/alter/ttl).