Zamień na

Opis

Zastępuje pola w istniejącym dokumencie polami w danym wyrażeniu.

Wyrażenie może być mapą literałów lub wyrażeniem, które daje w wyniku mapę. Jeśli dane wyrażenie nie daje w wyniku mapy, ten etap zwraca błąd.

Obsługiwane są 3 tryby:

  • full_replace: zastępuje cały dokument wynikiem danego wyrażenia, pomijając pola, które się w nim nie pojawiają.
  • merge_overwrite_existing: łączy wyrażenie z istniejącym dokumentem, zastępując wartości pól w dokumencie wartościami w wyrażeniu.
  • merge_keep_existing: łączy wyrażenie z istniejącym dokumentem, dodając tylko wartości pól, które nie istnieją w dokumencie.

Przykłady

Utwórz kolekcję cities z tymi dokumentami:

Node.js

await db.collection("cities").doc("SF").set({name: "San Francisco", population: 800000, location: {country: "USA", state: "California"}});
await db.collection("cities").doc("TO").set({name: "Toronto", population:  3000000, province: "ON", location: {country: "Canada", province: "Ontario"}});
await db.collection("cities").doc("NY").set({name: "New York", location: {country: "USA", state: "New York"}});
await db.collection("cities").cov("AT").set({name: "Atlantis", population: null});

Używanie trybu full_replace do uzyskania zmienionej wersji dokumentu

Wyodrębnij zagnieżdżone location pole, odrzucając wszystkie inne dane:

Node.js
  const names = await db.pipeline()
    .collection("/cities")
    .replace_with(Field.of("location"), "full_replace")
    .execute();
Java
Pipeline.Snapshot names =
    firestore.pipeline().collection("cities").replaceWith(field("location")).execute().get();
Go
snapshot := client.Pipeline().
	Collection("cities").
	ReplaceWith(firestore.FieldOf("location")).
	Execute(ctx)

Co daje te dokumenty:

{ country: "USA", state: "California" },
{ country: "Canada", province: "Ontario" },
{ country: "USA", state: "New York" },
{ }

Używanie trybu merge_overwrite_existing do ustawiania pól

Ustaw pole population wszystkich dokumentów na 0, zastępując istniejące wartości:

Node.js
  const censoredResults = await db.pipeline()
    .collection("/cities")
    .replace_with(map("population", 0), "merge_overwrite_existing")
    .execute();

Co daje te dokumenty:

{name: "San Francisco", population: 0, location: {country: "USA", state: "California"}},
{name: "Toronto", population: 0, province: "ON", location: {country: "Canada", province: "Ontario"}},
{name: "New York", population: 0, location: {country: "USA", state: "New York"}},
{name: "Atlantis", population: 0}

Używanie trybu merge_keep_existing do dodawania wartości domyślnej

Ustawianie wartości domyślnej dla location, gdy nie występuje ona w dokumencie:

Node.js
  const defaultedResults = await db.pipeline()
    .collection("/cities")
    .replace_with(map("location", "unknown"), "merge_keep_existing")
    .execute();

Co daje te dokumenty:

{ name: "San Francisco", population: 800000, location: { country: "USA", state: "California" } },
{ name: "Toronto", province: "ON", population: 3000000, location: { country: "Canada", province: "Ontario" } },
{ name: "New York", location: { country: "USA", state: "New York" } },
{ name: "Atlantis", population: null, location: "unknown" }