Referenz zu generischen Funktionen

Allgemeine Funktionen

Name Beschreibung
CURRENT_DOCUMENT Gibt das Dokument zurück, das gerade in der Pipeline verarbeitet wird.
CONCAT Verkettet zwei oder mehr Werte desselben Typs.
LENGTH Berechnet die Länge von String, Bytes, Array, Vector oder Map.
REVERSE Kehrt eine String-, Bytes- oder Array-Transaktion um.

CURRENT_DOCUMENT

Syntax:

current_document() -> MAP

Beschreibung:

Wird zu einer Map ausgewertet, die alle im aktuellen Bereich definierten Felder enthält. Das ist nützlich, wenn Sie mehrere Dokumente zusammenführen oder aggregieren oder die Feldnamen im Dokument dynamisch prüfen möchten.

So rufen Sie beispielsweise eine Liste von Dokumenten ab, die nach einem Feld gruppiert sind:

Node.js

const cities = await db.pipeline()
  .collection("/restaurants")
  .aggregate({
    groups: [ field("location.state").as("state") ],
    accumulators: [ arrayAgg(currentDocument().as("restaurants")) ]
   })
  .execute();

CONCAT

Syntax:

concat[T <: STRING | BYTES | ARRAY](values:T ...) -> T

Beschreibung:

Verkettet zwei oder mehr Werte desselben Typs.

Beispiele:

Werte concat(values)
„abc“, „def“ "abcdef"
[1, 2], [3, 4] [1, 2, 3, 4]
b"abc", b"def" b"abcdef"
„abc“, [1,2,3], „ghi“ Fehler
[1,2,3] Fehler
"abc", null null
Node.js
concat(constant("Author ID: "), field("authorId"));
test.firestore.js

Web

concat(constant("Author ID: "), field("authorId"));
test.firestore.js
Swift
let displayString = Constant("Author ID: ").concat([Field("authorId")])
PipelineSnippets.swift
Kotlin
Android
val displayString = constant("Author ID: ").concat(field("authorId"))

DocSnippets.kt
Java
Android
Expression displayString = constant("Author ID: ").concat(field("authorId"));
DocSnippets.java
Python
Constant.of("Author ID: ").concat(Field.of("authorId"))
firestore_pipelines.py

LENGTH

Syntax:

length[T <: STRING | BYTES | ARRAY | VECTOR | MAP](value: T) -> INT64

Beschreibung:

Berechnet die Länge eines String-, Bytes-, Array-, Vector- oder Map-Werts.

Beispiele:

Wert length(value)
„hallo“ 5
[1, 2, 3, 4] 4
b"abcde" 5
Null null
1 Fehler

REVERSE

Syntax:

reverse[T <: STRING | BYTES | ARRAY](value: T) -> T

Beschreibung:

Kehrt einen String-, Bytes- oder Array-Wert um.

Beispiele:

Wert reverse(value)
„hallo“ „olleh“
[1, 2, 3] [3, 2, 1]
b"abc" b"cba"
23 Fehler
null null

Nächste Schritte