Atoms Bulutu Veritabanı, uygulamanızın dayandığı yapılandırılmış verileri depolar ve yönetir; buna ürünler, rezervasyonlar, siparişler, form gönderimleri ve kullanıcı tarafından oluşturulan içerikler dahildir. Veritabanı modülünde ortamları ve tabloları görüntüleyebilir, kayıtları arayıp düzenleyebilir, tablo yapılarını inceleyebilir ve CSV dosyalarını kullanarak veri içe veya dışa aktarabilirsiniz.

Bu kılavuz, Atoms Bulutu içine yerleşik veritabanını kapsar. Projeniz Supabase kullanıyorsa bunun yerine Supabase Bağlantısı bölümüne bakın.

Bir veritabanı açın

Bir veritabanı açmadan önce projenizi Atoms Bulutu'na bağlayın. Henüz bağlı değilse Atoms Bulutu içindeki bağlantı adımlarını izleyin.

1. Projenizi masaüstü bir cihazda açın.
2. Uygulama Görüntüleyici 'nin bulunduğu aynı çalışma alanı araç çubuğunda Atoms Bulutu'nu seçin.
3. Atoms Bulutu kenar çubuğunda Veritabanı'nı seçin.
4. Databases altında incelemek istediğiniz veritabanını seçin. Development ve Production veritabanı kartları, proje için kullanılabilir olduklarında görünür.

Her veritabanı kartı ne kadar depolama alanı kullanıldığını ve toplam kullanılabilir miktarı gösterir. Uygulamanızı oluştururken ve test ederken Development kullanın. Production içinde yapılan değişiklikler canlı uygulamanın verilerini etkileyebilir; bu nedenle değişiklik yapmadan önce her zaman hangi ortamda olduğunuzu kontrol edin.

Development veya Production veritabanını seçin.

Tablo verilerine göz atın ve filtreleyin

1. Çalışmak istediğiniz ortama bağlı olarak Development veya Production veritabanı kartını seçin.
2. Bir tablo bulmak için Search tables kullanın veya listeden doğrudan birini seçin. Her tablo kartı satır sayısını ve salt okunur olup olmadığını gösterir.
3. Geçerli tablo içinde arama yapmak için Search rows kullanın veya bir ya da daha fazla alan kullanarak sonuçları daraltmak için Filter seçin.
4. Ek satırları görüntülemek için tablonun altındaki sayfa ok denetimlerini kullanın.
5. Tablonun yapısını incelemek için ••• menüsünü açın ve Schema seçin.

Schema görünümü her alanın adını, veri türünü, anahtar durumunu, gereksinimlerini, kısıtlamalarını ve varsayılan değerini gösterir. Görüntülenen şemayı kopyalamak için Copy seçin.

Satır ekleyin, düzenleyin veya silin

Değişiklik yapmak istediğiniz veritabanını bulduğunuzda bunu yapmak için şu işlemleri kullanabilirsiniz:

İşlem	Nasıl yapılır
Satır ekle	... öğesini açın ve Add Row seçin. Kullanılabilir alanlarla eşleşen değerleri girin, ardından satırı gönderin.
Satırı düzenle	Bir hücreye çift tıklayın ve yeni değeri girin. Bekleyen tüm düzenlemeleri kaydetmek için Commit Changes seçin veya bunları kaldırmak için Discard seçin.
Satırları sil	Bir veya daha fazla satır seçin, Delete seçin, ardından onaylayın. Satır silme işlemi geri alınamaz.

Bir satır eklemek veya silmeyi onaylamak, değişikliği seçilen veritabanına hemen uygular. Yalnızca satır içi hücre düzenlemeleri için Commit Changes veya Discard seçmeniz gerekir. Bekleyen düzenlemeleriniz varsa satır eklemeden, CSV dosyası içe veya dışa aktarmadan, aramayı ya da filtreleri değiştirmeden veya başka bir sayfaya gitmeden önce bunları kaydedin ya da iptal edin.

