Метод DBEngine.CompactDatabase (DAO)DBEngine.CompactDatabase Method (DAO)

• ‎24‎.‎10‎.‎2016

В этой статье

1. Синтаксис
2. Параметры
3. Примечания
4. Зашифрованные связанные таблицы

Область применения: Access 2013 | Access 2016Applies to: Access 2013 | Access 2016

Копирует и сжимает закрытую базу данных, предоставляя возможность изменить ее версию, порядок сортировки и шифрование.Copies and compacts a closed database, and gives you the option of changing its version, collating order, and encryption. (Только для рабочих областей Microsoft Access.)Creates a new TableDef object (Microsoft Access workspaces only).

Примечание

Если используются зашифрованные связанные таблицы для действия, обновления и запросов SQL [например, оператор SQL UPDATE (CurrentDb.Execute "UPDATE...")], необходимо указать ключ шифрования.When using encrypted linked tables for action, update, and SQL queries [such as a SQL UPDATE statement (CurrentDb.Execute "UPDATE...")], you must supply the encryption key. Кроме того, в связанных таблицах установлено ограничение в 19 знаков для ключа шифрования.Also, linked tables have a 19-character limit for the encryption key. См. раздел Зашифрованные связанные таблицы в конце этой статьи.See the Encrypted linked tables section at the end of this topic.

СинтаксисSyntax

выражение .CompactDatabase(SrcName, DstName, DstLocale, Options, password)expression .CompactDatabase(SrcName, DstName, DstLocale, Options, password)

выражение: выражение, возвращающее объект DBEngine.expression An expression that returns a Range object.

ПараметрыParameters

ПримечанияRemarks

Можно использовать одну из следующих констант для аргумента DstLocale, чтобы задать свойство CollatingOrder для сравнения строк текста.You can use one of the following constants for the DstLocale argument to specify the CollatingOrder property for string comparisons of text.

Можно использовать одну из следующих констант в аргументе Options, чтобы указать необходимость шифрования или расшифровки базы данных при сжатии.You can use one of the following constants in the options argument to specify whether to encrypt or to decrypt the database while it's compacted.

Примечание

Константы dbEncrypt и dbDecrypt являются устаревшими и не поддерживаются в форматах файлов ACCDB.The constants dbEncrypt and dbDecrypt are deprecated and not supported in .ACCDB file formats.

Если опустить константу шифрования или указать как dbDecrypt, так и dbEncrypt, для DstName будет применяться такое же шифрование, как для SrcName.If you omit an encryption constant or if you include both dbDecrypt and dbEncrypt, DstName will have the same encryption as SrcName.

Можно использовать одну из следующих констант в аргументе Options, чтобы указать версию формата данных сжатой базы данных.You can use one of the following constants in the options argument to specify the version of the data format for the compacted database. Эта константа влияет только на версию формата данных DstName и не влияет на версию объектов, определяемых в Microsoft Access, таких как формы и отчеты.This constant affects only the version of the data format of DstName and doesn't affect the version of any Microsoft Access-defined objects, such as forms and reports.

Можно указать константу только одной версии.You can specify only one version constant. Если опустить константу версии, версия DstName будет совпадать с SrcName.If you omit a version constant, DstName will have the same version as SrcName. Можно сжать DstName только до версии, совпадающей с версией SrcName или более поздней.You can compact DstName only to a version that is the same or later than that of SrcName.

Когда вы изменяете данные в базе данных, файл базы данных может фрагментироваться и будет занимать больше места на диске, чем требуется.As you change data in a database, the database file can become fragmented and use more disk space than is necessary. Периодически для сжатия базы данных можно использовать метод CompactDatabase, чтобы дефрагментировать файл базы данных.Periodically, you can use the CompactDatabase method to compact your database to defragment the database file. Сжатая база данных обычно меньше и часто работает быстрее.The compacted database is usually smaller and often runs faster. Вы также можете изменить порядок сортировки, шифрование или версию формата данных при копировании и сжатии базы данных.You can also change the collating order, the encryption, or the version of the data format while you copy and compact the database.

Необходимо закрыть файл SrcName перед его сжатием.You must close SrcName before you compact it. В многопользовательской среде другие пользователи не могут держать SrcName в открытом состоянии при его сжатии.In a multiuser environment, other users can't have SrcName open while you're compacting it. Если SrcName не закрыт или недоступен для монопольного использования, возникает ошибка.If SrcName isn't closed or isn't available for exclusive use, an error occurs.

