Firebase Data Connect'te toplu veri işlemleri mutasyonlar kullanılarak gerçekleştirilir. Data Connect projeleriniz verileri PostgreSQL'de depolasa da SQL ifadeleri veya SQL araçlarını kullanarak verileri toplu olarak yükleyemezsiniz: Data Connect hizmetiniz ve şemalarınız veritabanınızla senkronize kalmalıdır ve doğrudan PostgreSQL'de çalışmak bu senkronizasyonu bozar.
Bu nedenle Data Connect, başlangıç verileri ve toplu veri yönetimi için standart _insertMany, _upsertMany ve _deleteMany mutasyonları sağlar.
Uygulama prototipleri oluştururken ve CI/CD akışları çalıştırırken bu mutasyonlar, VS Code uzantısı, Data Connect emülatörü ve (isteğe bağlı olarak) yerel bir veritabanı örneği kullanılarak yerel bir geliştirme ortamında çağrılabilir.
Yerel ve üretim örneklerine veri ekleme
Başlangıç kılavuzunda, anlık ekleme mutasyonu kullanarak tek bir tabloya tek bir kayıt eklemek için bir uygulama oluşturdunuz.
Film yorumu uygulamasının kullanılabilir olması için film, yorum ve kullanıcı verileri gerekir. Bu veriler, gerçekçi veriler içeren birden fazla tabloda birleştirme ve diğer işlemleri kullanan sorgu ve mutasyon prototipleri oluşturmak için kullanılır. Şemanızı genişletebilir ve veritabanınızı doldurabilirsiniz.
birini inceleyerek erişebilirsiniz.Prototipleme ortamınızda, veri ekleme işlemini gerçekleştirmek için kod gerekir. Bu kılavuzda, aşağıdakileri gösteren bazı örnekler verilmiştir:
- Ayrı tablolarda
_insertManyve_upsertManykullanımı - İlgili tablolarda
_insertManykullanımı
Film yorumu uygulaması şemasını güncelleme
Veritabanı tablolarını tek tek güncellemek veya birleştirme ilişkilerine göre ilişkili birden fazla tabloyu güncellemek için _insertMany ve _upsertMany mutasyonlarını kullanabilirsiniz. Bu kullanım alanlarını ve örnekleri açıklamaya yardımcı olacak genişletilmiş film yorumu uygulaması şeması aşağıda verilmiştir. schema.gql, daha karmaşık sorguların prototipini oluşturabilmemiz için Actor ve MovieActor türlerini içerecek şekilde başlangıç Movie türünün ötesine geçer.
# Actors
# Suppose an actor can participate in multiple movies and movies can have multiple actors
# Movie - Actors (or vice versa) is a many to many relationship
type Actor @table {
id: UUID!
imageUrl: String!
name: String! @col(name: "name", dataType: "varchar(30)")
}
# Join table for many-to-many relationship for movies and actors
# The 'key' param signifies the primary key(s) of this table
# In this case, the keys are [movieId, actorId], the generated fields of the reference types [movie, actor]
type MovieActor @table(key: ["movie", "actor"]) {
# @ref creates a field in the current table (MovieActor) that holds the primary key of the referenced type
# In this case, @ref(fields: "movieId", references: "id") is implied
movie: Movie!
# movieId: UUID! <- this is created by the implied @ref
actor: Actor!
# actorId: UUID! <- this is created by the implied @ref
role: String! # "main" or "supporting"
}
Sıfır durum verilerini oluşturmak için mutasyonları yazma
Prototipleme sırasında, sorgularınızın ve mutasyonlarınızın bir dizi ayrı değerle test edilmesi gerektiğinde verileri birden fazla kayıtla doldurabilirsiniz. Örneğin, karşılaştırma ve filtrelemeyi test etmek için farklı türde tür ve derecelendirmelere sahip birden fazla film kaydı ekleyebilirsiniz.
Movie ve Actor tablolarına veri çek
Prototip aşamanıza bağlı olarak, bir veya iki kayıt eklemek için Başlangıç kılavuzunda açıklanan aynı tekniği kullanabilirsiniz. Yani, _insert mutasyonlar oluşturmak, verileri sabit kodlamak ve bu mutasyonları VS Code'da çalıştırmak için VS Code uzantısındaki Kod Lensleri'ni kullanabilirsiniz.
Sonuç olarak, bir tabloya _insertMany işlemi kullanarak çok sayıda kayıt eklemek daha mantıklı olacaktır. Film yorumu uygulaması örneğinde, Movie ve Actor bölümlerine bir başlangıç veri kümesi eklenir.
Aşağıdaki mutasyonları yürütmek için VS Code Firebase uzantısını kullanarak, uygun dosya düzenleyici görünümünde, üretim hizmetinizle mi yoksa yerel bir veritabanıyla mı prototip oluşturduğunuza bağlı olarak Çalıştır (Üretim) veya Çalıştır (Yerel) CodeLens düğmelerini tıklayın.
# insertMany for Movie
# 2 records shown
mutation {
movie_insertMany(data: [
{
id: "550e8400-e29b-41d4-a716-446655440000",
title: "Inception",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Finception.jpg?alt=media&token=07b09781-b302-4623-a5c3-1956d0143168",
genre: "sci-fi",
},
{
id: "550e8400-e29b-41d4-a716-446655440001",
title: "The Matrix",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Fthe_matrix.jpg?alt=media&token=4975645d-fef8-409e-84a5-bcc1046e2059",
genre: "action",
}
])
}
# insertMany for Actor
# 2 records shown
mutation {
actor_insertMany(data: [
{
id: "123e4567-e89b-12d3-a456-426614174000",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/actors%2Fdicaprio.jpeg?alt=media&token=452e030a-efa5-4ef4-bb81-502b23241316",
name: "Leonardo DiCaprio"
},
{
id: "123e4567-e89b-12d3-a456-426614174001",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/actors%2Fkeanu.jpg?alt=media&token=6056520c-ef3e-4823-aad0-108aab163115",
name: "Keanu Reeves"
}
])
}
MovieActor birleştirme tablosuna veri ekleme
Sorguları ve mutasyonları birleştirme ve diğer karmaşık işlemleri kullanarak test etmek için MovieActor tablosuna birden fazla kayıt ekleyebilirsiniz.
Bu tür bir ilişkide birden fazla tabloyu güncellerken güncellemenin düzgün şekilde tamamlanmasını sağlamak için @transaction yönergesini ekleyebilirsiniz.
mutation @transaction {
movie_insertMany(data: [
{
id: "550e8400-e29b-41d4-a716-446655440000",
title: "Inception",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Finception.jpg?alt=media&token=07b09781-b302-4623-a5c3-1956d0143168",
genre: "sci-fi",
},
{
id: "550e8400-e29b-41d4-a716-446655440001",
title: "The Matrix",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Fthe_matrix.jpg?alt=media&token=4975645d-fef8-409e-84a5-bcc1046e2059",
genre: "action",
}
])
actor_insertMany(data: [
{
id: "123e4567-e89b-12d3-a456-426614174000",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/actors%2Fdicaprio.jpeg?alt=media&token=452e030a-efa5-4ef4-bb81-502b23241316",
name: "Leonardo DiCaprio"
},
{
id: "123e4567-e89b-12d3-a456-426614174001",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/actors%2Fkeanu.jpg?alt=media&token=6056520c-ef3e-4823-aad0-108aab163115",
name: "Keanu Reeves"
}
])
}
Tohum verilerini sıfırlamak için bir mutasyon yazın
Prototip oluştururken ve CI/CD'yi gerçekleştirirken yeni bir veri kümesinde yeni bir test dizisi yürütmek için verileri sıfır durumuna sıfırlamak yararlı olabilir.
Bunu yapmak için prototip kodunuz tablolarınıza kayıt eklemiyorsa Data Connect tarafından sağlanan _upsertMany değişikliğini kullanın.
Aşağıdaki örnekte, film kayıtlarını orijinal durumlarına güncellemek için movie_upsertMany ilk değerlerle çağrılır.
mutation {
# Execute an upsertMany operation to update the Movie table
movie_upsertMany(data: [
{
id: "550e8400-e29b-41d4-a716-446655440000",
title: "Inception",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Finception.jpg?alt=media&token=07b09781-b302-4623-a5c3-1956d0143168",
genre: "sci-fi",
},
{
id: "550e8400-e29b-41d4-a716-446655440001",
title: "The Matrix",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Fthe_matrix.jpg?alt=media&token=4975645d-fef8-409e-84a5-bcc1046e2059",
genre: "action",
}
…
}
Sırada ne var?
- Admin SDK'u Data Connect projelerinize entegre etme hakkında bilgi edinin.