Enumeração de JET_param

Parâmetros do sistema ESENT.

Namespace: Microsoft. ISAM. ESENT. Interop
Assembly: Microsoft. ISAM. ESENT. Interop (em Microsoft.Isam.Esent.Interop.dll)

Sintaxe

'Declaration
Public Enumeration JET_param
'Usage
Dim instance As JET_param
public enum JET_param

Membros

Nome do membro Descrição
SystemPath Esse parâmetro indica o caminho relativo ou absoluto do sistema de arquivos da pasta que conterá o arquivo de ponto de verificação para a instância. O caminho deve ser terminado com um caractere de barra invertida, que indica que o caminho de destino é uma pasta.
TempPath Esse parâmetro indica o caminho relativo ou absoluto do sistema de arquivos da pasta ou do arquivo que conterá o banco de dados temporário para a instância. Se o caminho for para uma pasta que conterá o banco de dados temporário, ele deverá ser encerrado com um caractere de barra invertida.
LogFilePath Esse parâmetro indica o caminho relativo ou absoluto do sistema de arquivos da pasta que conterá os logs de transação para a instância. O caminho deve ser terminado com um caractere de barra invertida, que indica que o caminho de destino é uma pasta.
BaseName Esse parâmetro define o prefixo de três letras usado para muitos dos arquivos usados pelo mecanismo de banco de dados. Por exemplo, o arquivo de ponto de verificação é chamado de EDB. CHK por padrão, porque o EDB é o nome de base padrão.
EventSource Esse parâmetro fornece uma cadeia de caracteres específica do aplicativo que será adicionada a qualquer mensagem de log de eventos emitida pelo mecanismo de banco de dados. Isso permite uma fácil correlação de mensagens de log de eventos com o aplicativo de origem. Por padrão, o nome executável do aplicativo host será usado.
MaxSessions Esse parâmetro reserva o número solicitado de recursos de sessão para uso por uma instância. Um recurso de sessão corresponde diretamente a um tipo de dados JET_SESID. Essa configuração afetará quantas sessões podem ser usadas ao mesmo tempo.
MaxOpenTables Esse parâmetro reserva o número solicitado de recursos da árvore B + para uso por uma instância. Essa configuração afetará quantas tabelas podem ser usadas ao mesmo tempo.
MaxCursors Esse parâmetro reserva o número solicitado de recursos de cursor para uso por uma instância. Um recurso de cursor corresponde diretamente a um tipo de dados JET_TABLEID. Essa configuração afetará quantos cursores podem ser usados ao mesmo tempo. Um recurso de cursor não pode ser compartilhado por sessões diferentes, portanto, esse parâmetro deve ser definido como um valor grande o suficiente para que cada sessão possa usar quantos cursores forem necessários.
MaxVerPages Esse parâmetro reserva o número solicitado de páginas de repositório de versão para uso por uma instância.
MaxTemporaryTables Esse parâmetro reserva o número solicitado de recursos de tabela temporária para uso por uma instância. Essa configuração afetará quantas tabelas temporárias podem ser usadas ao mesmo tempo. Se esse parâmetro de sistema for definido como zero, nenhum banco de dados temporário será criado e qualquer atividade que exija o uso do banco de dados temporário falhará. Essa configuração pode ser útil para evitar a e/s necessária para criar o banco de dados temporário se for conhecido que ele não será usado.

O uso de uma tabela temporária também requer um recurso de cursor.

