dbindex:==keyfield
<element>
<keyfield>
Esse elemento permite definir um índice vinculado a uma tabela.
É possível definir vários índices. Um índice pode fazer referência a um ou mais campos da tabela. A declaração Index geralmente segue a definição do elemento schema principal.
A ordem dos <keyfield>
elementos definidos em um <dbindex>
é muito importante. O primeiro <keyfield>
deve ser o critério de indexação no qual os queries se baseiam principalmente.
O nome do índice no banco de dados é calculado concatenando o nome da tabela e o nome do índice. Por exemplo: Nome da tabela "Amostra", Namespace "Cus", nome do índice "MyIndex"-> nome do campo de índice durante a consulta de criação de índice: "CusSample_myIndex".
_operation (cadeia de caracteres): define o tipo de gravação no banco de dados.
Esse atributo é usado principalmente na extensão de schemas prontos para uso.
Os valores acessíveis são:
applicableIf (cadeia de caracteres): condição para considerar o índice - recebe uma expressão XTK.
label (string): rótulo do índice.
name (MNTOKEN): nome de índice exclusivo.
exclusivo (booleano): se essa opção estiver ativada (@unique="true"), o atributo garantirá a exclusividade do índice em seus campos.
Criação de um índice no campo "id". (o atributo "@unique" no <dbindex>
O elemento aciona a adição da palavra-chave SQL "EXCLUSIVA" quando o índice é criado no banco de dados (query).
<element label="Sample" name="Sample">
<dbindex name="myIndex" label="My index on the ID field" unique="true" applicableIf="HasPackage('nms:social')">
<keyfield xpath="@id"/>
</dbindex>
<attribute name="id" type="long"/>
</element>
ALTER TABLE CusSample ADD iSampleId INTEGER;
UPDATE CusSample SET iSampleId = 0;
ALTER TABLE CusSample ALTER COLUMN iSampleId SET Default 0;
ALTER TABLE CusSample ALTER COLUMN iSampleId SET NOT NULL;
CREATE UNIQUE INDEX CusSample_myIndex ON CusSample(iSampleId);
Criação de um índice composto nos campos "@mail" e "@phoneNumber":
<element label="NewSchemaUser" name="NewSchemaUser">
<dbindex name="myIndex" label="My composite index">
<keyfield xpath="@email"/>
<keyfield xpath="@phone"/>
</dbindex>
<attribute name="email" type="string"/>
<attribute name="phone" type="string"/>
</element>
CREATE INDEX DocNewSchemaUser_myIndex ON DocNewSchemaUser(sEmail, sPhone);