Proje bir çalışma alanındaysa yalnızca Editors ve workspace owner, yazılabilir tablolardaki satırları düzenleyebilir. Atoms bir tablo için birincil anahtar algılayamazsa satırlarını düzenleyemez veya silemezsiniz; çünkü Atoms tek tek kayıtları güvenilir şekilde tanımlayamaz.

Bekleyen bir satır düzenlemesini gözden geçirin, ardından değişikliği kaydedin veya iptal edin.

Tablolar oluşturun veya şemayı değiştirin

Güncellemek istediğiniz veritabanı ortamını açın, ardından yapmak istediğiniz değişiklik için talimatları izleyin:

İşlem	Nasıl yapılır
Tablo oluştur	Tablo listesinde ... öğesine tıklayın ve Create table seçin. Geçerli bir tablo adı ve başlangıç alanlarını girin, ardından isteği gönderin. Agent işlemi bitirdikten sonra Veritabanı'nı yeniden açın ve tabloyu doğrulayın.
Şemayı değiştir	Değişiklik yapmak istediğiniz tabloya tıklayın, ardından ... öğesine tıklayın ve Schema. seçin. Bir alan oluşturmak için Add Field kullanın veya düzenlemek için uygun bir alan seçin. Adını, türünü, varsayılan değerini, zorunlu durumunu veya benzersizliğini değiştirebilirsiniz. Anahtar olmayan alanları silinmek üzere de işaretleyebilirsiniz. İsteği Agent'a göndermek için Submit Changes seçin veya bekleyen değişikliklerinizi temizlemek için Discard seçin.

Yalnızca workspace owner tablo oluşturabilir veya bir tablonun şemasını değiştirebilir.

Bir şema isteği göndermek, geçişin tamamlandığı anlamına gelmez. Agent'ın bitirmesini bekleyin, sonucu Veritabanı içinde doğrulayın ve ardından uygulamanızı test edin. Birincil anahtar alanları ve salt okunur tablolar bu şekilde değiştirilemez.

Yeni alanın ayrıntılarını Add Field içinde girin.

Submit Changes seçmeden önce bekleyen şema değişikliklerini gözden geçirin.

CSV verilerini içe veya dışa aktarın

Çalışmak istediğiniz tabloyu seçin, ardından ilgili işlem için talimatları izleyin:

İşlem	Nasıl yapılır
CSV içe aktar	... öğesine tıklayın ve Import CSV seçin. 10 MB'den büyük olmayan bir .csv dosyası seçin, ardından onaylamadan önce dosya adını, tahmini satır sayısını, seçilen tabloyu ve ortamı gözden geçirin. CSV sütunları tablo şemasıyla eşleşmelidir. İçe aktarılan satırlar hemen eklenir ve otomatik olarak geri alınamaz; bu nedenle önce mevcut verileri dışa aktarmayı düşünebilirsiniz.
CSV dışa aktar	... öğesine tıklayın ve Export CSV seçin. Bir arama veya filtre etkinse yalnızca eşleşen satırlar dışa aktarılır. Aksi takdirde geçerli tablodaki tüm veriler dışa aktarılır.

Yalnızca workspace owner CSV dosyalarını içe veya dışa aktarabilir. Salt okunur tablolar için kullanılabilen tek seçenek Export CSV'dir.

İzinler ve korumalı tablolar

Eylem	Bunu kim yapabilir	Ek gereksinimler
Satır ekleme, düzenleme veya silme	Editor veya workspace owner	Tablonun yazılabilir olması gerekir. Satırları düzenlemek ve silmek ayrıca birincil anahtar bilgisi gerektirir.
Tablo oluşturma veya şemaları değiştirme	Çalışma Alanı owner	Birincil anahtar alanları ve salt okunur tablolar değiştirilemez.
CSV dosyalarını içe veya dışa aktarma	Çalışma Alanı owner	CSV dosyaları salt okunur tablolara içe aktarılamaz.

Korumalı sistem veya kullanıcı tablolarında Read-only rozeti görüntülenebilir. Verilerini görüntüleyebilir ve mevcut olduğunda şemalarını inceleyebilirsiniz, ancak bu sayfadan satırlarını veya yapılarını değiştiremezsiniz.