LogFileSize Esse parâmetro irá configurar o tamanho dos arquivos de log de transações. Cada arquivo de log de transações é um tamanho fixo. O tamanho é igual à configuração desse parâmetro de sistema em unidades de 1024 bytes.
LogBuffers Esse parâmetro irá configurar a quantidade de memória usada para armazenar em cache os registros de log antes que eles sejam gravados no arquivo de log de transações. A unidade para esse parâmetro é o tamanho do setor do volume que contém os arquivos de log de transações. O tamanho do setor quase sempre é de 512 bytes, portanto, é seguro assumir esse tamanho para a unidade. Esse parâmetro tem um impacto no desempenho. Quando o mecanismo de banco de dados está sob carga de atualização pesada, esse buffer pode se tornar completo com muita rapidez. Um tamanho de cache maior para o arquivo de log de transações é essencial para um bom desempenho de atualização sob uma condição de alta carga. O padrão é conhecido como muito pequeno para esse caso. Não defina esse parâmetro como um número de buffers que seja maior (em bytes) que metade do tamanho de um arquivo de log de transações.
CircularLog Esse parâmetro configura como os arquivos de log de transações são gerenciados pelo mecanismo de banco de dados. Quando o log circular está desativado, todos os arquivos de log de transações gerados são mantidos no disco até que não sejam mais necessários porque um backup completo do banco de dados foi executado. Quando o log circular está ativado, somente os arquivos de log de transações mais jovens do que o ponto de verificação atual são mantidos no disco. O benefício desse modo é que os backups não são necessários para desativar arquivos de log de transação antigos.
DbExtensionSize Esse parâmetro controla a quantidade de espaço que é adicionada a um arquivo de banco de dados cada vez que ele precisa aumentar para acomodar mais informações. O tamanho está em páginas de banco de dados.
PageTempDBMin Esse parâmetro controla o tamanho inicial do banco de dados temporário. O tamanho está em páginas de banco de dados. Um tamanho de zero indica que o tamanho padrão de um banco de dados comum deve ser usado. Geralmente, é desejável que aplicativos pequenos configurem o banco de dados temporário para que seja o menor possível. Definir esse parâmetro como SystemParameters. PageTempDBSmallest atingirá o menor banco de dados temporário possível.
CacheSizeMax Esse parâmetro configura o tamanho máximo do cache de página do banco de dados. O tamanho está em páginas de banco de dados. Se esse parâmetro for deixado para seu valor padrão, o tamanho máximo do cache será definido como o tamanho da memória física quando JetInit for chamado.
CheckpointDepthMax Esse parâmetro controla o quão agressivamente as páginas do banco de dados são liberadas do cache de página do banco de dados para minimizar a quantidade de tempo que levará para se recuperar de uma falha. O parâmetro é um limite em bytes para saber quantos arquivos de log de transações deverão ser reproduzidos após uma falha. Se o log circular estiver habilitado usando JET_param. CircularLog, esse parâmetro também controlará a quantidade aproximada de arquivos de log de transações que serão retidos no disco.
OutstandingIOMax Esse parâmetro controla quantas e/SS de arquivo de banco de dados podem ser enfileiradas por disco no sistema operacional do host ao mesmo tempo. Um valor maior para esse parâmetro pode ajudar significativamente o desempenho de um aplicativo de banco de dados grande.
StartFlushThreshold Esse parâmetro controla quando o cache de página do banco de dados começa a remover páginas do cache para liberar espaço para páginas que não são armazenadas em cache. Quando o número de buffers de página no cache cair abaixo desse limite, um processo em segundo plano será iniciado para reabastecer o pool de buffers disponíveis. Esse limite é sempre relativo ao tamanho máximo do cache, conforme definido por JET_paramCacheSizeMax. Esse limite também deve ser menor que o limite de parada definido por JET_paramStopFlushThreshold. A altura da distância do limite inicial determinará o tempo de resposta que o cache da página do banco de dados deve ter para produzir os buffers disponíveis antes que o aplicativo precise deles. Um limite de início alto dará ao processo em segundo plano mais tempo para reagir. No entanto, um limite de início alto implica um limite de parada maior e reduzirá o tamanho efetivo do cache de página de banco de dados para páginas modificadas (Windows 2000) ou para todas as páginas (Windows XP e posterior).
StopFlushThreshold Esse parâmetro controla quando o cache da página do banco de dados encerra a remoção de páginas do cache para liberar espaço para páginas que não são armazenadas em cache. Quando o número de buffers de página no cache ultrapassar esse limite, o processo em segundo plano que foi iniciado para reabastecer o pool de buffers disponíveis será interrompido. Esse limite é sempre relativo ao tamanho máximo do cache, conforme definido por JET_paramCacheSizeMax. Esse limite também deve ser maior que o limite de início definido por JET_paramStartFlushThreshold. A distância entre o limite inicial e o limite de interrupção afeta a eficiência com a qual as páginas de banco de dados são liberadas pelo processo em segundo plano. Um intervalo maior fará com que seja mais provável que as gravações nas páginas vizinhas possam ser combinadas. No entanto, um limite de parada alta reduzirá o tamanho efetivo do cache de página de banco de dados para páginas modificadas (Windows 2000) ou para todas as páginas (Windows XP e posterior).
Recuperação Esse parâmetro é a opção mestra que controla a recuperação de falha de uma instância. Se esse parâmetro for definido como " on " , a recuperação de estilo Aries será usada para colocar todos os bancos de dados na instância em um estado consistente no caso de uma falha de processo ou máquina. Se esse parâmetro for definido como " off " , todos os bancos de dados na instância serão gerenciados sem o benefício da recuperação de falha. Isso significa que, se a instância não for desligada corretamente usando JetTerm antes da saída do processo ou do desligamento do computador, o conteúdo de todos os bancos de dados nessa instância será corrompido.
EnableOnlineDefrag Esse parâmetro controla o comportamento da desfragmentação online quando iniciado usando JetDefragment (JET_SESID, JET_DBID, String, Int32, Int32, DefragGrbit) e JetDefragment2 (JET_SESID, JET_DBID, String, Int32, Int32, JET_CALLBACK, DefragGrbit).
CacheSize Esse parâmetro pode ser usado para controlar o tamanho do cache de página do banco de dados em tempo de execução. Normalmente, o cache ajustará automaticamente seu tamanho como uma função de níveis de atividade de banco de dados e máquina. Se o aplicativo definir esse parâmetro como zero, o cache ajustará seu próprio tamanho dessa maneira. No entanto, se o aplicativo definir esse parâmetro como um valor diferente de zero, o cache se ajustará a esse tamanho de destino.
EnableIndexChecking Quando esse parâmetro for true, todos os bancos de dados serão verificados em JetAttachDatabase tempo para índices em colunas de chave Unicode que foram criadas usando uma versão mais antiga da biblioteca NLS no sistema operacional. Isso deve ser feito porque o mecanismo de banco de dados persiste as chaves de classificação geradas por LCMapStringW e o valor dessas chaves de classificação muda de Release para Release. Se for detectado que um índice primário está nesse estado, JetAttachDatabase sempre falhará com JET_err. PrimaryIndexCorrupted. Se algum índice secundário for detectado para estar nesse estado, haverá dois resultados possíveis. Se AttachDatabaseGrbit. DeleteCorruptIndexes foi passado para JetAttachDatabase, esses índices serão excluídos e JET_wrnCorruptIndexDeleted serão retornados de JetAttachDatabase. Esses índices precisarão ser recriados pelo seu aplicativo. Se AttachDatabaseGrbit. DeleteCorruptIndexes não foi passado para JetAttachDatabase, a chamada falhará com JET_errSecondaryIndexCorrupted.
EventSourceKey Esse parâmetro pode ser usado para controlar qual log de eventos o mecanismo de banco de dados usa para suas mensagens de log de eventos. Por padrão, todas as mensagens de log de eventos vão para o log de eventos do aplicativo. Se o nome da chave do registro para outro log de eventos estiver configurado, as mensagens do log de eventos entrarão em seu lugar.
NoInformationEvent Quando esse parâmetro for true, as mensagens de log de eventos informativas que normalmente seriam geradas pelo mecanismo de banco de dados serão suprimidas.
EventLoggingLevel Configura o nível de detalhe das mensagens de log de eventos emitidas para o log de eventos pelo mecanismo de banco de dados. Números mais altos resultarão em mensagens de log de eventos mais detalhadas.
DeleteOutOfRangeLogs Exclua os arquivos de log que não são correspondentes (geração Wise) durante a recuperação simples.
CacheSizeMin Esse parâmetro configura o tamanho mínimo do cache de página do banco de dados. O tamanho está em páginas de banco de dados.
PreferredVerPages Esse parâmetro representa um limite relativo a MaxVerPages que controla o uso discricionário de páginas de versão pelo mecanismo de banco de dados. Se o tamanho do repositório de versão exceder esse limite, todas as informações usadas apenas para tarefas em segundo plano opcionais, como a recuperação de espaço excluído no banco de dados, serão sacrificadas para preservar espaço para informações transacionais.
DatabasePageSize Esse parâmetro configura o tamanho da página para o banco de dados. O tamanho da página é a menor unidade de alocação de espaço possível para um arquivo de banco de dados. O tamanho da página do banco de dados também é muito importante porque ele define o limite superior do tamanho de um registro individual no banco de dados.

