Funzioni di tipo

Anteprima: Firestore in modalità nativa (con operazioni di pipeline) per l'edizione Enterprise è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. Puoi elaborare i dati personali per questa funzionalità, come indicato nell'Addendum per il trattamento dei dati Cloud, fatti salvi gli obblighi e le restrizioni descritti nell'accordo che regola l'accesso a Google Cloud. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Funzioni di tipo

Nome	Descrizione
TYPE	Restituisce il tipo del valore come STRING.
IS_TYPE	Restituisce true se il valore corrisponde al tipo specificato.

TYPE

Sintassi:

type(input: ANY) -> STRING

Descrizione:

Restituisce una rappresentazione stringa del tipo input.

Se viene fornito un valore assente, restituisce NULL.

Esempi:

input	type(input)
NULL	"null"
true	"boolean"
1	"int32"
-3L	"int64"
3.14	"float64"
2024-01-01T00:00:00Z UTC	"timestamp"
"foo"	"string"
b"foo"	"bytes"
[1, 2]	"array"
{"a": 1}	"map"
path("c/d")	"reference"
vector([1.0, 2.0])	"vector"
ABSENT	NULL

Esempi di client

Node.js

const result = await db.pipeline()
  .collection("books")
  .select(field("title").notEqual("1984").as("not1984"))
  .execute();
test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("title").notEqual("1984").as("not1984"))
);
test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("books")
  .select([Field("title").notEqual("1984").as("not1984")])
  .execute()
PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(field("title").notEqual("1984").alias("not1984"))
    .execute()
DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("title").notEqual("1984").alias("not1984"))
    .execute();
DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("title").not_equal("1984").as_("not1984"))
    .execute()
)
firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(notEqual(field("title"), "1984").as("not1984"))
        .execute()
        .get();
PipelineSnippets.java

IS_TYPE

Sintassi:

is_type(input: ANY, type: STRING) -> BOOLEAN

Descrizione:

Restituisce true se input corrisponde al type specificato, altrimenti false. Se viene fornito un input assente, restituisce NULL.

Le stringhe type supportate sono:

• "null"
• "boolean"
• "int32"
• "int64"
• "float64"
• "decimal128"
• "number"
• "timestamp"
• "string"
• "bytes"
• "array"
• "map"
• "reference"
• "vector"
• "geo_point"
• "max_key"
• "min_key"
• "object_id"
• "regex"
• "bson_timestamp"

Esempi:

input	type	is_type(input, type)
NULL	"null"	true
true	"boolean"	true
3.14	"float64"	true
"foo"	"string"	true
b"foo"	"string"	false
[1, 2]	"array"	true
{"a": 1}	"map"	true
vector([1.0, 2.0])	"vector"	true
ABSENT	"string"	NULL
"bar"	"other"	ERROR