enumeração 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 da instância. O caminho deve ser encerrado com um caractere de barra invertida, o 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 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 da instância. O caminho deve ser encerrado com um caractere de barra invertida, o 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 EDB é o nome base padrão.
EventSource	Esse parâmetro fornece uma cadeia de caracteres específica do aplicativo que será adicionada a todas as mensagens de log de eventos emitidas pelo mecanismo de banco de dados. Isso permite uma correlação fácil 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 de á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 do 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ários para uso por uma instância. Essa configuração afetará quantas tabelas temporárias podem ser usadas ao mesmo tempo. Se esse parâmetro do 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 souber que ele não será usado. O uso de uma tabela temporária também requer um recurso de cursor.
LogFileSize	Esse parâmetro 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 do sistema em unidades de 1024 bytes.
LogBuffers	Esse parâmetro configurará a quantidade de memória usada para armazenar em cache registros de log antes de serem 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 ficar cheio muito rapidamente. Um tamanho de cache maior para o arquivo de log de transações é essencial para um bom desempenho de atualização em uma condição de carga tão alta. O padrão é conhecido por ser muito pequeno para esse caso. Não defina esse parâmetro como um número de buffers maiores (em bytes) do 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 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ções antigos.
DbExtensionSize	Esse parâmetro controla a quantidade de espaço que é adicionada a um arquivo de banco de dados sempre que ele precisa crescer para acomodar mais dados. 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 ser o menor possível. Definir esse parâmetro como SystemParameters.PageTempDBSmallest alcançará o menor banco de dados temporário possível.
CacheSizeMax	Esse parâmetro configura o tamanho máximo do cache da 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 como as páginas de banco de dados são liberadas agressivamente do cache da página do banco de dados para minimizar o tempo necessário para se recuperar de uma falha. O parâmetro é um limite em bytes para saber quantos arquivos de log de transações precisarão ser reproduzidos após uma falha. Se o log circular estiver habilitado usando JET_param. CircularLog, então, 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 quantos E/Ss de arquivo de banco de dados podem ser enfileirados por disco no sistema operacional 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 da página do banco de dados começa a remover páginas do cache para abrir espaço para páginas que não são armazenadas em cache. Quando o número de buffers de página no cache ficar abaixo desse limite, um processo em segundo plano será iniciado para repor esse 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 sempre menor que o limite de parada, conforme 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 buffers disponíveis antes que o aplicativo precise deles. Um limite inicial alto dará ao processo em segundo plano mais tempo para reagir. No entanto, um limite inicial alto implica um limite de parada mais alto e isso reduzirá o tamanho efetivo do cache de páginas 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 de banco de dados termina de remover páginas do cache para abrir espaço para páginas que não são armazenadas em cache. Quando o número de buffers de página no cache aumenta acima desse limite, o processo em segundo plano que foi iniciado para repor esse pool de buffers disponíveis é interrompido. Esse limite é sempre relativo ao tamanho máximo do cache, conforme definido por JET_paramCacheSizeMax. Esse limite também deve ser sempre maior que o limite inicial, conforme definido por JET_paramStartFlushThreshold. A distância entre o limite inicial e o limite de parada afeta a eficiência com que as páginas de banco de dados são liberadas pelo processo em segundo plano. Uma lacuna maior tornará mais provável que as gravações em páginas vizinhas possam ser combinadas. No entanto, um limite de parada alta reduzirá o tamanho efetivo do cache da página do banco de dados para páginas modificadas (Windows 2000) ou para todas as páginas (Windows XP e posterior).
Recuperação	Esse parâmetro é o comutador master que controla a recuperação de falhas de uma instância. Se esse parâmetro estiver definido como "Ativado", a recuperação de estilo do ARIES será usada para levar todos os bancos de dados na instância a um estado consistente em caso de falha de um processo ou computador. Se esse parâmetro for definido como "Desativado", todos os bancos de dados na instância serão gerenciados sem o benefício da recuperação de falha. Ou seja, se a instância não for desligada de forma limpa usando JetTerm antes da saída do processo ou 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 da página do banco de dados em tempo de execução. Normalmente, o cache ajustará automaticamente seu tamanho como uma função dos níveis de atividade do banco de dados e do computador. 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 é verdadeiro, cada banco de dados é verificado na hora jetattachDatabase para índices sobre 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 versão para versão. 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 nesse estado, haverá dois resultados possíveis. Se AttachDatabaseGrbit.DeleteCorruptIndexes tiver sido passado para JetAttachDatabase, esses índices serão excluídos e JET_wrnCorruptIndexDeleted serão retornados de JetAttachDatabase. Esses índices precisarão ser recriados pelo aplicativo. Se AttachDatabaseGrbit.DeleteCorruptIndexes não tiver sido 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 irão para o log de eventos do aplicativo. Se o nome da chave do Registro para outro log de eventos estiver configurado, as mensagens de log de eventos irão para lá.
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 detalhes das mensagens de eventlog emitidas para o eventlog pelo mecanismo de banco de dados. Números mais altos resultarão em mensagens de eventlog mais detalhadas.
DeleteOutOfRangeLogs	Exclua os arquivos de log que não correspondem (geração em termos) durante a recuperação reversível.
CacheSizeMin	Esse parâmetro configura o tamanho mínimo do cache da 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 opcionais em segundo plano, como recuperar 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 define o limite superior no tamanho de um registro individual no banco de dados. No momento, há suporte para apenas um tamanho de página de banco de dados por processo. Isso significa que, se você estiver em um único processo que contenha aplicativos diferentes que usam o mecanismo de banco de dados, todos eles deverão concordar com 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 delegado de JET_CALLBACK . 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. No momento, esse parâmetro não pode ser recuperado.
CleanupMismatchedLogFiles	Esse parâmetro controla o resultado do JetInit quando o mecanismo de banco de dados é configurado para começar a usar arquivos de log de transações em disco que têm um tamanho diferente do configurado. Normalmente, JetInit(JET_INSTANCE) recuperará os bancos de dados com êxito, 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 seu tamanho de arquivo de log de transações, mas ainda funciona de forma transparente em cenários de atualização e restauração.
ExceptionAction	Esse parâmetro controla o que acontece quando uma exceção é gerada 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 capturar e ignorar erroneamente uma exceção gerada pelo mecanismo de banco de dados. Isso não pode ser permitido porque pode ocorrer corrupção de banco de dados. 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 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 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 ao mesmo tempo.

Confira também

Referência

Namespace Microsoft.Isam.Esent.Interop