Uygulamanın bir Supabase veritabanı, kimlik doğrulama, dosya depolama veya arka uç işlevleri kullanmasını istediğinizde bir Atoms projesini Supabase'e bağlayın.

Bu kılavuz sizi tüm süreç boyunca yönlendirir: bir Supabase hesabı ve projesi hazırlama, doğru kuruluşu yetkilendirme, projeyi bağlama, bağlantının çalıştığını kontrol etme ve gerektiğinde bağlantıyı kesme.

Bağlantı nasıl çalışır

Her Supabase projesi, içindeki projelere kimlerin erişebileceğini ve onları yönetebileceğini kontrol eden bir kuruluşa aittir. Supabase'i Atoms'a bağladığınızda, önce Atoms'un kullanmak istediğiniz kuruluşa erişmesine izin verir, ardından bağlamak için o kuruluştan bir proje seçersiniz.

Her Atoms projesi aynı anda yalnızca bir Supabase projesine bağlanabilir. Ancak aynı Supabase projesi birden fazla Atoms projesine bağlanabilir.

Supabase ve Atoms Bulutu alternatif arka uç seçenekleridir. İkisini aynı anda aynı Atoms projesine bağlayamazsınız.

Başlamadan önce

Supabase'i bağlamadan önce şunlardan emin olun:

• Projeyi içeren Atoms çalışma alanının sahibisiniz. Supabase'i yalnızca çalışma alanı sahibi yetkilendirebilir, bağlayabilir veya bağlantısını kesebilir.
• Bir Supabase hesabınız var veya kurulum sırasında bir tane oluşturmaya hazırsınız.
• Supabase kuruluşunu yetkilendirme ve bağlamak istediğiniz projeye erişme izniniz var.
• Agent mevcut görevini tamamladı ve Yarış Modu kapalı.
• Tarayıcınız Atoms'tan gelen açılır pencerelere izin veriyor.
• Atoms projeniz zaten Atoms Bulutu'na bağlı değil.

Bu bağlantıyı ilk kez deniyorsanız, süreci öğrenirken bir test projesi kullanmayı düşünebilirsiniz.

Supabase parolasını, API anahtarını, erişim jetonunu veya başka bir kimlik bilgisini asla Sohbet'e yapıştırmayın.

Supabase Bağlantısı

Supabase bağlayıcısını açın

1. Bağlamak istediğiniz projeyi açın.
2. Sohbet panelinin sağ üst kısmındaki proje adına tıklayın.
3. Açılan açılır menüden Connectors seçeneğini seçin.
4. Kullanılabilir bağlayıcılar listesinde Supabase öğesini bulun ve connect seçeneğine tıklayın.

Ayrıca Settings → Connectors → Supabase bölümünü açıp Connect seçeneğini seçebilirsiniz.

Ayarlar → Bağlayıcılar'ı açın ve Supabase için Bağlan'ı seçin.

Supabase içinde Atoms'u yetkilendirin

Eğer Organizations bölümünde kullanmak istediğiniz Supabase kuruluşu zaten görünüyorsa, bu kuruluş zaten yetkilendirilmiştir. Supabase projesini seçin bölümüne devam edebilirsiniz.

1. Atoms bir Supabase yetkilendirme penceresi açar. Bağlamak istediğiniz Supabase hesabında oturum açın veya gerekirse yeni bir hesap oluşturun.
2. Doğru Supabase hesabında oturum açtığınızdan emin olun, ardından Atoms'un erişmesini istediğiniz kuruluşu seçin.
3. Atoms tarafından istenen izinleri gözden geçirin. Tüm izinleri görmek için Show detailed permissions seçeneğini seçin. Kabul ediyorsanız Authorize Atoms seçeneğini seçin.
4. Atoms'a geri dönün ve Connect success mesajını bekleyin.
5. Atoms'ta Connectors → Supabase bölümünü açın ve kuruluşun Organizations altında göründüğünü doğrulayın.

Atoms, Veritabanı, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST ve Storage için okuma ve yazma erişimi ister. Ayrıca Organizations ve Domains için okuma erişimi de ister. Bu izinler, Atoms'un projeniz tarafından kullanılan desteklenen Supabase hizmetlerini bağlamasına ve yönetmesine olanak tanır.

