دليل إعداد AlloyDB Postgres كمصدر

لنقل البيانات من مثيل AlloyDB الخاص بك إلى ClickHouse Cloud باستخدام ClickPipes، يجب تهيئة مثيلك لاستخدام النسخ المتماثل المنطقي. وهذا مدعوم بدءًا من الإصدار 14 من AlloyDB.

للتحقق مما إذا كان النسخ المتماثل المنطقي مفعّلًا في مثيل AlloyDB، شغّل الاستعلام التالي على المثيل الأساسي:

SHOW  wal_level;

إذا كانت النتيجة logical، فهذا يعني أن النسخ المتماثل المنطقي مفعّل بالفعل، ويمكنك الانتقال إلى الخطوة التالية. أما إذا كانت النتيجة replica، فيجب ضبط العلامتين alloydb.enable_pglogical وalloydb.logical_decoding على on في المثيل الأساسي.

لتمكين هذه العلامات:

1. في Google Cloud Console، انتقل إلى صفحة Clusters الخاصة بـ AlloyDB. من قائمة Actions للمثيل الأساسي، انقر على Edit.

   

2. مرّر إلى أسفل حتى Advanced configuration options ثم وسّع هذا القسم. ضمن Flags، انقر على Add a database flag.

   • أضف العلامة allowdb.enable_pglogical واضبط قيمتها على on
   • أضف العلامة alloydb.logical_decoding واضبط قيمتها على on

   

3. انقر على Update instance لحفظ تغييرات التكوين. ومن المهم ملاحظة أن هذا الإجراء يؤدي إلى إعادة تشغيل المثيل الأساسي.

4. بعد أن تتغير حالة المثيل من Updating إلى Ready، شغّل الاستعلام التالي على المثيل الأساسي للتأكد من تفعيل النسخ المتماثل المنطقي:

   SHOW  wal_level;

   يجب أن تكون النتيجة logical.

   

اتصل بمثيل AlloyDB الخاص بك كمستخدم إداري ونفّذ الأوامر التالية:

1. أنشئ مستخدمًا مخصصًا لـ ClickPipes:

   CREATE USER clickpipes_user PASSWORD 'some-password';

2. امنح المستخدم الذي أنشأته في الخطوة السابقة وصولًا للقراءة فقط على مستوى المخطط. يوضح المثال التالي الأذونات الخاصة بالمخطط public. كرر هذه الأوامر لكل مخطط يحتوي على جداول تريد نسخها متماثلًا:

   GRANT USAGE ON SCHEMA "public" TO clickpipes_user;
   GRANT SELECT ON ALL TABLES IN SCHEMA "public" TO clickpipes_user;
   ALTER DEFAULT PRIVILEGES IN SCHEMA "public" GRANT SELECT ON TABLES TO clickpipes_user;

3. امنح المستخدم امتيازات النسخ المتماثل:

   ALTER USER clickpipes_user WITH REPLICATION;

4. أنشئ publication تتضمن الجداول التي تريد نسخها متماثلًا. نوصي بشدة بقصر الـ publication على الجداول التي تحتاجها فقط لتجنب الحمل الإضافي على الأداء.

• لإنشاء publication لجداول محددة:

  CREATE PUBLICATION clickpipes FOR TABLE table_to_replicate, table_to_replicate2;

  • لإنشاء publication لجميع الجداول ضمن مخطط محدد:

    CREATE PUBLICATION clickpipes FOR TABLES IN SCHEMA "public";

تحدّد publication ‏clickpipes مجموعة الجداول التي ستُبث أحداث التغيير الخاصة بها إلى ClickPipes. لا نوصي باستخدام FOR ALL TABLES إلا إذا كنت تنوي نسخ كل الجداول متماثلًا، لأن تضمين جداول غير ضرورية يزيد حركة WAL من Postgres إلى ClickPipes ويقلل الكفاءة العامة للنسخ المتماثل.

بعد ذلك، اختر كيفية اتصال ClickPipes بمثيل AlloyDB الخاص بك.

يمكنك الآن إنشاء ClickPipe الخاص بك وبدء إدخال البيانات من مثيل Postgres لديك إلى ClickHouse Cloud. احرص على تدوين تفاصيل الاتصال التي استخدمتها أثناء إعداد مثيل Postgres لديك، لأنك ستحتاج إليها خلال عملية إنشاء ClickPipe.