Présentation du langage MQL

Jointures

Le langage MQL prend en charge les jointures internes gauches des objets de modèle, comme illustré par l'exemple suivant :

SELECT Db2Server.* FROM Db2Server, OracleInstance WHERE Db2Server.port == OracleInstance.port 

Cette jointure renvoie tous les objets de modèle Db2Server dans les cas où les numéros de port de Db2Server et d'OracleInstance sont identiques. Le MQL ne prend pas en charge les combinaisons de jointures extérieures droites, extérieures gauches, complètes ou croisées.

Limitations

com.ibm.db2.jcc.am.SqlSyntaxErrorException: DB2 SQL Error: SQLCODE=-418, SQLSTATE=42610

Grammaire de l'instruction SELECT

L'exemple suivant montre la grammaire de l'instruction SELECT. Consultez le Javadoc pour plus de détails et les dernières mises à jour.

statement := SELECT attribute-list [EXCLUDING attribute-list]
   FROM [ONLY] class_list { WHERE [expression | 
   exists_expr] }
[ FETCH FIRST n { ROW | ROWS } [ ONLY ]] [ ORDER BY order_list ]
attribute_list := attrib {, attrib}* | * 
class_list := domain_class {, domain_class }*  
class := <a model object class> 
exists_expr := exists( array_attrib op value {logical_op array_attrib op value}* ) 
expression := [ attrib op value | attrib post-op | pre-op ( attrib )
   |[ NOT ] IN ( expression [, ...] ){logical_op expression}* 
value := <data value> 
in_expr := [ NOT ] IN ( expression [, expression ... ])
array_attrib := <series of attributes where at least the second to last 
   attribute is an array > 
op := != | == | > | < | >= | <= | contains | starts-with | ends-with | 
   equals | not-equals | instanceof | eval
logical_op := AND | OR | && | || 
post_op := is-null | is-not-null 
pre_op := lower | upper 
attrib := {class .} [<an attribute of a class>{.embedded_attribute} | * ] 
embedded_attribute := [<embedded attribute>{.embedded_attribute} | *] 
domain_class := {domain_list} class
domain_list := domain {, domain}* : 
domain := <the server from which to pull data from, default: local database> 
order_list := attrib [ ASC | ASCENDING | DESC | DESCENDING ] [ , order_list ]

Les attributs peuvent contenir des caractères génériques. De même, tous les mots clé, tels que SELECT, FROM et WHERE sont insensibles à la casse.

Exemples

L'exemple suivant illustre une requête MQL qui filtre les systèmes informatiques exécutant le système d'exploitation Linux® :

SELECT *
   FROM ComputerSystem
   WHERE OSRunning.OSName == 'Linux'

La requête suivante se sert de l'opérateur EXISTS pour demander une appartenance à une grappe, correspondant à tous les systèmes informatiques qui ont une interface en mode écoute sur ibm.com ou leur masque de réseau défini sur 255.255.255.0 :

SELECT * 
	FROM ComputerSystem 
	WHERE EXISTS (ipInterfaces.ipNetwork.name ends-with '.ibm.com' 
		OR ipInterfaces.ipNetwork.netmask == '255.255.255.0')

SELECT * 
   FROM ComputerSystem
   WHERE virtual

La requête suivante sélectionne tous les systèmes informatiques dont l'attribut virtuel est défini sur false :

SELECT * 
   FROM ComputerSystem
   WHERE not virtual

SELECT OSInstalled 
	FROM ComputerSystem,WindowsOperatingSystem 
	WHERE ComputerSystem.guid==WindowsOperatingSystem.parent.guid 
	AND 
	EXISTS(WindowsOperatingSystem.installedServices.displayName contains 'Wireless')

SELECT primarySAP.portNumber,displayName 
    FROM AppServer 
    WHERE primarySAP.portNumber==9084

SELECT ports.portNumber,displayName 
   FROM RuntimeProcess 
   WHERE EXISTS (ports.portNumber==1415)

Requêtes MQL avec l'opérateur NOT EQUAL TO (!=)

Exemple

On considère souvent que le nombre de résultats qui sont renvoyés depuis la commande de recherche d'interface de programme d'application suivante :

./api.sh -u <admin> -p <pass> find --count "select * from ComputerSystem"

est égal à la somme des résultats qui sont renvoyés depuis les deux commandes de recherche d'interface de programme d'application suivantes :

./api.sh -u <admin> -p <pass> find --count "select * from ComputerSystem where manufacturer == 'IBM'"

./api.sh -u <admin> -p <pass> find --count "select * from ComputerSystem where manufacturer != 'IBM'"

Cependant, l'attribut Fabricant est défini sur NULL, il est donc exclu des résultats renvoyés depuis la requête qui contient l'opérateur NOT EQUAL TO.

Les requêtes qui contiennent l'opérateur NOT EQUAL TO peuvent se présenter sous les formes suivantes :

select * from ComputerSystem where manufacturer != 'IBM'

select * from ComputerSystem where not(manufacturer == 'IBM')

Si vous souhaitez sélectionner tous les systèmes informatiques avec un fabricant différent d'IBM, utilisez la requête suivante :

select * from ComputerSystem where manufacturer != 'IBM' or manufacturer is-null

Requêtes MQL avec opérateur EVAL (attributs XA et XD uniquement)

Beaucoup d'attributs CDM sont déplacés dans le contenu XML des attributs XA ou XD. Par conséquent, la syntaxe MQL prend en charge un nouvel opérateur eval, qui peut être ajouté à la clause where. L'opérateur eval permet d'interroger les éléments de configuration par les valeurs des attributs étendus ou des instances étendues.

./api.sh -u username -p password find "MQL query"

SELECT * FROM ComputerSystem WHERE productID == 'prod1'

SELECT * FROM ComputerSystem WHERE XA eval '/xml[attribute[@category=\"taddm_global\" and @name=\"productID\"]=\"prod1\"]'