Bu yetkilendirme seçilen Supabase kuruluşu için geçerlidir ve daha sonra mevcut Atoms projesine bağlayacağınız Supabase projesiyle sınırlı değildir. Atoms, bağlı Supabase hesabının kendisinin erişemediği kuruluşlara veya projelere erişemez ve Supabase izinleri ek kısıtlamalar getirebilir.

Atoms'u yetkilendirmeden önce kuruluşu ve izinleri gözden geçirin.

Supabase projesini seçin

1. Organizations altında, yetkilendirdiğiniz kuruluşu genişletin.
2. Projects altında, bağlamak istediğiniz etkin Supabase projesini bulun.
3. İhtiyacınız olan kuruluş listede yoksa New Organization seçeneğini seçin ve onu yetkilendirin. Bu işlem yeni bir Supabase kuruluşu oluşturmaz; Supabase hesabınızda zaten var olan başka bir kuruluşu yetkilendirmenizi sağlar.
4. Henüz bir projeniz yoksa Create Project seçeneğini seçin ve Supabase içinde bir proje oluşturun. Proje etkin ve kullanıma hazır olana kadar bekleyin, ardından Atoms'a dönüp proje listesini yenilemek için Update seçeneğini seçin.
5. Kullanmak istediğiniz projenin yanında Connect seçeneğini seçin.

Yetkilendirilmiş kuruluştan bir Supabase projesi seçin.

Projeyi onaylayın

1. Onay penceresinde, Supabase Project altında gösterilen kuruluşu ve projeyi kontrol edin.
2. Gerekirse doğru projeyi seçtiğinizi doğrulamak için Supabase Dashboard veya View Tables kullanın.
3. Connect seçeneğini seçin.
4. Atoms, proje Sohbet'ine bir Supabase bağlantı öğesi ekler. Agent'tan bir veritabanı, kimlik doğrulama, depolama veya arka uç özelliği oluşturmasını istemeden önce sayfayı açık tutun ve işlemin tamamlanmasını bekleyin.

Bağlanmadan önce seçilen Supabase projesini onaylayın.

Bağlantının çalıştığını kontrol edin

1. Settings → Connectors → Supabase bölümünü açın.
2. Doğru kuruluşun ve Supabase projesinin bağlı olarak gösterildiğini doğrulayın.
3. Dashboard veya Tables seçeneğini seçin ve bunun Supabase içinde aynı projeyi açtığını kontrol edin.

Bağlı proje paneli ayrıca Manage Users, SQL Editor, Edge Functions ve Manage Secrets bağlantılarını da içerebilir. Yalnızca oluşturduğunuz özelliklerle ilgili alanları kullanmanız gerekir.

Bağlı Supabase projesini ve yönetim bağlantılarını gözden geçirin.

Uygulamanızın veri kaydedebildiğini test edin

Supabase'i bağlamak tek başına uygulamanıza bir veritabanı özelliği eklemez. Chat içinde Agent'tan istediğiniz özelliği oluşturmasını ve verilerini depolamak için bağlı Supabase projesini kullanmasını isteyin. Agent tamamladıktan sonra tüm süreci test edin.

1. Chat içinde istediğiniz özelliği, hangi bilgileri kaydetmesi gerektiğini ve kullanıcıların bu bilgileri tekrar nerede görmesi gerektiğini açıklayın. Agent'a bağlı Supabase projesini kullanmasını söyleyin.
2. Agent'ın özelliği oluşturmayı tamamlamasını bekleyin.
3. Uygulama Görüntüleyici içinde özelliği bir kullanıcının yapacağı gibi kullanın ve zararsız test verileri girin. Kişisel, gizli veya hassas bilgiler kullanmayın.
4. Uygulama Görüntüleyici'yi yenileyin veya özelliği yeniden açın. Kaydedilen bilgilerin kaldığını ve doğru yerde göründüğünü doğrulayın.
5. Settings → Connectors → Supabase bölümünü açın, Tables seçeneğini seçin ve eşleşen kaydın doğru tabloda göründüğünü doğrulayın.

