Función JetCreateIndex2

  • Artículo

Se aplica a: Windows | Windows Server

Función JetCreateIndex2

La función JetCreateIndex2 crea índices sobre los datos de una base de datos ESE, que se pueden usar para localizar datos específicos rápidamente.

    JET_ERR JET_API JetCreateIndex2(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_INDEXCREATE* pindexcreate,
      __in          unsigned long cIndexCreate
    );

Parámetros

sesid

Contexto de sesión de base de datos que se va a usar para la llamada API.

tableid

Tabla en la que se creará el índice.

pindexcreate

Matriz de estructuras de JET_INDEXCREATE , cada una de las cuales define un índice que se va a crear.

cIndexCreate

Número de elementos de la matriz pindexcreate .

Valor devuelto

Esta función devuelve el JET_ERR tipo de datos con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto

Descripción

JET_errSuccess

La operación se ha completado correctamente.

JET_errCannotIndex

Se intentó indizar sobre una columna de actualización de custodia o SLV (tenga en cuenta que las columnas SLV están en desuso).

JET_errColumnNotFound

Se intentó indizar en una columna inexistente. Si se intenta indizar condicionalmente en una columna inexistente, también se puede producir este error.

JET_errDensityInvalid

Este error se devolverá si el miembro ulDensity de la estructura de JET_INDEXCREATE está establecido en un número menor que 20 o más de 100.

JET_errIndexDuplicate

Se intentó definir dos índices idénticos.

JET_errIndexHasPrimary

Se intentó especificar más de un índice principal para una tabla. Una tabla debe tener exactamente un índice principal. Si no se especifica ningún índice principal, el motor de base de datos creará de forma transparente uno.

JET_errIndexInvalidDef

Se especificó una definición de índice no válida. Algunas de las posibles razones para recibir este error son:

  • Un índice principal es condicional (el miembro grbit de JET_INDEXCREATE tiene JET_bitIndexPrimary establecido y el miembro cConditionalColumn de JET_INDEXCREATE es mayor que cero).

  • Windows Server 2003 y versiones posteriores. Intentando crear un índice de tupla con límites de tupla, pero sin pasar información en el miembro ptuplelimits en JET_INDEXCREATE (es decir, grbit tiene JET_bitIndexTupleLimits establecido, pero el puntero ptuplelimits es NULL).

  • Pasar una definición de clave no válida en el miembro szKey de la estructura JET_INDEXCREATE . Consulte JET_INDEXCREATE para obtener una explicación de las definiciones válidas.

  • Establecer el miembro cbVarSegMac en JET_INDEXCREATE que sea mayor que JET_cbPrimaryKeyMost (para un índice principal) o mayor que JET_cbSecondaryKeyMost (para un índice secundario).

  • Pasar una combinación no válida para un índice Unicode definido por el usuario (uno que tiene el bit de JET_bitIndexUnicode establecido en el miembro grbit de JET_INDEXCREATE). Algunas causas comunes pueden ser que el campo pidxunicode de la estructura JET_INDEXCREATE es NULL, o el LCID especificado en la estructura pidxunicode no es válido.

  • Especificar una columna con varios valores para un índice principal.

  • Intentando indexar demasiadas columnas condicionales. El miembro cConditionalColumn de la estructura JET_INDEXCREATE no debe ser mayor que JET_ccolKeyMost.

JET_errIndexTuplesInvalidLimits

Windows XP y versiones posteriores. Se especificó una estructura de JET_TUPLELIMITS y no se admiten sus límites. Vea la sección comentarios de la estructura JET_TUPLELIMITS .

JET_errIndexTuplesNonUniqueOnly

Windows XP y versiones posteriores. Un índice de tupla no puede ser único (grbit no debe tener JET_bitIndexTuples y JET_bitIndexUnique establecido).

JET_errIndexTuplesOneColumnOnly

