enumeración JET_param

Parámetros del sistema ESENT.

Espacio de nombres:Microsoft.Isam.Esent.Interop
Ensamblaje: Microsoft.Isam.Esent.Interop (en Microsoft.Isam.Esent.Interop.dll)

Sintaxis

'Declaration
Public Enumeration JET_param
'Usage
Dim instance As JET_param

public enum JET_param

Miembros

Nombre del miembro	Descripción
SystemPath	Este parámetro indica la ruta de acceso del sistema de archivos relativa o absoluta de la carpeta que contendrá el archivo de punto de comprobación de la instancia. La ruta de acceso debe terminarse con un carácter de barra diagonal inversa, que indica que la ruta de acceso de destino es una carpeta.
TempPath	Este parámetro indica la ruta de acceso del sistema de archivos relativa o absoluta de la carpeta o archivo que contendrá la base de datos temporal de la instancia. Si la ruta de acceso es a una carpeta que contendrá la base de datos temporal, debe terminarse con un carácter de barra diagonal inversa.
LogFilePath	Este parámetro indica la ruta de acceso del sistema de archivos relativa o absoluta de la carpeta que contendrá los registros de transacciones de la instancia. La ruta de acceso debe terminarse con un carácter de barra diagonal inversa, que indica que la ruta de acceso de destino es una carpeta.
BaseName	Este parámetro establece el prefijo de tres letras usado para muchos de los archivos usados por el motor de base de datos. Por ejemplo, el archivo de punto de control se denomina EDB. CHK de forma predeterminada porque EDB es el nombre base predeterminado.
EventSource	Este parámetro proporciona una cadena específica de la aplicación que se agregará a los mensajes de registro de eventos emitidos por el motor de base de datos. Esto permite una correlación sencilla de mensajes de registro de eventos con la aplicación de origen. De forma predeterminada, se usará el nombre ejecutable de la aplicación host.
MaxSessions	Este parámetro reserva el número solicitado de recursos de sesión para su uso por parte de una instancia. Un recurso de sesión corresponde directamente a un tipo de datos JET_SESID. Esta configuración afectará al número de sesiones que se pueden usar al mismo tiempo.
MaxOpenTables	Este parámetro reserva el número solicitado de recursos de árbol B+ para su uso por una instancia. Esta configuración afectará al número de tablas que se pueden usar al mismo tiempo.
MaxCursors	Este parámetro reserva el número solicitado de recursos de cursor para su uso por parte de una instancia. Un recurso de cursor corresponde directamente a un tipo de datos JET_TABLEID. Esta configuración afectará al número de cursores que se pueden usar al mismo tiempo. Un recurso de cursor no se puede compartir mediante sesiones diferentes, por lo que este parámetro debe establecerse en un valor lo suficientemente grande como para que cada sesión pueda usar tantos cursores como sea necesario.
MaxVerPages	Este parámetro reserva el número solicitado de páginas de almacén de versiones para su uso por parte de una instancia.
MaxTemporaryTables	Este parámetro reserva el número solicitado de recursos de tabla temporal para su uso por parte de una instancia. Esta configuración afectará al número de tablas temporales que se pueden usar al mismo tiempo. Si este parámetro del sistema se establece en cero, no se creará ninguna base de datos temporal y se producirá un error en cualquier actividad que requiera el uso de la base de datos temporal. Esta configuración puede ser útil para evitar la E/S necesaria para crear la base de datos temporal si se sabe que no se usará. El uso de una tabla temporal también requiere un recurso de cursor.
LogFileSize	Este parámetro configurará el tamaño de los archivos de registro de transacciones. Cada archivo de registro de transacciones es de tamaño fijo. El tamaño es igual al valor de este parámetro del sistema en unidades de 1024 bytes.
LogBuffers	Este parámetro configurará la cantidad de memoria usada para almacenar en caché los registros de registro antes de que se escriban en el archivo de registro de transacciones. La unidad de este parámetro es el tamaño del sector del volumen que contiene los archivos de registro de transacciones. El tamaño del sector casi siempre es de 512 bytes, por lo que es seguro asumir ese tamaño para la unidad. Este parámetro tiene un impacto en el rendimiento. Cuando el motor de base de datos está bajo una carga de actualización intensiva, este búfer puede llenarse muy rápidamente. Un tamaño de caché mayor para el archivo de registro de transacciones es fundamental para un buen rendimiento de actualización en una condición de carga tan alta. Se sabe que el valor predeterminado es demasiado pequeño para este caso. No establezca este parámetro en un número de búferes mayores (en bytes) que la mitad del tamaño de un archivo de registro de transacciones.
CircularLog	Este parámetro configura cómo el motor de base de datos administra los archivos de registro de transacciones. Cuando el registro circular está desactivado, todos los archivos de registro de transacciones que se generan se conservan en el disco hasta que ya no son necesarios porque se ha realizado una copia de seguridad completa de la base de datos. Cuando el registro circular está activado, solo se conservan los archivos de registro de transacciones más pequeños que el punto de control actual en el disco. La ventaja de este modo es que las copias de seguridad no son necesarias para retirar los archivos antiguos del registro de transacciones.
DbExtensionSize	Este parámetro controla la cantidad de espacio que se agrega a un archivo de base de datos cada vez que necesita crecer para dar cabida a más datos. El tamaño está en páginas de base de datos.
PageTempDBMin	Este parámetro controla el tamaño inicial de la base de datos temporal. El tamaño está en páginas de base de datos. Un tamaño de cero indica que se debe usar el tamaño predeterminado de una base de datos normal. A menudo, es conveniente que las aplicaciones pequeñas configuren la base de datos temporal para que sea lo más pequeña posible. Establecer este parámetro en SystemParameters.PageTempDBSmallest logrará la base de datos temporal más pequeña posible.
CacheSizeMax	Este parámetro configura el tamaño máximo de la caché de páginas de la base de datos. El tamaño está en páginas de base de datos. Si este parámetro se deja en su valor predeterminado, el tamaño máximo de la memoria caché se establecerá en el tamaño de la memoria física cuando se llame a JetInit.
CheckpointDepthMax	Este parámetro controla cómo se vacían las páginas de base de datos de forma agresiva desde la memoria caché de páginas de la base de datos para minimizar la cantidad de tiempo que se tardará en recuperarse de un bloqueo. El parámetro es un umbral en bytes para el número de archivos de registro de transacciones que deberán reproducirse después de un bloqueo. Si el registro circular está habilitado mediante JET_param. CircularLog, a continuación, este parámetro también controlará la cantidad aproximada de archivos de registro de transacciones que se conservarán en el disco.
OutstandingIOMax	Este parámetro controla cuántas E/S de archivos de base de datos se pueden poner en cola por disco en el sistema operativo host a la vez. Un valor mayor para este parámetro puede ayudar significativamente al rendimiento de una aplicación de base de datos grande.
StartFlushThreshold	Este parámetro controla cuando la caché de páginas de la base de datos comienza a expulsar páginas de la memoria caché para dejar espacio para las páginas que no están almacenadas en caché. Cuando el número de búferes de página de la memoria caché cae por debajo de este umbral, se iniciará un proceso en segundo plano para reponer ese grupo de búferes disponibles. Este umbral siempre es relativo al tamaño máximo de caché establecido por JET_paramCacheSizeMax. Este umbral también debe ser siempre menor que el umbral de parada establecido por JET_paramStopFlushThreshold. El alto de distancia del umbral de inicio determinará el tiempo de respuesta que debe tener la caché de páginas de la base de datos para generar búferes disponibles antes de que la aplicación los necesite. Un umbral de inicio alto dará más tiempo al proceso en segundo plano para reaccionar. Sin embargo, un umbral de inicio alto implica un umbral de detención superior y que reducirá el tamaño efectivo de la caché de páginas de la base de datos para las páginas modificadas (Windows 2000) o para todas las páginas (Windows XP y versiones posteriores).
StopFlushThreshold	Este parámetro controla cuando la caché de páginas de la base de datos termina expulsando páginas de la memoria caché para dejar espacio para las páginas que no están almacenadas en caché. Cuando el número de búferes de página de la memoria caché aumenta por encima de este umbral, se detiene el proceso en segundo plano que se inició para reponer ese grupo de búferes disponibles. Este umbral siempre es relativo al tamaño máximo de caché establecido por JET_paramCacheSizeMax. Este umbral también debe ser siempre mayor que el umbral de inicio establecido por JET_paramStartFlushThreshold. La distancia entre el umbral de inicio y el umbral de parada afecta a la eficacia con la que el proceso en segundo plano vacía las páginas de la base de datos. Una brecha mayor hará que sea más probable que se combinen las escrituras en páginas vecinas. Sin embargo, un umbral de alto alto reducirá el tamaño efectivo de la caché de páginas de la base de datos para las páginas modificadas (Windows 2000) o para todas las páginas (Windows XP y versiones posteriores).
Recuperación	Este parámetro es el conmutador maestro que controla la recuperación de bloqueos para una instancia de . Si este parámetro se establece en "Activado", se usará la recuperación de estilo ARIES para llevar todas las bases de datos de la instancia a un estado coherente en caso de bloqueo de proceso o máquina. Si este parámetro se establece en "Off", todas las bases de datos de la instancia se administrarán sin la ventaja de la recuperación de bloqueos. Es decir, que si la instancia no se cierra limpiamente mediante JetTerm antes de que el proceso salga o el apagado de la máquina, el contenido de todas las bases de datos de esa instancia se dañará.
EnableOnlineDefrag	Este parámetro controla el comportamiento de la desfragmentación en línea cuando se inicia mediante JetDefragment(JET_SESID, JET_DBID, String, Int32, Int32, DefragGrbit) y JetDefragment2(JET_SESID, JET_DBID, String, Int32, Int32, JET_CALLBACK, DefragGrbit)).
CacheSize	Este parámetro se puede usar para controlar el tamaño de la caché de páginas de la base de datos en tiempo de ejecución. Normalmente, la memoria caché ajustará automáticamente su tamaño como función de los niveles de actividad de la base de datos y la máquina. Si la aplicación establece este parámetro en cero, la memoria caché ajustará su propio tamaño de esta manera. Sin embargo, si la aplicación establece este parámetro en un valor distinto de cero, la memoria caché se ajustará a ese tamaño de destino.
EnableIndexChecking	Cuando este parámetro es true, todas las bases de datos se comprueban en la hora de JetAttachDatabase en busca de índices sobre columnas de clave Unicode compiladas con una versión anterior de la biblioteca NLS en el sistema operativo. Esto debe hacerse porque el motor de base de datos conserva las claves de ordenación generadas por LCMapStringW y el valor de estas claves de ordenación cambian de versión a versión. Si se detecta que un índice principal está en este estado, JetAttachDatabase siempre producirá un error con JET_err. PrimaryIndexCorrupted. Si se detecta que hay índices secundarios en este estado, hay dos resultados posibles. Si AttachDatabaseGrbit.DeleteCorruptIndexes se pasó a JetAttachDatabase, estos índices se eliminarán y JET_wrnCorruptIndexDeleted se devolverán desde JetAttachDatabase. La aplicación deberá volver a crear estos índices. Si AttachDatabaseGrbit.DeleteCorruptIndexes no se pasó a JetAttachDatabase, se producirá un error en la llamada con JET_errSecondaryIndexCorrupted.
EventSourceKey	Este parámetro se puede usar para controlar qué registro de eventos usa el motor de base de datos para sus mensajes de registro de eventos. De forma predeterminada, todos los mensajes de registro de eventos van al registro de eventos de la aplicación. Si el nombre de la clave del Registro para otro registro de eventos está configurado, los mensajes del registro de eventos irán allí en su lugar.
NoInformationEvent	Cuando este parámetro es true, se suprimirán los mensajes de registro de eventos informativos que normalmente generarían el motor de base de datos.
EventLoggingLevel	Configura el nivel de detalle de los mensajes de registro de eventos emitidos al registro de eventos por el motor de base de datos. Los números más altos darán lugar a mensajes de registro de eventos más detallados.
DeleteOutOfRangeLogs	Elimine los archivos de registro que no coinciden (de generación) durante la recuperación temporal.
CacheSizeMin	Este parámetro configura el tamaño mínimo de la memoria caché de páginas de base de datos. El tamaño está en páginas de base de datos.
PreferredVerPages	Este parámetro representa un umbral relativo a MaxVerPages que controla el uso discrecional de las páginas de versión por el motor de base de datos. Si el tamaño del almacén de versiones supera este umbral, cualquier información que solo se use para tareas en segundo plano opcionales, como recuperar espacio eliminado en la base de datos, se sacrifica en su lugar para conservar espacio para la información transaccional.
DatabasePageSize	Este parámetro configura el tamaño de página de la base de datos. El tamaño de página es la unidad más pequeña de asignación de espacio posible para un archivo de base de datos. El tamaño de página de la base de datos también es muy importante porque establece el límite superior en el tamaño de un registro individual de la base de datos. Solo se admite un tamaño de página de base de datos por proceso en este momento. Esto significa que si se encuentra en un único proceso que contiene diferentes aplicaciones que usan el motor de base de datos, todos deben aceptar un tamaño de página de base de datos.
ErrorToString	Este parámetro se puede usar para convertir un JET_ERR en una cadena. Esto solo se debe usar con JetGetSystemParameter.
RuntimeCallback	Configura el motor con un delegado JET_CALLBACK . Se puede llamar a esta devolución de llamada por los siguientes motivos: FreeCursorLS, FreeTableLS o Null. Consulte JetSetLS(JET_SESID, JET_TABLEID, JET_LS, LsGrbit) para obtener más información. Este parámetro no se puede recuperar actualmente.
CleanupMismatchedLogFiles	Este parámetro controla el resultado de JetInit cuando el motor de base de datos está configurado para empezar a usar archivos de registro de transacciones en el disco que tienen un tamaño diferente al configurado. Normalmente, JetInit(JET_INSTANCE) recuperará correctamente las bases de datos, pero producirá un error en LogFileSizeMismatchDatabasesConsistent para indicar que el tamaño del archivo de registro está mal configurado. Sin embargo, cuando este parámetro se establece en true, el motor de base de datos eliminará silenciosamente todos los archivos de registro antiguos, inicie un nuevo conjunto de archivos de registro de transacciones mediante el tamaño del archivo de registro configurado. Este parámetro es útil cuando la aplicación desea cambiar de forma transparente su tamaño de archivo de registro de transacciones, pero sigue funcionando de forma transparente en escenarios de actualización y restauración.
ExceptionAction	Este parámetro controla lo que sucede cuando el motor de base de datos o el código que llama el motor de base de datos produce una excepción. Cuando se establece en JET_ExceptionMsgBox, se producirá cualquier excepción en el filtro de excepciones no controladas de Windows. Esto provocará que la excepción se controle como un error de aplicación. La intención es evitar que el código de aplicación intente detectar e ignorar erróneamente una excepción generada por el motor de base de datos. Esto no se puede permitir porque se pueden producir daños en la base de datos. Si la aplicación desea controlar correctamente estas excepciones, la protección se puede deshabilitar estableciendo este parámetro en JET_ExceptionNone.
CreatePathIfNotExist	Cuando este parámetro se establece en true, se creará silenciosamente cualquier carpeta que falte en una ruta de acceso del sistema de archivos que use el motor de base de datos. De lo contrario, se producirá un error en la operación que usa la ruta de acceso del sistema de archivos que falta con JET_err. InvalidPath.
OneDatabasePerSession	Cuando este parámetro es true, solo se permite abrir una base de datos mediante JetOpenDatabase mediante una sesión determinada a la vez. La base de datos temporal se excluye de esta restricción.
MaxInstances	Este parámetro controla el número máximo de instancias que se pueden crear en un único proceso.
VersionStoreTaskQueueMax	Este parámetro controla el número de elementos de trabajo de limpieza en segundo plano que se pueden poner en cola en el grupo de subprocesos del motor de base de datos en cualquier momento.

Consulte también

Referencia

Espacio de nombres Microsoft.Isam.Esent.Interop