Firebase Data Connect'i kullanmaya başlama

Not: Firebase Data Connect, herkese açık önizleme sürümündedir. Data Connect, Google Cloud Platform Hizmet Şartları'nın Hizmete Özel Şartlar bölümündeki "GK Öncesi Teklif Şartları"na tabi olacaktır. GKST öncesi özellikler "olduğu gibi" sunulur ve sınırlı destek alabilir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

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

Not: Blaze planındaki Firebase projelerinizden birine Data Connect eklemek, Data Connect hizmeti oluşturmak ve prototip oluşturma işlemi için Cloud SQL veritabanı sağlamak istiyorsanız bu hızlı başlangıç kılavuzunu uygulayın. Spark planını kullanmak ve bir emülatör ile yerel veritabanı kullanarak yerel olarak prototip oluşturmak istiyorsanız yerel geliştirmeye başlama bölümünü deneyin.

• Firebase Data Connect dosyasını Firebase projenize ekleyin.
• Üretim örneğiyle çalışmak için Visual Studio Code uzantısı içeren bir geliştirme ortamı oluşturun.
• Ardından aşağıdakileri nasıl yapacağınızı 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 yayayın.

Web için codelab'imizi izleyerek hızlı başlangıç uygulaması deposu bulun ve tam özellikli bir Data Connect uygulaması oluşturun. Android ve iOS için Codelabs yakında kullanıma sunulacak.

Ö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.

• Linux, macOS veya Windows
• Visual Studio Code

Firebase projenize bağlanma

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 işlem, PostgreSQL için Cloud SQL örneği oluşturmanıza olanak tanır.

   Not: Blaze yükseltmenizde faturalandırmayı ayarlasanız da önizleme sırasında Data Connect veya varsayılan PostgreSQL için Cloud SQL yapılandırmasının kullanımı için sizden ücret alınmaz.

4. PostgreSQL için CloudSQL 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.

   Not: PostgreSQL için Cloud SQL örneğinizin temel hazırlığının tamamlanması 15 dakikayı bulabilir. Veritabanı sağlama dahil olmak üzere Data Connect kurulum akışının tamamlandığını Google Cloud konsolunu kullanarak onaylayabilirsiniz.

Geliştirme ortamı seçme ve ayarlama

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

• Kotlin Android, iOS, Flutter veya web geliştiriciyseniz PostgreSQL için Cloud SQL örneğinize bağlanırken şemaları ve işlemleri yerel olarak tasarlamak ve test etmek için VS Code geliştirme özelliğini kullanabilirsiniz.
• Web geliştiricisiyseniz PostgreSQL içeren önceden yapılandırılmış bir IDX şablonu, Data Connect emülatörlü VS Code uzantısı ve sizin için ayarlanmış hızlı başlangıç istemci kodunu kullanarak IDX çalışma alanında prototip oluşturmak için IDX Geliştirme'yi kullanabilirsiniz. Daha fazla bilgiyi Project IDX sitesinde bulabilirsiniz.

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. VS Code'u yeni dizinde açın.

3. Visual Studio Code Marketplace'ten Firebase Data Connect uzantısını yükleyin.

   Not: Bu uzantı, pazar yeri GraphQL söz dizimi vurgulama uzantısını içerir. Yüklediğiniz diğer GraphQL uzantıları, Firebase Data Connect uzantısında bulunan GraphQL desteğiyle çakışabilir.

Yerel projenizi oluşturma

Not: IDX'yi kullanmıyorsanız bu bölümdeki adımları uygulayın.

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

Not: Mevcut bir CLI yüklemesi kullanıyorsanız en son sürüme güncellediğinizden emin olun.

Proje dizininizi oluşturma

Yerel projenizi oluşturmak için proje dizininizi ilk kullanıma hazırlayı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ğla düğmesini tıklayın ve daha önce konsolda oluşturduğunuz projeyi seçin.
3. Firebase init'i ç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.

   Not: Entegre Terminal'de, yapılandırılmış emülatörlerinizin başlatıldığını doğrulayın. Çalıştırdıktan sonra, uzantı kullanıcı arayüzünüzün emülatör ayrıntılarıyla güncellendiğini göreceksiniz.

Ş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 bulunur. Data Connect String ve UUID ilkel veri türlerini tanır.

Aşağıdaki snippet'i kopyalayın veya dosyada ilgili satırların yorumunu 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
}

MovieMetadata

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 Movie türüyle eşleştirildiğini unutmayın. Data Connect, bunun Movie ile MovieMetadata arasındaki bir ilişki olduğunu anlıyor ve bu ilişkiyi sizin için yönetecektir.

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

Ş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. Şemanızı üretim veritabanınıza dağıttıktan sonra şemayı konsolda görüntüleyebilirsiniz.

Not: PostgreSQL için Cloud SQL örneğinizin temel hazırlığı 15 dakika kadar sürebilir. Örnek hazır olana kadar dağıtım yapamazsınız. Şemanızı dağıtmadan önce, veritabanı sağlama dahil olmak üzere Data Connect kurulum akışının tamamlandığını Google Cloud konsolunu kullanarak onaylayın.

1. Dağıtmak için Data Connect VS Code uzantısını kullanabilirsiniz.
   • Uzantının kullanıcı arayüzünde, Firebase Data Connect panelinin altında Üretime dağıt'ı tıklayın.
2. Şema değişikliklerini incelemeniz ve zararlı 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 düzenleyici panelinde, /dataconnect/schema/schema.gql içindeki GraphQL türlerinin üzerinde CodeLens düğmelerinin göründüğünü görebilirsiniz. Şemanızı üretime dağıttığınız için arka uçtaki veritabanına veri eklemek için Veri ekle ve Çalıştır (Üretim) düğmelerini kullanabilirsiniz.

Movie tablosuna kayıt eklemek için:

1. schema.gql dosyasında, Movie tür beyanının üstündeki Veri ekle düğmesini tıklayın.
   
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.
   
4. Oluşturulan MovieMetadata_insert mutasyonunda istendiği gibi MovieMetadata tablosuna kayıt eklemek için önceki adımları tekrarlayın ve movieId alanına Filminizin id değerini girin.

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

1. schema.gql dosyasına dönüp Movie tür beyanının üzerindeki Verileri oku düğmesini tıklayın.
2. Elde edilen Movie_read.gql dosyasında, sorguyu yürütmek için Çalıştır (Üretim) düğmesini tıklayın.

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

Sorgunuzu tanımlayın

Şimdi eğlenceli kısım olan sorgulara geçelim. 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.

İpucu: Firebase konsolunda GraphQL sorguları oluşturup test etmenize yardımcı olması için Firebase'te Gemini'yi kullanabilirsiniz. Sorgular ve mutasyonlar için yapay zeka yardımını kullanma başlıklı makaleden daha fazla bilgi edinebilirsiniz.

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

SDK oluşturma ve bunları uygulamanızda kullanma

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şturulur ve bu klasöre kaydedilir.

   Not: Henüz uygulama dizininiz yoksa şimdilik SDK kodu için yeni bir dizin oluşturup seçebilir ve daha sonra uygulamanıza bağlayabilirsiniz.

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

Oluşturulan SDK'yı istemci uygulamalarından (web, Android, iOS, Flutter) sorgu ve mutasyon çağırmada nasıl kullanacağınızı öğrenin.

Şemanızı ve sorgunuzu üretime dağıtma

Bir geliştirme iterasyonunda çalıştınız. Artık şemanızı, verilerinizi ve sorgularınızı Firebase uzantısı kullanıcı arayüzü veya Firebase CLI ile sunucuya dağıtabilirsiniz.

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.