مصدر قاموس 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`.
`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، تمامًا كما تُخفى كلمات المرور.

لا توجد معلمة صريحة باسم 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

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

المحركات

الدوال

التنسيقات

الواجهات

الإعدادات

جداول النظام

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