system.disk_types

جدول نظامي يتضمن قائمة بأنواع الأقراص التي يدعمها الخادم إلى جانب الوثائق المضمّنة لكلٍ منها.

الوصف

يحتوي على قائمة بأنواع الأقراص التي يدعمها الخادم، إلى جانب الوثائق المضمّنة لكل نوع. ويُحدَّد نوع القرص في type ضمن تهيئة القرص، وهو ما يحدد أين وكيف يخزّن القرص بياناته (نظام الملفات المحلي، أو تخزين الكائنات، أو ذاكرة تخزين مؤقت فوق قرص آخر، وما إلى ذلك).

لاحظ أن هذا الجدول يسرد أنواع الأقراص المتاحة، بينما يسرد system.disks مثيلات الأقراص المُعدّة على الخادم.

الأعمدة

• name (String) — اسم نوع القرص، كما هو محدد في type ضمن تهيئة القرص.
• description (String) — وصف عام لما يتيحه نوع القرص.
• syntax (String) — كيفية تحديد نوع القرص في تهيئة القرص.
• examples (String) — أمثلة استخدام.
• introduced_in (String) — إصدار ClickHouse الذي طُرح فيه نوع القرص لأول مرة، بصيغة major.minor.
• related (Array(String)) — أسماء أنواع الأقراص ذات الصلة.

أمثلة على التهيئة

يمكن تهيئة القرص بطريقتين: ثابتًا، في ملفات تهيئة الخادم (XML أو YAML)، أو ديناميكيًا، في إعدادات استعلام CREATE/ATTACH باستخدام الدالة disk. ويُقبل نوع القرص نفسه والمعلمات نفسها في كلتا الحالتين.

الإعداد الثابت

تُعرَّف الأقراص ضمن storage_configuration في إعدادات الخادم. يوضّح المثال التالي قرص s3 وسياسة تخزين تستخدمه.

config.xml

<clickhouse>
    <storage_configuration>
        <disks>
            <s3_disk>
                <type>s3</type>
                <endpoint>https://s3.eu-west-1.amazonaws.com/clickhouse-eu-west-1.clickhouse.com/data/</endpoint>
                <use_environment_credentials>1</use_environment_credentials>
            </s3_disk>
        </disks>
        <policies>
            <s3_policy>
                <volumes>
                    <main>
                        <disk>s3_disk</disk>
                    </main>
                </volumes>
            </s3_policy>
        </policies>
    </storage_configuration>
</clickhouse>

الإعداد نفسه بصيغة YAML:

config.yaml

storage_configuration:
  disks:
    s3_disk:
      type: s3
      endpoint: https://s3.eu-west-1.amazonaws.com/clickhouse-eu-west-1.clickhouse.com/data/
      use_environment_credentials: 1
  policies:
    s3_policy:
      volumes:
        main:
          disk: s3_disk

يمكن للجدول بعد ذلك استخدام القرص عبر سياسة التخزين الخاصة به:

Query

CREATE TABLE test (a Int32, b String)
ENGINE = MergeTree() ORDER BY a
SETTINGS storage_policy = 's3_policy';

الإعداد الديناميكي

يمكن أيضًا تعريف قرص مباشرةً ضمن إعدادات استعلام CREATE/ATTACH، من دون الحاجة إلى تعريف قرص مسبقًا في ملفات التهيئة، باستخدام الدالة disk:

Query

CREATE TABLE test (a Int32, b String)
ENGINE = MergeTree() ORDER BY a
SETTINGS disk = disk(
    type = s3,
    endpoint = 'https://s3.eu-west-1.amazonaws.com/clickhouse-eu-west-1.clickhouse.com/data/',
    use_environment_credentials = 1
);

راجع إعداد التخزين الخارجي للاطلاع على القائمة الكاملة للمعلمات لكل نوع من أنواع الأقراص.

مثال

Query

SELECT name, description
FROM system.disk_types
WHERE name IN ('local', 'object_storage')
ORDER BY name

انظر أيضًا

• system.disks — الأقراص المُهيّأة على الخادم.
• system.storage_policies — سياسات التخزين ووحداته.