Parâmetros de Banco de Dados

Aplica-se a: Windows | Windows Server

Parâmetros de Banco de Dados

Este tópico contém parâmetros usados para o banco de dados.

JET_paramCheckFormatWhenOpenFail
44

Esse parâmetro, quando definido, fará com que o JetInit retorne um erro especial quando um banco de dados ou log de transações de uma versão anterior do mecanismo de banco de dados for aberto. Esses erros são:

Erro

Descrição

JET_errDatabase200Format

Os arquivos de banco de dados e/ou de log de transações foram criados com o mecanismo de banco de dados no Windows NT 3.51.

JET_errDatabase400Format

Os arquivos de banco de dados e/ou de log de transações foram criados com o mecanismo de banco de dados em uma versão de teste antes do Windows NT Server 4.0.

JET_errDatabase500Format

Os arquivos de banco de dados e/ou de log de transações foram criados com o mecanismo de banco de dados no Windows NT Server 4.0.

Windows Vista: Para o Windows Vista e posteriores, esse parâmetro é obsoleto e não afeta a operação do mecanismo de banco de dados.

Rótulo Valor

Valor Padrão:

True

Tipo:

Boolean

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:

Não

Afeta o desempenho:

Não

Afeta recursos:

Não

Disponibilidade:

Tudo

JET_paramDatabasePageSize
64

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.

Nota 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 diferentes aplicativos que usam o mecanismo de banco de dados, todos eles deverão concordar com o tamanho de uma página de banco de dados.

Rótulo Valor

Valor Padrão:

4096

Tipo:

Inteiro

Intervalo válido:

2048, 4096, 8192

Escopo:

Global

Set After JetCreateInstance:

Não

Definido após JetInit:

Não

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Não

Afeta o desempenho:

Sim

Afeta recursos:

Sim

Disponibilidade:

Tudo

JET_paramDbExtensionSize
18

Esse parâmetro controla a quantidade de espaço que é adicionada a um arquivo de banco de dados sempre que precisa crescer para acomodar mais dados. O tamanho está nas páginas do banco de dados.

Rótulo Valor

Valor Padrão:

256

Tipo:

Inteiro

Intervalo válido:

1 – 2147483647

Escopo:

Instância

Set After JetCreateInstance:

Sim

Definido após JetInit:

Não

Windows Vista: Para Windows Vista e posterior: Sim

Afeta o layout físico:

Não

Afeta a confiabilidade:

Não

Afeta o desempenho:

Sim

Afeta recursos:

Sim

Disponibilidade:

Tudo

JET_paramEnableIndexChecking
45

Quando esse parâmetro é verdadeiro, cada banco de dados é verificado no momento jetattachDatabase 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 versão para versão.

Se for detectado que um índice primário está nesse estado, JetAttachDatabase sempre falhará com JET_errPrimaryIndexCorrupted.

Se algum índice secundário for detectado nesse estado, haverá dois resultados possíveis. Se JET_bitDbDeleteCorruptIndexes 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 aplicativo. Se JET_bitDbDeleteCorruptIndexes não tiver sido passado para JetAttachDatabase , a chamada falhará com JET_errSecondaryIndexCorrupted.

Nota É altamente recomendável que esse parâmetro seja definido como True pelo seu aplicativo.

Nota É altamente recomendável que os aplicativos evitem o uso de colunas de chave Unicode em seus índices de chave primária (clusterizados).

Rótulo Valor

Valor Padrão:

Falso

Tipo:

Boolean

Intervalo válido:

False, True

Escopo:

Global

Windows Vista: Para Windows Vista e posterior: Instância

Set After JetCreateInstance:

Não

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_paramEnableIndexCleanup
54

Quando esse parâmetro é definido como true, o mecanismo de banco de dados pode limpo automaticamente índices em colunas de chave Unicode no momento jetInit, conforme necessário, para evitar alterações no formato de banco de dados causadas por alterações na biblioteca NLS no Windows. Essas alterações são feitas rotineiramente na biblioteca NLS para adicionar suporte a novos idiomas, adicionar caracteres ausentes a um idioma, adicionar uma ordem de ordenação a um idioma ou corrigir bugs na ordem de ordenação de um idioma. Essas alterações afetam as chaves de classificação produzidas por LCMapStringW que são persistidas pelo mecanismo de banco de dados como componentes de chaves de índice.

É importante perceber que é possível que as alterações no índice sejam tão grandes que uma limpeza incremental não seja possível. Nesse caso, o índice será tratado conforme prescrito por JET_paramEnableIndexChecking.

Nota É altamente recomendável que esse parâmetro e JET_paramEnableIndexChecking sejam definidos como True pelo seu aplicativo.

Rótulo Valor

Valor Padrão:

True

Tipo:

Boolean

Intervalo válido:

False, True

Escopo:

Instância

Set After JetCreateInstance:

Sim

Definido após JetInit:

Não

Windows Vista: Para Windows Vista e posterior: Sim

Afeta o layout físico:

Não

Afeta a confiabilidade:

Não

Afeta o desempenho:

Não

Afeta recursos:

Não

Disponibilidade:

Windows Server 2003 e versões posteriores

JET_paramOneDatabasePerSession
102

Quando esse parâmetro for true, 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.

Windows XP e Windows Server 2003: Esse parâmetro é gravado somente no Windows XP e no Windows Server 2003.

