Kết nối một dự án Atoms với Supabase khi bạn muốn app sử dụng cơ sở dữ liệu Supabase, xác thực, lưu trữ tệp hoặc các hàm backend.

Hướng dẫn này sẽ đưa bạn qua toàn bộ quy trình: chuẩn bị tài khoản và dự án Supabase, cấp quyền cho đúng tổ chức, kết nối dự án, kiểm tra kết nối đã hoạt động và ngắt kết nối khi cần.

Cách kết nối hoạt động

Mỗi dự án Supabase thuộc về một organization, nơi kiểm soát ai có thể truy cập và quản lý các dự án bên trong đó. Khi bạn kết nối Supabase với Atoms, trước tiên bạn cấp quyền cho Atoms truy cập organization mà bạn muốn sử dụng, sau đó chọn một dự án từ organization đó để kết nối.

Mỗi dự án Atoms chỉ có thể được kết nối với một dự án Supabase tại một thời điểm. Tuy nhiên, cùng một dự án Supabase có thể được kết nối với nhiều hơn một dự án Atoms.

Supabase và Atoms Cloud là các tùy chọn backend thay thế cho nhau. Bạn không thể kết nối cả hai với cùng một dự án Atoms cùng lúc.

Trước khi bắt đầu

Trước khi kết nối Supabase, hãy đảm bảo rằng:

• Bạn là chủ sở hữu của Không gian làm việc Atoms chứa dự án. Chỉ chủ sở hữu không gian làm việc mới có thể cấp quyền, kết nối hoặc ngắt kết nối Supabase.
• Bạn có tài khoản Supabase hoặc sẵn sàng tạo một tài khoản trong quá trình thiết lập.
• Bạn có quyền cấp quyền cho organization Supabase và truy cập dự án mà bạn muốn kết nối.
• Agent đã hoàn thành tác vụ hiện tại và Chế độ đua đã được tắt.
• Trình duyệt của bạn cho phép cửa sổ bật lên từ Atoms.
• Dự án Atoms của bạn chưa được kết nối với Atoms Cloud.

Nếu đây là lần đầu bạn thử kết nối này, hãy cân nhắc sử dụng một dự án thử nghiệm trong khi tìm hiểu quy trình.

Không bao giờ dán mật khẩu Supabase, khóa API, token truy cập hoặc thông tin xác thực khác vào Chat.

Kết nối Supabase

Mở trình kết nối Supabase

1. Mở dự án mà bạn muốn kết nối.
2. Nhấp vào tên dự án ở góc trên bên phải của bảng chat.
3. Chọn Connectors trong menu thả xuống xuất hiện.
4. Tìm Supabase trong danh sách các trình kết nối khả dụng và nhấp vào connect.

Bạn cũng có thể mở Settings → Connectors → Supabase và chọn Connect.

Mở Settings → Connectors và chọn Connect cho Supabase.

Cấp quyền cho Atoms trong Supabase

Nếu Organizations đã hiển thị organization Supabase mà bạn muốn sử dụng, thì organization đó đã được cấp quyền. Bạn có thể tiếp tục đến phần Chọn dự án Supabase.

1. Atoms mở một cửa sổ cấp quyền Supabase. Đăng nhập vào tài khoản Supabase mà bạn muốn kết nối hoặc tạo tài khoản mới nếu cần.
2. Kiểm tra rằng bạn đã đăng nhập đúng tài khoản Supabase, sau đó chọn organization mà bạn muốn Atoms truy cập.
3. Xem lại các quyền mà Atoms yêu cầu. Để xem mọi quyền, chọn Show detailed permissions. Nếu bạn đồng ý, chọn Authorize Atoms.
4. Quay lại Atoms và chờ thông báo Connect success.
5. Trong Atoms, mở Connectors → Supabase và xác nhận rằng organization xuất hiện dưới Organizations.

Atoms yêu cầu quyền đọc và ghi đối với Cơ sở dữ liệu, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST và Storage. Atoms cũng yêu cầu quyền đọc đối với Organizations và Domains. Các quyền này cho phép Atoms kết nối và quản lý các dịch vụ Supabase được hỗ trợ mà dự án của bạn sử dụng.

