Eine Subselect Projektion bietet eine einfache Möglichkeit, einen einzelnen simplen Wert (bzw. in besonderen Fällen auch mehrere simple Werte) aus den Daten von Entitäten eines beliebigen Entitätstyps in den Kontext der übergeordneten Suche (_parentQuery) einzubinden.

Der Begriff Subselect bezieht sich auf die Methodik zum Einbinden von Daten einer "fremden" Entität als "Unterabfrage", die konkrete Werte für unterschiedliche funktionale Abschnitte (z. B. Ausgabespalten oder Einschränkungen) der übergeordneten Suche bereitstellen kann.

Das Einsatzgebiet der Subselect Projektion weist Schnittmengen mit dem von Joins auf. Allerdings gibt es Konstellationen beim Einbinden oder Nachschlagen von Daten, die nur auf dem einen oder anderen Weg realisiert werden können.

• Einerseits ist eine Subselect Projektion mit Blick auf die Performanz einer Suche oft "teurer", weil die Daten des eingebundenen Entitätstyps "zeilenweise" und daher oft wiederholt (und ggf. redundant) abgerufen werden.

• Andererseits bietet die Subselect Projektion Freiheitsgrade für Nebenbedingungen und die Aufbereitung der eingebundenen Daten (z. B. Gruppierung und Aggregation), die im Kontext von Joins nicht verfügbar sind.

Beim Einsatz der Subselect Projektion sind folgende Einschränkungen zu beachten:

1. Als Spaltenprojektion für Subselect können nur Projektionen verwendet werden, die Werte liefern, die datenbankseitig "simpel" (durch genau eine Spalte) repräsentiert sind.
   
   

   • Beispiel: Aufzählungswerte

     • Ein Aufzählungswert wird auf der Datenbank-Ebene entweder als Long-Wert ("Ordinal") oder in Ausnahmefällen als String ("Name") gespeichert. Jedenfalls verwendet die Datenbank einen simplen Wert, auch wenn dieser im XML komplex erscheint.

     • Werte aus Dynamischen oder statischen Aufzählungen eignen sich daher problemlos als Spaltenprojektion für Subselect.
       
       

   • Beispiel: Datumswerte

     • Timestamp-Feld - z. B. das "Erstelldatum" (created) für eine beliebige Entität - eignet sich problemlos als Spaltenprojektion für Subselect.

     • Ein DateTime-Feld - z. B. das "Passwort Ablaufdatum" (passwordExpiryDate) für Benutzer - eignet sich nicht als Spaltenprojektion für Subselect, weil ein Datum/Uhrzeit-Feld auf der Datenbank-Ebene zwei "Spalten" (für UTC-Millisekunden und Zeitzone) beansprucht.

     • Die UTC-Millisekunden eines DateTime-Felds - z. B. das Feld "Passwort Ablaufdatum.Datumswert" (passwordExpiryDate.dateValue) für Benutzer - eignet sich problemlos als Spaltenprojektion für Subselect.
       
       

   • Beispiel: Listenfelder

     • Grundsätzlich können "Listenfelder" - z. B. "Übergeordnete Firmen" (parentCompanies) für Firmen - durchaus als Spaltenprojektion für Subselect verwendet werden.
       

     • Allerdings darf die Spaltenprojektion für Subselect nur mehrere Werte liefern, wo diese auch verarbeitet werden können:
       

       • Definiert die Subselect Projektion eine Ausgabespalte (in einer Tupel- oder CSV-Suche), dann ist nur ein Einzelwert als Rückgabewert zulässig. Mit einem "Listenfeld" als Spaltenprojektion für Subselect wird die Suche zur Laufzeit mit Fehler abgebrochen, sobald das Listenfeld mehrere Werte für dieselbe Ergebniszeile liefert.

       • Wo "mehrwertiger" Inhalt zulässig ist - z. B. auf der rechten Seite einer Feld Einschränkung mit dem in-Vergleichstyp - kann ein "Listenfeld" problemlos als Spaltenprojektion für Subselect verwendet werden.

     • ►WICHTIG◄ Der Einsatz einer Collection Projektion als Spaltenprojektion für Subselect innerhalb einer Subselect Projektion um eine Liste in eine Ausgabespalte zu projizieren ist aus technischen Gründen nicht sinnvoll möglich.

       • Allerdings ist der umgekehrte Weg zielführend: Eine Subselect Projektion mit einem "Listenwert" als Spaltenprojektion für Subselect kann in einer Collection Projektion eingesetzt werden, um Werte für eine Collection bereitzustellen.
         
         

2. Die Subselect Projektion darf nur genau ein Ergebnis liefern, sofern der Kontext nicht ausdrücklich auf eine Liste abzielt.
   
   

   • Nur in der übergeordneten Suche kann man die Eindeutigkeit des Ergebnisses erzwingen, indem man dem Parameter "Maximale Ergebnisse" den Wert 1 einstellt. Die Subselect Projektion kennt dagegen kein "Limit" für die Anzahl der "Ergebniszeilen", also kann man auch nicht einfach das "erste Ergebnis" als Rückgabewert definieren.

   • Ggf. kann eine Aggregation in der Spaltenprojektion für Subselect genutzt werden, um z. B. den Minimal- oder Maximalwert aus mehreren Werten auszuwählen.

   • Innerhalb Collection Projektion

►WICHTIG◄ Im Unterschied zur übergeordneten Suche greifen für den Subselect keine Zugriffbeschränkungen. Falls sich der Parameter Entität auf denselben Entitätstyp wie die übergeordnete Suche bezieht, berücksichtigt der Subselect grundsätzlich alle existierenden Instanzen dieses Typs, während die übergeordnete Suche nur eine echte oder unechte Teilmenge zurückgibt, nämlich die Entitäten, für die im Ausführungskontext Lesezugriff besteht.

String