Adicionar campos (etapa de transformação)
Descrição
Adicione novos campos aos documentos produzidos na etapa anterior.
Os documentos gerados vão conter todos os campos da etapa anterior, além de todos os campos recém-adicionados, substituindo qualquer campo que compartilhe o mesmo nome do documento anterior. A etapa add_fields(...) permite atualizar
campos aninhados especificando um nome de campo aninhado como alias.
Exemplos
Web
const result = await execute(db.pipeline() .collection("books") .select(field("soldBooks").add(field("unsoldBooks")).as("totalBooks")) );
Swift
let result = try await db.pipeline() .collection("books") .select([Field("soldBooks").add(Field("unsoldBooks")).as("totalBooks")]) .execute()
Kotlin
Android
val result = db.pipeline() .collection("books") .select(Expression.add(field("soldBooks"), field("unsoldBooks")).alias("totalBooks")) .execute()
Java
Android
Task<Pipeline.Snapshot> result = db.pipeline() .collection("books") .select(Expression.add(field("soldBooks"), field("unsoldBooks")).alias("totalBooks")) .execute();
Python
from google.cloud.firestore_v1.pipeline_expressions import Field result = ( client.pipeline() .collection("books") .select(Field.of("soldBooks").add(Field.of("unsoldBooks")).as_("totalBooks")) .execute() )
Java
Pipeline.Snapshot result = firestore .pipeline() .collection("books") .select(add(field("soldBooks"), field("unsoldBooks")).as("totalBooks")) .execute() .get();
Go
snapshot := client.Pipeline(). Collection("books"). Select(firestore.Fields( firestore.Add(firestore.FieldOf("soldBooks"), firestore.FieldOf("unsoldBooks")).As("totalBooks"), )). Execute(ctx)
Comportamento
Campos sobrepostos
Atribuir a uma expressão um alias que já está nos documentos da etapa anterior faz com que a etapa add_fields(...) substitua o campo anterior. Isso pode ser usado para encadear várias expressões no mesmo nome de campo, como:
Node.js
const results = await db.pipeline()
.collection("/users")
.addFields(field('age').abs().as('age'))
.addFields(field('age').add(10).as('age'))
.execute();
Campos aninhados
Os campos aninhados (por exemplo, aqueles com sintaxe .) podem ser atualizados como parte dessa
etapa. Isso permite atualizar um campo "no local", como em:
Node.js
const results = await db.pipeline()
.collection("/users")
.addFields(field('address.city').toLower().as('address.city'))
.execute();
Atribuir uma expressão a um campo aninhado também cria implicitamente os campos principais ausentes.