Funzioni di riferimento

Anteprima: Firestore in modalità nativa (con operazioni di pipeline) per Enterprise Edition è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. Puoi accedere ai dati personali per questa funzionalità, come indicato nell'Addendum per il trattamento dei dati Cloud, fatti salvi gli obblighi e le restrizioni all'interno dell'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 riferimento

Il tipo REFERENCE funge da "puntatore" ad altri documenti nel database (o anche ad altri database). Le seguenti funzioni consentono di manipolare questo tipo durante l'esecuzione delle query.

Nome	Descrizione
COLLECTION_ID	Restituisce l'ID della raccolta foglia nel riferimento specificato
DOCUMENT_ID	Restituisce l'ID del documento nel riferimento specificato
PARENT	Restituisce il riferimento principale
REFERENCE_SLICE	Restituisce un sottoinsieme di segmenti dal riferimento specificato

COLLECTION_ID

Sintassi:

collection_id(ref: REFERENCE) -> STRING

Descrizione:

Restituisce l'ID della raccolta foglia del REFERENCE specificato.

Esempi:

ref	collection_id(ref)
users/user1	"users"
users/user1/posts/post1	"posts"

DOCUMENT_ID

Sintassi:

document_id(ref: REFERENCE) -> ANY

Descrizione:

Restituisce l'ID del documento del REFERENCE specificato.

Esempi:

ref	document_id(ref)
users/user1	"user1"
users/user1/posts/post1	"post1"

PARENT

Sintassi:

parent(ref: REFERENCE) -> REFERENCE

Descrizione:

Restituisce il REFERENCE principale del riferimento specificato o NULL se il riferimento è già un riferimento principale.

Esempi:

ref	parent(ref)
/	NULL
users/user1	/
users/user1/posts/post1	users/user1

REFERENCE_SLICE

Sintassi:

reference_slice(ref: REFERENCE, offset: INT, length: INT) -> REFERENCE

Descrizione:

Un REFERENCE è un elenco di tuple (collection_id, document_id) e questo consente di ottenere una visualizzazione di questo elenco, proprio come array_slice(...).

Restituisce un nuovo REFERENCE che è un sottoinsieme dei segmenti del ref specificato.

• offset: l'indice iniziale (basato su 0) della sezione. Se è negativo, è un offset dalla fine del riferimento.
• length: il numero di segmenti da includere nella sezione.

Esempi:

ref	offset	length	reference_slice(ref, offset, length)
a/1/b/2/c/3	1L	2L	b/2/c/3
a/1/b/2/c/3	0L	2L	a/1/b/2
a/1/b/2/c/3	-2L	2L	c/3