Compartilhar via


Parâmetros de Log de Transação

Aplica-se a: Windows | Windows Server

Neste artigo
Parâmetros de Log de Transação
Requisitos
Consulte Também

Parâmetros de Log de Transação

Este tópico contém parâmetros usados para logs de transações.

JET_paramBaseName
3

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. O nome base pode ser usado para distinguir facilmente entre conjuntos de arquivos que pertencem a instâncias diferentes ou a aplicativos diferentes.

Rótulo Valor

Valor Padrão:

"edb"

Tipo:

String

Intervalo válido:

3 caracteres

Escopo:

Instância

Set After JetCreateInstance:

Sim

Definido após JetInit:

Não

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Não

Afeta o desempenho:

Não

Afeta recursos:

Não

Disponibilidade:

Tudo

JET_paramCircularLog
17

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 retidos no disco até que não sejam mais necessários porque um backup completo do banco de dados foi executado. Nesse modo, é possível restaurar de um backup mais antigo e executar para frente por meio de todos os arquivos de log de transações retidos, de modo que nenhum dado seja perdido como resultado do desastre que forçou a restauração. Backups completos regulares são necessários para impedir que o disco seja preenchido com arquivos de log de transações.

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. A desvantagem é que uma restauração de perda de dados zero não é mais possível.

Rótulo Valor

Valor Padrão:

Falso

Tipo:

Booliano

Intervalo válido:

False, True

Escopo:

Instância

Set After JetCreateInstance:

Sim

Definido após JetInit:

Não

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Sim

Afeta o desempenho:

Não

Afeta recursos:

Sim

Disponibilidade:

Tudo

JET_paramCommitDefault
16

Esse parâmetro controla a ação padrão executada quando a transação mais externa é confirmada em uma sessão. Qualquer opção válida que possa ser passada para JetCommitTransaction também pode ser feita para ser o padrão para todas as sessões em uma instância e/ou para uma sessão específica. Consulte JetCommitTransaction para obter mais detalhes sobre essas opções.

Esse parâmetro tem um impacto na confiabilidade e no desempenho das transações. Consulte JetCommitTransaction para obter mais detalhes.

Rótulo Valor

Valor Padrão:

0

Tipo:

JET_GRBIT (inteiro)

Intervalo válido:

Uma opção válida para JetCommitTransaction

Escopo:

Instância ou Sessão

Set After JetCreateInstance:

Sim

Definido após JetInit:

Sim

Afeta o layout físico:

Não

Afeta a confiabilidade:

Sim

Afeta o desempenho:

Sim

Afeta recursos:

Não

Disponibilidade:

Tudo

JET_paramDeleteOldLogs
48

Quando esse parâmetro for true e os arquivos de log de transações apontados pelo caminho do arquivo de log (JET_paramLogFilePath) forem todos de uma versão obsoleta, esses arquivos de log de transações serão excluídos automaticamente.

Windows 2000: É necessário ter cuidado com o uso desse parâmetro ao atualizar um banco de dados do Windows NT para o Windows 2000. Se o banco de dados não estiver em um estado consistente e os arquivos de log antigos forem excluídos, o conteúdo do banco de dados será perdido.

Rótulo Valor

Valor Padrão:

Windows 2000: False

Windows XP: Verdade

Tipo:

Booliano

Intervalo válido:

False, True

Escopo:

Instância

Set After JetCreateInstance:

Sim

Definido após JetInit:

Não

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Sim

Afeta o desempenho:

Não

Afeta recursos:

Não

Disponibilidade:

Tudo

JET_paramIgnoreLogVersion
47

Se esse parâmetro for true, o mecanismo de banco de dados não validará o número de versão do arquivo de log de transações durante o JetInit.

Windows XP: A partir do Windows XP, esse parâmetro é obsoleto e não afeta a operação do mecanismo de banco de dados.

Rótulo Valor

Valor Padrão:

Falso

Tipo:

