CREATE DATABASE

CREATE DATABASE [IF NOT EXISTS] db_name [ON CLUSTER cluster] [ENGINE = engine(...)] [SETTINGS ...] [COMMENT 'Comment']

​

البنود

​

IF NOT EXISTS

• لا يطرح استثناءً إذا كان هذا البند محددًا.
• يطرح استثناءً إذا لم يكن هذا البند محددًا.

​

ON CLUSTER

​

المحرك

​

تعليق

CREATE DATABASE db_name ENGINE = engine(...) COMMENT 'Comment'

CREATE DATABASE db_comment ENGINE = Memory COMMENT 'The temporary database';
SELECT name, comment FROM system.databases WHERE name = 'db_comment';

┌─name───────┬─comment────────────────┐
│ db_comment │ The temporary database │
└────────────┴────────────────────────┘

​

SETTINGS

​

disk

CREATE DATABASE db_name SETTINGS disk = 'db_disk';
CREATE DATABASE db_name SETTINGS disk = disk(type = 'local', path = '/var/lib/clickhouse-disks/db_disk');

​

lazy_load_tables

CREATE DATABASE db_name ENGINE = Atomic SETTINGS lazy_load_tables = 1;

• قبل الوصول إلى الجدول، يعرض system.tables محركه على أنه TableProxy. وبعد أول وصول، يعرض اسم المحرك الحقيقي (مثل MergeTree).
• تُرجِع الأعمدة مثل total_rows وtotal_bytes القيمة NULL للجداول غير المحمّلة، لأن التخزين الفعلي لم يُنشأ بعد.

• تؤدي عمليات SELECT وINSERT وALTER وDROP تلقائيًا إلى تحميل محرك الجدول الحقيقي عند أول استخدام.
• تعمل RENAME TABLE من دون التسبّب في التحميل.
• بعد تحميل الجدول، يظلّ محمّلًا طوال عمر عملية الخادم.

• قد تعرض أدوات المراقبة التي تعتمد على البيانات الوصفية في system.tables (مثل total_rows وengine) معلومات غير مكتملة للجداول غير المحمّلة.
• يترتّب على أول query إلى جدول غير محمّل كلفة تحميل تُدفَع مرة واحدة (تحليل تعليمة CREATE TABLE المخزّنة وتهيئة المحرك).