เชื่อมต่อ Supabase

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

การเชื่อมต่อทำงานอย่างไร

แต่ละโปรเจกต์ Supabase เป็นของ องค์กร, ซึ่งควบคุมว่าใครสามารถเข้าถึงและจัดการโปรเจกต์ภายในองค์กรนั้นได้ เมื่อคุณเชื่อมต่อ Supabase กับ Atoms คุณจะต้องอนุญาตให้ Atoms เข้าถึงองค์กรที่คุณต้องการใช้ก่อน จากนั้นจึงเลือกโปรเจกต์จากองค์กรนั้นเพื่อเชื่อมต่อ

แต่ละโปรเจกต์ Atoms สามารถเชื่อมต่อกับ โปรเจกต์ Supabase ได้ครั้งละหนึ่งโปรเจกต์. อย่างไรก็ตาม โปรเจกต์ Supabase เดียวกันสามารถเชื่อมต่อกับโปรเจกต์ Atoms ได้มากกว่าหนึ่งโปรเจกต์

Supabase และ Atoms Cloud เป็นตัวเลือกแบ็กเอนด์ทางเลือกแทนกัน คุณไม่สามารถเชื่อมต่อทั้งสองอย่างกับโปรเจกต์ Atoms เดียวกันพร้อมกันได้

ก่อนเริ่มต้น

ก่อนเชื่อมต่อ Supabase โปรดตรวจสอบให้แน่ใจว่า:

• คุณเป็น เจ้าของ workspace ของ Atoms ที่มีโปรเจกต์นี้อยู่ มีเพียงเจ้าของ workspace เท่านั้นที่สามารถอนุญาต เชื่อมต่อ หรือยกเลิกการเชื่อมต่อ Supabase ได้
• คุณมีบัญชี Supabase หรือพร้อมที่จะสร้างบัญชีระหว่างการตั้งค่า
• คุณมีสิทธิ์ในการอนุญาตองค์กร Supabase และเข้าถึงโปรเจกต์ที่คุณต้องการเชื่อมต่อด้วย
• ตัว Agent ได้ทำงานปัจจุบันเสร็จสิ้นแล้ว และ Race Mode ถูกปิดอยู่
• เบราว์เซอร์ของคุณอนุญาตหน้าต่างป๊อปอัปจาก Atoms
• โปรเจกต์ Atoms ของคุณ ยังไม่ได้เชื่อมต่อกับ Atoms Cloud อยู่แล้ว.

หากคุณกำลังลองเชื่อมต่อนี้เป็นครั้งแรก ให้พิจารณาใช้โปรเจกต์ทดสอบขณะเรียนรู้ขั้นตอน

อย่าวางรหัสผ่าน คีย์ API โทเค็นการเข้าถึง หรือข้อมูลรับรองอื่นใดของ Supabase ลงใน Chat โดยเด็ดขาด

เชื่อมต่อ Supabase

เปิดตัวเชื่อมต่อ Supabase

1. เปิดโปรเจกต์ที่คุณต้องการเชื่อมต่อ
2. คลิกชื่อโปรเจกต์ที่มุมขวาบนของแผงแชต
3. เลือก Connectors ในเมนูดรอปดาวน์ที่ปรากฏขึ้น
4. ค้นหา Supabase ในรายการตัวเชื่อมต่อที่พร้อมใช้งาน แล้วคลิก เชื่อมต่อ.

คุณยังสามารถเปิด Settings → Connectors → Supabase แล้วเลือก Connect.

เปิด Settings → Connectors แล้วเลือก Connect สำหรับ Supabase

อนุญาต Atoms ใน Supabase

หาก Organizations แสดงองค์กร Supabase ที่คุณต้องการใช้อยู่แล้ว แสดงว่าได้อนุญาตไว้แล้ว คุณสามารถไปต่อที่ เลือกโปรเจกต์ Supabase.

