Supabase

Supabase เชื่อมต่อผ่าน OAuth: คลิก Connect with Supabase อนุญาตสิทธิ์อ่านบน Supabase โดยเลือกองค์กรที่จะเชื่อมต่อ แล้วคุณจะถูก redirect กลับมาพร้อมการซิงก์ที่เริ่มแล้ว โทเค็นถูกเข้ารหัสก่อนจัดเก็บ และเอเจนต์ไม่มีทางเห็นมัน

ทางเลือกใช้ personal access token

หากคุณต้องการข้อมูลรับรองอายุยาว ให้เชื่อมต่อด้วย personal access token แทน:

1. เปิด Supabase ไปที่ Account → Access Tokens
2. คลิก Generate new token และคัดลอกโทเค็น (เริ่มด้วย sbp_)
3. วางโทเค็นใน Polylane หากบัญชีของคุณเข้าถึงได้มากกว่าหนึ่งองค์กร ให้ระบุ slug ขององค์กรที่จะเชื่อมต่อด้วย
4. Polylane ตรวจสอบโทเค็นและเริ่มซิงก์

แต่ละการเชื่อมต่อครอบคลุมองค์กร Supabase เดียว Polylane ค้นหาโปรเจกต์ของมันพร้อม edge function, branch ของฐานข้อมูล และ storage bucket รวมถึงสถานะ region และขนาด compute

การแก้ปัญหา

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

• ตรวจว่าโทเค็นไม่ได้ถูกเพิกถอนในการตั้งค่าบัญชีของ Supabase
• personal access token ทำงานด้วยสิทธิ์ของบัญชีคุณ ตรวจสอบว่าบัญชีของคุณเข้าถึงองค์กรได้

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

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

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

• Supabase อาจใช้เวลาสองสามนาทีในการซิงก์ทุกอย่าง
• โปรเจกต์ที่หยุดชั่วคราว (ไม่ใช้งาน) ถูกแสดงในรายการ แต่ edge function, branch และ bucket ของมันซิงก์เฉพาะขณะโปรเจกต์ใช้งานอยู่
• สั่ง Sync ด้วยตัวเองจากส่วนหัวของบัญชีเพื่อรีเฟรช

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

ยกเลิกการเชื่อมต่อบัญชีใน Polylane แล้วเพิกถอน access token จากการตั้งค่าบัญชี Supabase ของคุณ

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

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

• คีย์ API ของ Polylane ที่มีสโคป cloud_accounts:write และ cloud_accounts:read ดูคีย์ API และ OAuth
• ID ของ workspace ของคุณ ซึ่งเริ่มด้วย ws_ อ่านจาก GET /v1/workspaces ด้วยคีย์เดียวกัน
• personal access token ของ Supabase (เริ่มด้วย sbp_) จาก Account → Access Tokens ขั้นตอน OAuth ของคอนโซลต้องใช้เบราว์เซอร์ access token ไม่ต้อง

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

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

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

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

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

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

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