Firebase Data Connect'i kullanmaya başlama

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

1. Henüz oluşturmadıysanız bir Firebase projesi oluşturun.
   1. Firebase konsolunda şu simgeyi tıklayın: Proje ekleyin, ardından ekrandaki talimatları uygulayın.

2. Projenizi Blaze planına yükseltin. Bu sayede Cloud SQL, örneğidir.

3. Firebase konsolunun Data Connect bölümüne gidin ürün kurulumu iş akışını takip edebilir.

4. PostgreSQL için Cloud SQL veritabanınız için bir konum seçin.

5. Daha sonra onaylamak için proje, hizmet ve veritabanı adlarını ve kimliklerini not edin.

6. 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:

1. Yerel projeniz için yeni bir dizin oluşturun.
2. Yeni dizinde VS Code'u açın.

3. VSIX paketi olarak verilen uzantıyı Firebase Storage'dan indirin.

4. VS Code'da Görünüm menüsünden Uzantılar'ı seçin.

5. 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:

1. Oturum açtığınızdan emin olun.
2. Run firebase init (firebase init çalıştır) düğmesini tıklayın.
3. İstemler için VS Code alt panelindeki Terminal sekmesini kontrol edin.
4. Bu dizinde kullanılacak bir özellik olarak Data Connect 'i seçin.
5. İ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.

1. 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.
2. Ş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:

1. schema.gql ürününde User türünün üzerindeki Veri ekle düğmesini tıklayın. beyan.
   
2. Oluşturulan User_insert.gql dosyasında, kullanabilirsiniz.
3. Çalıştır (Üretim) düğmesini tıklayın.
   
4. Aşağıdaki adımları tekrarlayarak Email tablosuna kayıt ekleyin: OluşturulanuidfromUid 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:

1. VS Code'da soldaki panelde Firebase simgesini tıklayarak Firebase VS Code uzantısı kullanıcı arayüzü.
2. Connect to Local PostgreSQL (Yerel PostgreSQL'e Bağlan) düğmesini tıklayın.

Sonraki adımlar