Поделиться через

Макрокоманда CopyDatabaseFile

  • Статья

Область применения: Access 2013, Office 2013

С помощью действия CopyDatabaseFile можно создать копию текущей базы данных Microsoft SQL Server 7.0 или более поздней версии, подключенной к проекту Access. Access отсоединяет текущую базу данных, а затем присоединяет ее к целевому серверу. Дополнительные сведения об отключении и подключении базы данных см. в документации по SQL Server.

Примечание.

Эта макрокоманда доступна только для доверенных баз данных.

Параметр

Действие CopyDatabaseFile имеет следующие аргументы.

Аргумент макрокоманды

Описание

Имя файла базы данных

Имя нового файла основных данных. Путь к файлу по умолчанию — это текущее расположение файла проекта Access (ADP).

Перезаписать существующий файл

Указывает, следует ли заменять существующий файл тем же именем. Если задано значение Да и имя файла уже существует, файл перезаписывается. Если задано значение Нет и имя файла уже существует, файл не перезаписывается и действие завершается ошибкой. Если файл еще не существует, этот параметр игнорируется. Значение по умолчанию — Да.

Отключение всех пользователей

Указывает, должен ли Access вынудить пользователей из базы данных. Если задано значение Да, все пользователи, подключенные к текущей базе данных, будут отключены, чтобы можно было продолжить операцию копирования базы данных. Если задано значение Нет и один или несколько пользователей подключены к базе данных, операция копирования базы данных завершается ошибкой. По умолчанию используется значение Нет.

ПРЕДУПРЕЖДЕНИЕ. Отключение пользователей от базы данных без соответствующего предупреждения может привести к потере данных.

Замечания

Операция копирования является синхронной, поэтому вы не сможете выполнять другие операции до завершения копирования базы данных.

Действие CopyDatabaseFile не только копирует данные, определения данных и объекты базы данных, но и копирует расширенные свойства, такие как значения по умолчанию, текстовые ограничения и значения подстановки.

Требования для копирования базы данных:

  • Перед копированием файла базы данных необходимо отключить все приложения и пользователей.

  • Все объекты и представления, кроме области навигации, должны быть закрыты.

  • Текущую базу данных нельзя реплицировать.

  • База данных исходного сервера должна быть Microsoft SQL Server версии 7.0 или более поздней или SQL Server 2000 Desktop Engine, запущенная на локальном компьютере.

  • База данных SQL Server на исходном сервере должна быть одной файловой базой данных.

  • Необходимо быть членом роли sysadmin на исходном и целевом компьютерах SQL Server.

Чтобы запустить действие CopyDatabaseFile в модуле Visual Basic для приложений, используйте метод CopyDatabaseFile объекта DoCmd.