Partager via

INDEX, clause

  • Article

La clause INDEX spécifie une clé pour sélectionner une ligne unique dans une collection scalaire ou de table. Le fournisseur SNMP est mappé à un autre type de classe CIM en fonction du type de table utilisé par l’appareil SNMP. Étant donné qu’une clé peut être plusieurs types d’objet, le fournisseur utilise différentes règles de mappage en fonction du type d’objet dans la clé. Pour plus d’informations, consultez types de données de clause INDEX.

Note

Pour plus d’informations sur l’installation du fournisseur, consultez Configuration de l’environnement SNMP WMI.

 

Une collection scalaire est mappée à une classe CIM singleton : autrement dit, une classe qui ne peut avoir qu’une seule instance. Étant donné qu’il n’est pas nécessaire d’identifier de manière unique une instance d’une autre, une classe singleton ne désigne pas une ou plusieurs propriétés comme clé. Classes générées à partir de collections scalaires :

  • Ne contiennez pas qualificateurs de propriété key.
  • Contenir le qualificateur de classe CIM standard Singleton, qui est de type Bool.

Une collection de tables est mappée à une classe CIM qui peut avoir plusieurs instances. Par conséquent, la définition de classe CIM doit contenir au moins une propriété qui définit la clé d’objet ; autrement dit, une propriété qui identifie de manière unique une instance de la classe. La clause INDEX de la macro OBJECT-TYPE d’une collection de tables spécifie l’ensemble de propriétés de clé de la collection. Les règles de mappage suivantes s’appliquent :

  • Le qualificateur CIM Key, type Bool, définit une propriété de clé.

  • L’ordre des informations INDEX dans la collection de tables définit l’ordre des clés dans la définition de classe CIM.

    Le qualificateur CIM Key_Order définit l’ordre des clés. Ce qualificateur est une valeur entière 32 bits non signée qui, à des fins de syntaxe de qualificateur MOF, doit être convertie en valeur entière 32 bits signée à l’aide de l’opération à deux compléments.

Actuellement, le mappage de la clause SNMPv2C INDEX ne gère pas l’utilisation du qualificateur de IMPLICITE. Une définition de classe CIM n’est pas générée dans ce cas.

Types de données de clause INDEX

En raison de la flexibilité de la clause INDEX dans la macro OBJECT-TYPE, la spécification des propriétés clé n’est pas simple. Au lieu de cela, vous devez envisager les possibilités que la clause INDEX peut contenir un ou plusieurs des types de données suivants :

  • Valeur indexobject accessible en interne

    Le indexobject valeur est une valeur nommée qui fait référence à une définition d’objet MIB apparaissant dans la ligne conceptuelle de la même table qui contient la clause INDEX. La définition d’objet MIB référencée dans la clause INDEX est mappée à une propriété clé de la définition de classe CIM.

  • Valeur indexobject accessible en externe

    Dans ce cas, indexobject est une valeur nommée qui fait référence à une définition d’objet MIB apparaissant dans la ligne conceptuelle d’une autre table.

  • Valeur indextype accessible

    La valeur de type d’index est un type nommé qui fait référence à l’un des types de données suivants : INTEGER, STRING OCTET, OBJECT IDENTIFIER, NetworkAddressou IpAddress. Si la clause INDEX contient une référence de type MIB, les règles de mappage suivantes s’appliquent :

    • L’objet MIB référencé est mappé à une propriété clé de la définition de classe CIM. Sa syntaxe de type est basée sur le type d’index valeur spécifiée, qui correspond aux qualificateurs de propriété CIM à l’aide de la clause SYNTAX standard procédures de mappage.
    • Le processus de mappage génère un nom de propriété unique en concaténant le descripteur d’objet de table MIB, un trait de soulignement (_) et l’ordre de classement de la clause INDEX valeur indextype. Par exemple, le nom de propriété du troisième composant indextype de la table MIB enterpriseIfTable est enterpriseIfTable_3.
    • La propriété CIM est annotée avec le qualificateur Virtual_Key. Ce qualificateur spécifie que le fournisseur SNMP doit calculer la valeur de la propriété en fonction du super-ensemble d’informations d’instance associées à toutes les définitions d’objet MIB accessibles dans la définition de classe.
    • La définition de classe CIM doit contenir au moins une propriété qui n’a pas de qualificateur d'Virtual_Key associé ; échec de spécification de cette propriété invalide la définition de classe.

  • Sous-type de longueur fixe

    Lorsque la clause INDEX d’une collection de tables SNMP contient un type pris en charge par SNMP qui est sous-typé sous forme de chaîne OCTET de longueur fixe, le qualificateur de propriété CIM Fixed_Length doit être utilisé pour spécifier cette valeur.