Özellik kullanıcıların kaydedilmiş bilgileri düzenlemesine veya silmesine izin veriyorsa, bu işlemleri de test edin ve sonuçların hem uygulamada hem de Supabase'de doğru olduğunu doğrulayın. Doğrudan Supabase içinde yapılan değişikliklerin uygulamada hemen görünüp görünmeyeceği, uygulamanın nasıl oluşturulduğuna bağlıdır.

Supabase bağlantısını kesin

Mevcut Atoms projesinin bağlı Supabase projesini artık kullanmasını istemediğinizde Supabase bağlantısını kesin.

1. Settings → Connectors → Supabase bölümünü açın.
2. Doğru Atoms projesinin bağlantısını görüntülediğinizi doğrulayın.
3. Disconnect Project seçeneğini seçin.
4. Sohbet'teki Supabase bağlantı kesme öğesinin tamamlanmasını bekleyin.
5. Connectors → Supabase bölümünü yeniden açın ve projenin artık bağlı olarak gösterilmediğini doğrulayın.

Bağlantıyı kesmek, mevcut Atoms projesinden bağlantıyı kaldırır. Bu işlem Supabase projesini veya verilerini silmez ve Supabase kuruluşu için verilen yetkilendirmeyi kaldırmaz.

Atoms projenizde Supabase'e bağlı olan özellikler, bağlantıyı kestikten sonra çalışmayı durdurabilir. Uygulamanız zaten yayımlandıysa, değişikliğin etkili olması için yayımlanmış sürümü güncellemeniz gerekebilir. Bağlantıyı kestikten sonra hem projenizi hem de canlı uygulamayı test edin.

Supabase bağlantısını bir Atoms projesinden kesmek, aynı Supabase projesine bağlı diğer Atoms projelerini etkilemez.

SSS

Supabase bağlantım neden çalışmayı durdurdu?

1. Supabase Dashboard'u açın ve etkilenen projenin durumunu kontrol edin. Düşük etkinlikli bir Ücretsiz Plan projesi yedi günlük bir sürenin ardından duraklatılmış olabilir.
2. Duraklatılmışsa Resume project seçeneğini seçin ve Supabase etkin olduğunu bildirene kadar bekleyin.
3. Atoms'a dönün, projenin Connectors panelini açın ve Supabase bağlantısını doğrulayın. Başarısız olan işlemi bir kez daha deneyin.
4. Supabase zaten etkinse, tam Atoms veya Supabase hatasını kaydedin ve bağlantının kesilmiş ya da süresi dolmuş olarak gösterilip gösterilmediğini kontrol edin. Yalnızca durum bunun gerekli olduğunu gösterdiğinde yeniden bağlayın.

Nedeni öğrenmeden ve mevcut verileri korumadan anahtarları döndürmeyin veya yerine geçecek bir proje oluşturmayın. Sorun devam ederse, Sohbet Bağlantısı, saat ve saat dilimi, bağlantı durumu ve hassas bilgiler temizlenmiş hata ekran görüntüsü ile Destek ekibiyle iletişime geçin.

Harici referans: Supabase — Proje Duraklatma

Duraklatılmış bir Supabase projesini nasıl yeniden bağlarım?

1. Doğru Supabase kuruluşunda oturum açın ve duraklatılmış projeyi açın.
2. Resume project seçeneğini seçin ve durumu etkin olana kadar bekleyin. Supabase'in mevcut yönlendirmesine göre, düşük etkinlikli Ücretsiz Plan projeleri yedi günlük düşük etkinlik süresinden sonra duraklatılabilir.
3. Atoms'a dönün ve projenin Connectors panelini açın. Supabase'in bağlı olduğunu doğrulayın, ardından etkilenen işlemi yeniden deneyin.
4. Atoms hâlâ bağlayıcıyı bağlantısı kesilmiş veya süresi dolmuş olarak gösteriyorsa, yeniden bağlayın ve istenen yetkilendirmeyi tamamlayın.

Mevcut veriler korunmadan yeni bir Supabase projesi oluşturmayın veya kimlik bilgilerini döndürmeyin. Yeniden bağlama başarısız olursa, Destek ekibine Sohbet Bağlantısı, Supabase proje durumu, saat ve saat dilimi ile hassas bilgiler temizlenmiş bir hata ekran görüntüsü sağlayın.

Harici referans: Supabase — Proje Duraklatma