Yaygın veritabanı sorunlarını düzeltin

“No databases found” veya “No tables found”

Atoms Bulutu'nun projeye bağlı olduğundan emin olun. Zaten bağlıysa uygulamanızın kalıcı veri depolayan bir özellik içerdiğini doğrulayın. Gerekirse Agent'tan veritabanı destekli özelliği eklemesini isteyin. Agent işlemi tamamladıktan sonra Veritabanı'nı yeniden açın veya Refresh seçin.

Bir veritabanı eylemi eksik veya kullanılamıyor

Tabloda Read-only rozeti olup olmadığını kontrol edin, ardından çalışma alanı rolünüzün eyleme izin verdiğini doğrulamak için yukarıdaki izinleri inceleyin. Satırları düzenlemek ve silmek ayrıca birincil anahtar bilgisi gerektirir.

Bekleyen satır düzenlemeleri diğer eylemleri engelleyebilir. Satır eklemeden, CSV dosyası içe veya dışa aktarmadan, aramayı ya da filtreleri değiştirmeden veya başka bir sayfaya geçmeden önce Commit Changes ya da Discard seçin.

Bu kontrollerden sonra eylem hâlâ kullanılamıyorsa Support ile iletişime geçin ve proje veya Chat bağlantısını, ortamı, tabloyu, çalışma alanı rolünü, denenmiş eylemi ve tam hata metnini ekleyin.

Bir CSV dosyası içe aktarılamıyor

Yalnızca workspace owner veri içe aktarabilir ve hedef tablonun yazılabilir olması gerekir. Şunlardan emin olun:

• Dosya .csv biçimini kullanıyor.
• Dosya 10 MB'den büyük değil.
• Sütunları ve verileri hedef tablonun şemasıyla uyumlu.
• Bekleyen satır düzenlemelerini kaydettiniz veya iptal ettiniz.

İçe aktarma yine de başarısız olursa Support ile iletişime geçin ve proje veya Chat bağlantısını, ortamı, hedef tabloyu, çalışma alanı rolünü, dosya adını ve boyutunu, denenmiş eylemi ve tam hata metnini ekleyin.

SSS

Production veritabanım senkronize olmuyor. Ne yapmalıyım?

Development normal çalışıyor ancak canlı site (Production) eksik tablolar, sütunlar veya geçiş hataları gösteriyorsa:

Önemli: Production veritabanını kendi başınıza yeniden oluşturmayın veya üzerine yazmayın.

Gerekli bilgiler:

• Chat bağlantısı ve canlı URL
• Tam SQL hata mesajı
• Eksik tablo/sütun adları
• Son veritabanı şeması değişikliği
• Son çalışan canlı sürüm
• Production verilerinin korunması gerekip gerekmediği
• Development verilerini tamamen senkronize etmek mi yoksa yalnızca eksik yapıları doldurmak mı istediğiniz

Değişiklik yapmadan önce Development/Production sürümlerini, geçiş durumunu ve şema farklarını karşılaştırabilmemiz için bu ayrıntılarla destek ekibiyle iletişime geçin.

Geliştirme verilerim neden production verilerinden farklı?

Birden fazla kez yayımladıysanız ancak kod güncellemeleri sorunsuz çalışırken Production hâlâ eski verileri gösteriyorsa:

Destek ile iletişime geçmeden önce şunları doğrulayın:

1. Mevcut production verilerinin korunması gerekiyor mu?

2. Mevcut Development verileriyle tamamen üzerine yazmak mı istiyorsunuz, yoksa yalnızca eksik kayıtları mı doldurmak istiyorsunuz?

3. Zaten bir yedeğiniz var mı?

4. Kabul edilebilir bakım pencereniz nedir?

Veri işleme hedefi doğrulanana kadar production verilerinin üzerine yazmayacağız veya bunları yeniden oluşturmayacağız. Farkı gösteren Development/Production URL'lerini ve örnek kayıt kimliklerini ya da sayımlarını sağlayın.