odbc

تعيد جدولًا متصلًا عبر ODBC.

تعيد جدولًا متصلًا عبر ODBC.

​

الصيغة

odbc(datasource, external_database, external_table)
odbc(datasource, external_table)
odbc(named_collection)

​

الوسائط

الوسيطة	الوصف
datasource	اسم القسم الذي يتضمن إعدادات الاتصال في ملف odbc.ini.
external_database	اسم قاعدة بيانات في نظام إدارة قواعد بيانات خارجي.
external_table	اسم جدول في external_database.

يمكن أيضًا تمرير هذه المعلمات باستخدام المجموعات المُسمّاة.

لتنفيذ اتصالات ODBC بأمان، يستخدم ClickHouse برنامجًا منفصلًا هو clickhouse-odbc-bridge. وإذا جرى تحميل برنامج تشغيل ODBC مباشرةً من clickhouse-server، فقد تتسبب مشكلات برنامج التشغيل في تعطل خادم ClickHouse. ويبدأ ClickHouse تلقائيًا تشغيل clickhouse-odbc-bridge عند الحاجة إليه. ويُثبَّت برنامج جسر ODBC من الحزمة نفسها التي يتضمنها clickhouse-server.

تُحوَّل الحقول ذات القيم NULL من الجدول الخارجي إلى القيم الافتراضية لنوع البيانات الأساسي. على سبيل المثال، إذا كان أحد الحقول في جدول MySQL بعيد من النوع INT NULL، فسيُحوَّل إلى 0 (وهي القيمة الافتراضية لنوع البيانات Int32 في ClickHouse).

​

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

الحصول على البيانات من تثبيت MySQL المحلي عبر ODBC

تم التحقق من هذا المثال على Ubuntu Linux 18.04 وMySQL server 5.7.

تأكد من تثبيت unixODBC وMySQL Connector.

افتراضيًا (إذا كان التثبيت من الحزم)، يبدأ ClickHouse العمل بالمستخدم clickhouse. لذلك تحتاج إلى إنشاء هذا المستخدم وتهيئته على خادم MySQL.

$ sudo mysql

mysql> CREATE USER 'clickhouse'@'localhost' IDENTIFIED BY 'clickhouse';
mysql> GRANT ALL PRIVILEGES ON *.* TO 'clickhouse'@'clickhouse' WITH GRANT OPTION;

ثم اضبط إعدادات الاتصال في /etc/odbc.ini.

$ cat /etc/odbc.ini
[mysqlconn]
DRIVER = /usr/local/lib/libmyodbc5w.so
SERVER = 127.0.0.1
PORT = 3306
DATABASE = test
USERNAME = clickhouse
PASSWORD = clickhouse

يمكنك التحقق من الاتصال باستخدام الأداة isql من حزمة تثبيت unixODBC.

$ isql -v mysqlconn
+-------------------------+
| Connected!                            |
|                                       |
...

الجدول في MySQL:

mysql> CREATE TABLE `test`.`test` (
    ->   `int_id` INT NOT NULL AUTO_INCREMENT,
    ->   `int_nullable` INT NULL DEFAULT NULL,
    ->   `float` FLOAT NOT NULL,
    ->   `float_nullable` FLOAT NULL DEFAULT NULL,
    ->   PRIMARY KEY (`int_id`));
Query OK, 0 rows affected (0,09 sec)

mysql> insert into test (`int_id`, `float`) VALUES (1,2);
Query OK, 1 row affected (0,00 sec)

mysql> select * from test;
+------+----------+-----+----------+
| int_id | int_nullable | float | float_nullable |
+------+----------+-----+----------+
|      1 |         NULL |     2 |           NULL |
+------+----------+-----+----------+
1 row in set (0,00 sec)

استرجاع البيانات من جدول MySQL داخل ClickHouse:

SELECT * FROM odbc('DSN=mysqlconn', 'test', 'test')

┌─int_id─┬─int_nullable─┬─float─┬─float_nullable─┐
│      1 │            0 │     2 │              0 │
└────────┴──────────────┴───────┴────────────────┘

​

راجع أيضًا

• قواميس ODBC
• محرك جدول ODBC.