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 de índice segue normalmente a definição do elemento principal do schema.
A ordem dos elementos <keyfield>
definidos em <dbindex>
é muito importante. O primeiro <keyfield>
deve ser o critério de indexação no qual os query 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 da criação do índice: "CusSample_myIndex".
_operation (cadeia de caracteres): define o tipo de gravação no banco de dados.
Este atributo é usado principalmente ao estender schemas prontos para uso.
Os valores acessíveis são:
applyIf (string): condição para levar em conta o índice - recebe uma expressão XTK.
label (string): rótulo do índice.
name (MNTOKEN): nome de índice exclusivo.
único (booleano): se essa opção estiver ativada (@unique="true"), o atributo garante a exclusividade do índice em todos os campos.
Criação de um índice no campo "id". (o atributo "@unique" no elemento <dbindex>
aciona a adição da palavra-chave SQL "UNIQUE" 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);