Bu hızlı başlangıç kılavuzunda şunları öğreneceksiniz:
- Firebase Data Connect'i Firebase projenize ekleyin.
- Visual Studio dahil bir geliştirme ortamı kurma Bir üretim örneğiyle çalışacak kod uzantısı.
- Daha sonra, size aşağıdakilerin nasıl yapılacağını göstereceğiz:
- Bir e-posta uygulaması için şema oluşturun ve üretime dağıtın.
- Şemanız için sorgular ve dönüşümleri tanımlayın.
- Nihai prototipinizi üretime dağıtın.
Ön koşullar
Bu hızlı başlangıç kılavuzunu kullanmak için aşağıdakilere ihtiyacınız vardır.
- Linux, macOS veya Windows
- Visual Studio Code
Firebase projenize bağlanın
- Henüz oluşturmadıysanız bir Firebase projesi oluşturun.
- Firebase konsolunda şu simgeyi tıklayın: Proje ekleyin, ardından ekrandaki talimatları uygulayın.
Projenizi Blaze planına yükseltin. Bu sayede Cloud SQL, örneğidir.
Firebase konsolunun Data Connect bölümüne gidin ürün kurulumu iş akışını takip edebilir.
PostgreSQL için Cloud SQL veritabanınız için bir konum seçin.
Daha sonra onaylamak için proje, hizmet ve veritabanı adlarını ve kimliklerini not edin.
Kalan kurulum akışını takip edip Bitti'yi tıklayın.
Bir geliştirme ortamı seçme ve kurma
Data Connect, prototip oluşturma için iki geliştirme deneyimini destekler:
- Kotlin Android veya web geliştiricisiyseniz VS Code'u kullanabilirsiniz. bir yandan yerel olarak çalışırken şemaları ve işlemleri yerel olarak prototipini PostgreSQL için Cloud SQL örneğiniz olabilir.
- Web geliştiricisiyseniz prototip oluşturmak için IDX Geliştirme'yi kullanabilirsiniz PostgreSQL ile önceden yapılandırılmış bir IDX şablonu kullanarak IDX çalışma alanında Data Connect emülatörü ve hızlı başlangıç kodu ile VS Code uzantısı hesaplayabilirsiniz. Şurada daha fazla bilgi bulabilirsiniz: Project IDX sitesi.
Bu hızlı başlangıç kılavuzu, VS Code uzantısı geliştirme akışına odaklanır. Devam etmek için:
- Yerel projeniz için yeni bir dizin oluşturun.
- Yeni dizinde VS Code'u açın.
VSIX paketi olarak verilen uzantıyı Firebase Storage'dan indirin.
VS Code'da Görünüm menüsünden Uzantılar'ı seçin.
Uzantılar panelinin başlık çubuğunda menü simgesini tıklayın. more_horiz, ardından takip edin VSIX'ten yükle....
İsteğe bağlı olarak, yerel geliştirme için yerel PostgreSQL veritabanı yükleyebilirsiniz . Bu kurulum, eğitimin sonunda, inceleyebilirsiniz.
Yerel projenizi oluşturun
Normal talimatları uygulayarak KSA'yı yükleyin. npm'niz varsa yüklüyse aşağıdaki komutu çalıştırın:
npm install -g firebase-tools
Proje dizininizi oluşturun
Yerel projenizi ayarlamak için proje dizininizi başlatın.
VS Code'un sol panelindeki Firebase simgesini tıklayarak Firebase VS'yi açın Kod uzantısı kullanıcı arayüzü.
Firebase uzantısı kullanıcı arayüzünde:
- Oturum açtığınızdan emin olun.
- Run firebase init (firebase init çalıştır) düğmesini tıklayın.
- İstemler için VS Code alt panelindeki Terminal sekmesini kontrol edin.
- Bu dizinde kullanılacak bir özellik olarak Data Connect 'i seçin.
- İstendiğinde Daha önce konsolda oluşturduğunuz Data Connect projesi.
Şema oluşturma
Firebase proje dizininizdeki /dataconnect/schema/schema.gql
dosyasında, kullanıcıları ve e-postaları içeren bir GraphQL şeması tanımlamaya başlayın.
Kullanıcı
Data Connect'te GraphQL alanları sütunlarla eşlenir. Kullanıcıların,
uid
, name
ve address
adresine e-posta gönderin. Data Connect birkaç tane tanır
temel veri türleri: String
ve Date
.
Aşağıdaki snippet'i kopyalayın veya dosyadaki ilgili satırların açıklamasını kaldırın.
# File `/dataconnect/schema/schema.gql`
type User @table(key: "uid") {
uid: String!
name: String!
address: String!
}
UUID id
anahtarı yoksa Firebase Data Connect, varsayılan olarak bir UUID ekler
sağlar. Ancak, bu durumda uid
öğemin birincil anahtar olmasını istersiniz.
bunu @table(key: "uid")
yönergesiyle yapabilirsiniz.
E-posta
Artık kullanıcılarınız olduğuna göre e-postaları modelleyebilirsiniz. Burada, gireceğiniz alanları (veya sütunları). Bu kez birincil anahtar dahil değildir çünkü yönetmesi için Data Connect'e güvenebilirsiniz.
# File `/dataconnect/schema/schema.gql`
type Email @table {
subject: String!
sent: Date!
text: String!
from: User!
}
from
alanının bir User
türüyle eşlendiğine dikkat edin.
Data Connect, bunun Email
arasında bir ilişki olduğunu anlıyor
ve User
, bu ilişkiyi sizin adınıza yönetecek.
Şemanızı üretime dağıtma
devam etmeden önce şemanızı dağıtmanız gerekir. Şu tarihten sonra: şemanızı üretim veritabanınıza dağıttığınızda, yeni bir görebilirsiniz.
- Dağıtım için Firebase VS Code uzantısını kullanabilirsiniz.
- Uzantı kullanıcı arayüzünde, Firebase Data Connect panelinin altındaki Dağıtma.
- Şema değişikliklerini incelemeniz ve zararlı olabilecek öğeleri onaylamanız gerekebilir
kabul edersiniz. Şunları yapmanız istenir:
firebase dataconnect:sql:diff
kullanarak şema değişikliklerini inceleme- İstediğiniz değişiklikleri elde ettiğinizde,
firebase dataconnect:sql:migrate
Tablolarınıza veri ekleme
VS Code editor panelinde CodeLens düğmelerini görebilirsiniz.
/dataconnect/schema/schema.gql
aralığındaki grafikQL türleri. Dağıtım işlemini gerçekleştirdiğiniz için
Veri ekle ve Çalıştır (Üretim) seçeneklerini kullanabilirsiniz.
düğmeleri de arka uçta veritabanınıza veri ekler.
User
ve Email
tablolarına kayıt eklemek için:
schema.gql
ürünündeUser
türünün üzerindeki Veri ekle düğmesini tıklayın. beyan.
- Oluşturulan
User_insert.gql
dosyasında, kullanabilirsiniz. - Çalıştır (Üretim) düğmesini tıklayın.
- Aşağıdaki adımları tekrarlayarak
Email
tablosuna kayıt ekleyin: Oluşturulanuid
fromUid
Email_insert
mutasyonu.
Sorgunuzu tanımlayın
Şimdi sıra işin eğlenceli kısmına, sorgulara. Geliştirici olarak, SQL yazmaya alışkınsınız sorguları yerine bu isteği kullanabilirsiniz. Bu nedenle, başlangıçta biraz farklı görünebilir. Bununla birlikte, GraphQL ham SQL'den çok daha kısa ve tür açısından güvenlidir. VS Kodumuz uzantı, geliştirme deneyimini kolaylaştırır.
/dataconnect/default-connector/queries.gql
dosyasını düzenlemeye başlayın. Şunu istiyorsanız:
tüm e-postaları almak için bunun gibi bir sorgu kullanın.
# File `/dataconnect/default-connector/queries.gql`
query ListEmails @auth(level: NO_ACCESS) {
emails {
id, subject, text, sent
from {
name
}
}
}
Yakındaki CodeLens düğmesini kullanarak sorguyu yürütün.
Burada gerçekten heyecan verici bir özellik; veritabanının
grafikler gibidir. Bir E-posta’dafrom
Kullanıcı, alanı iç içe yerleştirebilir ve kullanıcıyla ilgili bilgileri geri alabilirsiniz.
Şemanızı ve sorgunuzu üretime dağıtma
Bir geliştirme iterasyonu ile çalıştınız. Artık Firebase aracılığıyla sunucuya şema, veri ve sorguları uzantı kullanıcı arayüzünü veya Firebase CLI'yı, şemanızda yaptığınız gibi.
Dağıtım için Firebase VS Code uzantısını kullanıyorsanız Tümünü dağıt'ı düğmesini tıklayın.
Dağıtımdan sonra işlemlerinizi konsolda görüntüleyip çalıştırabilirsiniz. de faydalı olabilir. Data Connect hizmetiniz, işlemleri işlemeye hazır olur yardımcı olur. PostgreSQL İçin Cloud SQL örneği, oluşturulan şema ve verilerin son hâlini içerir.
(İsteğe bağlı) PostgreSQL'i yerel olarak yükleme
PostgreSQL'i yerel olarak yükleyip emülatörle entegre ederek tamamen yerel bir geliştirme ortamında prototip oluşturmaktır.
Yeni bir PostgreSQL örneği yükleyebilir veya mevcut bir örneği kullanabilirsiniz.
PostgreSQL'i yükleme
Platformunuz için talimatları uygulayarak PostgreSQL sürüm 15.x'i yükleyin.
- macOS için Google Haritalar'ı tıklayın. Postgres.app'i indirip yükleyin.
- Windows: PostgreSQL indirmeleri sayfasındaki EDB yükleyiciyi kullanın.
- Docker: Şunu çekip çalıştırın:
pgvector/pgvector:15
resim, ve vektör desteği içeriyor. - Linux: Docker'ı önceki görüntüyle kullanmanızı öneririz ancak isterseniz popüler dağıtımlar için alternatif talimatları uygulayın.
sırasında ana makine adı, bağlantı noktası, kullanıcı adı, şifre ve ilgili parametreler çıkışını not edin adımlarına göz atın.
PostgreSQL örneğinize bağlanmak için emülatör aşağıdakilere ihtiyaç duyar:
- Bu kurulum yapılandırma parametreleri
dataconnect.yaml
içinde yer alan veritabanı adı ve buna karşılık gelen bir ad veritabanı ilk kullanıma hazırlanır.
Yerel PostgreSQL örneğinizi kullanma
Mevcut bir yerel PostgreSQL örneğini kullanarak Data Connect emülatörü ayarları.
firebase setup:emulators:dataconnect
İstendiğinde PostgreSQL bağlantı dizesini şu biçimde girin:
postgresql://postgresusername:postgrespassword@localhost:5432/postgresdatabase?sslmode=disable
Bağlantı dizesi hakkında daha fazla bilgi için PostgreSQL belgeleri.
Yerel PostgreSQL örneğinize bağlanın
Bu yapılandırmayı tamamladıktan sonra yerel veritabanınıza bağlanmak için:
- VS Code'da soldaki panelde Firebase simgesini tıklayarak Firebase VS Code uzantısı kullanıcı arayüzü.
- Connect to Local PostgreSQL (Yerel PostgreSQL'e Bağlan) düğmesini tıklayın.