Booliano

Intervalo válido:

False, True

Escopo:

Instância

Set After JetCreateInstance:

Sim

Definido após JetInit:

Não

Afeta o layout físico:

Não

Afeta a confiabilidade:

Sim

Afeta o desempenho:

Não

Afeta recursos:

Não

Disponibilidade:

Tudo

JET_paramLegacyFileNames
136

Esse parâmetro fornece compatibilidade com versões anteriores com as convenções de nomenclatura de arquivo de versões anteriores do mecanismo de banco de dados.

No momento, há suporte para as seguintes opções:

JET_bitESE98FileNames

Quando essa opção estiver presente, o mecanismo de banco de dados usará as seguintes convenções de nomenclatura para seus arquivos:

  • Os arquivos de log de transações usarão . LOG para a extensão de arquivo

  • Os arquivos de ponto de verificação usarão . CHK para a extensão de arquivo

Rótulo Valor

Valor Padrão:

JET_bitESE98FileNames

Tipo:

JET_GRBIT (inteiro)

Intervalo válido:

0, JET_bitESE98FileNames

Escopo:

Instância

Set After JetCreateInstance:

Sim

Definido após JetInit:

Não

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Não

Afeta o desempenho:

Não

Afeta recursos:

Não

Disponibilidade:

Windows Vista e versões posteriores

JET_paramLogBuffers
12

Esse parâmetro 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 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.

Windows XP e Windows 2000: No Windows XP e nas versões anteriores, não é recomendável definir 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.

Rótulo Valor

Valor padrão:

Windows 2000, Windows XP e Windows Server 2003: 80

Windows Vista: 126

Tipo:

Inteiro

Intervalo válido:

Windows 2000, Windows XP e Windows Server 2003: 80 – 2147483647

Windows Vista: 1 – 2147483647

Escopo:

Instância

Definir após JetCreateInstance:

Sim

Definir após JetInit:

Não

Afeta o layout físico:

Não

Afeta a confiabilidade:

Não

Afeta o desempenho:

Sim

Afeta recursos:

Sim

Disponibilidade:

Tudo

JET_paramLogCheckpointPeriod
14

Esse parâmetro configura o mecanismo de banco de dados para fazer um ponto de verificação quando o número especificado de setores de arquivos de log tiver sido gerado.

Windows XP: A partir do Windows XP, esse parâmetro é obsoleto e não afeta a operação do mecanismo de banco de dados.

Rótulo Valor

Valor padrão:

1024

Tipo:

Inteiro

Intervalo válido:

0 – 2147483647

Escopo:

Instância

Definir após JetCreateInstance:

Sim

Definir após JetInit:

Não

Afeta o layout físico:

Não

Afeta a confiabilidade:

Sim

Afeta o desempenho:

Sim

Afeta recursos:

Não

Disponibilidade:

Tudo

JET_paramLogFileCreateAsynch
69

Quando esse parâmetro for definido como true, o mecanismo de banco de dados criará o próximo arquivo de log de transações à medida que o arquivo de log de transações atual for consumido. A intenção é minimizar o tempo gasto alternando de um arquivo de log de transações para o próximo em uma carga de atualização pesada.

Rótulo Valor

Valor padrão:

True

Tipo:

Booliano

Intervalo válido:

False, True

Escopo:

Instância

Definir após JetCreateInstance:

Sim

Definir após JetInit:

Não

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Não

Afeta o desempenho:

Sim

Afeta recursos:

Sim

Disponibilidade:

Windows XP e versões posteriores

JET_paramLogFilePath
2

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. Os arquivos de log de transações contêm as informações necessárias para levar os arquivos de banco de dados a um estado consistente após uma falha. Normalmente, eles são chamados de EDB*. LOG. O conteúdo dos arquivos de log de transações é igualmente importante (se não mais) do que os próprios arquivos de banco de dados. Todos os esforços devem ser feitos para protegê-los.

