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
Abfragehinweise
Abfragehinweise (Schlüsselwort HINT) können in der One Identity Manager Abfragesprache verwendet werden, um den Abfrageprozessor mit zusätzlichen Daten zu versorgen. Abfragehinweise werden intern verwendet, um einen Kontext für zusätzliche Berechtigungsabfragen zum Anzeigen von Spalten bereitzustellen, die nur verfügbar sind, wenn sie als Anzeigewerte für Fremdschlüssel einer anderen Tabelle geladen werden.
HINT 'Name' = 'Value'
Beispiel: Laden einer Identität, die in einer Unternehmensstruktur als UID_PersonHead referenziert wird
FROM Person
WHERE PRIMARYKEY '<Key><T>Person</T><P>99918ef1-113f-480a-8e6e-704b1a3cf73a</P></Key>'
SELECT DISPLAYS
HINT 'SourceContext' = 'Org'
Bedingungen
Bedingungen kombinieren alle Ausdrücke, die die resultierenden Entitäten nach einem oder mehreren Kriterien filtern.
In der One Identity Manager Abfragesprache können Bedingungen mit den Operatoren AND und OR verknüpft werden. Die Vorrangigkeit der Operatoren kann mit geschweiften Klammern ({ }) außer Kraft gesetzt werden. Bedingungen können durch das Schlüsselwort NOT invertiert werden.
Beispiel für eine Bedingung
WHERE Lastname = 'Harris'
AND (Firstname = 'Fred' OR Firstname = 'Clara')
Verwandte Themen
Besondere Bedingungen
Auswählen einer Entität über den Primärschlüssel
Mit dem Schlüsselwort PRIMARYKEY wählen Sie in der One Identity Manager Abfragesprache die Entität mit dem passenden Primärschlüssel aus. Der Primärschlüssel muss in Objektschlüssel-Notation angegeben werden.
WHERE PRIMARYKEY 'Object Key'
Beispiel
FROM Person
WHERE PRIMARYKEY '<Key><T>Person</T><P>99918ef1-113f-480a-8e6e-704b1a3cf73a</P></Key>'
SELECT DISPLAYS
Auswählen einer Entität über einen Schlüssel
Mit dem Schlüsselwort KEY wählen Sie die Entität mit dem passenden Schlüssel aus. Schlüssel können Objektschlüssel oder alternative Objektschlüssel sein, jeweils in ihrer XML-Notation.
WHERE KEY 'Key'
Beispiel
FROM ADSAccount
WHERE KEY '<Key><Table Name="ADSAccount" Key="c149784b-6386-45d7-a38d-3c6e8e1b69d4"><Prop Name="UID_ADSAccount"><Value>c149784b-6386-45d7-a38d-3c6e8e1b69d4</Value></Prop></Table></Key>'
SELECT COLUMNS cn
Auswählen über vordefiniertes SQL
Mit dem Schlüsselwort LIMITEDSQL verwenden Sie eine vorformatierte Where-Klausel aus der Tabelle QBMLimitedSQL. Eventuell darin verwendete Parameter können mit den Klauseln PARAMETER oder PARAMETERS angegeben werden.
WHERE LIMITEDSQL 'Identifier'
