Mini ders · Türkçe

Formdan gelen bilgileri veritabanına nasıl kaydedersiniz?

Sağlanan deneme veritabanı projesine formdan bir mesaj kaydedin; ardından sayfayı yeniden açınca bu kaydın hâlâ durduğunu doğrulayın.

Etkileşimli derse başlaDers notlarını oku

Bu ders kimler için?

Web sitesi gönderimlerinin kaydedilmesini isteyenler için. Kodlama asistanı verilen kurulumu uygulayıp formu bağlayabilir; SQL veya sunucu kodu yazmanız gerekmez.

Başlamadan önce

Kendi gözden çıkarılabilir Supabase projeniz ve Netlify function deneme projeniz gerekir. Kurulumda sağlanan eksiksiz dosyaları ve kodlama asistanını kullanın. Özel veritabanı kimlik bilgileri sunucuda kalsın; yalnızca yapay test mesajları kullanın. Örnek cevaplar, hesabınızda tamamlanmış testler değildir; bir cevabın nasıl yazılabileceğini gösterir. Örnekteki gözlemlerin yerine kendi sonuçlarınızı yazın ya da hangi adımda takıldığınızı belirtin.

Tahmini süre: 20–37 dk

Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. Hesap kurulumu ayrıca zaman ister. Kısıtlı alıştırma, herkese açık anonim geri bildirim hizmeti değildir; herkese uyarlamadan önce kalıcı kötüye kullanım sınırlarını değerlendirin.

Neler öğreneceksin?

  • Form kaydını gerçek depolamaya gönderin.
  • Sağlayıcının tablo görünümünde kalıcılığı doğrulayın.
  • Herkesin kayıtlarını açığa çıkarmadan geçersiz girdiyi reddedin.

Uygulama dosyaları

Adım 1

Kaydetmenin ne anlama geldiğini tanımlayın

Kayıt, mevcut tarayıcı sayfasının dışında var olmalıdır.

Hazır formu asistanınızla açıp ayırt edilebilir yapay bir ileti seçin. Bunu verilen sunucu üzerinden ayrı bir alıştırma veritabanına kaydedeceğiz.

Değerin hâlâ sayfada görünmesi veritabanında saklandığının kanıtı değildir. Aynı iletiyi sağlayıcıda ve yeniden açtıktan sonra bulmayı planlayın.

Somut bir örnek

Sağlayıcı tablosu ve o anki tarayıcı sayfası farklı yerlerdir. Uygulamayı kapattıktan sonra tabloda kalan mesaj, gönderme düğmesinin yanında hâlâ duran cümleden daha güçlü kanıttır.

Verilen geri bildirim saklama projesini kullan. Verilen şemayı yalnızca ayrı Supabase alıştırma veritabanıma uygulamama ve özel sunucu ortamını yapılandırmama yardım et. Ziyaretçinin geri bildirim tablosuna erişimini kısıtlı tut. Formu başlat; sağlayıcının tablo görünümüne yönlendir ve geçerli verinin kalıcı olduğunu, geçersiz isteklerin satır oluşturmadığını kontrol etmeme yardım et. SQL sözdizimini değil, yapacağım kontrolleri açıkla.

Supabase: veritabanı

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Kaydı tarayıcının dışında saklayın

Veritabanına kaydedilen satır, sayfa kapandıktan sonra da bulunmalıdır.

JavaScript değişkeni sayfası kapanınca kaybolur. Tarayıcının yerel saklama alanı o tarayıcıda kalır. Veritabanı ise kayıtları, uygulamanızın belirli izinlerle ulaşabildiği ayrı bir hizmette tutar.

Özel Supabase tablosu ve sunucu işlevi kullanacağız. Tarayıcı küçük mesaj gönderir; sunucu kontrol edip satırı kaydeder. Bu derste herkesin mesajlarını listeleyen açık bir veri adresi sunulmaz.

Çözülmüş örnek

“Database test D1” gönderdikten sonra sayfayı kapatıp projenin tablo düzenleyicisinde aynı mesajı bulun. Yalnızca sayfada gösterilen metin, kalıcı kaydetme kanıtı değildir.

Supabase: veritabanı

Extra implementation exercise

Sayfa gönderilen mesajı yerel değişkenden gösteriyor. Veritabanına kaydedildiği kanıtlandı mı?

