Ferramenta de atualização de banco de dados (SQL Server Compact)

A ferramenta de Atualização de Banco de Dados do 3.5 é um utilitário de prompt de comando que atualiza os bancos de dados do SQL Server 2000 Windows CE Edition 2.0 (SQL Server CE 2.0).

Dica

O formato de arquivo do 3.5 Service Pack 1 (SP1) difere do formato das versões anteriores. Portanto, os bancos de dados criados com versões anteriores devem ser atualizados para o novo formato de arquivo. Ocorrerá uma falha ao abrir um arquivo de banco de dados do SQL Server CE usando o 3.5 SP1 e será gerada uma System.Data.SqlServerCe.SqlCeException.

Como funciona a ferramenta de atualização de banco de dados

Quando a ferramenta de Atualização de Banco de Dados do (Upgrade.exe) é executada em um dispositivo inteligente, um novo banco de dados do é criado. O novo banco de dados do , com a extensão de nome de arquivo .sdf, contém todos os dados do banco de dados de origem. Para usar a Upgrade.exe, os tempos de execução do e do SQL Server CE devem ser instalados no mesmo dispositivo móvel.

O banco de dados de origem da versão anterior do também permanece no dispositivo. Antes de executar a ferramenta de Atualização de Banco de Dados, verifique se o dispositivo tem memória suficiente em ambos os bancos de dados. Além disso, a ferramenta de Atualização de Banco de Dados requer aproximadamente 300 KB de memória no dispositivo.

Essa ferramenta não atualiza informações de rastreamento ou assinatura. Apenas os dados do banco de dados de origem são atualizados.

Importante

Se você estiver usando replicação ou RDA para conectividade, primeiro sincronize o banco de dados de origem do juntamente com o banco de dados do SQL Server, antes de atualizar o banco de dados. A atualização de um banco de dados de conectividade seria usada somente para preservar tabelas locais possivelmente existentes no banco de dados. Isso ocorre porque, após a atualização, será necessário assinar ou efetuar pull novamente a partir do novo banco de dados.

Local da ferramenta de atualização de banco de dados

A ferramenta de atualização de banco de dados é instalada com o Visual Studio 2008 como parte do arquivo MSI do 3.5 for Devices (SSCEDeviceRuntime-[lang].msi ). O local padrão do arquivo é %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v3.5\Devices\[platform]\[processor]\upgrade.exe.

Dica

O MSI do 3.5 SP1 for Devices não é instalado com o Visual Studio 2008 SP1. O 3.5 SP1 for Devices só está disponível no Centro de Download da Microsoft.

Executando a ferramenta de atualização de banco de dados

Para executar a ferramenta de Atualização de Banco de Dados, é necessário que os seguintes softwares estejam instalados no dispositivo inteligente:

• SQL Server CE (v. 2.0) e 3.5/3.5 SP1
• Provedor OLE DB do (Por padrão, ele é instalado na instalação do .)

Quando implantada no dispositivo inteligente em que o banco de dados de origem está localizado, a ferramenta de Atualização de Banco de Dados executa as seguintes tarefas:

• Abre o arquivo de banco de dados de origem (com a extensão .sdf) que foi especificado no prompt de comando.

• Abre o banco de dados especificado. Se o provedor OLE DB do SQL Server CE 2.0 (ssce20.dll) não for encontrado no dispositivo, a ferramenta de Atualização de Banco de Dados retornará a mensagem "O SQL Server CE 1.1 ou uma versão posterior já deve estar instalado".

• Usa o mecanismo de armazenamento do para criar um novo banco de dados do .

• Lê o esquema do banco de dados de origem usando o provedor OLE DB da versão anterior do .

• Grava o esquema no banco de dados de destino do usando o provedor OLE DB do .

• Lê os dados no banco de dados de origem usando o provedor OLE DB da versão anterior do .

• Grava os dados no banco de dados de destino do usando o provedor OLE DB do .

  Dica

  A ferramenta de Atualização de Banco de Dados não pode distinguir um índice criado pelo usuário de um índice criado com a inclusão de uma restrição como uma chave primária. A ferramenta não atualizará índices que compartilhem o mesmo nome da restrição, pois a ferramenta pressupõe que eles foram criados pela própria restrição.

Os erros são gravados em um arquivo de log (upgrade.log), e são salvos no mesmo diretório no dispositivo em que a ferramenta de Atualização de Banco de Dados (Upgrade.exe) está localizada.

Dica

O log de atualização é excluído e recriado antes de cada atualização.

Para obter mais informações sobre compatibilidade com versões anteriores e atualização para o 3.5 SP1, consulte Atualizando versões anteriores (SQL Server Compact).

Para executar a ferramenta de Atualização de Banco de Dados, consulte Como atualizar o SQL Server Compact 2.0 usando a ferramenta de Atualização de Banco de Dados. A tabela a seguir descreve os parâmetros da linha de comando usados com a ferramenta de Atualização de Banco de Dados.

Parâmetro	Descrição
/s	O caminho do arquivo de banco de dados de origem. (necessário)
/sp	A senha do arquivo de banco de dados de origem. (opcional)
/d	O caminho do arquivo de banco de dados de destino. Se for especificado um arquivo existente, ele será substituído. (necessário)
/dp	A senha do arquivo de banco de dados de destino. (opcional)
/e	Se especificado, o banco de dados de destino será criptografado. Se você especificar o parâmetro /e, deverá especificar também o parâmetro /sp e fornecer uma senha. (opcional)
/q	Executar a atualização silenciosamente sem qualquer interface do usuário. (opcional)
/?	Exibe esta lista de parâmetros. (opcional)