Associations de schéma

Les requêtes d’association de schéma utilisent les mêmes instructions que celles utilisées dans les requêtes d’association de données : ASSOCIATORS OF et REFERENCES OF. Cependant, dans le cas des requêtes d’association de données, des instances de classe sont retournées ; dans le cas des requêtes d’association de schéma, ce sont les noms des classes qui peuvent participer à des relations d’association qui sont retournés. Par exemple, vous pouvez utiliser une requête de schéma pour rechercher toutes les classes d’association définies dans le schéma qui font référence à une classe source.

La syntaxe des instructions ASSOCIATORS OF et REFERENCES OF utilisée pour les requêtes d’association de schéma est identique à celle utilisée pour les requêtes d’association de données, à quelques différences près :

• L’objet source est une classe et non une instance.
• Il existe un mot clé supplémentaire, SchemaOnly, qui identifie la requête comme s’appliquant à un schéma et non à des données.
• Le mot clé ClassDefsOnly n’est pas valide.

L’exemple suivant montre la syntaxe complète de l’instruction ASSOCIATORS OF dans le cas d’une requête de schéma. Pour obtenir une syntaxe détaillée, consultez ASSOCIATORS OF, instruction.

ASSOCIATORS OF {SourceClass} WHERE 
    AssocClass = AssocClassName
    RequiredAssocQualifier = QualifierName
    RequiredQualifier = QualifierName
    ResultClass = ClassName
    ResultRole = PropertyName
    Role = PropertyName
    SchemaOnly

L’exemple suivant montre une requête qui retourne les classes Protocol et Driver, les deux classes qui font référence à la classe source.

ASSOCIATORS OF {Adapter} WHERE SchemaOnly

La requête suivante retourne uniquement la classe Driver en raison de la restriction définie par le mot clé AssocClass.

ASSOCIATORS OF {Adapter} WHERE AssocClass = AdapterDriver SchemaOnly

La syntaxe complète de l’instruction REFERENCES OF dans le cas d’une requête de schéma est la suivante. Pour obtenir une syntaxe détaillée, consultez REFERENCES OF, instruction.

REFERENCES OF {SourceClass} WHERE
    ResultClass = ClassName
    Role = PropertyName
    RequiredQualifier = QualifierName
    SchemaOnly

Notes

Les requêtes d’association de schéma peuvent retourner des objets en double.

 

Par exemple, la requête suivante retourne la classe CIM_ComputerSystem plusieurs fois lors de l’énumération de classes dans l’espace de noms root\cimv2.

ASSOCIATORS OF {Win32_ComputerSystem} WHERE SchemaOnly