Skip to main content

الوصف

يجمع هذا الجدول الوثائق المضمّنة للمكوّنات الموحّدة في النظام في جدول واحد. ويمثّل كل صف كيانًا واحدًا (مثل دالة، أو محرك جدول، أو نوع بيانات، وما إلى ذلك)، ويحتوي على الوثائق المرجعية لذلك الكيان معروضة بصيغة Markdown — أي المحتوى نفسه المنشور على الموقع الإلكتروني والمُتاح عبر جداول system.* الخاصة بكل نوع. يُجمَّع description من الأجزاء المنظَّمة للوثائق المضمّنة (description وsyntax والوسيطات والأمثلة وما إلى ذلك)، بحيث يحتوي عمود واحد على الوثائق الكاملة للكيان. وعندما تتضمّن الوثائق المضمّنة الصفحة المرجعية كاملةً داخل description الخاص بها (كما هو الحال بالنسبة إلى المكوّنات التي تُولَّد صفحات موقعها الإلكتروني منها تلقائيًا: محركات الجداول، ومحركات قواعد البيانات، وأنواع البيانات، والتنسيقات، ودوال الجداول)، تُنشر الصفحة كما هي، من دون إلحاق أقسام مُنشأة من حقول البيانات الوصفية المنظَّمة — لأن متن الصفحة يغطي هذه المادة بالفعل. وتُعرض الأسماء المستعارة كإحالة مرجعية قصيرة إلى الكيان المرجعي، مثل: Alias of `trunc`. يجمع هذا الجدول، إلى حدٍّ ما، المعلومات المتاحة في جداول الوثائق الخاصة بكل نوع (system.functions، وsystem.table_engines، وsystem.data_type_families، وغيرها). وهو مخصّص، على وجه الخصوص، لدعم أمر help تفاعلي في العميل، لكنه مفيد أيضًا بحد ذاته. تُجمع الأنواع التالية من الكيانات (وتظهر قيمة العمود type بين قوسين):
  • الدوال (Function)
  • الدوال التجميعية (Aggregate Function)
  • دوال الجداول (Table Function)
  • محركات الجداول (Table Engine)
  • محركات قواعد البيانات (Database Engine)
  • أنواع البيانات (Data Type)
  • تخطيطات القواميس (Dictionary Layout)
  • مصادر القواميس (Dictionary Source)
  • مُركِّبات الدوال التجميعية (Aggregate Function Combinator)
  • أنواع فهارس تخطي البيانات (Data Skipping Index)
  • أنواع الأقراص (Disk Type)
  • الإعدادات (Setting)
  • إعدادات MergeTree (MergeTree Setting)
  • إعدادات الخادم (Server Setting)
  • التنسيقات (Format)
  • ترميزات الضغط (Compression Codec)
  • أحداث الملف الشخصي (Profile Event)
  • المقاييس الحالية (Current Metric)
  • المقاييس غير المتزامنة (Asynchronous Metric)
  • جداول النظام (System Table)
بالنسبة إلى الإعدادات (من أي نوع)، تكون الوثائق هي وصف الإعداد، إلى جانب نوعه وقيمته الافتراضية؛ ولا تُعرض الإعدادات المتقادمة. وبالنسبة إلى جداول النظام، تكون الوثائق هي تعليق الجدول، إلى جانب قائمة أعمدته (اسم كل عمود ونوعه ووصفه). يحتوي العمود source على مسار الملف المصدري الذي تُعرَّف فيه وثائق الكيان، نسبةً إلى جذر المستودع. وبالنسبة إلى معظم الكيانات، يُلتقط هذا تلقائيًا في الموضع الذي يُنشأ فيه كائن الوثائق (موضع تسجيل المكوّن)؛ أما الأنواع التي يُوثَّق كلٌّ منها في ملف مصدري واحد (مثل الإعدادات وأحداث الملف الشخصي والمقاييس الحالية)، فيكون ذلك الملف.

الأعمدة

مثال

راجع وثائق كيان معيّن:
Query
يمكن أن يشير الاسم نفسه إلى عدة أنواع من الكيانات (على سبيل المثال، توجد file كدالة جدول وكمصدر قاموس)، لذا من المفيد البحث عن الاسم عبر جميع الأنواع:
Query
احسب الكيانات الموثقة لكل نوع:
Query

انظر أيضًا

Last modified on July 23, 2026