> ## 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.

# إعدادات الجلسة لـ hdfs_*

> إعدادات جلسة ClickHouse ضمن المجموعة المُنشأة hdfs_*.

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>النوع</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>القيمة الافتراضية</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          يمكن تغييره دون إعادة التشغيل
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

هذه الإعدادات متاحة في [system.settings](/docs/ar/reference/system-tables/settings)، وقد جرى توليدها تلقائيًا من [المصدر](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="hdfs_create_new_file_on_insert">
  ## hdfs\_create\_new\_file\_on\_insert
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

يُمكّن أو يعطّل إنشاء ملف جديد مع كل عملية إدراج في جداول محرك HDFS. إذا كان هذا الإعداد مفعّلًا، فسيُنشأ ملف HDFS جديد مع كل عملية إدراج، باسم يتبع نمطًا مشابهًا لما يلي:

الاسم الأصلي: `data.Parquet.gz` -> `data.1.Parquet.gz` -> `data.2.Parquet.gz`، وهكذا.

القيم الممكنة:

* 0 — يُلحِق استعلام `INSERT` بيانات جديدة بنهاية الملف.
* 1 — ينشئ استعلام `INSERT` ملفًا جديدًا.

<div id="hdfs_ignore_file_doesnt_exist">
  ## hdfs\_ignore\_file\_doesnt\_exist
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.6"},{"label": "0"},{"label": "السماح بإرجاع 0 صفوف عند عدم وجود الملفات المطلوبة، بدلًا من طرح استثناء في محرك جدول HDFS"}]}]} />

تجاهل عدم وجود الملف إذا لم يكن موجودًا عند قراءة مفاتيح معيّنة.

القيم الممكنة:

* 1 — يعيد `SELECT` نتيجة فارغ.
* 0 — يطرح `SELECT` استثناءً.

<div id="hdfs_replication">
  ## hdfs\_replication
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

يمكن تحديد العدد الفعلي للنسخ المتماثلة عند إنشاء ملف HDFS.

<div id="hdfs_skip_empty_files">
  ## hdfs\_skip\_empty\_files
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

يُمكّن أو يعطّل تخطي الملفات الفارغة في جداول المحرك [HDFS](/docs/ar/reference/engines/table-engines/integrations/hdfs).

القيم الممكنة:

* 0 — يطرح `SELECT` استثناءً إذا كان الملف الفارغ غير متوافق مع التنسيق المطلوب.
* 1 — يُرجع `SELECT` نتيجة فارغ للملف الفارغ.

<div id="hdfs_throw_on_zero_files_match">
  ## hdfs\_throw\_on\_zero\_files\_match
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.6"},{"label": "0"},{"label": "السماح بإطلاق خطأ عندما يتعذر على طلب ListObjects مطابقة أي ملفات في محرك HDFS بدلًا من نتيجة استعلام فارغة"}]}]} />

يُطلق خطأ إذا لم تتم مطابقة أي ملفات وفقًا لقواعد توسيع `glob`.

القيم الممكنة:

* 1 — `SELECT` يطرح استثناءً.
* 0 — `SELECT` يعيد نتيجة فارغ.

<div id="hdfs_truncate_on_insert">
  ## hdfs\_truncate\_on\_insert
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

يُفعّل أو يعطّل الاقتطاع قبل عملية الإدراج في جداول محرك HDFS. وإذا كان معطّلًا، فسيُطرَح استثناء عند محاولة الإدراج إذا كان الملف موجودًا بالفعل في HDFS.

القيم الممكنة:

* 0 — يُلحق استعلام `INSERT` البيانات الجديدة بنهاية الملف.
* 1 — يستبدل استعلام `INSERT` المحتوى الحالي للملف بالبيانات الجديدة.
