مصدر قاموس MySQL

مثال على الإعدادات:

DDL
ملف التهيئة

SOURCE(MYSQL(
    port 3306
    user 'clickhouse'
    password 'qwerty'
    replica(host 'example01-1' priority 1)
    replica(host 'example01-2' priority 1)
    db 'db_name'
    table 'table_name'
    where 'id=10'
    invalidate_query 'SQL_QUERY'
    fail_on_connection_loss 'true'
    query 'SELECT id, value_1, value_2 FROM db_name.table_name'
    enable_compression 1
))

<source>
  <mysql>
      <port>3306</port>
      <user>clickhouse</user>
      <password>qwerty</password>
      <replica>
          <host>example01-1</host>
          <priority>1</priority>
      </replica>
      <replica>
          <host>example01-2</host>
          <priority>1</priority>
      </replica>
      <db>db_name</db>
      <table>table_name</table>
      <where>id=10</where>
      <invalidate_query>SQL_QUERY</invalidate_query>
      <fail_on_connection_loss>true</fail_on_connection_loss>
      <query>SELECT id, value_1, value_2 FROM db_name.table_name</query>
      <enable_compression>1</enable_compression>
  </mysql>
</source>

حقول الإعداد:

الإعداد	الوصف
`port`	المنفذ على خادم MySQL. يمكنك تحديده لجميع النسخ المتماثلة، أو لكل نسخة على حدة (داخل `<replica>`).
`user`	اسم مستخدم MySQL. يمكنك تحديده لجميع النسخ المتماثلة، أو لكل نسخة على حدة (داخل `<replica>`).
`password`	كلمة مرور مستخدم MySQL. يمكنك تحديدها لجميع النسخ المتماثلة، أو لكل نسخة على حدة (داخل `<replica>`).
`replica`	قسم إعدادات النسخة المتماثلة. يمكن أن يوجد أكثر من قسم واحد.
`replica/host`	مضيف MySQL.
`replica/priority`	أولوية النسخة المتماثلة. عند محاولة الاتصال، يمر ClickHouse على النسخ المتماثلة وفق ترتيب الأولوية. وكلما كان الرقم أصغر، كانت الأولوية أعلى.
`db`	اسم قاعدة البيانات.
`table`	اسم الجدول.
`where`	معايير التحديد. صياغة الشروط هي نفسها المستخدمة في عبارة `WHERE` في MySQL، على سبيل المثال: `id > 10 AND id < 20`. اختياري.
`invalidate_query`	استعلام للتحقق من حالة القاموس. اختياري. اقرأ المزيد في قسم Refreshing dictionary data using LIFETIME.
`fail_on_connection_loss`	يتحكم في سلوك الخادم عند فقدان الاتصال. إذا كانت القيمة `true`، فسيُطرَح استثناء فورًا عند فقدان الاتصال بين العميل والخادم. وإذا كانت `false`، فسيعيد الخادم محاولة جلب البيانات ثلاث مرات على الأقل قبل الإبلاغ عن خطأ. لاحظ أن إعادة المحاولة تؤدي إلى زيادة زمن الاستجابة. القيمة الافتراضية: `false`.
`query`	الاستعلام المخصص. اختياري.
`enable_compression`	يفعّل ضغط zlib لاتصال بروتوكول MySQL. عند ضبطه على `1`، يطلب ClickHouse ضغطًا على مستوى البروتوكول من خادم MySQL. ويمكن أيضًا ضبطه لكل نسخة متماثلة داخل `<replica>`. القيمة الافتراضية: `0`.
`enable_local_infile`	يسمح لخادم MySQL بأن يطلب من ClickHouse محتويات ملف محلي (`LOAD DATA LOCAL INFILE`). لا يمكن تفعيله إلا لقاموس معرّف في ملف تهيئة الخادم؛ أما استعلام `CREATE DICTIONARY` فيمكن أن يتركه غير مضبوط أو يضبطه على `0`. ويمكن أيضًا ضبطه لكل نسخة متماثلة داخل `<replica>`، وأي `<replica>` لا تضبطه ترث القيمة المحددة أعلاه. القيمة الافتراضية: `0`.
`ssl_ca_pem`	محتويات شهادة CA التي يتم التحقق من شهادة خادم MySQL بمقارنتها بها. اختياري.
`ssl_cert_pem`	محتويات شهادة العميل، للمصادقة المستندة إلى الشهادات. اختياري.
`ssl_key_pem`	محتويات المفتاح الخاص المرتبط بـ `ssl_cert_pem`. اختياري.
`ssl_ca`, `ssl_cert`, `ssl_key`	بيانات الاعتماد نفسها على هيئة مسارات إلى ملفات على الخادم. يُسمح بها فقط لقاموس معرّف في ملف تهيئة الخادم، أو من خلال مجموعة مسماة معرّفة فيه، انظر أدناه. اختياري.

لا يمكن استخدام الحقلين table أو where مع الحقل query في الوقت نفسه. ويجب التصريح بأحد الحقلين table أو query.

تشير ssl_ca وssl_cert وssl_key إلى ملفات يفتحها الخادم بامتيازاته الخاصة، ولذلك لا تُقبل إلا لقاموس معرّف في ملف تهيئة الخادم، أو من خلال مجموعة مسماة معرّفة فيه. أما استعلام CREATE DICTIONARY الذي يحدد بيانات اعتماد TLS مباشرةً، فيجب أن يمرّر محتوياتها بدلًا من ذلك في ssl_ca_pem وssl_cert_pem وssl_key_pem. وتُخفى هذه القيم في السجلات وفي استعلامات SHOW، كما يحدث مع كلمات المرور.

يتيح enable_local_infile لخادم MySQL أن يطلب من ClickHouse محتويات ملف من اختياره، يقرأه الخادم بامتيازاته الخاصة، ولذلك لا يُقبل إلا لقاموس معرّف في ملف تهيئة الخادم. وأي استعلام CREATE DICTIONARY يفعّله، سواء في المصدر أو في أحد مدخلات <replica> التابعة له، يُرفض بالخطأ BAD_ARGUMENTS.

لا يوجد معامل صريح secure. فعند إنشاء اتصال SSL يكون الأمان إلزاميًا.

يمكن الاتصال بـ MySQL على مضيف محلي عبر المقابس. للقيام بذلك، اضبط host وsocket. مثال على الإعدادات:

DDL
ملف التهيئة

SOURCE(MYSQL(
    host 'localhost'
    socket '/path/to/socket/file.sock'
    user 'clickhouse'
    password 'qwerty'
    db 'db_name'
    table 'table_name'
    where 'id=10'
    invalidate_query 'SQL_QUERY'
    fail_on_connection_loss 'true'
    query 'SELECT id, value_1, value_2 FROM db_name.table_name'
))

<source>
  <mysql>
      <host>localhost</host>
      <socket>/path/to/socket/file.sock</socket>
      <user>clickhouse</user>
      <password>qwerty</password>
      <db>db_name</db>
      <table>table_name</table>
      <where>id=10</where>
      <invalidate_query>SQL_QUERY</invalidate_query>
      <fail_on_connection_loss>true</fail_on_connection_loss>
      <query>SELECT id, value_1, value_2 FROM db_name.table_name</query>
  </mysql>
</source>

مرجع SQL

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

المحركات

الدوال

الصيغ

الإعدادات

جداول النظام

بحيرات البيانات