Order by-Klauseln
Mit einer Order by-Klausel wird in der One Identity Manager Abfragesprache festgelegt, in welcher Reihenfolge die Einträge zurückgegeben werden.
ORDER BY <list of columns>
Die Reihenfolge der Spalten kann angegeben werden über
Wenn Anzeigewerte ausgewählt werden, wird eine standardmäßige Order by-Klausel über die Anzeigespalten erzeugt.
Beispiele für Order by-Klauseln
ORDER BY Lastname, Firstname
ORDER BY EntryDate DESC
Es können Fallback-Spalten angegeben werden, die für die Sortierung verwendet werden, wenn die vorherigen Werte NULL sind. Diese Fallback-Werte werden durch den Null-Koaleszenz Operator ?? angegeben.
Beispiele für die Angabe einer Fallback-Spalte
ORDER BY DisplayName ?? CN
ORDER BY DisplayName ?? CN DESC, XDateInserted
Klauseln für Paging
Die Paging-Operatoren der One Identity Manager Abfragesprache ermöglichen es, nur eine Teilmenge der ausgewählten Einträge zurückzugeben.
Take-Klausel
Die Take-Klausel gibt die Anzahl der Einträge an, die maximal zurückgegeben werden sollen. Wenn mehr als eine Take-Klausel angegeben wurde, ist nur die letzte Take-Klausel wirksam.
TAKE <integer>
Beispiel
-- Return only the first ten identities from the result set
FROM Person SELECT DISPLAYS TAKE 10
Skip-Klausel
Die Skip-Klausel gibt an, wie viele Einträge am Anfang des Ergebnisses übersprungen werden sollen, bevor Einträge zurückgegeben werden.
SKIP <integer>
Beispiel
-- Skip 50 identities and return the following 15
FROM Person SELECT DISPLAYS SKIP 50 TAKE 15
Klauseln für Anzeigewerte
Die Klauseln für Anzeigewerte ermöglichen die Definition eines benutzerdefinierten Anzeigemusters. Für die zurückgegebenen Einträge kann das Anzeigemuster und das Anzeigemuster (lang) der Tabelle mit einer Klausel für Anzeigewerte überschrieben werden.
DISPLAY 'Display pattern'
LONGDISPLAY 'Display pattern'
Parameter ist in beiden Fällen eine Zeichenkette, die das Anzeigemuster mit Platzhaltern in der Form %Spaltenname% enthält.
Beispiel
FROM Person
SELECT DISPLAYS
DISPLAY '%Lastname%, %Firstname%'
LONGDISPLAY '%Lastname%, %Firstname% - %CentralAccount%'
Verwandte Themen
Klauseln für Abfrageparameter
Klauseln für Abfrageparameter ermöglichen in der One Identity Manager Abfragesprache die Übergabe von Parameterwerten, die in Where-Klauseln verwendet werden. Es kann entweder ein einzelner Parameter oder eine Liste von Parametern übergeben werden.
Syntax für einen einzelnen Parameter
PARAM <Parameter name> [ OF <Type> ] = <Value>
Syntax für mehrere Parameter
PARAMS
<Param1> [ OF <Type> ] = <Value>,
<Param2> [ OF <Type> ] = <Value>
Als Parametername sind zulässig:
Gültige Typen sind die in ValType-Enumeration definierten .Net-Datentypen der Objektschicht. Wenn der Typ aus dem Wert abgeleitet werden kann, ist die Angabe eines Typs optional.
Beispiele für Abfrageparameter
PARAM Parameter1 = 'Harris'
PARAM @Parameter2 = 'Harris'
PARAM Parameter3 OF String = 'Harris'
PARAM @Parameter4 OF String = 'Harris'
PARAM Parameter5 = 42
PARAM Parameter6 OF Int = 42
PARAMS
Parameter7 OF Double = 3.14,
Parameter8 OF Date = 2020-04-30
Beispiel: Vollständige Abfrage mit Parameterreferenz und Definition
FROM Person
WHERE LastName = @Param1
SELECT DISPLAYS
PARAM Param1 = 'Harris'
Verwandte Themen