Windows Vista: Esse parâmetro se comporta normalmente a partir do Windows Vista.

Nota Esse parâmetro é somente gravação.

Rótulo Valor

Valor Padrão:

Falso

Tipo:

Boolean

Intervalo válido:

False, True

Escopo:

Global

Set After JetCreateInstance:

Não

Windows Vista: Para Windows Vista e posterior: Sim

Definido após JetInit:

Não

Afeta o layout físico:

Não

Afeta a confiabilidade:

Não

Afeta o desempenho:

Não

Afeta recursos:

Não

Disponibilidade:

Windows XP e versões posteriores

JET_paramEnableOnlineDefrag
35

Esse parâmetro controla o comportamento da desfragmentação online quando iniciado usando JetDefragment. Consulte JetDefragment para obter mais informações.

Windows 2000: No Windows 2000, esse parâmetro era um booliano simples que poderia bloquear o desfragmentamento online quando iniciado pelo JetDefragment. Quando definido como TRUE, a desfragmentação online será executada nos registros de cada tabela no banco de dados.

Windows XP: No Windows XP e versões posteriores, esse parâmetro pode ser definido como uma ou mais das seguintes opções:

Opção

Descrição

JET_OnlineDefragDisable

Não execute desfragmentação online. Esse é o binário equivalente à configuração do Windows 2000 de False para esse parâmetro.

JET_OnlineDefragAllOBSOLETE

Execute a desfragmentação online completa. Esse é o binário equivalente à configuração do Windows 2000 de True para esse parâmetro.

JET_OnlineDefragDatabases

Execute a desfragmentação online dos registros de cada tabela no banco de dados.

JET_OnlineDefragSpaceTrees

Execute a desfragmentação online das árvores espaciais de cada tabela no banco de dados.

JET_OnlineDefragStreamingFiles

Esse parâmetro é usado para dar suporte à infraestrutura do Microsoft Exchange e não se destina a ser usado em seu aplicativo.

JET_OnlineDefragAll

Execute a desfragmentação online completa. Esse é o equivalente conceitual à configuração do Windows 2000 de True para esse parâmetro.

Rótulo Valor

Valor padrão:

Windows 2000: Verdade

Windows XP: para Windows XP e posterior: JET_OnlineDefragAll

Tipo:

Windows 2000: Boolean

Windows XP e posterior: JET_GRBIT (inteiro)

Intervalo válido:

Windows 2000: False, True

Windows XP e posterior: 0 – JET_OnlineDefragAll

Escopo:

Instância

Definir após JetCreateInstance:

Sim

Definir 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_paramPageFragment
20

Esse parâmetro é o limite que o mecanismo de banco de dados usa para controlar a fragmentação de espaço livre. O tamanho está em páginas de banco de dados.

Rótulo Valor

Valor padrão:

8

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:

Não

Afeta o desempenho:

Sim

Afeta recursos:

Sim

Disponibilidade:

Tudo

JET_paramRecordUpgradeDirtyLevel
78

Esse parâmetro controla a agressividade com que o gerenciador de cache da página de banco de dados gravará uma página de banco de dados que passou por uma conversão de formato in-loco. Essas conversões de formato ocorrem em tempo real à medida que as páginas são carregadas de um banco de dados que foi criado com o mecanismo de banco de dados do Windows 2000, mas usado por um Windows XP ou versão posterior do mecanismo de banco de dados.

Rótulo Valor

Valor padrão:

1

Tipo:

Inteiro

Intervalo válido:

0-3

Escopo:

Global

Definir após JetCreateInstance:

Sim

Definir após JetInit:

Sim

Afeta o layout físico:

Sim

Afeta a confiabilidade:

Não

Afeta o desempenho:

Sim

Afeta recursos:

Não

Disponibilidade:

Windows XP e versões posteriores

JET_paramWaypointLatency
153

A latência (em logs) por trás do log de dica/confirmação mais alta para adiar as liberações de página do banco de dados. Habilitar essa latência pode permitir a recuperação de banco de dados no caso de perda catastrófica do arquivo de log mais recente. Confira JET_bitReplayIgnoreLostLogs.

Rótulo Valor

Valor Padrão:

0

Tipo:

Inteiro

Intervalo válido:

0-1023

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:

Sim

Afeta recursos:

Não

Disponibilidade:

Windows 7

JET_paramDefragmentSequentialBTrees
160

Ative/desative a desfragmentação sequencial automática de árvore B.

Rótulo Valor

Valor Padrão:

1

Tipo:

Boolean

Intervalo válido:

0-1

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:

Sim

Afeta recursos:

Não

Disponibilidade:

Windows 7

JET_paramDefragmentSequentialBTreesDensityCheckFrequency
161

Determina a frequência com que a densidade da árvore B é verificada.

Rótulo Valor

Valor Padrão:

10

Tipo:

Inteiro

Intervalo válido:

Inteiro máximo de 0

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:

Sim

Afeta recursos:

Não

Disponibilidade:

Windows 7

JET_paramIOThrottlingTimeQuanta
162

Tempo máximo, em milissegundos, que o mecanismo de limitação de E/S fornece uma tarefa a ser executada para que ela seja considerada "concluída".

Rótulo Valor

Valor Padrão:

125

Tipo:

Inteiro

Intervalo válido:

0-10000

Escopo:

Global

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:

Windows 7

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

JetAttachDatabase
JetCreateInstance
JetDefragment
JetInit