Çözülmüş örneği göster

Hayır. Veritabanındaki gerçek satırı doğrulayın. Hiç sunucu isteği yapılmasa bile tarayıcı yazılan mesajı gösterebilir.

  • Ekranda gösterilen durumla saklanan veriyi ayırır.
  • İzinli veritabanı görünümünden karşılık gelen satırı kontrol eder.

Adım 2

Yalıtılmış depolama projesini hazırlayın

Verilen kurulumu asistana güvenli biçimde uygulatın.

Gözden çıkarılabilir Supabase projenizi oluşturun veya seçin. Asistandan schema.sql dosyasını orada inceleyip uygulamanıza yardım etmesini, özel değerleri yapılandırmasını ve run-locally.txt ile tam projeyi çalıştırmasını isteyin.

Değişiklikleri uygulamadan önce doğru projeyi doğrulayın. Herkese açık ziyaretçilerin bütün geri bildirimleri taramasını engelleyin; test satırını incelemek için proje sahibinin Table Editor görünümünü kullanın.

Somut bir örnek

Sağlanan feedback tablosunda mesaj, üretilmiş kimlik ve oluşturulma saati var. Proje sahibi bunu sağlayıcıda inceleyebilir; bu test için ziyaretçilerin herkesin geri bildirimini okuma iznine ihtiyacı yok.

Supabase: satır düzeyinde güvenlik · Node.js: desteklenen sürümlerin durumu

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Özel bir deneme tablosu oluşturun

Satır güvenliğini açın; bu örnekte tarayıcıdan doğrudan veri erişimini kapalı tutun.

Bu tablo yapısını yalnızca kurulumunuzda belirlediğiniz ayrı Supabase deneme projesinde çalıştırın. Tarayıcı erişimi bilerek kısıtlıdır; satırı proje sahibi olarak Dashboard → Table Editor içinde doğrulayın. Alıştırma SQL’ini canlı veritabanında çalıştırmayın.

Ayrı Supabase projesi oluşturup SQL düzenleyicisinde schema.sql çalıştırın. Tabloda otomatik ID, sınırları olan message alanı ve sunucunun verdiği tarih/saat bulunur. Örnek tablo değişikliklerini ilgisiz canlı veritabanına uygulamayın.

Betik satır güvenliğini açar ve tarayıcı rollerinin tablo izinlerini kaldırır. Sunucunun secret/service-role anahtarı ayrıcalıklı kaydı yapabilir; sunucuda kalmalıdır. Tarayıcıya uygun publishable anahtar farklıdır ve bu yönetici izinlerini vermez.

Deneme satırını görmek için Supabase proje panelinde Table Editor açın; bu, tarayıcının geliştirici konsolu değildir. Ekleme başarısızsa sunucu yanıtını ve proje/veritabanı ayarlarını inceleyin. Yalnızca satır eklendi mi görmek için anonim SELECT açmayın.

Yerel çalışma sırasının tamamı için run-locally.txt dosyasını açın: kökteki özel ortamı hazırlayın, yalnızca deneme projesini bağlayın ve Netlify işlevlerine istek ileten yerel aracı başlatın. server-env.example.txt gerçek sırlar olmadan değişken adlarını listeler. Yalnızca HTML’yi açmak sunucuyu çalıştırmaz.

Çözülmüş örnek

Sunucunun aracılık ettiği bu alıştırmada herkese izin veren genel kural gerekmez. Hatayı araştırmak için anonim SELECT açmak, gönderilen mesajları da ifşa eder.

create table public.feedback (
 id uuid primary key default gen_random_uuid(),
 message text not null check (char_length(message) between 1 and 1000),
 created_at timestamptz not null default now()
);
alter table public.feedback enable row level security;
revoke all on public.feedback from anon, authenticated;
grant insert on public.feedback to service_role;
-- No browser read/write policies: the practice server uses its secret key.

Supabase: satır düzeyinde güvenlik · Node.js: desteklenen sürümlerin durumu

Extra implementation exercise

Tarayıcı sorgusu reddediliyor. Bütün geri bildirim tablosunu anonim kullanıcılara açarak mı düzeltmelisiniz?

Çözülmüş örneği göster