1. Atoms จะเปิดหน้าต่างอนุญาตของ Supabase ลงชื่อเข้าใช้บัญชี Supabase ที่คุณต้องการเชื่อมต่อ หรือสร้างบัญชีใหม่หากจำเป็น
2. ตรวจสอบว่าคุณลงชื่อเข้าใช้บัญชี Supabase ที่ถูกต้องแล้ว จากนั้นเลือกองค์กรที่คุณต้องการให้ Atoms เข้าถึง
3. ตรวจสอบสิทธิ์ที่ Atoms ขอ หากต้องการดูสิทธิ์ทั้งหมด ให้เลือก Show detailed permissions. หากคุณยอมรับ ให้เลือก Authorize Atoms.
4. กลับไปที่ Atoms และรอข้อความ Connect success .
5. ใน Atoms ให้เปิด Connectors → Supabase และยืนยันว่าองค์กรปรากฏอยู่ใต้ Organizations.

Atoms ขอสิทธิ์อ่านและเขียนสำหรับ Database, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST และ Storage. นอกจากนี้ยังขอสิทธิ์อ่านสำหรับ Organizations และ Domains. สิทธิ์เหล่านี้ช่วยให้ Atoms สามารถเชื่อมต่อและจัดการบริการ Supabase ที่รองรับซึ่งโปรเจกต์ของคุณใช้งานอยู่

การอนุญาตนี้ใช้กับองค์กร Supabase ที่เลือก และไม่ได้จำกัดเฉพาะโปรเจกต์ Supabase ที่คุณเชื่อมต่อกับโปรเจกต์ Atoms ปัจจุบันในภายหลัง Atoms ไม่สามารถเข้าถึงองค์กรหรือโปรเจกต์ที่บัญชี Supabase ที่เชื่อมต่อเองไม่สามารถเข้าถึงได้ และสิทธิ์ของ Supabase อาจมีข้อจำกัดเพิ่มเติม

ตรวจสอบองค์กรและสิทธิ์ก่อนอนุญาต Atoms

เลือกโปรเจกต์ Supabase

1. ภายใต้ Organizations, ขยายองค์กรที่คุณได้อนุญาตไว้
2. ภายใต้ Projects, ค้นหาโปรเจกต์ Supabase ที่ใช้งานอยู่ซึ่งคุณต้องการเชื่อมต่อ
3. หากองค์กรที่คุณต้องการไม่อยู่ในรายการ ให้เลือก New Organization แล้วอนุญาตองค์กรนั้น การดำเนินการนี้ไม่ได้สร้างองค์กร Supabase ใหม่ แต่ช่วยให้คุณอนุญาตอีกองค์กรหนึ่งที่มีอยู่แล้วในบัญชี Supabase ของคุณ
4. หากคุณยังไม่มีโปรเจกต์ ให้เลือก Create Project แล้วสร้างหนึ่งโปรเจกต์ใน Supabase รอจนกว่าโปรเจกต์จะเปิดใช้งานและพร้อมใช้งาน จากนั้นกลับไปที่ Atoms แล้วเลือก Update เพื่อรีเฟรชรายการโปรเจกต์
5. ถัดจากโปรเจกต์ที่คุณต้องการใช้ ให้เลือก Connect.

เลือกโปรเจกต์ Supabase จากองค์กรที่ได้รับอนุญาต

ยืนยันโปรเจกต์

1. ในหน้าต่างยืนยัน ให้ตรวจสอบองค์กรและโปรเจกต์ที่แสดงอยู่ใต้ Supabase Project.
2. หากจำเป็น ให้ใช้ Supabase Dashboard หรือ View Tables เพื่อยืนยันว่าคุณได้เลือกโปรเจกต์ที่ถูกต้อง
3. เลือก Connect.
4. Atoms จะเพิ่มรายการการเชื่อมต่อ Supabase ไปยัง Chat ของโปรเจกต์ เปิดหน้านี้ทิ้งไว้และรอให้เสร็จสิ้นก่อนขอให้ Agent สร้างฐานข้อมูล การยืนยันตัวตน ที่เก็บข้อมูล หรือฟีเจอร์แบ็กเอนด์

ยืนยันโปรเจกต์ Supabase ที่เลือกก่อนเชื่อมต่อ

ตรวจสอบว่าการเชื่อมต่อทำงานแล้ว

1. เปิด Settings → Connectors → Supabase.
2. ยืนยันว่าองค์กรและโปรเจกต์ Supabase ที่ถูกต้องแสดงว่าเชื่อมต่ออยู่
3. เลือก Dashboard หรือ Tables และตรวจสอบว่าเปิดโปรเจกต์เดียวกันใน Supabase

