Associations de schémas

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. Toutefois, avec les requêtes d’association de données, les instances de classe sont retournées et avec les requêtes d’association de schémas, les noms des classes qui peuvent participer aux relations d’association sont retournés. Par exemple, utilisez une requête de schéma pour rechercher toutes les classes d’association définies dans le schéma qui référencent une classe source.

La syntaxe des instructions ASSOCIATORS OF et REFERENCES OF est la même pour les requêtes d’association de schéma que pour les requêtes d’association de données avec les exceptions suivantes :

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

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

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 placée par le mot clé AssocClass.

ASSOCIATORS OF {Adapter} WHERE AssocClass = AdapterDriver SchemaOnly

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

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

Note

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

 

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