Hayır. Bu düzen bilerek tarayıcı okumalarını reddeder. Sunucunun yazma ayarını kontrol edip tabloyu sahibi olarak inceleyin.

  • Verilerin özel kalması için kurulan denetimi korur.
  • Herkese okuma izni vermek yerine sunucu yolunu veya yetkili paneli kullanır.

Adım 3

Sayfadan bir kayıt gönderin

Yazma işlemini hazır sunucu yapsın.

Gerçek yerel veya barındırılan alıştırma uygulamasını açıp D1 gibi bir ileti gönderin. Asistanınızdan kaydedilen kayıtta yalnızca hedeflenen ziyaretçi alanlarını tutmasını isteyin.

Sağlayıcı tablosunda D1 metnini tam olarak bulun; üretilen kimliğini/zamanını inceleyin. Gizli hesap değerlerini ekran görüntülerine veya paylaşılan notlara koymayın.

Somut bir örnek

D1’i gönderin; ardından feedback içinde tam o metni bulun. Üretilen kimlik bu satırı benzer metinli eski mesajdan ayırır; ziyaretçi bu kimliği seçmemeli veya üzerine yazmamalı.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Veriyi kontrol eden sunucu kaydını bağlayın

Tabloyu ve izin verilen alanları sunucu seçer; istemci yalnızca mesajı verir.

Adı verilen üç sunucu değişkenini ayarlayıp ayrı işlev projesini çalıştırın veya yayımlayın. Deneyen kişi uygulama kodunu girer. Kod bu kısıtlı adrese eriştirir; Supabase hesabına erişim sağlamaz.

mini-feedback.mjs dosyasını okuyun: sağlayıcıdan önce yöntem, erişim kodu, boyut ve mesaj kontrol edilir. İstemcinin verdiği ID veya tablo adları yok sayılır. Ancak ekleme yanıtı başarılıysa kaydedildi sonucu verilir.

Çözülmüş örnek

İsteğe eklenen admin alanı yönetici güncellemesine dönüşmez: sunucu yalnızca message içeren yeni bir nesne oluşturur.

Extra implementation exercise

Tarayıcıdaki bütün JSON’u veritabanına geçirmek yerine neden {message} oluşturulur?

Çözülmüş örneği göster

Sunucunun kabul ettiği alanları açık tutar ve beklenmedik alanların kayda dönüşmesini önler. Mesajı da doğrulayın; yalnızca alan seçmek yeterli değildir.

  • Yazılabilen alanları sınırlar.
  • İstemcinin belirlediği ID, tarih veya ayrıcalıklara güvenmez.

Adım 4

Kalıcılığı ve hatayı kontrol edin

İlk sayfayı kapattıktan sonra işlemi tekrarlayın.

Uygulamayı kapatıp yeniden açın; D1'in hâlâ depolamada olduğunu doğrulayın. Gözden çıkarılabilir kurulumda eksik/aşırı büyük girdi ve yanlış alıştırma kodunu deneyin.

Geçersiz denemeler yeni satır oluşturmamalıdır. Önceki başarı iletisi, sonraki başarısız deneme de kaydedilmiş gibi görünmeye devam etmemelidir.

Somut bir örnek

Olumsuz testlerden önce geçerli satırı kaydedin, sonra tabloyu yeniden inceleyin. “Form hata gösterdi” ve “geçersiz satır eklenmedi” kontrolün iki yararlı parçasıdır.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Kaydın kalıcılığını ve hataları doğrulayın

Ayırt edici mesajlar kullanıp veritabanına sayfadan bağımsız bakın.

Doğru deneme koduyla D1 gönderip tablo düzenleyicisinde eşleşen satırı inceleyin. Sayfayı kapatıp açın, kaydın hâlâ durduğunu doğrulayın. Hesap sırlarını paylaşmadan ID ve tarihini kaydedin.

Eksik mesajı, aşırı uzun mesajı ve yanlış erişim kodunu deneyin. Hiçbiri yeni satır oluşturmamalı. Gözden çıkarılabilir kurulumda eksik sunucu ayarının doğru hata verdiğini de kontrol edin.

Çözülmüş örnek

Geçerli bir kayıt ve reddedilmiş iki geçersiz istek, üç başarılı tıklamadan daha çok şey gösterir. İlk alıştırmada gerçek kişisel geri bildirim kullanmayın.

