Skip to main content
يتيح محرك PostgreSQL تنفيذ استعلامات SELECT وINSERT على البيانات المخزنة على خادم PostgreSQL بعيد.
حاليًا، لا يدعم محرك الجدول PostgreSQL هذا إلا PostgreSQL بالإصدار 12 فما فوق.
اطّلع على خدمة Managed Postgres الخاصة بنا. فهي تعتمد على تخزين NVMe موجود فعليًا إلى جانب موارد الحوسبة، ما يوفّر أداءً أسرع حتى 10 مرات لأحمال العمل المقيّدة بأداء القرص مقارنةً بالبدائل التي تستخدم تخزينًا متصلًا بالشبكة مثل EBS، كما تتيح لك نسخ بيانات Postgres إلى ClickHouse باستخدام موصل Postgres CDC في ClickPipes.

إنشاء جدول

راجع وصفًا مفصلًا لاستعلام CREATE TABLE. يمكن أن تختلف بنية الجدول عن بنية جدول PostgreSQL الأصلي:
  • يجب أن تكون أسماء الأعمدة مطابقة لما هي عليه في جدول PostgreSQL الأصلي، ولكن يمكنك استخدام بعض هذه الأعمدة فقط وبأي ترتيب.
  • قد تختلف أنواع الأعمدة عن تلك الموجودة في جدول PostgreSQL الأصلي. يحاول ClickHouse cast القيم إلى أنواع بيانات ClickHouse.
  • يحدّد الإعداد external_table_functions_use_nulls كيفية التعامل مع الأعمدة Nullable. القيمة الافتراضية: 1. إذا كانت القيمة 0، فلن تُنشئ دالة الجدول أعمدة Nullable، وستُدرج القيم الافتراضية بدلًا من قيم NULL. وينطبق هذا أيضًا على قيم NULL داخل المصفوفات.
معلمات المحرك
  • host:port — عنوان خادم PostgreSQL.
  • database — اسم قاعدة البيانات البعيدة.
  • table — اسم الجدول البعيد، أو استعلام يُمرَّر إلى PostgreSQL كما هو (راجع تمرير استعلام بدلًا من اسم جدول).
  • user — مستخدم PostgreSQL.
  • password — كلمة مرور المستخدم.
  • schema — مخطط الجدول غير الافتراضي. اختياري.
  • on_conflict — استراتيجية حل التعارض. مثال: ON CONFLICT DO NOTHING. اختياري. ملاحظة: ستؤدي إضافة هذا الخيار إلى جعل الإدراج أقل كفاءة.
يُنصح باستخدام المجموعات المسماة (المتاحة منذ الإصدار 21.11) في بيئة الإنتاج. إليك مثالًا:
يمكن تجاوز بعض المعلمات باستخدام وسيطات المفتاح-القيمة:

الإعدادات

يمكن تهيئة مجمّع الاتصالات الذي يستخدمه محرك الجدول PostgreSQL (ودالة الجدول postgresql) لكل جدول على حدة باستخدام عبارة SETTINGS. وعند عدم تحديد إعداد معيّن، تُستخدم تلقائيًا قيمة إعداد postgresql_* المقابل على مستوى الاستعلام.

postgresql_connection_pool_size

حجم مجمّع الاتصالات (إذا كانت جميع الاتصالات قيد الاستخدام، ينتظر الاستعلام حتى يصبح أحد الاتصالات متاحًا). يجب أن تكون القيمة غير صفرية. القيمة الافتراضية: 16.

postgresql_connection_pool_wait_timeout

مهلة انتظار push/pop لمجمع الاتصالات، بالمللي ثانية، عندما يكون المجمع فارغًا. تعني القيمة 0 أنه يتم الحظر عند فراغ المجمع. القيمة الافتراضية: 5000.

postgresql_connection_pool_retries

عدد مرات إعادة المحاولة لعمليتَي push/pop في مجمع الاتصالات. القيمة الافتراضية: 2.

postgresql_connection_pool_auto_close_connection

أغلق الاتصال قبل إعادته إلى مجمّع الاتصالات. القيمة الافتراضية: false.

postgresql_connection_attempt_timeout

مهلة الاتصال، بالثواني، لمحاولة واحدة للاتصال بنقطة نهاية PostgreSQL. تُمرَّر القيمة كمعلمة connect_timeout في عنوان URL الخاص بالاتصال. القيمة الافتراضية: 2. مثال:

تفاصيل التنفيذ

تُنفَّذ استعلامات SELECT على جانب PostgreSQL بصيغة COPY (SELECT ...) TO STDOUT داخل معاملة PostgreSQL للقراءة فقط، مع تنفيذ commit بعد كل استعلام SELECT. تُنفَّذ عبارات WHERE البسيطة مثل =, !=, >, >=, <, <=, وIN على خادم PostgreSQL. تُنفَّذ جميع عمليات JOIN، وعمليات التجميع، والفرز، وشروط IN [ array ]، وقيد أخذ العينات الخاص بـ LIMIT في ClickHouse فقط بعد اكتمال الاستعلام إلى PostgreSQL.

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

