Veritabanı

Bu kılavuz, Atoms Bulutu içine yerleşik olarak gelen 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ını 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 bir masaüstü 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 kullanıldığını ve kullanılabilir toplam 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
Bir satır ekleyin	Open... seçeneğini açın ve Add Row seçin. Kullanılabilir alanlarla eşleşen değerleri girin, ardından satırı gönderin.
Bir satırı düzenleyin	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ı silin	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çili 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, tek tek kayıtları güvenilir şekilde tanımlayamadığı için satırlarını düzenleyemez veya silemezsiniz.

Bekleyen bir satır düzenlemesini inceleyin, 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
Bir tablo oluşturun	Tablo listesinde ... seçeneğine 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'ın bitirmesini bekleyin, Veritabanı'nı yeniden açın ve tabloyu doğrulayın.
Şemayı değiştirin	Değişiklik yapmak istediğiniz tabloya tıklayın, ardından ... seçeneğine 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çeneğini seçmeden önce bekleyen şema değişikliklerini inceleyin.

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	... seçeneğine tıklayın ve Import CSV seçin. 10 MB'tan büyük olmayan bir .csv dosyası seçin, ardından onaylamadan önce dosya adını, tahmini satır sayısını, seçili tabloyu ve ortamı inceleyin. 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ı değerlendirin.
CSV dışa aktar	... seçeneğine 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 yalnızca Export CSV kullanılabilir seçenektir.

İzinler ve korumalı tablolar

Eylem	Bunu kim gerçekleştirebilir	Ek gereksinimler
Satır ekleme, düzenleme veya silme	Editor veya workspace owner	Tablo yazılabilir olmalıdır. Satırları düzenlemek ve silmek ayrıca birincil anahtar bilgisi gerektirir.
Tablo oluşturma veya şema 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ı bir Read-only rozeti gösterebilir. 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ı işlemi eksik veya kullanılamıyor

Tabloda Read-only rozeti olup olmadığını kontrol edin, ardından çalışma alanı rolünüzün işlemi yapmanıza 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 işlemleri 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 veya Discard seçin.

Bu kontrollerden sonra işlem 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ü, denenen işlemi ve tam hata metnini ekleyin.

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

Yalnızca workspace owner veri içe aktarabilir ve hedef tablo yazılabilir olmalıdır. Şunlardan emin olun:

• Dosya .csv biçimini kullanıyor.
• Dosya 10 MB'tan 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 hâlâ 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, denenen işlemi ve tam hata metnini ekleyin.

SSS

Production veritabanım eşitlenmiyor. 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 eşitlemek 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.

Development verilerim neden Production verilerinden farklı?

Birden fazla kez yayımlama yaptıysanız ancak kod güncellemeleri düzgün çalışırken Production hâlâ eski verileri gösteriyorsa:

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

1. Mevcut Production verileri korunmalı mı?

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. Development/Production URL'lerini ve farkı gösteren örnek kayıt kimliklerini ya da sayıları sağlayın.

Bir veritabanını veri kaybetmeden bir Atoms projesinden diğerine taşıyabilir miyim?

Atoms şu anda projeler arasında otomatik ve kayıpsız veritabanı geçişini desteklememektedir. Yeni bir proje oluşturmak veya mevcut bir projeyi bölmek, mevcut kullanıcı hesaplarını ya da veritabanı kayıtlarını yeni projeye otomatik olarak kopyalamaz.

Devam etmeden önce:

• Mevcut veritabanını veya proje kaynaklarını sıfırlamayın, değiştirmeyin, taşımayın ya da silmeyin.
• Orijinal projeyi mevcut verilerin kaynağı olarak değiştirmeden koruyun.
• Kaynak proje, hedef proje, veritabanı sağlayıcısı ve korunması gereken verilerle birlikte Atoms Support ile iletişime geçin.

Bazı durumlarda ekip, kaynak veritabanından hedef veritabanına tek seferlik manuel bir kopyalama konusunda yardımcı olabilir. Bu sürekli bir eşitleme değildir: kopyalama başladıktan sonra kaynağa yazılan yeni veriler hedefte otomatik olarak görünmez.

Veri farklarını en aza indirmek için geçiş penceresi sırasında kaynak veritabanına yazma işlemlerini duraklatın ve hedef projeye geçmeden önce kopyalanan verileri doğrulayın. Tamamen kayıpsız bir geçiş şu anda garanti edilemez.