ClickHouse

ClickHouse Cloud เชื่อมต่อด้วยคีย์ API ที่สร้างในการตั้งค่าองค์กรของคุณ คีย์ API เป็นขององค์กรเดียวพอดี หนึ่งคีย์จึงเชื่อมต่อหนึ่งองค์กร และแต่ละองค์กรเชื่อมต่อกับ workspace ได้ครั้งเดียว คีย์ถูกเข้ารหัสก่อนจัดเก็บ และเอเจนต์ไม่มีทางเห็นมัน

1. เปิด ClickHouse Cloud ไปที่ API Keys ขององค์กรของคุณ
2. คลิก New API key และเลือกบทบาท Developer (อ่านอย่างเดียว): Polylane อ่านระหว่างซิงก์เท่านั้น
3. คัดลอกทั้ง key ID และ key secret secret แสดงครั้งเดียวเท่านั้น
4. วางทั้งสองค่าใน Polylane
5. Polylane ตรวจสอบคีย์และเริ่มซิงก์

Polylane ค้นหาเซอร์วิสของคุณ รวมถึงสถานะ tier, region ผู้ให้บริการคลาวด์ เวอร์ชัน ClickHouse ขนาด replica และ endpoint การเชื่อมต่อ hostname ของการเชื่อมต่อใช้สำหรับการเชื่อมโยงข้ามคลาวด์ แอปพลิเคชันที่เข้าถึงเซอร์วิสผ่านตัวแปรสภาพแวดล้อมจึงเชื่อมโยงกับมันบนแผนที่

การมอนิเตอร์เปิด issue เมื่อเซอร์วิสอยู่ในสถานะ degraded, failed, stopped หรือ partially running เซอร์วิสที่ idle และ waking เป็นวงจรชีวิตปกติของเซอร์วิสที่ปรับขนาดตามการใช้งานและยังคงปกติ control plane ของ ClickHouse Cloud รายงานเมตริกเป็น snapshot ณ ขณะนั้นโดยไม่มีประวัติ เอเจนต์จึงอ่านค่าปัจจุบันเมื่อต้องการและเซอร์วิสไม่มีแผนภูมิเมตริก

การแก้ปัญหา

ข้อผิดพลาด "Invalid API key"

• ต้องมีทั้ง key ID และ key secret อย่างใดอย่างหนึ่งเพียงลำพังยืนยันตัวตนไม่ได้
• ตรวจว่าคีย์ไม่ได้ถูกลบหรือปิดใช้งานในการตั้งค่าคีย์ API ของ ClickHouse Cloud
• คีย์ที่มีวันหมดอายุหยุดทำงานเมื่อหมดอายุ สร้างคีย์ใหม่และหมุนเวียนมันใน Polylane

ทรัพยากรหายไป

• ClickHouse Cloud อาจใช้เวลาสองสามนาทีในการซิงก์ทุกอย่าง
• สั่ง Sync ด้วยตัวเองจากส่วนหัวของบัญชีเพื่อรีเฟรช

ขีดจำกัดอัตรา

• ClickHouse Cloud อนุญาต 10 คำขอ API ต่อ 10 วินาทีต่อคีย์ คีย์เฉพาะสำหรับ Polylane หลีกเลี่ยงการแบ่งงบนั้นกับเครื่องมืออื่น

การยกเลิกการเชื่อมต่อ

ยกเลิกการเชื่อมต่อบัญชีใน Polylane แล้วลบคีย์ API จากการตั้งค่าองค์กร ClickHouse Cloud ของคุณ

การเชื่อมต่อ ClickHouse Cloud ไม่ต้องใช้เบราว์เซอร์: endpoint เดียวกับที่คอนโซลเรียกอยู่ในงาน CI ได้ POST ที่ยืนยันตัวตนแล้วครั้งเดียวสร้างการเชื่อมต่อและเริ่มการซิงก์ครั้งแรก

สิ่งที่ต้องมีก่อน

• คีย์ API ของ Polylane ที่มีสโคป cloud_accounts:write และ cloud_accounts:read ดูคีย์ API และ OAuth
• ID ของ workspace ของคุณ ซึ่งเริ่มด้วย ws_ อ่านจาก GET /v1/workspaces ด้วยคีย์เดียวกัน
• API key ID และ secret ของ 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 การเรียกซ้ำจึงไม่มีทางทำให้การเชื่อมต่อซ้ำ

รอการซิงก์ครั้งแรก

poll แต่ละบัญชีที่คืนมาด้วย 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

ให้ loop มีเส้นตายเพื่อให้การเชื่อมต่อที่ล้มเหลวทำให้งานล้มเหลวแทนที่จะค้าง เมื่อบัญชี ready แล้ว ทรัพยากรของมันอยู่ในโทโพโลยีและ 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 ฝั่งผู้ให้บริการ ตามที่อธิบายใต้ Disconnect ด้านล่าง