بدلًا من اسم جدول، يمكن أن تكون الوسيطة table استعلام SELECT يُمرَّر إلى PostgreSQL كما هو. ويُستدل على بنية الجدول من نتيجة الاستعلام. ويمكن كتابة الاستعلام إما كاستعلام فرعي، أو تغليفه داخل الدالة query:
يُعد هذا مفيدًا لدفع تنفيذ عمليات JOIN وعمليات التجميع أو أي معالجة أخرى إلى PostgreSQL. هذا الجدول للقراءة فقط: لا يُسمح بتنفيذ INSERT فيه. وتدعم دالة الجدول postgresql الصياغة نفسها.
تُحلَّل صيغة الاستعلام الفرعي (SELECT ...) بواسطة ClickHouse، ثم يُعاد تسلسلها وفق لهجة PostgreSQL ‏(وضع علامات الاقتباس لمعرّفات PostgreSQL وإفلات القيم الحرفية النصية) قبل إرسالها إلى الخادم. لذلك يجب أن تكون صالحة في ClickHouse SQL. ولتمرير صياغة خاصة بـ PostgreSQL لا يحللها ClickHouse، استخدم صيغة query('...')، حيث يُرسل نصها إلى PostgreSQL كما هو.لا يتم دفع أي WHERE أو LIMIT خارجي أو aggregation أو غير ذلك من استعلام ClickHouse المحيط إلى الاستعلام المُمرَّر — بل يُطبَّق ذلك في ClickHouse بعد جلب نتيجة الاستعلام كاملةً. ولتقييد البيانات المقروءة من PostgreSQL، ضع شرط التصفية داخل الاستعلام المُمرَّر. عند استخدام external_table_strict_query = 1، يُرفَض أي شرط تصفية خارجي لا يمكن دفعه مع Exception بدلًا من تطبيقه محليًا.
تُنفَّذ استعلامات INSERT على جانب PostgreSQL بصيغة COPY \"table_name\" (field1, field2, ... fieldN) FROM STDIN داخل معاملة PostgreSQL مع auto-commit بعد كل تعليمة INSERT. تُحوَّل أنواع Array في PostgreSQL إلى مصفوفات في ClickHouse.
انتبه: في PostgreSQL، قد تحتوي بيانات المصفوفة المُنشأة على هيئة type_name[] على مصفوفات متعددة الأبعاد بأعداد مختلفة من الأبعاد في صفوف مختلفة من الجدول داخل العمود نفسه. لكن في ClickHouse، لا يُسمح إلا بمصفوفات متعددة الأبعاد لها العدد نفسه من الأبعاد في جميع صفوف الجدول داخل العمود نفسه.
يدعم عدة نسخ متماثلة يجب إدراجها باستخدام |. على سبيل المثال:
يتم دعم تحديد أولوية النسخ المتماثلة لمصدر قاموس PostgreSQL. وكلما زادت القيمة في map، انخفضت الأولوية. أعلى أولوية هي 0. في المثال أدناه، تتمتع النسخة المتماثلة example01-1 بأعلى أولوية:

مثال استخدام

جدول في PostgreSQL

إنشاء جدول في ClickHouse والاتصال بجدول PostgreSQL المُنشأ أعلاه

يستخدم هذا المثال محرك جدول PostgreSQL لربط جدول ClickHouse بجدول PostgreSQL واستخدام عبارتي SELECT وINSERT على قاعدة بيانات PostgreSQL:

إدراج البيانات الأولية من جدول PostgreSQL إلى جدول ClickHouse باستخدام استعلام SELECT

تقوم دالة الجدول postgresql بنسخ البيانات من PostgreSQL إلى ClickHouse، ويُستخدم ذلك غالبًا لتحسين أداء الاستعلامات على هذه البيانات عبر الاستعلام عنها أو إجراء التحليلات في ClickHouse بدلًا من PostgreSQL، كما يمكن استخدامه أيضًا لترحيل البيانات من PostgreSQL إلى ClickHouse. وبما أننا سننسخ البيانات من PostgreSQL إلى ClickHouse، فسنستخدم محرك جدول MergeTree في ClickHouse ونسميه postgresql_copy:

إدراج البيانات التزايدية من جدول PostgreSQL إلى جدول ClickHouse

إذا كنت ستُجري بعد الإدراج الأولي مزامنةً مستمرة بين جدول PostgreSQL وجدول ClickHouse، فيمكنك استخدام عبارة WHERE في ClickHouse لإدراج البيانات التي أُضيفت إلى PostgreSQL فقط استنادًا إلى طابع زمني أو معرّف تسلسلي فريد. ويتطلّب ذلك تتبّع الحد الأقصى للمعرّف أو الطابع الزمني الذي أُضيف سابقًا، كما في المثال التالي:
ثم إدراج القيم من جدول PostgreSQL التي تتجاوز الحد الأقصى

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

استخدام مخطط غير افتراضي

انظر أيضًا
آخر تعديل في ٢٣ يوليو ٢٠٢٦