Também haverá arquivos de log de reserva adicionais chamados RES1. LOG e RES2. LOG armazenado junto com os arquivos de log comuns. O conteúdo desses arquivos não é importante, pois sua única finalidade é reservar espaço em disco para permitir que o mecanismo seja desligado normalmente em um cenário de disco baixo. Eles também serão um arquivo de log temporário normalmente chamado EDBTMP. FAÇA LOGOn nessa mesma pasta. O conteúdo desse arquivo também não é importante. Esse arquivo é um novo arquivo de log que está sendo preparado para uso.

As propriedades do volume de host dos arquivos de log de transações e seu posicionamento em relação aos outros arquivos usados pelo mecanismo de banco de dados podem afetar drasticamente o desempenho.

Nota Se um caminho relativo for especificado, ele será relativo ao diretório de trabalho atual do processo que hospeda o aplicativo que está usando o mecanismo de banco de dados.

Rótulo Valor

Valor Padrão:

"."

Tipo:

Caminho da Pasta (cadeia de caracteres)

Intervalo válido:

0 – 246 caracteres

Escopo:

Instância

Set After JetCreateInstance:

Sim

Definido após JetInit:

Não

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Sim

Afeta o desempenho:

Sim

Afeta recursos:

Não

Disponibilidade:

Tudo

JET_paramLogFileSize
11

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 de sistema em unidades de 1024 bytes.

Esse parâmetro tem um impacto na confiabilidade. Se a configuração for muito pequena, o número máximo de arquivos de log (1048575) será atingido muito mais rapidamente. Quando isso acontece, a instância deve ser desligada corretamente, os arquivos de log existentes devem ser excluídos e a instância deve ser reiniciada. Essa ação não apenas reduzirá a disponibilidade do aplicativo, mas também invalidará quaisquer backups anteriores do banco de dados do aplicativo.

Esse parâmetro tem um impacto no desempenho. Se a configuração for muito grande, o JetInit será lento porque o mecanismo de banco de dados deve ler o arquivo de log mais jovem (no mínimo) quando inicializar. Se a configuração for muito grande, também levará mais tempo para alternar entre arquivos de log. Se a configuração for muito pequena, mais arquivos de log precisarão ser criados para um determinado número de atualizações, o que adicionará mais sobrecarga.

Rótulo Valor

Valor Padrão:

5120

Tipo:

Inteiro

Intervalo válido:

Windows 2000, Windows XP e Windows Server 2003: 128 – 32768

Windows Vista: 64 – 32768

Escopo:

Instância

Set After JetCreateInstance:

Sim

Definido após JetInit:

Não

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Sim

Afeta o desempenho:

Sim

Afeta recursos:

Sim

Disponibilidade:

Tudo

JET_paramLogWaitingUserMax
15

Esse parâmetro tenta otimizar a liberação do buffer de log causado por uma confirmação durável aguardando um número especificado de sessões aguardar uma confirmação durável antes de forçar uma liberação a ocorrer na esperança de que outra transação compartilhe a liberação.

Windows XP: A partir do Windows XP, esse parâmetro é obsoleto e não afeta a operação do mecanismo de banco de dados.

Rótulo Valor

Valor Padrão:

3

Tipo:

Inteiro

Intervalo válido:

0 – 2147483647

Escopo:

Instância

Set After JetCreateInstance:

Sim

Definido após JetInit:

Não

Afeta o layout físico:

Não

Afeta a confiabilidade:

Não

Afeta o desempenho:

Sim

Afeta recursos:

Não

Disponibilidade:

Tudo

JET_paramRecovery
34

Esse parâmetro é o comutador master que controla a recuperação de falhas de uma instância. Se esse parâmetro for 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 do 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 corretamente 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.

Desabilitar a recuperação é útil em circunstâncias especiais em que se sabe que o conteúdo de um banco de dados não é útil em caso de falha. A recuperação deve ser habilitada para todos os outros casos.

