Documentation de référence sur les fonctions génériques

Fonctions génériques

Nom Description
CURRENT_DOCUMENT Renvoie le document en cours de traitement dans le pipeline.
CONCAT Concatène deux valeurs ou plus du même type.
LENGTH Calcule la longueur d'un String, Bytes, Array, Vector ou Map.
REVERSE Inverse un String, Bytes ou Array.

CURRENT_DOCUMENT

Syntaxe :

current_document() -> MAP

Description :

Évalue une carte contenant tous les champs définis dans le champ d'application actuel. Cela est utile lorsque vous fusionnez ou agrégez plusieurs documents, ou lorsque vous souhaitez inspecter de manière dynamique les noms de champs dans le document.

Par exemple, pour obtenir une liste de documents regroupés par champ :

Node.js

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

CONCAT

Syntaxe :

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

Description :

Concatène deux valeurs ou plus du même type.

Exemples :

valeurs concat(values)
"abc", "def" "abcdef"
[1, 2], [3, 4] [1, 2, 3, 4]
b"abc", b"def" b"abcdef"
"abc", [1,2,3], "ghi" erreur
[1,2,3] erreur
"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

Syntaxe :

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

Description :

Calcule la longueur d'une valeur String, Bytes, Array, Vector ou Map.

Exemples :

valeur length(value)
"bonjour" 5
[1, 2, 3, 4] 4
b"abcde" 5
null null
1 erreur

REVERSE

Syntaxe :

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

Description :

Inverse une valeur String, Bytes ou Array.

Exemples :

valeur reverse(value)
"bonjour" "olleh"
[1, 2, 3] [3, 2, 1]
b"abc" b"cba"
23 erreur
null null

Étapes suivantes