Há suporte para apenas um tamanho de página de banco de dados por processo no momento. Isso significa que, se você estiver em um único processo que contém diferentes aplicativos que usam o mecanismo de banco de dados, todos eles deverão concordar em um tamanho de página de banco de dados.

ErrorToString Esse parâmetro pode ser usado para converter um JET_ERR em uma cadeia de caracteres. Isso só deve ser usado com JetGetSystemParameter.
RuntimeCallback Configura o mecanismo com um JET_CALLBACK delegado. Esse retorno de chamada pode ser chamado pelos seguintes motivos: FreeCursorLS, FreeTableLS ou NULL. Consulte JetSetLS (JET_SESID, JET_TABLEID, JET_LS, LsGrbit) para obter mais informações. Este parâmetro não pode ser recuperado no momento.
CleanupMismatchedLogFiles Esse parâmetro controla o resultado de JetInit quando o mecanismo de banco de dados é configurado para começar a usar arquivos de log de transações em um disco que tenha um tamanho diferente do que está configurado. Normalmente, JetInit (JET_INSTANCE) recuperará com êxito os bancos de dados, mas falhará com LogFileSizeMismatchDatabasesConsistent para indicar que o tamanho do arquivo de log está configurado incorretamente. No entanto, quando esse parâmetro for definido como true, o mecanismo de banco de dados excluirá silenciosamente todos os arquivos de log antigos, iniciará um novo conjunto de arquivos de log de transações usando o tamanho do arquivo de log configurado. Esse parâmetro é útil quando o aplicativo deseja alterar de forma transparente o tamanho do arquivo de log de transações e ainda funcionar de forma transparente nos cenários de atualização e restauração.
Exceçãoaction Esse parâmetro controla o que acontece quando uma exceção é lançada pelo mecanismo de banco de dados ou pelo código que é chamado pelo mecanismo de banco de dados. Quando definido como JET_ExceptionMsgBox, qualquer exceção será lançada para o filtro de exceção sem tratamento do Windows. Isso fará com que a exceção seja tratada como uma falha do aplicativo. A intenção é impedir que o código do aplicativo tente detectar erroneamente e ignorar uma exceção gerada pelo mecanismo de banco de dados. Isso não pode ser permitido porque a corrupção do banco de dados pode ocorrer. Se o aplicativo quiser lidar corretamente com essas exceções, a proteção poderá ser desabilitada definindo esse parâmetro como JET_ExceptionNone.
CreatePathIfNotExist Quando esse parâmetro for definido como true, qualquer pasta que estiver ausente em um caminho do sistema de arquivos em uso pelo mecanismo de banco de dados será criada silenciosamente. Caso contrário, a operação que usa o caminho do sistema de arquivos ausente irá falhar com JET_err. InvalidPath.
OneDatabasePerSession Quando esse parâmetro for true, somente um banco de dados poderá ser aberto usando JetOpenDatabase por uma determinada sessão ao mesmo tempo. O banco de dados temporário é excluído dessa restrição.
MaxInstances Esse parâmetro controla o número máximo de instâncias que podem ser criadas em um único processo.
VersionStoreTaskQueueMax Esse parâmetro controla o número de itens de trabalho de limpeza em segundo plano que podem ser enfileirados no pool de threads do mecanismo de banco de dados a qualquer momento.

Confira também

Referência

Namespace Microsoft. ISAM. ESENT. Interop