แผงโปรเจกต์ที่เชื่อมต่ออาจมีลิงก์ไปยัง Manage Users, SQL Editor, Edge Functions, และ Manage Secrets. คุณจำเป็นต้องใช้เฉพาะส่วนที่เกี่ยวข้องกับฟีเจอร์ที่คุณกำลังสร้างเท่านั้น

ตรวจสอบโปรเจกต์ Supabase ที่เชื่อมต่อและลิงก์การจัดการของมัน

ทดสอบว่าแอปของคุณสามารถบันทึกข้อมูลได้

การเชื่อมต่อ Supabase ไม่ได้เพิ่มฟีเจอร์ฐานข้อมูลให้แอปของคุณโดยอัตโนมัติ ใน Chat, ขอให้ Agent สร้างฟีเจอร์ที่คุณต้องการและใช้โปรเจกต์ Supabase ที่เชื่อมต่ออยู่เพื่อจัดเก็บข้อมูล หลังจาก Agent ทำเสร็จแล้ว ให้ทดสอบขั้นตอนทั้งหมด

1. ใน Chat, อธิบายฟีเจอร์ที่คุณต้องการ ข้อมูลที่ควรบันทึก และตำแหน่งที่ผู้ใช้ควรเห็นข้อมูลนั้นอีกครั้ง บอก Agent ให้ใช้โปรเจกต์ Supabase ที่เชื่อมต่ออยู่
2. รอให้ Agent สร้างฟีเจอร์เสร็จสิ้น
3. ใน App Viewer, ใช้ฟีเจอร์เหมือนที่ผู้ใช้จะใช้ และป้อนข้อมูลทดสอบที่ไม่เป็นอันตราย อย่าใช้ข้อมูลส่วนบุคคล ข้อมูลลับ หรือข้อมูลอ่อนไหว
4. รีเฟรช App Viewer หรือเปิดฟีเจอร์อีกครั้ง ยืนยันว่าข้อมูลที่บันทึกไว้ยังคงอยู่และแสดงในตำแหน่งที่ถูกต้อง
5. เปิด Settings → Connectors → Supabase, เลือก Tables และยืนยันว่าระเบียนที่ตรงกันปรากฏในตารางที่ถูกต้อง

หากฟีเจอร์อนุญาตให้ผู้ใช้แก้ไขหรือลบข้อมูลที่บันทึกไว้ ให้ทดสอบการกระทำเหล่านั้นด้วย และยืนยันว่าผลลัพธ์ถูกต้องทั้งในแอปและ Supabase การที่การเปลี่ยนแปลงที่ทำโดยตรงใน Supabase จะปรากฏในแอปทันทีหรือไม่นั้นขึ้นอยู่กับวิธีที่แอปถูกสร้างขึ้น

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

ยกเลิกการเชื่อมต่อ Supabase เมื่อคุณไม่ต้องการให้โปรเจกต์ Atoms ปัจจุบันใช้โปรเจกต์ Supabase ที่เชื่อมต่ออยู่อีกต่อไป

1. เปิด Settings → Connectors → Supabase.
2. ยืนยันว่าคุณกำลังดูการเชื่อมต่อของโปรเจกต์ Atoms ที่ถูกต้อง
3. เลือก Disconnect Project.
4. รอให้รายการยกเลิกการเชื่อมต่อ Supabase ใน Chat เสร็จสิ้น
5. เปิดอีกครั้ง Connectors → Supabase และยืนยันว่าโปรเจกต์ไม่แสดงว่าเชื่อมต่ออยู่อีกต่อไป

การยกเลิกการเชื่อมต่อจะลบการเชื่อมต่อออกจากโปรเจกต์ Atoms ปัจจุบัน โดย จะไม่ลบโปรเจกต์ Supabase หรือข้อมูลของมัน, และจะไม่ลบการอนุญาตสำหรับองค์กร Supabase

