> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> استخدم تخزين الكائنات المتوافق مع S3 من Tigris مع ClickHouse

# استخدام Tigris

export const CloudNotSupportedBadge = () => {
  return <a href="https://clickhouse.com/docs/products/cloud/guides/cloud-compatibility#list-of-unsupported-features" className="cloudNotSupportedBadge">
            <div className="cloudNotSupportedIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.5" d="M6.33366 12.6666L12.3739 12.6667C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00003 12.3739 8.00003C12.3739 8.00003 12.3337 7.66659 12.0003 7.33325M10.667 5.33322C8.00033 2.33325 4.45395 4.78537 4.14195 6.68203C2.55728 6.7627 1.29395 8.06203 1.29395 9.6667C1.29395 11.3234 2.66699 12.6666 4.00033 12.6666" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.5" d="M2.66699 14L12.0003 4.66663" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>

        </div>
            غير مدعوم في ClickHouse Cloud
        </a>;
};

<CloudNotSupportedBadge />

<Note>
  هذه الصفحة لا تنطبق على [ClickHouse Cloud](https://clickhouse.com/cloud). الميزة الموثقة هنا غير متاحة في خدمات ClickHouse Cloud.
  راجع دليل [التوافق مع Cloud](/docs/ar/products/cloud/guides/cloud-compatibility) الخاص بـ ClickHouse لمزيد من المعلومات.
</Note>

تتوافق دالة الجدول `s3` ونوع القرص `S3` في ClickHouse مع [Tigris](https://www.tigrisdata.com)، وهي خدمة تخزين كائنات متوافقة مع S3. يوفّر Tigris endpoint عالميًا واحدًا على `https://t3.storage.dev`، وتُخدَّم عمليات القراءة من Region الأقرب إلى العميل، لذا يمكن لمجموعة ClickHouse متعددة المناطق استخدام Bucket URL واحد دون الحاجة إلى replicas لكل Region أو egress بين المناطق.

يتوافق إعداد merge tree المدعوم مع إدخال تغييرات طفيفة:

```xml theme={null}
<clickhouse>
    <storage_configuration>
        ...
        <disks>
            <s3>
                <type>s3</type>
                <endpoint>https://your-bucket.t3.storage.dev/tables/</endpoint>
                <access_key_id>your_access_key_id</access_key_id>
                <secret_access_key>your_secret_access_key</secret_access_key>
                <region>auto</region>
                <metadata_path>/var/lib/clickhouse/disks/s3/</metadata_path>
            </s3>
            <s3_cache>
                <type>cache</type>
                <disk>s3</disk>
                <path>/var/lib/clickhouse/disks/s3_cache/</path>
                <max_size>10Gi</max_size>
            </s3_cache>
        </disks>
        ...
    </storage_configuration>
</clickhouse>
```

<Tip>
  اضبط `<region>auto</region>`. يستخدم Tigris نقطة نهاية عالمية واحدة بدلاً من حاويات لكل منطقة، لكن مسار توقيع AWS SigV4 الذي يستخدمه ClickHouse لا يزال يتطلب قيمة للمنطقة، و`auto` هو الاصطلاح المتّبع.
</Tip>

تعمل دالة الجدول `s3` مع نقطة النهاية نفسها:

```sql theme={null}
SELECT *
FROM s3(
    'https://your-bucket.t3.storage.dev/path/to/file.parquet',
    'your_access_key_id',
    'your_secret_access_key',
    'Parquet'
);
```

يمكن إنشاء مفاتيح الوصول من [وحدة تحكم Tigris](https://console.storage.dev/). تبدأ معرّفات مفاتيح الوصول بـ `tid_`، والأسرار بـ `tsec_`.