Việc cấp quyền này áp dụng cho organization Supabase đã chọn và không bị giới hạn ở dự án Supabase mà sau đó bạn kết nối với dự án Atoms hiện tại. Atoms không thể truy cập các organization hoặc dự án mà chính tài khoản Supabase đã kết nối không thể truy cập, và quyền của Supabase có thể áp dụng thêm các hạn chế khác.

Xem lại organization và các quyền trước khi cấp quyền cho Atoms.

Chọn dự án Supabase

1. Trong Organizations, mở rộng organization mà bạn đã cấp quyền.
2. Trong Projects, tìm dự án Supabase đang hoạt động mà bạn muốn kết nối.
3. Nếu organization bạn cần không có trong danh sách, chọn New Organization và cấp quyền cho organization đó. Việc này không tạo organization Supabase mới; nó cho phép bạn cấp quyền cho một organization khác đã tồn tại trong tài khoản Supabase của bạn.
4. Nếu bạn chưa có dự án, chọn Create Project và tạo một dự án trong Supabase. Chờ đến khi dự án hoạt động và sẵn sàng sử dụng, sau đó quay lại Atoms và chọn Update để làm mới danh sách dự án.
5. Bên cạnh dự án bạn muốn sử dụng, chọn Connect.

Chọn một dự án Supabase từ organization đã được cấp quyền.

Xác nhận dự án

1. Trong cửa sổ xác nhận, kiểm tra organization và dự án được hiển thị dưới Supabase Project.
2. Nếu cần, sử dụng Supabase Dashboard hoặc View Tables để xác nhận rằng bạn đã chọn đúng dự án.
3. Chọn Connect.
4. Atoms thêm một mục kết nối Supabase vào Chat của dự án. Hãy giữ trang mở và chờ hoàn tất trước khi yêu cầu Agent xây dựng tính năng cơ sở dữ liệu, xác thực, lưu trữ hoặc backend.

Xác nhận dự án Supabase đã chọn trước khi kết nối.

Kiểm tra kết nối đã hoạt động

1. Mở Settings → Connectors → Supabase.
2. Xác nhận rằng đúng organization và dự án Supabase được hiển thị là đã kết nối.
3. Chọn Dashboard hoặc Tables và kiểm tra rằng nó mở đúng cùng dự án trong Supabase.

Bảng dự án đã kết nối cũng có thể bao gồm các liên kết đến Manage Users, SQL Editor, Edge Functions và Manage Secrets. Bạn chỉ cần sử dụng các khu vực liên quan đến những tính năng mà bạn đang xây dựng.

Xem lại dự án Supabase đã kết nối và các liên kết quản lý của dự án.

Kiểm tra app của bạn có thể lưu dữ liệu

Việc kết nối Supabase không tự động thêm tính năng cơ sở dữ liệu vào app của bạn. Trong Chat, hãy yêu cầu Agent xây dựng tính năng bạn muốn và sử dụng dự án Supabase đã kết nối để lưu dữ liệu của tính năng đó. Sau khi Agent hoàn tất, hãy kiểm tra toàn bộ quy trình.

1. Trong Chat, mô tả tính năng bạn muốn, thông tin mà tính năng đó cần lưu và nơi người dùng sẽ nhìn thấy lại thông tin đó. Hãy yêu cầu Agent sử dụng dự án Supabase đã kết nối.
2. Chờ Agent hoàn tất việc xây dựng tính năng.
3. Trong Trình xem App, sử dụng tính năng như một người dùng thực sự và nhập dữ liệu thử nghiệm vô hại. Không sử dụng thông tin cá nhân, bí mật hoặc nhạy cảm.
4. Làm mới Trình xem App hoặc mở lại tính năng. Xác nhận rằng thông tin đã lưu vẫn còn và xuất hiện đúng vị trí.
5. Mở Settings → Connectors → Supabase, chọn Tables và xác nhận rằng bản ghi tương ứng xuất hiện trong đúng bảng.

Nếu tính năng cho phép người dùng chỉnh sửa hoặc xóa thông tin đã lưu, hãy kiểm tra cả các thao tác đó và xác nhận rằng kết quả là chính xác trong cả app lẫn Supabase. Việc các thay đổi được thực hiện trực tiếp trong Supabase có xuất hiện ngay trong app hay không phụ thuộc vào cách app được xây dựng.

