ClickHouse

يُربط ClickHouse Cloud بمفتاح API منشأ في إعدادات مؤسستك. ينتمي مفتاح API إلى مؤسسة واحدة بالضبط، فيربط مفتاح واحد مؤسسة واحدة، وتُربط كل مؤسسة بمساحة عمل مرة واحدة. تُشفَّر المفاتيح قبل تخزينها، ولا يراها الوكيل أبداً.

1. افتح ClickHouse Cloud، وانتقل إلى API Keys في مؤسستك.
2. انقر New API key واختر دور Developer (للقراءة فقط): لا يقرأ Polylane إلا أثناء المزامنة.
3. انسخ كلاً من معرّف المفتاح وسرّ المفتاح؛ لا يُعرض السرّ إلا مرة واحدة.
4. الصق القيمتين في Polylane.
5. يتحقق Polylane من المفتاح ويبدأ المزامنة.

يكتشف Polylane خدماتك، بما في ذلك الحالة والفئة والمنطقة ومزود السحابة وإصدار ClickHouse وحجم النسخ المتماثلة ونقاط نهاية الاتصال. تُستخدم أسماء مضيفي الاتصال للربط عبر السحابات، فترتبط التطبيقات التي تصل إلى خدمة عبر متغير بيئة بها على الخريطة.

تفتح المراقبة مشكلة حين تبقى الخدمات متدهورة أو فاشلة أو متوقفة أو تعمل جزئياً؛ أما الخدمات الخاملة والمستيقظة فهي دورة حياة عادية للخدمات ذات التحجيم الخامل وتبقى سليمة. يبلّغ مستوى التحكم في ClickHouse Cloud عن المقاييس كلقطة حية بلا تاريخ، فيقرأ الوكلاء القيم الحالية عند الطلب ولا تحمل الخدمات رسوماً بيانية للمقاييس.

استكشاف الأخطاء

خطأ "Invalid API key"

• كلا معرّف المفتاح وسرّ المفتاح مطلوبان؛ ولا يستطيع أي منهما وحده المصادقة.
• تحقق من أن المفتاح لم يُحذف أو يُعطَّل في إعدادات مفاتيح API في ClickHouse Cloud.
• تتوقف المفاتيح ذات تاريخ الانتهاء عن العمل حين تنتهي صلاحيتها؛ أنشئ مفتاحاً جديداً ودوّره في Polylane.

موارد مفقودة

• قد يستغرق ClickHouse Cloud بضع دقائق لمزامنة كل شيء.
• أطلق Sync يدوياً من رأس الحساب للتحديث.

حدود المعدل

• يسمح ClickHouse Cloud بـ 10 طلبات API لكل 10 ثوانٍ لكل مفتاح. يتجنب مفتاح مخصص لـ Polylane مشاركة تلك الميزانية مع أدوات أخرى.

الفصل

افصل الحساب في Polylane، ثم احذف مفتاح API من إعدادات مؤسسة ClickHouse Cloud الخاصة بك.

لا يحتاج ربط ClickHouse Cloud إلى متصفح: نقطة النهاية نفسها التي تستدعيها وحدة التحكم تناسب مهمة CI. ينشئ طلب POST موثَّق واحد الاتصال ويبدأ المزامنة الأولى.

المتطلبات الأساسية

• مفتاح API من Polylane بنطاقَي cloud_accounts:write وcloud_accounts:read. انظر مفاتيح API وOAuth.
• معرّف مساحة عملك، الذي يبدأ بـ ws_. اقرأه من GET /v1/workspaces بالمفتاح نفسه.
• معرّف مفتاح API وسرّه من ClickHouse Cloud من API Keys في مؤسستك، منشأان بدور Developer (للقراءة فقط).

إنشاء الاتصال

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "clickhouse",
    "workspaceId": "ws_0abc123",
    "keyId": "<key-id>",
    "keySecret": "<key-secret>"
  }'

ينتمي مفتاح API إلى مؤسسة واحدة بالضبط، فيربط استدعاء واحد مؤسسة واحدة.

تسرد الاستجابة ما رُبط، مع المزامنة الأولى جارية أصلاً. مختصرة إلى الحقلين اللذين تقرؤهما بقية التدفق:

{
  "success": true,
  "result": {
    "provider": "clickhouse",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

يقع الحساب المربوط أصلاً في failures بدلاً من accounts، فلا يكرر تكرار الاستدعاء اتصالاً أبداً.

انتظار المزامنة الأولى

استطلع كل حساب مُعاد عبر id الخاص به حتى تصل status إلى ready (‏new عند التسجيل، وsyncing أثناء تدفق الموارد):

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

أعطِ الحلقة موعداً نهائياً ليُفشل الربط الفاشل المهمة بدلاً من تعليقها. وبعد أن يصبح الحساب ready، تكون موارده في Topology ويكون Polylane قد بدأ فحصه الأول.

الفصل من API

يوقف حذف الاتصال كل مزامنة وفحص ويحذف بيانات الاعتماد التي احتفظ بها Polylane. يحتاج الاستدعاء إلى نطاق cloud_accounts:delete:

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

ثم ألغِ بيانات اعتماد ClickHouse Cloud على جانب المزود، كما هو موضح تحت الفصل أدناه.