Так как метод CompactDatabase создает копию базы данных, необходимо располагать достаточным местом как для исходной базы данных, так и для копии.Because CompactDatabase creates a copy of the database, you must have enough disk space for both the original and the duplicate databases. Операция сжатия завершается сбоем, если отсутствует достаточное место на диске.The compact operation fails if there isn't enough disk space available. Дублированную базу данных DstName не обязательно располагать на том же диске, что и SrcName.The DstName duplicate database doesn't have to be on the same disk as SrcName. После успешного сжатия базы данных можно удалить файл SrcName и присвоить сжатому файлу DstName исходное имя файла.After successfully compacting a database, you can delete the SrcName file and rename the compacted DstName file to the original file name.

Метод CompactDatabase копирует все данные и параметры разрешений системы безопасности из базы данных, определяемой SrcName, в базу данных, определяемую DstName.The CompactDatabase method copies all the data and the security permission settings from the database specified by SrcName to the database specified by DstName.

Примечание

Так как метод CompactDatabase не преобразует объекты Microsoft Access, не следует использовать CompactDatabase для преобразования базы данных, содержащей такие объекты.Because the CompactDatabase method doesn't convert Microsoft Access objects, you shouldn't use CompactDatabase to convert a database containing such objects.

Зашифрованные связанные таблицыEncrypted linked tables

Зашифрованные пароли зависят от используемого формата файла базы данных.Encrypted passwords are dependent on the file format of the database that you are using. Если вы используете Access 2003 (.mdb) или базу данных более ранней версии, у вас есть один пароль для защиты базы данных и другой пароль для шифрования базы данных.If you are using an Access 2003 (.mdb) or earlier database, you will have one password to protect the database, and a separate password to encrypt the database. В Access 2007 (.accdb) или базах данных более поздних версий (.mdb) зашифровать и защитить базу данных можно только с помощью одного пароля, так как возможность использования двух разных паролей была удалена.For Access 2007 (.accdb) and later (.mdb) databases, the only option is to encrypt and protect the database with one password, as the option to have two separate passwords has been removed.

Примечание

Для баз данных Access 2007 (.accdb) пароль является ключом шифрованияFor Access 2007 (.accdb) databases, the password is the encryption key

Вы можете использовать следующий пример кода VBA для кнопки:You can use the following example VBA code for a command button:

VB Копировать

Private Sub Command0_Click()

Dim strSourcePath As String

Dim strDestPath As String

strSourcePath = "<path>\sourceDb.accdb"

strDestPath = "<path>\destDb.accdb"

DBEngine.CompactDatabase strSourcePath, strDestPath, dbLangGeneral & ";pwd=Access", dbVersion120, ";pwd=Access"

Set CurrentDatabase = CurrentDb

Set LinkedTableDef = CurrentDatabase.CreateTableDef

("My Linked Table")

LinkedTableDef.Connect = "MS Access;pwd=Access";database=" & strDestPath

LinkedTableDef.RefreshLink

MsgBox "Finished"

End Sub

В следующем примере кода показано, как использовать CompactDatabase с паролем (ключом шифрования) и затем сослаться на таблицу в этой сжатой базе данных.The following code sample shows how to use CompactDatabase with a password (encryption key) and then link to a table in that compacted database. Обратите внимание, что нужно указать пароль.Note that a password must be supplied.

VB Копировать

Private Sub CompactAndLink_Click()

Dim strSourcePath As String

Dim strDestPath As String

Dim strSourceTableName As String

Dim strDestTableName As String

Dim tdf As TableDef

strSourcePath = "<path>\<database>.accdb"

strDestPath = "<path>\<database>.accdb"

strSourceTableName = "<table name in destination database>"

strDestTableName = "<linked table name>"

' Compact source database into new destination database with encrypted password

DBEngine.CompactDatabase strSourcePath, strDestPath, dbLangGeneral & ";pwd=Access", dbVersion120, ";pwd=Access"

' Link to one of the tables in the destination database

' Password must be provided in the Connect property

Set CurrentDatabase = CurrentDb

Set tdf = CurrentDatabase.CreateTableDef(strDestTableName)

With tdf

.Connect = ";pwd=Access" & ";DATABASE=" & strDestPath

.SourceTableName = strSourceTableName

End With

CurrentDatabase.TableDefs.Append tdf

MsgBox "Database compacted and encrypted password applied. Link to table also completed."

End Sub