Turso

Turso เชื่อมต่อด้วย platform API token:

1. เปิด Turso ไปที่หน้า API Tokens ในการตั้งค่าบัญชีของคุณ หรือรัน turso auth api-tokens mint polylane จาก CLI
2. คัดลอก platform API token
3. วางโทเค็นใน Polylane หากโทเค็นเข้าถึงได้มากกว่าหนึ่งองค์กร ให้เลือกองค์กรที่จะเชื่อมต่อเมื่อถูกถาม
4. Polylane ตรวจสอบโทเค็นและเริ่มซิงก์

แต่ละการเชื่อมต่อครอบคลุมองค์กร Turso เดียว Polylane ค้นหากลุ่มฐานข้อมูลและฐานข้อมูลของมัน รวมถึงตำแหน่ง การจัดวาง ความเป็นแม่ลูกของ branch และสถานะอ่าน/เขียน โทเค็นถูกเข้ารหัสก่อนจัดเก็บ และเอเจนต์ไม่มีทางเห็นมัน Polylane อ่าน Platform API เท่านั้น มันไม่มีทางเชื่อมต่อกับฐานข้อมูลของคุณและไม่มีทางถือข้อมูลรับรองของฐานข้อมูล

Platform API ของ Turso รายงานการใช้งานเป็นตัวนับสะสมต่อรอบบิลแทน time series ฐานข้อมูลจึงไม่มีแผนภูมิเมตริก การมอนิเตอร์ poll ตัวนับเหล่านั้นและดูส่วนต่างแทน: ปริมาณอ่านและเขียน ทราฟฟิกซิงก์ การเติบโตของพื้นที่จัดเก็บ จำนวนฐานข้อมูล การใช้โควตาเทียบกับแผนของคุณ และคิวรีที่หนักที่สุดต่อฐานข้อมูล แต่ละอย่างถูกตรวจสอบเทียบกับประวัติของบัญชีเอง

การแก้ปัญหา

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

• platform API token ต่างจาก auth token ของฐานข้อมูล สร้างด้วย turso auth api-tokens mint หรือจากการตั้งค่าบัญชีของคุณ
• ตรวจว่าโทเค็นไม่ได้ถูกเพิกถอนในการตั้งค่าของ Turso

ข้อผิดพลาด "Multiple Turso organizations are reachable"

• โทเค็นเข้าถึงได้มากกว่าหนึ่งองค์กร จึงต้องระบุชื่อองค์กรที่จะเชื่อมต่อ
• เมื่อเชื่อมต่อในคอนโซล ให้เลือกองค์กรเมื่อถูกถามหลังการตรวจสอบ
• เมื่อเชื่อมต่อผ่าน API ให้ตั้งฟิลด์ organization เป็น slug ขององค์กร

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

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

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

ยกเลิกการเชื่อมต่อบัญชีใน Polylane แล้วเพิกถอนโทเค็น API จากการตั้งค่าบัญชี Turso ของคุณหรือด้วย turso auth api-tokens revoke

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

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

• คีย์ API ของ Polylane ที่มีสโคป cloud_accounts:write และ cloud_accounts:read ดูคีย์ API และ OAuth
• ID ของ workspace ของคุณ ซึ่งเริ่มด้วย ws_ อ่านจาก GET /v1/workspaces ด้วยคีย์เดียวกัน
• platform API token ของ Turso สร้างจากการตั้งค่าบัญชีของคุณหรือด้วย turso auth api-tokens mint polylane

สร้างการเชื่อมต่อ

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "turso",
    "workspaceId": "ws_0abc123",
    "token": "<platform-api-token>",
    "organization": "my-org-slug"
  }'

การเรียกครั้งเดียวเชื่อมต่อองค์กร Turso เดียว

• organization ละได้เฉพาะเมื่อโทเค็นเข้าถึงองค์กรเดียวพอดี ไม่เช่นนั้นการเรียกล้มเหลวด้วย 400 ที่แสดงรายการ slug ขององค์กรที่เข้าถึงได้

การตอบกลับแสดงรายการสิ่งที่เชื่อมต่อแล้ว พร้อมการซิงก์ครั้งแรกที่รันอยู่ ตัดให้เหลือสองฟิลด์ที่ขั้นตอนที่เหลืออ่าน:

{
  "success": true,
  "result": {
    "provider": "turso",
    "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"

จากนั้นเพิกถอนข้อมูลรับรอง Turso ฝั่งผู้ให้บริการ ตามที่อธิบายใต้ Disconnect ด้านล่าง