Firebase Data Connect'i kullanmaya başlama

Bu hızlı başlangıç kılavuzunda, uygulamanızda Firebase Data Connect'i nasıl oluşturacağınızı öğreneceksiniz.

  • Firebase projenize Firebase Data Connect 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:
    • Film yorumu uygulaması için bir şema oluşturun ve üretime dağıtın.
    • Şemanız için sorgular ve mutasyonlar tanımlayın.
    • Güçlü şekilde yazılmış SDK'lar oluşturun ve bunları uygulamanızda kullanın
    • Nihai şemanızı, sorgunuzu ve verilerinizi üretime dağıtın.

Ön koşullar

Bu hızlı başlangıç kılavuzunu yerel ortamınızda kullanmak için aşağıdakilere ihtiyacınız vardır.

Firebase projenize bağlanın

  1. Henüz oluşturmadıysanız bir Firebase projesi oluşturun.
    1. Firebase konsolunda Proje ekle'yi tıklayın ve ekrandaki talimatları uygulayın.
  2. Firebase konsolunun Data Connect bölümüne gidin ve ürün kurulum iş akışını uygulayın.
  3. Projenizi Blaze planına yükseltin. Bu sayede Cloud SQL, örneğidir.

  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ı uygulayıp Bitti'yi tıklayın.

Bir geliştirme ortamı seçme ve kurma

Data Connect, uygulama geliştirme için iki geliştirme deneyimini destekler:

  • Kotlin Android, iOS, Flutter veya web geliştiricisiyseniz Şemalar ve işlemler tasarlayıp test etmek için VS Code geliştirmeyi kullanabilirsiniz yerel olarak oluşturabilirsiniz.
  • 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ıç istemcisi içeren VS Code uzantısı sizin yerinize ayarlamalıdır. Ş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. Visual Studio Code Marketplace'ten Firebase Data Connect uzantısını yükleyin.

Yerel projenizi oluşturma

Normal talimatları uygulayarak CLI'yi yükleyin. npm zaten 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.

Firebase VS Code uzantısı kullanıcı arayüzünü açmak için VS Code'un sol panelindeki Firebase simgesini tıklayın.

  1. Google ile oturum aç düğmesini tıklayın.
  2. Firebase projesi bağlayın düğmesini tıklayın ve oluşturduğunuz projeyi seçin oluşturabilirsiniz.
  3. Run firebase init (firebase init çalıştır) düğmesini tıklayın.
  4. Projeniz Blaze planındaysa "Arka uç kaynaklarınızı hemen yapılandırmak ister misiniz?" sorusunu "Evet" olarak yanıtlayın.
  5. Emülatörleri başlat düğmesini tıklayın.

Şema oluşturma

Firebase proje dizininizdeki /dataconnect/schema/schema.gql dosyasında, filmleri içeren bir GraphQL şeması tanımlamaya başlayın.

Film

Data Connect'te GraphQL alanları sütunlarla eşlenir. Movie türünde id, title, imageUrl ve genre var. Data Connect. String ve UUID temel veri türlerini tanır.

Aşağıdaki snippet'i kopyalayın veya dosyadaki ilgili satırların açıklamasını kaldırın.

# File `/dataconnect/schema/schema.gql`

# By default, a UUID id key will be created by default as primary key.
type Movie @table {
  id: UUID! @default(expr: "uuidV4()")
  title: String!
  imageUrl: String!
  genre: String
}

FilmMeta Verileri

Filmleriniz olduğunda film meta verilerini modelleyebilirsiniz.

Aşağıdaki snippet'i kopyalayın veya dosyada ilgili satırların yorumunu kaldırın.

# Movie - MovieMetadata is a one-to-one relationship
type MovieMetadata @table {
  # This time, we omit adding a primary key because
  # you can rely on Data Connect to manage it.

  # @unique indicates a 1-1 relationship
  movie: Movie! @unique
  # movieId: UUID <- this is created by the above reference
  rating: Float
  releaseYear: Int
  description: String
}

movie alanının bir Movie türüyle eşlendiğine dikkat edin. Data Connect, bunun Movie ile MovieMetadata arasındaki bir ilişki olduğunu anlıyor ve bu ilişkiyi sizin için yönetecektir.

Dokümanlardan Data Connect şemaları hakkında daha fazla bilgi edinebilirsiniz.

Şemanızı üretime dağıtma

Üretim veritabanınızla çalışmak için Firebase VS Code uzantısını kullanıyorsanız 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ğıtmak için Data Connect VS Code uzantısını kullanabilirsiniz.
    • Uzantı kullanıcı arayüzünde, Firebase Data Connect panelinin altındaki Üretime dağıtma.
  2. Şema değişikliklerini incelemeniz ve yıkıcı olabilecek değişiklikleri onaylamanız gerekebilir. Sizden şunlar istenir:
    • firebase dataconnect:sql:diff kullanarak şema değişikliklerini inceleme
    • Değişikliklerden memnun kaldığınızda firebase dataconnect:sql:migrate tarafından başlatılan akışı kullanarak değişiklikleri uygulayın.