Extra implementation exercise

Sunucu hata döndürüyor ama tarayıcı önceki denemeden “Saved” (kaydedildi) gösteriyor. Neyi doğrulamalısınız?

Çözülmüş örneği göster

Yeni değerin satırı var mı bakın. Arayüz güncel hatayı göstermeli; önceki başarı bu denemenin sonucu sayılmamalı.

  • Güncel yanıtı ve yeni ayırt edici değeri kontrol eder.
  • Eski başarıyı başarısız yeni isteğin kanıtı saymaz.

Adım 5

Verileri açığa çıkarmadan konu ekleyin

Alan değişikliği için asistan kullanıp sonucu inceleyin.

Asistandan forma, depolama kurulumuna ve sunucu doğrulamasına Project ve Question adlı iki konu eklemesini isteyin. Saklanan değerleri project ve question. Sağlanan referans, gereksinimi keşfetmek zorunda olduğunuz yer değil, kendi denemenizden sonra açılacak karşılaştırmadır.

Konu başına bir denetimli kayıt oluşturun ve asistan yardımıyla other adlı desteklenmeyen konuyu deneyin. feedback tablosunu ziyaretçilere kapalı tutarak iki kaydedilmiş değeri ve reddi doğrulayın.

Somut bir örnek

İzinli iki konu ekleyin: Project ve Question. Seçilen her değer mesajın yanında saklanmalı. Other bir reddetme testi; dolayısıyla güzel bir seçici tek başına depolama değişikliğini tamamlamaz.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Ödeviniz: doğrulanan bir konu alanı saklayın

Tarayıcı izinlerini açmadan tabloyu ve sunucuyu birlikte genişletin.

Yalnızca project veya question kabul eden topic sütunu ekleyin. Sunucu izin verilen değerleri kontrol edip kaydedeceği nesneyi açıkça oluştursun. Forma da karşılık gelen seçim alanını ekleyin.

İzin verilen her konu için kayıt oluşturup desteklenmeyen değeri reddedin. ID ve tarih/saat üretimi veritabanında kalsın.

Bu alıştırmada DEFAULT, mevcut satırlara question değerini atar. Tabloda önceden satır varsa bir değer veya varsayılan belirlemeden NOT NULL sütunu eklemek başarısız olabilir. Gerçek bir veritabanı şeması değişikliğinde (migration), eski satırları hangi değerle dolduracağınızı mevcut verilere göre seçin; bu örnekteki varsayılanı düşünmeden kopyalamayın.

Çözülmüş örnek

Veritabanı kısıtı sunucu doğrulamasını destekler. Açık hata mesajları ve veri doğruluğunda birinin rolü diğerinin yerini tutmaz.

Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.

-- Existing rows need a value when the new column is NOT NULL.
alter table public.feedback add column topic text not null default 'question';
alter table public.feedback add constraint feedback_topic_allowed
 check (topic in ('project','question'));

Extra implementation exercise

Konu alanını ekleyip doğru verinin kalıcı olduğunu, yanlışın reddedildiğini gösterin.

Çözülmüş örneği göster

Konu eklerken üç katman uyuşmalı: tarayıcı select alanı, sunucunun izin listesi ve veritabanı sütunu/kısıtı. Referans ALTER TABLE, kısıtı uygulamadan önce belgelenen varsayılan konuyu atayarak mevcut satırları ele alır.

Sunucu yalnızca {message,topic} yazar. Desteklenmeyen konuyu gizli veritabanı anahtarını kullanmadan reddetmelidir. İstemcinin ID/tablo adlarını yok saymalı; sağlayıcıda yazma başarısızsa hata bildirmelidir.

Kaydedilen tam mesaj ve konuyu tarayıcı başarı paragrafında değil Supabase Table Editor içinde inceleyin. Tarayıcıyı yenileyip veya kapatıp aynı kaydı doğrulayın. Kendi hesabınızın araçlarını kullanın; sorun aramak için anonim okumayı açmayın.

  • Konu kontrolü hem sunucuda hem veritabanında vardır.
  • Geçerli satırlar kalır; desteklenmeyen değer yeni satır oluşturmaz.

Ders işine yaradı mı?

Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.

Öğrenmeye devam edin

Diğer dersleri inceleyin