Compartilhar via


Método DoCmd.TransferSQLDatabase (Access)

Transfere todo o banco de dados do Microsoft SQL Server especificado para outro banco de dados do SQL Server.

Sintaxe

expressão. TransferSQLDatabase (Server, Database, UseTrustedConnection, Login, Password, TransferCopyData)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Servidor Obrigatório Variantes O nome do SQL Server para o qual o banco de dados será transferido.
Banco de dados Obrigatório Variantes O nome do novo banco de dados no servidor especificado.
UseTrustedConnection Opcional Variantes True se a conexão atual estiver usando um logon com privilégios de administrador de sistema. Se esse argumento não for True, você deve especificar um logon e uma senha nos argumentos Login e Password.
Logon Opcional Variantes O nome de um logon no servidor de destino com privilégios de administrador. Se UseTrustedConnection for True, esse argumento será ignorado.
Password Opcional Variantes A senha de logon especificada em Login. Se UseTrustedConnection for True, esse argumento será ignorado.
TransferCopyData Opcional Variantes True se todos os dados do banco de dados forem transferidos para o banco de dados de destino. Se esse argumento não for True, somente o esquema de banco de dados será transferido.

Comentários

As condições a seguir devem ser atendidas ou um ocorrerá um erro:

  • Os servidores atuais e de destino devem ser do SQL Server versão 7.0 ou posterior.

  • O usuário tem direitos de logon de administrador do sistema no servidor de destino.

  • O banco de dados de destino não existe no servidor de destino.

Exemplo

Este exemplo transfere o banco de dados do SQL Server atual para um novo banco de dados SQL Server denominado Inventory no servidor MainOffice. (Presume-se que o usuário tenha privilégios de administrador do sistema no MainOffice.) Os dados são copiados junto com o esquema de banco de dados.

DoCmd.TransferCompleteSQLDatabase _ 
 Server:="MainOffice", _ 
 Database:="Inventory", _ 
 UseTrustedConnection:=True, _ 
 TransferCopyData:=False 

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.