> ## 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_*
> إعدادات جلسة ClickHouse ضمن المجموعة المُولَّدة s3_*.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
النوع
{type}
القيمة الافتراضية
{default_value}
{changeable_without_restart &&
يمكن تغييره دون إعادة التشغيل
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
هذه الإعدادات متاحة في [system.settings](/docs/ar/reference/system-tables/settings)، ويتم توليدها تلقائيًا من [المصدر](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## s3\_check\_objects\_after\_upload
تحقّق من كل كائن تم رفعه إلى S3 باستخدام طلب head للتأكد من نجاح عملية الرفع
## s3\_connect\_timeout\_ms
مهلة الاتصال بالمضيف لأقراص S3.
## s3\_create\_new\_file\_on\_insert
يُمكّن أو يعطّل إنشاء ملف جديد مع كل عملية إدراج في جداول محرك S3. وإذا كان مفعّلًا، فسيُنشأ كائن S3 جديد بالمفتاح نفسه مع كل عملية إدراج، وفق نمط مشابه لما يلي:
في البداية: `data.Parquet.gz` -> `data.1.Parquet.gz` -> `data.2.Parquet.gz`، وهكذا.
القيم الممكنة:
* 0 — ينشئ استعلام `INSERT` ملفًا جديدًا، أو يفشل إذا كان الملف موجودًا ولم يتم تعيين `s3_truncate_on_insert`.
* 1 — ينشئ استعلام `INSERT` ملفًا جديدًا مع كل عملية إدراج باستخدام لاحقة (بدءًا من الملف الثاني) إذا لم يتم تعيين `s3_truncate_on_insert`.
اطّلع على مزيد من التفاصيل [هنا](/docs/ar/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data).
## s3\_disable\_checksum
لا تحسب checksum عند إرسال ملف إلى S3. يسرّع ذلك عمليات الكتابة من خلال تجنّب تمريرات المعالجة المفرطة على الملف. ويُعد هذا آمنًا في معظم الحالات، لأن بيانات جداول MergeTree تتحقق سلامتها باستخدام checksum من قِبل ClickHouse على أي حال، وعند الوصول إلى S3 عبر HTTPS، توفّر طبقة TLS بالفعل سلامة البيانات أثناء نقلها عبر الشبكة. ومع ذلك، فإن استخدام checksums إضافية على S3 يوفّر حماية متعددة الطبقات.
## s3\_ignore\_file\_doesnt\_exist
تجاهل عدم وجود الملف عند قراءة مفاتيح معيّنة.
القيم الممكنة:
* 1 — يعيد `SELECT` نتيجة فارغة.
* 0 — يطلق `SELECT` استثناءً.
## s3\_list\_object\_keys\_size
الحد الأقصى لعدد الملفات التي يمكن إرجاعها في دفعة واحدة عبر طلب ListObject
## s3\_min\_upload\_part\_size
الحد الأدنى لحجم الجزء المطلوب رفعه أثناء الرفع متعدد الأجزاء إلى S3.
## s3\_path\_filter\_limit
الحد الأقصى لعدد قيم `_path` التي يمكن استخراجها من عوامل تصفية الاستعلام لاستخدامها في اجتياز الملفات
بدلاً من إدراجها باستخدام `glob`. وتعني القيمة 0 أنه معطّل.
## s3\_request\_timeout\_ms
مهلة خمول لإرسال البيانات واستقبالها من/إلى S3. تفشل العملية إذا ظل استدعاء واحد للقراءة أو الكتابة عبر TCP محجوبًا لهذه المدة.
## s3\_skip\_empty\_files
يُفعّل أو يعطّل تخطي الملفات الفارغة في الجداول التي تستخدم محرك [S3](/docs/ar/reference/engines/table-engines/integrations/s3).
القيم الممكنة:
* 0 — يُطلق `SELECT` استثناءً إذا لم يكن الملف الفارغ متوافقًا مع التنسيق المطلوب.
* 1 — يعيد `SELECT` نتيجة فارغة للملف الفارغ.
## s3\_slow\_all\_threads\_after\_network\_error
عند ضبطه على `true`، يتم إبطاء جميع سلاسل التنفيذ التي تنفّذ طلبات S3 إلى نقطة نهاية النسخة الاحتياطية نفسها
بعد أن يواجه أي طلب S3 واحد خطأ شبكة قابلاً لإعادة المحاولة، مثل مهلة socket.
وعند ضبطه على `false`، تتعامل كل سلسلة تنفيذ مع backoff لطلب S3 بشكل مستقل عن سلاسل التنفيذ الأخرى.
## s3\_strict\_upload\_part\_size
الحجم المحدد بدقة للجزء المطلوب رفعه أثناء الرفع متعدد الأجزاء إلى S3 (بعض التطبيقات لا تدعم الأجزاء ذات الأحجام المتغيرة).
## s3\_throw\_on\_zero\_files\_match
إرجاع خطأ عندما لا يتمكن طلب ListObjects من مطابقة أي ملفات
## s3\_truncate\_on\_insert
يُفعّل أو يعطّل إجراء truncate قبل عمليات الإدراج في جداول محرك S3. وإذا كان معطّلًا، فسيُطرَح استثناء عند محاولة الإدراج إذا كان كائن S3 موجودًا مسبقًا.
القيم الممكنة:
* 0 — ينشئ استعلام `INSERT` ملفًا جديدًا، أو يفشل إذا كان الملف موجودًا ولم يتم تعيين s3\_create\_new\_file\_on\_insert.
* 1 — يستبدل استعلام `INSERT` المحتوى الحالي للملف بالبيانات الجديدة.
اطّلع على مزيد من التفاصيل [هنا](/docs/ar/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data).
## s3\_uri\_style
يفرض نمط نقطة نهاية S3. القيم الممكنة: auto, virtual\_hosted, path.
## s3\_use\_adaptive\_timeouts
عند ضبطه على `true`، تُنفَّذ المحاولتان الأوليان لجميع طلبات S3 باستخدام مهلات إرسال واستقبال منخفضة.
عند ضبطه على `false`، تُنفَّذ جميع المحاولات باستخدام المهلات نفسها.