CREATE INDEX

CREATE INDEX ( tabla ; arrayCampos ; tipoIndice ; nombreIndice {; *} )

Parámetro	Tipo		Descripción
tabla	Table	→	Tabla para la cual crear un índice
arrayCampos	Pointer array	→	Puntero(s) a el/los campo(s) a indexar
tipoIndice	Integer	→	Tipo de índice a crear: -1 = Palabras claves, 0 = por defecto, 1 = B-Tree estándar, 3 = B-Tree cluster
nombreIndice	Text	→	Nombre del índice a crear
*	Operador	→	Si pasa = indexación asincrónica

Descripción

El comando CREATE INDEX permite crear:

• Un índice estándar en uno o más campos (índice compuesto) o
• Un índice de palabras claves en un campo.

El índice se crea para la tabla laTabla utilizando uno o más campos designados por el array de punteros arrayCampos. Este array contiene una sola línea si quiere crear un índice simple y dos o más cuando quiere crear un índice compuesto (excepto en el caso de un índice de palabras claves). En el caso de los índices compuestos, el orden de los campos en el array es importante durante la construcción del índice.

El parámetro tipoIndice permite definir el tipo de índice a crear. Puede pasar una de las siguientes constantes, que se encuentran en el tema “Tipo de índice”:

Constante	Tipo	Valor	Comentario
Cluster BTree index	Entero largo	3	Índice de tipo B-Tree utilizando clusters. Este tipo de índice se optimiza cuando el índice contiene pocas palabras claves, es decir cuando los mismos valores se presentan con frecuencia en los datos.
Default index type	Entero largo	0	4D define el tipo de índice (excepto los índices de palabras claves) que es el más optimizado en función del contenido del campo.
Keywords index	Entero largo	-1	Permite la indexación palabra por palabra del contenido del campo. Este tipo de índice sólo puede utilizarse con campos de tipo Texto, Alfa e Imagen. Atención los índices de palabras claves no pueden ser compuestos
Standard BTree index	Entero largo	1	Índice de tipo B-Tree clásico. Este tipo de índice multi propósito se utiliza en las versiones anteriores de 4D

Nota: un índice B-Tree asociado a un campo de tipo texto almacena como máximo los primeros 1024 caracteres del campo. Por lo tanto en este contexto, las búsquedas en las cadenas que contienen más de 1024 caracteres fallarán.

Pase en nomIndice el nombre del índice a crear. Es necesario dar nombres a los índices si varios índices de diferentes tipos pueden asociarse a un mismo campo y si prefiere poder borrarlos individualmente con la ayuda del comando DELETE INDEX. Si el índice nomIndice ya existe, el comando no hace nada.

El parámetro opcional *, cuando se pasa, permite efectuar la indexación en modo asincrónico. En este modo, el método original continua su ejecución después de la llamada del comando, sin importar si la indexación ha terminado o no.

Si el comando CREATE INDEX encuentra registros bloqueados, estos no se indexarán y el comando esperará a que se desbloqueen.

Si ocurre un problema durante la ejecución del comando (campo no indexable, intento de creación de un índice de palabras claves de más de un campo, etc.), se genera un error. Este error puede interceptarse utilizando un método de gestión de errores.

Nota para despliegue

Dado que este comando modifica la estructura de la base de datos, no puede utilizarse en el contexto de una aplicación empaquetada de sólo lectura (archivo .4dc instalado en la carpeta Archivos de programa o archivo .4dz).

Ejemplo 1

Creación de dos índices estándar en los campos “Apellido” y “Teléfono” de la tabla [Clientes]:

 ARRAY POINTER(arrayPtrCampo;1)
 fieldPtrArr{1}:=->[Clientes]Apellido
 CREATE INDEX([Clientes];arrayPtrCampo;Standard BTree Index;"CustLNameIdx")
 fieldPtrArr{1}:=->[Clientes]Telefono
 CREATE INDEX([Clientes];arrayPtrCampo;Standard BTree Index;"CustTelIdx")

Ejemplo 2

Creación de un índice de palabras claves en el campo “Observaciones” de la tabla [Clientes]:

 ARRAY POINTER(arrayPtrCampo;1)
 fieldPtrArr{1}:=->[Clientes]Observaciones
 CREATE INDEX([Clientes];arrayPtrCampo;Keywords Index;"CustObsIdx")

Ejemplo 3

Creación de un índice compuesto en los campos “Ciudad” y “CodigoPostal” de la tabla [Clientes]:

 ARRAY POINTER(arrayPtrCampo;2)
 fieldPtrArr{1}:=->[Clientes]Ciudad
 fieldPtrArr{2}:=->[Clientes]CodigoPostal
 CREATE INDEX([Clientes];arrayPtrCampo;Standard BTree Index;"CityZip")

Ver también

DELETE INDEX
RESUME INDEXES
SET INDEX

Propiedades

Número de comando	966
Hilo seguro	✓