Tablolarınıza veri ekleme

VS Code editor panelinde CodeLens düğmelerini görebilirsiniz. /dataconnect/schema/schema.gql aralığındaki grafikQL türleri. Şemanızı üretime dağıttığınız için arka uçtaki veritabanınıza veri eklemek için Veri ekle ve Çalıştır (Üretim) düğmelerini kullanabilirsiniz.

Movie tablosuna kayıt eklemek için:

  1. schema.gql ürününde Movie türünün üzerindeki Veri ekle düğmesini tıklayın. beyan.
    Firebase Data Connect için Code Lens Veri ekle düğmesi
  2. Oluşturulan Movie_insert.gql dosyasında, dört alan için verileri sabit kodlayın.
  3. Çalıştır (Üretim) düğmesini tıklayın.
    Firebase Data Connect için Code Lens Çalıştır düğmesi

Verilerin eklendiğini hızlıca doğrulamak için:

  1. schema.gql ürününde Verileri oku düğmesini tıklayın.
  2. Oluşturulan Movie_read.gql dosyasında, Run (Production) (Çalıştır (Üretim)) öğesini tıklayın. düğmesini tıklayın.

Veri Bağlantısı mutasyonları hakkında daha fazla bilgiyi dokümanda bulabilirsiniz.

Sorgunuzu tanımlayın

Şimdi sıra işin eğlenceli kısmına, sorgulara. Geliştirici olarak GraphQL sorguları yerine SQL sorguları yazmaya alışkın olduğunuzdan bu durum başlangıçta biraz farklı gelebilir. Ancak GraphQL, ham SQL'den çok daha kısa ve tür açısından güvenlidir. VS Code uzantımız da geliştirme deneyimini kolaylaştırır.

/dataconnect/connector/queries.gql dosyasını düzenlemeye başlayın. Tüm filmleri almak istiyorsanız aşağıdaki gibi bir sorgu kullanın.

# File `/dataconnect/connector/queries.gql`

# @auth() directives control who can call each operation.
# Anyone should be able to list all movies, so the auth level
# is set to PUBLIC
query ListMovies @auth(level: PUBLIC) {
  movies {
    id
    title
    imageUrl
    genre
  }
}

Yakındaki CodeLens düğmesini kullanarak sorguyu yürütün.

Veri Bağlantısı sorguları hakkında daha fazla bilgiyi dokümanda bulabilirsiniz.

SDK'lar oluşturun ve bunları uygulamanızda kullanın

  1. SDK'yı uygulamaya ekle düğmesini tıklayın.
  2. Açılan iletişim kutusunda, uygulamanızın kodunu içeren bir dizin seçin. Data Connect. SDK kodu oluşturulacak ve kaydedilmektedir.

  3. Uygulama platformunuzu seçin, ardından SDK kodunun seçtiğiniz dizinde hemen oluşturulduğunu unutmayın.

İstemciden sorgu ve mutasyon çağırmak için oluşturulan SDK'nın nasıl kullanılacağını öğrenin. uygulamaları (web, Android, iOS, Flutter).

Ş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ı gibi, uzantı kullanıcı arayüzünü veya Firebase KSA'yı da kullanabilirsiniz.

Dağıtım için Firebase VS Code uzantısını kullanıyorsanız Üretime dağıt düğmesini tıklayın.

Dağıtıldıktan sonra şemanın, işlemlerin ve verilerin buluta yüklendiğini doğrulamak için Firebase konsoluna gidin. Şemayı görüntüleyebilir ve işlemlerinizi konsolda da çalıştırabilirsiniz. PostgreSQL için Cloud SQL örneği, oluşturulan nihai dağıtılmış şemasıyla ve verileriyle güncellenir.

Veri Bağlantısı emülatörünü kullanma hakkında daha fazla bilgiyi dokümanda bulabilirsiniz.

Sonraki adımlar

Dağıtılan projenizi inceleyin ve daha fazla araç keşfedin:

  • Firebase konsolunda veritabanınıza veri ekleyin, şemalarınızı inceleyip değiştirin ve Data Connect hizmetinizi izleyin. Dokümanlar bölümünden daha fazla bilgi edinebilirsiniz. Örneğin, hızlı başlangıç kılavuzunu tamamladığınız için:

  • Şema, sorgu ve mutasyon geliştirme hakkında daha fazla bilgi edinin.

  • Web, Android, iOS ve Flutter için istemci SDK'ları oluşturma ve istemci kodundan sorgu ve mutasyon çağırma hakkında bilgi edinin.