محرك جدول SQLite - ClickHouse Documentation

يتيح هذا المحرك استيراد البيانات إلى SQLite وتصديرها منه، كما يدعم الاستعلام عن جداول SQLite مباشرةً من ClickHouse.

إنشاء جدول

    CREATE TABLE [IF NOT EXISTS] [db.]table_name
    (
        name1 [type1],
        name2 [type2], ...
    ) ENGINE = SQLite('db_path', 'table')

معلمات المحرّك

db_path — مسار ملف SQLite الذي يحتوي على قاعدة البيانات.
table — اسم جدول في قاعدة بيانات SQLite، أو استعلام يُمرَّر إلى SQLite كما هو (انظر تمرير استعلام بدلًا من اسم جدول).

تمرير استعلام بدلًا من اسم جدول

بدلًا من اسم الجدول، يمكن أن تكون قيمة الوسيطة table استعلام SELECT يُمرَّر إلى SQLite كما هو. ويُستدل على بنية الجدول من نتيجة الاستعلام. ويمكن كتابة الاستعلام إما كاستعلام فرعي أو بتغليفه داخل الدالة query:

CREATE TABLE sqlite_table ENGINE = SQLite('sqlite.db', (SELECT col1, col2 FROM table1 WHERE col2 > 1));
CREATE TABLE sqlite_table ENGINE = SQLite('sqlite.db', query('SELECT col1, col2 FROM table1 WHERE col2 > 1'));

مثل هذا الجدول للقراءة فقط: لا يُسمح بتنفيذ INSERT فيه. وتدعم دالة الجدول sqlite الصياغة نفسها.

يُحلَّل شكل الاستعلام الفرعي (SELECT ...) بواسطة ClickHouse، ثم يُعاد تسلسله قبل إرساله إلى SQLite. لذلك يجب أن يكون صالحًا في ClickHouse SQL. ولتمرير صياغة خاصة بـ SQLite لا يحلّلها ClickHouse، استخدم صيغة query('...')، إذ يُرسَل نصها إلى SQLite كما هو.أي WHERE أو LIMIT أو aggregation أو غير ذلك من عناصر استعلام ClickHouse المحيط لا يُدفَع إلى داخل الاستعلام المُمرَّر — بل يُطبَّق في ClickHouse بعد جلب نتيجة الاستعلام كاملةً. ولتقييد البيانات المقروءة من SQLite، ضع filter داخل الاستعلام المُمرَّر. ومع external_table_strict_query = 1، يُرفَض أي filter خارجي لا يمكن دفعه إلى المصدر عبر exception بدلًا من تطبيقه محليًا.

دعم أنواع البيانات

عند تحديد أنواع أعمدة ClickHouse صراحةً في تعريف الجدول، يمكن تحليل أنواع ClickHouse التالية من أعمدة TEXT في SQLite:

Date, Date32
DateTime, DateTime64
UUID
Enum8, Enum16
Decimal32, Decimal64, Decimal128, Decimal256
FixedString
جميع أنواع الأعداد الصحيحة (UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64)
Float32, Float64

راجع محرك قاعدة بيانات SQLite للاطّلاع على مطابقة الأنواع الافتراضية.

مثال على الاستخدام

يعرض استعلامًا لإنشاء جدول SQLite:

SHOW CREATE TABLE sqlite_db.table2;

CREATE TABLE SQLite.table2
(
    `col1` Nullable(Int32),
    `col2` Nullable(String)
)
ENGINE = SQLite('sqlite.db','table2');

يُرجِع البيانات من الجدول:

SELECT * FROM sqlite_db.table2 ORDER BY col1;

┌─col1─┬─col2──┐
│    1 │ text1 │
│    2 │ text2 │
│    3 │ text3 │
└──────┴───────┘

راجع أيضًا

محرك SQLite
دالة الجدول sqlite

​إنشاء جدول

​تمرير استعلام بدلًا من اسم جدول

​دعم أنواع البيانات

​مثال على الاستخدام

إنشاء جدول

تمرير استعلام بدلًا من اسم جدول

دعم أنواع البيانات

مثال على الاستخدام