وجّه الطلبات ذات الصلة إلى النسخة المتماثلة نفسها في ClickHouse Cloud لاستخدام الجداول المؤقتة والجلسات وإعادة استخدام ذاكرة التخزين المؤقت واتساق القراءة بعد الكتابة
يوجّه التوجيه المراعي للنسخ المتماثلة، المعروف أيضًا باسم الجلسات اللاصقة أو التوجيه اللاصق أو تقارب الجلسة، الطلبات ذات الصلة إلى النسخة المتماثلة نفسها من ClickHouse. استخدمه عندما تحتاج إلى أن تظل الجداول المؤقتة أو حالة الجلسة المسمّاة متاحة عبر الاستعلامات، أو عندما تريد أن تعيد الاستعلامات ذات الصلة استخدام الذاكرات المؤقتة المحلية للنسخة المتماثلة نفسها، أو عندما تحتاج إلى اتساق القراءة بعد الكتابة بين عملية كتابة وعمليات القراءة التي تليها.هذه الميزة تعمل وفق أفضل جهد ولا تضمن العزل. يربط الوكيل كل قيمة توجيه بنسخة متماثلة واحدة. ويظل هذا الربط ثابتًا ما دام عدد النسخ المتماثلة دون تغيير؛ لكن تغيير سعة الخدمة قد يربط القيمة بنسخة متماثلة مختلفة.
يتطلب واجهة HTTPيُطبَّق التوجيه المراعي للنسخ المتماثلة في طبقة الوكيل عبر واجهة HTTP/HTTPS. ينتقل ClickHouse Cloud بالتوجيه المراعي للنسخ المتماثلة من session_id إلى الترويسة X-ClickHouse-Replica-Tag. تصف علامات التبويب أدناه الطريقتين خلال مرحلة الطرح.التوجيه المراعي للنسخ المتماثلة غير متاح حاليًا عبر البروتوكول الأصلي (المنفذ الأصلي، مثل برنامج التشغيل clickhouse-go في وضعه الأصلي الافتراضي). يجب على عملاء البروتوكول الأصلي التبديل إلى HTTP وإرسال قيمة التوجيه مع كل طلب.
افتح تذكرة دعم واطلب تمكين التوجيه اللاصق للنسخ المتماثلة المستند إلى HTTP. ضمّن معرّف الخدمة وسبب حاجتك إليه (الجداول المؤقتة، أو حالة الجلسة، أو إعادة استخدام ذاكرة التخزين المؤقت، أو اتساق القراءة بعد الكتابة). قبل ترحيل خدمة موجودة، اطلب من الدعم تأكيد تمكين التوجيه المستند إلى الترويسة لها. واصل استخدام session_id حتى تتلقى التأكيد؛ لن يوفر X-ClickHouse-Replica-Tag توجيهًا لاصقًا حتى يصل النشر التدريجي إلى خدمتك. لا يلزم إجراء أي إعادة تشغيل.
لتثبيت عبء عمل على نسخة متماثلة، أرسل ترويسة X-ClickHouse-Replica-Tag عبر واجهة HTTPS. يستخدم الوكيل التجزئة المتسقة لقيمة الترويسة، لذا تُوجَّه الطلبات التي تحمل القيمة نفسها إلى النسخة المتماثلة ذاتها ما دام عدد النسخ المتماثلة لم يتغير. وتُجزَّأ القيمة المختلفة بصورة مستقلة، وقد تُوجَّه إلى النسخة المتماثلة نفسها أو إلى نسخة أخرى، لكن لا يمكنك اختيار أيّ نسخة متماثلة تُعيَّن لها قيمة معيّنة.استخدم اسم مضيف الخدمة الحالي. لا تحتاج إلى أسماء مضيفين مثبتة خاصة أو إلى إجراء تغييرات على DNS. يمكن أن تكون قيمة الترويسة أي سلسلة تختارها، مثل اسم التطبيق أو معرّف المستخدم أو تسمية عبء العمل. وتستمر الطلبات التي لا تتضمن الترويسة في استخدام موازنة التحميل العادية.عيّن ترويسة X-ClickHouse-Replica-Tag في كل طلب:
بالنسبة إلى clickhouse-go (v2)، اضبط Protocol: clickhouse.HTTP ومرّر الترويسة عبر خيار الاتصال HttpHeaders.
توفّر X-ClickHouse-Replica-Tag ارتباطًا بنسخة متماثلة محددة دون إنشاء جلسة HTTP في ClickHouse. ويمكن للطلبات المتزامنة إعادة استخدام الوسم نفسه دون ظهور الخطأ SESSION_IS_LOCKED.
في خدمة تضم عدة نسخ متماثلة، قد لا تظهر الكتابة على إحدى النسخ في النسخ الأخرى إلى أن تلحق بها عملية النسخ المتماثل. أرسل عملية الكتابة مع ترويسة X-ClickHouse-Replica-Tag، ثم أعد استخدام قيمة الترويسة نفسها في عمليات القراءة اللاحقة. يوجّه الوكيل العمليتين إلى النسخة المتماثلة نفسها، لذا يمكنك قراءة البيانات التي كتبتها حتى عندما تكون النسخ المتماثلة الأخرى متأخرة. يناسب هذا النمط أعباء العمل التي تكتب البيانات ثم تقرؤها فورًا، مثل التطبيقات التفاعلية أو مهام ETL التي تتحقق من عمليات الإدراج قبل المتابعة.ولضمانات أوسع عبر جميع النسخ المتماثلة، يمكنك أيضًا ضبط select_sequential_consistency على 1 في ClickHouse Cloud.
شغّل مثال SELECT hostName() مرة أخرى باستخدام قيمة X-ClickHouse-Replica-Tag نفسها. ينبغي أن تحصل على اسم المضيف نفسه ما دام عدد النسخ المتماثلة لم يتغير. وقد تُعيَّن قيمة ترويسة مختلفة إلى نسخة متماثلة مختلفة.
يحلّ X-ClickHouse-Replica-Tag محل session_id في التوجيه المراعي للنسخ المتماثلة. واصل استخدام session_id إلى أن يؤكد فريق الدعم تفعيل التوجيه المستند إلى الرأس لخدمتك.
فشل الطلبات المتزامنة مع SESSION_IS_LOCKED
لأن session_id ينشئ جلسة HTTP في ClickHouse، لا يمكن تشغيل أكثر من استعلام واحد ضمن الجلسة نفسها في الوقت ذاته.
بعد تفعيل التوجيه المستند إلى الرأس لخدمتك، يمكن لأحمال العمل التي تحتاج فقط إلى الارتباط بنسخة متماثلة الانتقال إلى X-ClickHouse-Replica-Tag. ويمكن للطلبات المتزامنة مشاركة وسم النسخة المتماثلة نفسه.
إذا كنت تحتاج إلى حالة جلسة HTTP في ClickHouse، فنفّذ الطلبات التي تشترك في session_id بشكل متسلسل.
لتثبيت حمل عمل على نسخة متماثلة، أرسل مَعلمة الاستعلام session_id عبر واجهة HTTPS. يستخدم الوكيل التجزئة المتسقة لقيمة المَعلمة، لذا تُوجَّه الطلبات التي تشترك في القيمة نفسها إلى النسخة المتماثلة نفسها ما دام عدد النسخ المتماثلة لم يتغير. وتُجزَّأ القيمة المختلفة بشكل مستقل، وقد تصل إلى النسخة المتماثلة نفسها أو إلى نسخة أخرى، لكن لا يمكنك اختيار أي نسخة متماثلة تُعيَّن لها قيمة معينة.استخدم اسم مضيف خدمتك الحالي. لا حاجة إلى أسماء مضيفين مثبتة خاصة أو إلى تغييرات في DNS. يمكن أن يكون session_id أي سلسلة تختارها، مثل اسم تطبيق أو معرّف مستخدم أو تسمية حمل عمل. أما الطلبات التي لا تتضمن session_id فتستمر في استخدام موازنة التحميل العادية.عيّن مَعلمة الاستعلام session_id في كل طلب:
في خدمة تضم عدة نسخ متماثلة، قد لا تظهر عملية كتابة على إحدى النسخ في النسخ الأخرى إلى أن تلحق بها عملية النسخ المتماثل. أرسل عملية الكتابة مع session_id، ثم أعد استخدام session_id نفسه في عمليات القراءة اللاحقة. يوجّه الوكيل كليهما إلى النسخة المتماثلة نفسها، لذا يمكنك قراءة البيانات التي كتبتها حتى عندما تكون النسخ المتماثلة الأخرى متأخرة. يناسب هذا النمط أحمال العمل التي تكتب البيانات ثم تقرأها فورًا، مثل التطبيقات التفاعلية أو مهام ETL التي تتحقق من عمليات الإدراج قبل المتابعة.للحصول على ضمانات أوسع عبر جميع النسخ المتماثلة، يمكنك أيضًا ضبط select_sequential_consistency على 1 في ClickHouse Cloud.
تحقّق من النسخة المتماثلة التي تصل إليها باستخدام session_id
شغّل مثال SELECT hostName() مرة أخرى باستخدام session_id نفسه. يُفترض أن تحصل على اسم المضيف نفسه ما دام عدد النسخ المتماثلة لم يتغير. قد يُربط session_id مختلف بنسخة متماثلة مختلفة.
لم يعد التوجيه المستند إلى النطاق الفرعي مُمكّنًا في الخدمات الجديدة. إذا كنت تستخدم بالفعل نطاقات فرعية مثبتة، فتواصل مع Support للترحيل إلى طريقة رأس HTTP.
كيفية عمل التوجيه القديم المستند إلى النطاق الفرعي
سابقًا، كان تمكين التوجيه المراعي للنسخ المتماثلة يتيح استخدام نطاق فرعي عام (wildcard) فوق اسم مضيف الخدمة. بالنسبة إلى خدمة يكون اسم المضيف الخاص بها abcxyz123.us-west-2.aws.clickhouse.cloud، كان أي اسم مضيف يطابق *.sticky.abcxyz123.us-west-2.aws.clickhouse.cloud (مثل aaa.sticky.abcxyz123.us-west-2.aws.clickhouse.cloud) يُوجَّه بواسطة Envoy، باستخدام hash، إلى نسخة متماثلة ثابتة. أما اسم المضيف الأصلي فكان يستمر في استخدام موازنة التحميل LEAST_CONNECTION، وهي خوارزمية التوجيه الافتراضية.
يغيّر التوسع أو التقليص حلقة تجزئة التوجيه. وقد تُوجَّه الطلبات التي تشترك في قيمة التوجيه نفسها بعد ذلك إلى نسخة متماثلة مختلفة. إذا كنت تعتمد على الجداول المؤقتة أو الإعدادات على مستوى الجلسة، فكن مستعدًا لإعادة إنشائها بعد إعادة التوزيع.
التوجيه المراعي للنسخ المتماثلة ليس عزلًا لأعباء العمل
لا يحدد التوجيه اللاصق سوى أي نسخة متماثلة ستعالج الطلب. وقد تظل هذه النسخة المتماثلة تخدم حركة مرور أخرى. للحصول على موارد حوسبة مخصصة، استخدم فصل الحوسبة-الحوسبة.
يعمل التوجيه المستند إلى HTTP مع الشبكات الخاصة على اسم مضيف الخدمة العادي لديك. ولا تحتاج إلى أي سجلات DNS إضافية.أما طريقة النطاق الفرعي القديمة فلا تعمل: يجب عليك إضافة DNS لنمط اسم المضيف *.sticky.*، وقد يؤدي الإعداد غير الصحيح إلى عدم توازن الحمل بين النسخ المتماثلة.
يتطلب التوجيه المراعي للنسخ المتماثلة بروتوكول HTTP
يرتكز التوجيه اللاصق على ترويسة HTTP أو معلَمة استعلام، وفقاً لطريقة التوجيه المتاحة لخدمتك. لا يحمل البروتوكول الثنائي الأصلي أياً من القيمتين ليُجري وكيل HTTP hash عليها، لذا لا يتوفر التوجيه المراعي للنسخ المتماثلة عبر البروتوكول الأصلي. يجب على برامج العميل التي تستخدم البروتوكول الأصلي نقل عبء العمل المعني إلى واجهة HTTP لاستخدام هذه الميزة.
