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á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 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á nas páginas do banco de dados.
PageTempDBMin Esse parâmetro controla o tamanho inicial do banco de dados temporário. O tamanho está nas páginas do banco de dados. Um tamanho 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á nas páginas do 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 quantas E/Ss de arquivo de banco de dados podem ser enfileiradas 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 de início 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 da página de banco de dados para páginas modificadas (Windows 2000) ou para todas as páginas (Windows XP e posteriores).
StopFlushThreshold Esse parâmetro controla quando o cache da página do 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 mestre que controla a recuperação de falha 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 da instância a um estado consistente no caso de um processo ou falha no 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 falhas. 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.
HabilitarOnlineDefrag Esse parâmetro controla o comportamento de 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 pelo LCMapStringW e o valor dessas chaves de classificação é alterado de versão para versão. Se um índice primário for detectado 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 verdadeiro, as mensagens de log de eventos informativos 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 são correspondentes (geração sábia) 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á nas páginas do banco de dados.
PreferredVerPages Esse parâmetro representa um limite relativo ao 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ões 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 do 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 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. Esse parâmetro não pode ser recuperado no momento.
CleanupMismatchedLogFiles Esse parâmetro controla o resultado do JetInit quando o mecanismo de banco de dados está configurado para começar a usar arquivos de log de transações em disco de 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, 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 código que é chamado pelo mecanismo de banco de dados. Quando definido como JET_ExceptionMsgBox, qualquer exceção será lançada no Windows filtro de exceção sem tratamento. Isso resultará na manipulação da exceção 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 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 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 verdadeiro, apenas 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