Associações de esquema
As consultas de associação de esquema usam as mesmas instruções que são usadas em consultas de associação de dados: ASSOCIADORES OF e REFERENCES OF. No entanto, com consultas de associação de dados, instâncias de classe são retornadas e, com consultas de associação de esquema, nomes de 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 e para consultas de associação de dados, com as seguintes exceções:
- O objeto de origem é uma classe e não uma instância.
- Há uma palavra-chave adicional, SchemaOnly, que identifica a consulta como se aplicando a um esquema e não 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 ASSOCIATORS OF Statement.
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 Protocol 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 pela 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 uma sintaxe detalhada, consulte REFERÊNCIAS DA Declaração.
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 root\cimv2 namespace.
ASSOCIATORS OF {Win32_ComputerSystem} WHERE SchemaOnly