تحجيم MySQL ClickPipes عبر OpenAPI

قد تكون واجهة برمجة تطبيقات التحجيم مفيدة في الحالات التالية:

• أحمال أولية كبيرة (أكثر من 4 تيرابايت)
• ترحيل كمية متوسطة من البيانات بأسرع وقت ممكن
• دعم أكثر من 8 ClickPipes معتمدة على CDC ضمن الخدمة نفسها

قبل محاولة التوسيع، ضع في اعتبارك ما يلي:

• التأكد من أن قاعدة البيانات المصدر لديها سعة متاحة كافية
• ضبط توازي الحمل الأولي والتقسيم أولًا عند إنشاء ClickPipe
• التحقق من وجود معاملات طويلة التشغيل على المصدر قد تتسبب في تأخير CDC

ستؤدي زيادة مستوى التحجيم إلى زيادة تكاليف compute الخاصة بـ ClickPipes بشكل متناسب. إذا كنت تزيد التحجيم فقط من أجل الأحمال الأولية، فمن المهم خفضه بعد اكتمال اللقطة لتجنب الرسوم غير المتوقعة. لمزيد من التفاصيل حول التسعير، راجع تسعير ClickPipes.

قبل البدء، ستحتاج إلى:

1. مفتاح واجهة برمجة تطبيقات لـ ClickHouse مع أذونات Admin على خدمة ClickHouse Cloud المستهدفة.
2. أن يكون قد تم، في وقتٍ ما، توفير DB ClickPipe ‏(Postgres أو MySQL أو MongoDB) في الخدمة. تُنشأ البنية التحتية لـ CDC مع أول ClickPipe، وتصبح نقاط النهاية الخاصة بالتحجيم متاحة اعتبارًا من ذلك الوقت.

اضبط متغيرات البيئة التالية قبل تشغيل أي أوامر:

ORG_ID=<Your ClickHouse organization ID>
SERVICE_ID=<Your ClickHouse service ID>
KEY_ID=<Your ClickHouse key ID>
KEY_SECRET=<Your ClickHouse key secret>

استرجع تكوين التحجيم الحالي (اختياري):

curl --silent --user $KEY_ID:$KEY_SECRET \
https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/clickpipesCdcScaling \
| jq

# example result:
{
  "result": {
    "replicaCpuMillicores": 2000,
    "replicaMemoryGb": 8
  },
  "requestId": "04310d9e-1126-4c03-9b05-2aa884dbecb7",
  "status": 200
}

حدّد مستوى التحجيم المطلوب. تشمل التهيئات المدعومة من 1 إلى 24 نواة CPU، مع ضبط الذاكرة (GB) على 4× عدد الأنوية:

cat <<EOF | tee cdc_scaling.json
{
  "replicaCpuMillicores": 24000,
  "replicaMemoryGb": 96
}
EOF

curl --silent --user $KEY_ID:$KEY_SECRET \
-X PATCH -H "Content-Type: application/json" \
https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/clickpipesCdcScaling \
-d @cdc_scaling.json | jq

انتظر حتى تسري التهيئة (عادةً من 3 إلى 5 دقائق). بعد اكتمال التحجيم، ستُظهر نقطة نهاية GET القيم الجديدة:

curl --silent --user $KEY_ID:$KEY_SECRET \
https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/clickpipesCdcScaling \
| jq

# example result:
{
  "result": {
    "replicaCpuMillicores": 24000,
    "replicaMemoryGb": 96
  },
  "requestId": "5a76d642-d29f-45af-a857-8c4d4b947bf0",
  "status": 200
}