Очищает хранилище от записей удаленных раньше указанной даты.
Синтаксис
ОчиститьНеиспользуемоеМесто(<ДатаОчистки>)Полное описание, параметры и ограничения
АдминистрированиеХранилищеДвоичныхДанных.ОчиститьНеиспользуемоеМесто (AdministrationBinaryDataStorage.ClearUnusedSpace)
АдминистрированиеХранилищеДвоичныхДанных (AdministrationBinaryDataStorage)
ОчиститьНеиспользуемоеМесто (ClearUnusedSpace)
Доступен, начиная с версии 8.3.27.
Синтаксис:
ОчиститьНеиспользуемоеМесто(<ДатаОчистки>)
Параметры:
<ДатаОчистки> (обязательный)
Тип: Дата.
Дата и время (в формате UTC), до которой будут удалены неиспользуемые данные.
Описание:
Очищает хранилище от записей удаленных раньше указанной даты.
Доступность:
Тонкий клиент, сервер, толстый клиент, интеграция.
Использование в версии:
Доступен, начиная с версии 8.3.27.
Методическая информация
Практические примеры
RAS: удалить неиспользуемые записи до границы UTC
Очистка применяется только к ранее удалённым данным собственного хранилища старше явно подготовленной границы.
Где и как запускать
Синтаксис в своей административной форме тонкого или толстого клиента либо серверном модуле. Соединение RAS относится только к выделенному собственному учебному серверу. Здесь соединения и изменения не выполнялись.
Подготовка
Подготовьте собственный отдельный учебный сервер 1С с RAS по 127.0.0.1:1545 и ровно одним своим кластером. Не направляйте пример на сервер рабочих пользователей.
В административной форме задайте строковые реквизиты ИмяАгента, ПарольАгента, ИмяАдминистратораКластера и ПарольКластера. Пароли вводятся в режиме пароля и не выводятся в сообщения. RAS аутентифицирует агента в порядке пароль, имя, а кластер — имя, пароль.
Используйте только собственное встроенное хранилище выделенной учебной ИБ. Пути C:\УчебныеДанные\full.bak и C:\УчебныеДанные\diff.bak относятся к компьютеру сервера, не к клиенту.
Для создания подготовьте новые незанятые пути и права серверной учётной записи. Для восстановления заранее приготовьте согласованную свою полную и соответствующую ей дифференциальную копию и отдельное учебное назначение.
Загрузка заменяет данные. Эти фрагменты нельзя запускать для рабочих хранилищ. Здесь никакие архивы не создавались и не загружались.
Создайте реквизит ДатаГраницыUTC типа Дата и вручную задайте согласованную ненулевую UTC-границу для ненужных удалённых данных только своей ИБ.
Сервер = Новый АдминистрированиеСервера("127.0.0.1", 1545);
Сервер.ВыполнитьАутентификацию(ПарольАгента, ИмяАгента);
Кластеры = Сервер.ПолучитьКластеры();
Если Кластеры.Количество() <> 1 Тогда
ВызватьИсключение "Нужен ровно один собственный учебный кластер";
КонецЕсли;
Кластер = Кластеры[0];
Кластер.ВыполнитьАутентификацию(ИмяАдминистратораКластера, ПарольКластера);
Базы = Кластер.ПолучитьИнформационныеБазы();
Если Базы.Количество() <> 1 Тогда
ВызватьИсключение "Нужна ровно одна собственная учебная ИБ";
КонецЕсли;
База = Базы[0];
База.ВыполнитьАутентификацию(ИмяАдминистратораБазы, ПарольБазы);
Хранилища = База.ПолучитьХранилищаДвоичныхДанных();
Если Хранилища.Количество() <> 1 Тогда
ВызватьИсключение "Нужно одно подготовленное собственное хранилище";
КонецЕсли;
Хранилище = Хранилища[0];
Сообщить("Хранилище: " + Хранилище.Имя);
Хранилище.ОчиститьНеиспользуемоеМесто(ДатаГраницыUTC);
Сообщить("Вызов очистки до заданной UTC-границы выполнен");Разбор по шагам
Получите настоящее собственное хранилище.
Проверьте согласованную UTC-границу до запуска.
Передайте эту дату без превращения очистки в безусловное удаление всех данных.
Как проверить результат
Дата имеет смысл UTC, а не автоматически локального времени клиента.
Изменение размера отдельно наблюдается штатными средствами; конкретное число освобождённых байт не обещается.
Ожидаемый результат
Это короткий синтаксический пример для указанного учебного стенда. Здесь он не выполнялся; сообщение после вызова не заменяет отдельную проверку фактического состояния.
На что обратить внимание
После удаления неиспользуемых записей восстановимость прежних удалённых данных может измениться.
Здесь не используется пустая дата, не выполняется общая очистка рабочей базы и не обещается откат.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.