Rótulo Valor

Valor Padrão:

"Ativado"

Tipo:

String

Intervalo válido:

0 – 259 caracteres

Escopo:

Instância

Definir após JetCreateInstance:

Sim

Definir após JetInit:

Não

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Sim

Afeta o desempenho:

Sim

Afeta recursos:

Sim

Disponibilidade:

Tudo

JET_paramSystemPath
0

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. O arquivo de ponto de verificação é um arquivo simples mantido por instância que se lembra do arquivo de log de transações mais antigo que deve ser reproduzido para levar todos os bancos de dados nessa instância a um estado consistente após uma falha. O arquivo de ponto de verificação normalmente é chamado de EDB. CHK.

Nota Se um caminho relativo for especificado, ele será relativo ao diretório de trabalho atual do processo que hospeda o aplicativo que está usando o mecanismo de banco de dados.

Rótulo Valor

Valor padrão:

"."

Tipo:

Caminho da Pasta (cadeia de caracteres)

Intervalo válido:

0 – 246 caracteres

Escopo:

Instância

Definir após JetCreateInstance:

Sim

Definir após JetInit:

Não

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Não

Afeta o desempenho:

Não

Afeta recursos:

Não

Disponibilidade:

Tudo

JET_paramWaitLogFlush
13

Esse parâmetro tenta otimizar a liberação do buffer de log causado por uma confirmação durável aguardando um período especificado antes de forçar uma liberação a ocorrer na esperança de que outra transação compartilhe a liberação.

Windows XP: A partir do Windows XP, esse parâmetro é obsoleto e não afeta a operação do mecanismo de banco de dados.

Rótulo Valor

Valor padrão:

0

Tipo:

Inteiro

Intervalo válido:

0 – 2147483647

Escopo:

Instância ou Sessão

Definir após JetCreateInstance:

Sim

Definir após JetInit:

Sim

Afeta o layout físico:

Não

Afeta a confiabilidade:

Não

Afeta o desempenho:

Sim

Afeta recursos:

Não

Disponibilidade:

Tudo

JET_paramLegacyFileNames
136

Esse parâmetro é usado para especificar os recursos de compatibilidade de nomenclatura de arquivo a serem mantidos com o Windows Server 2003 e o esquema de nomenclatura de arquivo anterior. Para obter mais informações sobre os diferentes arquivos e suas nomenclaturas, consulte Arquivos extensíveis do mecanismo de armazenamento.

O JET_bitESE98FileNames garante que a extensão de arquivo usada nos arquivos de log de transações e o arquivo de ponto de verificação sejam os mesmos usados no Windows Server 2003. Observe que, se estiver atualizando do Windows Server 2003, esse bit ainda não precisará ser especificado, pois o mecanismo atualizará automaticamente as extensões de arquivo se JET_paramCircularLog estiver definido como true ou manterá a extensão de log mais antiga se JET_paramCircularLog for false.

Nota Para definir um bit, o valor deve primeiro ser recuperado e, em seguida, "ou" no bit de compatibilidade desejado.

Rótulo Valor

Valor padrão:

JET_bitESE98FileNames

Tipo:

JET_GRBIT (inteiro)

Intervalo válido:

JET_bitESE98FileNames

Escopo:

Instância

Definir após JetCreateInstance:

Sim

Definir após JetInit:

Não

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Não

Afeta o desempenho:

Não

Afeta recursos:

Não

Disponibilidade:

Começando com o Windows Server 2008 e o Windows Vista

Requisitos

Requisito Valor

Cliente

Requer Windows Vista, Windows XP ou Windows 2000 Professional.

Servidor

Requer o Windows Server 2008, o Windows Server 2003 ou o Windows 2000 Server.

Cabeçalho

Declarado em Esent.h.

Consulte Também

Arquivos extensíveis do mecanismo de armazenamento
JetCommitTransaction
JetCreateInstance
JetInit
JetTerm