ฟีเจอร์ใดๆ ในโปรเจกต์ Atoms ของคุณที่พึ่งพา Supabase อาจหยุดทำงานหลังจากที่คุณยกเลิกการเชื่อมต่อ หากแอปของคุณเผยแพร่ไปแล้ว คุณอาจต้องอัปเดตเวอร์ชันที่เผยแพร่ก่อนที่การเปลี่ยนแปลงจะมีผล ทดสอบทั้งโปรเจกต์และแอปที่ใช้งานจริงหลังยกเลิกการเชื่อมต่อ

การยกเลิกการเชื่อมต่อ Supabase จากโปรเจกต์ Atoms หนึ่งโปรเจกต์จะไม่ส่งผลต่อโปรเจกต์ Atoms อื่นที่เชื่อมต่อกับโปรเจกต์ Supabase เดียวกัน

คำถามที่พบบ่อย

ทำไมการเชื่อมต่อ Supabase ของฉันจึงหยุดทำงาน?

1. เปิด Supabase Dashboard และตรวจสอบสถานะของโปรเจกต์ที่ได้รับผลกระทบ โปรเจกต์ Free Plan ที่มีกิจกรรมต่ำอาจถูกพักหลังจากช่วงเวลาเจ็ดวัน
2. หากถูกพักอยู่ ให้เลือก Resume project และรอจนกว่า Supabase จะแจ้งว่าโปรเจกต์เปิดใช้งานอยู่
3. กลับไปที่ Atoms เปิดแผง Connectors ของโปรเจกต์ และตรวจสอบการเชื่อมต่อ Supabase ลองทำการกระทำที่ล้มเหลวอีกครั้งหนึ่ง
4. หาก Supabase เปิดใช้งานอยู่แล้ว ให้บันทึกข้อผิดพลาดของ Atoms หรือ Supabase ที่เกิดขึ้นอย่างชัดเจน และตรวจสอบว่าการเชื่อมต่อแสดงว่าไม่ได้เชื่อมต่อหรือหมดอายุหรือไม่ เชื่อมต่อใหม่เฉพาะเมื่อสถานะระบุว่าจำเป็นเท่านั้น

อย่าหมุนเวียนคีย์หรือสร้างโปรเจกต์ทดแทนจนกว่าคุณจะทราบสาเหตุและได้ปกป้องข้อมูลที่มีอยู่แล้ว หากปัญหายังคงเกิดขึ้น โปรดติดต่อ Support พร้อม Chat Link เวลาและเขตเวลา สถานะการเชื่อมต่อ และภาพหน้าจอข้อผิดพลาดที่ลบข้อมูลสำคัญแล้ว

ข้อมูลอ้างอิงภายนอก: Supabase — การพักโปรเจกต์

ฉันจะเชื่อมต่อโปรเจกต์ Supabase ที่ถูกพักไว้ใหม่ได้อย่างไร?

1. ลงชื่อเข้าใช้องค์กร Supabase ที่ถูกต้องและเปิดโปรเจกต์ที่ถูกพักไว้
2. เลือก Resume project และรอจนกว่าสถานะจะเป็นใช้งานอยู่ คำแนะนำปัจจุบันของ Supabase ระบุว่าโปรเจกต์ Free Plan ที่มีกิจกรรมต่ำอาจถูกพักหลังจากช่วงกิจกรรมต่ำเจ็ดวัน
3. กลับไปที่ Atoms และเปิดแผง Connectors ของโปรเจกต์ ยืนยันว่า Supabase เชื่อมต่ออยู่ จากนั้นลองดำเนินการที่ได้รับผลกระทบอีกครั้ง
4. หาก Atoms ยังคงแสดงตัวเชื่อมต่อว่าไม่ได้เชื่อมต่อหรือหมดอายุ ให้เชื่อมต่อใหม่และดำเนินการอนุญาตที่ร้องขอให้เสร็จสิ้น

อย่าสร้างโปรเจกต์ Supabase ใหม่หรือหมุนเวียนข้อมูลรับรองจนกว่าข้อมูลที่มีอยู่จะได้รับการปกป้อง หากการเชื่อมต่อใหม่ล้มเหลว โปรดส่ง Chat Link สถานะโปรเจกต์ Supabase เวลาและเขตเวลา และภาพหน้าจอข้อผิดพลาดที่ลบข้อมูลสำคัญแล้วให้กับ Support

ข้อมูลอ้างอิงภายนอก: Supabase — การพักโปรเจกต์