Associações de esquema

As consultas de associação de esquema usam as mesmas instruções que são utilizadas em consultas de associação de dados: ASSOCIATORS OF e REFERENCES OF. No entanto, com consultas de associação de dados, as instâncias de classe são retornadas e, com consultas de associação de esquema, os nomes das classes que podem participar de relações de associação são retornados. Por exemplo, use uma consulta de esquema para localizar todas as classes de associação definidas no esquema que fazem referência a uma classe de origem.

A sintaxe para as instruções ASSOCIATORS OF e REFERENCES OF é a mesma para consultas de associação de esquema que é para consultas de associação de dados com as seguintes exceções:

• O objeto de origem é uma classe em vez de uma instância.
• Há um palavra-chave adicional, SchemaOnly, que identifica a consulta como aplicável a um esquema em vez de a dados.
• A palavra-chave ClassDefsOnly não é válida.

O exemplo a seguir mostra a sintaxe completa da instrução ASSOCIATORS OF para uma consulta de esquema. Para obter uma sintaxe detalhada, consulte Instrução ASSOCIATORS OF.

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

O exemplo a seguir mostra uma consulta que retorna as classes Protocolo e Driver, as duas classes que se referem à classe de origem.

ASSOCIATORS OF {Adapter} WHERE SchemaOnly

A consulta a seguir retorna apenas a classe Driver devido à restrição colocada pelo palavra-chave AssocClass.

ASSOCIATORS OF {Adapter} WHERE AssocClass = AdapterDriver SchemaOnly

A sintaxe completa da instrução REFERENCES OF para uma consulta de esquema é a seguinte. Para obter uma sintaxe detalhada, confira Instrução REFERENCES OF.

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

Observação

As consultas de associação de esquema podem retornar objetos duplicados.

 

Por exemplo, a consulta a seguir retornará a classe CIM_ComputerSystem várias vezes ao enumerar classes no namespace root\cimv2.

ASSOCIATORS OF {Win32_ComputerSystem} WHERE SchemaOnly