Referenzfunktionen

Vorabversion: Firestore im nativen Modus (mit Pipelinevorgängen) für die Enterprise Version unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Sie können personenbezogene Daten für diese Funktion gemäß dem Zusatz zur Verarbeitung von Cloud-Daten verarbeiten, vorbehaltlich der in der Vereinbarung beschriebenen Verpflichtungen und Einschränkungen, gemäß der Sie auf Google Cloud zugreifen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Referenzfunktionen

Der Typ REFERENCE fungiert als „Zeiger“ auf andere Dokumente in der Datenbank (oder sogar auf andere Datenbanken). Mit den folgenden Funktionen kann dieser Typ während der Abfrageausführung bearbeitet werden.

Name	Beschreibung
COLLECTION_ID	Gibt die ID der Blatt-Collection in der angegebenen Referenz zurück
DOCUMENT_ID	Gibt die ID des Dokuments in der angegebenen Referenz zurück
PARENT	Gibt die übergeordnete Referenz zurück
REFERENCE_SLICE	Gibt eine Teilmenge von Segmenten aus der angegebenen Referenz zurück

COLLECTION_ID

Syntax:

collection_id(ref: REFERENCE) -> STRING

Beschreibung:

Gibt die Blatt-Collection-ID der angegebenen REFERENCE zurück.

Beispiele:

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

DOCUMENT_ID

Syntax:

document_id(ref: REFERENCE) -> ANY

Beschreibung:

Gibt die Dokument-ID der angegebenen REFERENCE zurück.

Beispiele:

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

PARENT

Syntax:

parent(ref: REFERENCE) -> REFERENCE

Beschreibung:

Gibt die übergeordnete REFERENCE der angegebenen Referenz oder NULL zurück, wenn die Referenz bereits eine Stammreferenz ist.

Beispiele:

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

REFERENCE_SLICE

Syntax:

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

Beschreibung:

Eine REFERENCE ist eine Liste von (collection_id, document_id)-Tupeln. Mit dieser Funktion können Sie eine Ansicht dieser Liste abrufen, genau wie mit array_slice(...).

Gibt eine neue REFERENCE zurück, die eine Teilmenge der Segmente der angegebenen ref ist.

• offset: Der Startindex (0-basiert) des Slice. Wenn er negativ ist, ist er ein Offset vom Ende der Referenz.
• length: Die Anzahl der Segmente, die im Slice enthalten sein sollen.

Beispiele:

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