Windows XP y versiones posteriores. Un índice de tupla solo puede estar sobre una sola columna (es decir, el miembro grbit de la estructura JET_INDEXCREATE tiene JET_bitIndexTuples establecido y el miembro szKey de la estructura JET_INDEXCREATE especifica más de una columna).

JET_errIndexTuplesSecondaryIndexOnly

Windows XP y versiones posteriores. Un índice de tupla no puede ser un índice principal (es decir, el miembro grbit de la estructura de JET_INDEXCREATE no debe tener JET_bitIndexPrimary y JET_bitIndexTuples establecido).

JET_errIndexTuplesTextColumnsOnly

Windows XP y versiones posteriores. Un índice de tupla solo puede estar en una columna text o Unicode. Un intento de indexar otras columnas (por ejemplo, columnas binarias) dará como resultado JET_errIndexTuplesTextColumnsOnly.

JET_errIndexTuplesVarSegMacNotAllowed

Windows XP y versiones posteriores. Un índice de tupla no permite establecer el miembro cbVarSegMac de la estructura JET_INDEXCREATE .

JET_errInTransaction

Se intentó crear un índice sin información de versión mientras se encontraba en una transacción.

JET_errInvalidgrbit

La definición de índice no es válida porque el miembro grbit de la estructura de JET_INDEXCREATE contiene valores incoherentes. Algunas de las razones posibles son:

  • Un índice principal tenía un bit omitido especificado (JET_bitIndexPrimary se pasó con uno de JET_bitIndexIgnoreNull, JET_bitIndexIgnoreAnyNull o JET_bitIndexIgnoreFirstNull).

  • Un índice vacío no omite ningún campo NULL (es decir, el miembro grbit de la estructura JET_INDEXCREATE tiene JET_bitIndexEmpty establecido, pero no tiene JET_bitIndexIgnoreAnyNull establecido).

  • Pasar una estructura de JET_CONDITIONALCOLUMN con un miembro grbit no válido. Consulte JET_CONDITIONALCOLUMN.

Al crear varios índices a la vez (es decir, si el parámetro cIndexCreate es mayor que uno), ninguno de los índices puede contener ninguno de los bits siguientes:

  • JET_bitIndexPrimary

  • JET_bitIndexUnversioned

  • JET_bitIndexEmpty

JET_errInvalidLanguageId

Se pasó un identificador de configuración regional (LCID) no válido (ya sea a través del miembro lcid de la estructura JET_UNICODEINDEX , que el miembro pidxunicode de la estructura JET_INDEXCREATE contiene un puntero a o a través del miembro lcid de la estructura JET_INDEXCREATE ).

JET_errInvalidName

Se especificó un nombre de índice no válido. Consulte JET_INDEXCREATE para obtener más detalles.

JET_errInvalidParameter

Se pasó un parámetro no válido a la API. Algunos de los motivos por los que se puede devolver este error son:

JET_errUnicodeTranslationFail

Error al intentar normalizar una columna Unicode. Esto puede deberse a la ejecución de recursos del sistema.

Comentarios

El valor devuelto se JET_errSuccess al completar correctamente todos los índices especificados.

JetCreateIndex2 recorre en iteración los índices proporcionados en pindexcreate y, a veces, se anularán en el primer error. Es posible que no se hayan intentado los índices después del primer índice con un error, aunque el miembro err de la estructura de JET_INDEXCREATE contenga JET_errSuccess.

Requisitos

Requisito Value

Cliente

Requiere Windows Vista, Windows XP o Windows 2000 Professional.

Servidor

Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.

Encabezado

Declarado en Esent.h.

Library

Use ESENT.lib.

Archivo DLL

Requiere ESENT.dll.

Unicode

Se implementa como JetCreateIndex2W (Unicode) y JetCreateIndex2A (ANSI).

Consulte también

JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_INDEXCREATE
JetCreateIndex
JetCreateTableColumnIndex
JetCreateTableColumnIndex2