Ngắt kết nối Supabase

Ngắt kết nối Supabase khi bạn không còn muốn dự án Atoms hiện tại sử dụng dự án Supabase đã kết nối nữa.

1. Mở Settings → Connectors → Supabase.
2. Xác nhận rằng bạn đang xem kết nối của đúng dự án Atoms.
3. Chọn Disconnect Project.
4. Chờ mục ngắt kết nối Supabase trong Chat hoàn tất.
5. Mở lại Connectors → Supabase và xác nhận rằng dự án không còn được hiển thị là đã kết nối.

Việc ngắt kết nối sẽ xóa kết nối khỏi dự án Atoms hiện tại. Nó không xóa dự án Supabase hoặc dữ liệu của dự án đó, và cũng không xóa quyền đã cấp cho organization Supabase.

Bất kỳ tính năng nào trong dự án Atoms của bạn phụ thuộc vào Supabase có thể ngừng hoạt động sau khi bạn ngắt kết nối. Nếu app của bạn đã được xuất bản, bạn có thể cần cập nhật phiên bản đã xuất bản trước khi thay đổi có hiệu lực. Hãy kiểm tra cả dự án của bạn và app đang chạy sau khi ngắt kết nối.

Việc ngắt kết nối Supabase khỏi một dự án Atoms không ảnh hưởng đến các dự án Atoms khác được kết nối với cùng dự án Supabase.

Câu hỏi thường gặp

Tại sao kết nối Supabase của tôi đã ngừng hoạt động?

1. Mở Supabase Dashboard và kiểm tra trạng thái của dự án bị ảnh hưởng. Một dự án Gói miễn phí có mức hoạt động thấp có thể bị tạm dừng sau khoảng thời gian bảy ngày.
2. Nếu dự án đang bị tạm dừng, chọn Resume project và chờ đến khi Supabase báo rằng dự án đang hoạt động.
3. Quay lại Atoms, mở bảng Connectors của dự án và xác minh kết nối Supabase. Thử lại thao tác bị lỗi một lần.
4. Nếu Supabase đã hoạt động, hãy ghi lại chính xác lỗi Atoms hoặc Supabase và kiểm tra xem kết nối có được hiển thị là đã ngắt hoặc hết hạn hay không. Chỉ kết nối lại khi trạng thái cho biết điều đó là cần thiết.

Không xoay vòng khóa hoặc tạo dự án thay thế cho đến khi bạn biết nguyên nhân và đã bảo vệ dữ liệu hiện có. Nếu lỗi vẫn tiếp diễn, hãy liên hệ Support kèm theo Chat Link, thời gian và múi giờ, trạng thái kết nối và ảnh chụp màn hình lỗi đã được ẩn thông tin nhạy cảm.

Tham khảo bên ngoài: Supabase — Tạm dừng dự án

Làm cách nào để kết nối lại một dự án Supabase đã bị tạm dừng?

1. Đăng nhập vào đúng organization Supabase và mở dự án đã bị tạm dừng.
2. Chọn Resume project và chờ đến khi trạng thái của dự án là đang hoạt động. Hướng dẫn hiện tại của Supabase cho biết các dự án Gói miễn phí có mức hoạt động thấp có thể bị tạm dừng sau thời gian bảy ngày hoạt động thấp.
3. Quay lại Atoms và mở bảng Connectors của dự án. Xác nhận rằng Supabase đã được kết nối, sau đó thử lại thao tác bị ảnh hưởng.
4. Nếu Atoms vẫn hiển thị trình kết nối là đã ngắt hoặc hết hạn, hãy kết nối lại và hoàn tất việc cấp quyền được yêu cầu.

Không tạo dự án Supabase mới hoặc xoay vòng thông tin xác thực cho đến khi dữ liệu hiện có được bảo vệ. Nếu việc kết nối lại thất bại, hãy cung cấp cho Support Chat Link, trạng thái dự án Supabase, thời gian và múi giờ, cùng ảnh chụp màn hình lỗi đã được ẩn thông tin nhạy cảm.

Tham khảo bên ngoài: Supabase — Tạm dừng dự án