Сохраняет изменения менеджера внешнего хранилища двоичных данных в базу данных. Вызов метода требует административных прав в сеансе, в котором все разделители не установлены. Если до вызова метода режим монопольного доступа к базе данных не был установлен, то он устанавливается на время вызова. Если установить монопольный доступ невозможно, будет сгенерировано исключение. Если режим хранилища по умолчанию на другом внешнем либо встроенном хранилище двоичных данных установлен в Истина, то при попытке установить ХранилищеПоУмолчанию в Истина будет сгенерировано исключение. Один и тот же объект метаданных в СоставХранимыхДанных не может быть настроен для использования с разными хранилищами двоичных данных в СоставХранимыхДанных. Если СоставХранимыхДанных содержит объект метаданных, который уже был настроен для использования в другом внешнем или встроенном хранилище двоичных данных, будет сгенерировано исключение.
Синтаксис
Записать()Примеры платформы
СтрПодключения = Новый
ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных();
СтрПодключения.URL = "https://bucket.example.com";
СтрПодключения.ТипURL =
ТипURLВнешнегоХранилищаДвоичныхДанных.ВиртуальныйХостS3;
Доступ = Новый ПараметрыДоступаВнешнегоХранилищаДвоичныхДанных();
Доступ.ИдентификаторДоступа = "EXAMPLE";
Доступ.СекретныйКлюч = "wJalrXUtnFEMI/K7MDENG/bPxRfiCY";
Доступ.Регион = "US";
Мнджр = ВнешниеХранилищаДвоичныхДанных
.Добавить("manager", СтрПодключения, Доступ);
Мнджр.МинимальныйРазмерЗаписываемыхДанных = 4096;
Мнджр.Имя = "OtherName";
РежимЗаписи = РежимЧтенияЗаписиХранилищаДвоичныхДанных.ЧтениеЗапись;
Мнджр.РежимЧтенияЗаписи = РежимЗаписи;
Мнджр.Записать();Полное описание, параметры и ограничения
МенеджерВнешнегоХранилищаДвоичныхДанных.Записать (BinaryDataExternalStorageManager.Write)
МенеджерВнешнегоХранилищаДвоичныхДанных (BinaryDataExternalStorageManager)
Записать (Write)
Доступен, начиная с версии 8.3.24.
Синтаксис:
Записать()
Возвращаемое значение:
Нет
Описание:
Сохраняет изменения менеджера внешнего хранилища двоичных данных в базу данных.
Вызов метода требует административных прав в сеансе, в котором все разделители не установлены. Если до вызова метода режим монопольного доступа к базе данных не был установлен, то он устанавливается на время вызова. Если установить монопольный доступ невозможно, будет сгенерировано исключение.
Если режим хранилища по умолчанию на другом внешнем либо встроенном хранилище двоичных данных установлен в Истина, то при попытке установить ХранилищеПоУмолчанию в Истина будет сгенерировано исключение.
Один и тот же объект метаданных в СоставХранимыхДанных не может быть настроен для использования с разными хранилищами двоичных данных в СоставХранимыхДанных. Если СоставХранимыхДанных содержит объект метаданных, который уже был настроен для использования в другом внешнем или встроенном хранилище двоичных данных, будет сгенерировано исключение.
Доступность:
Сервер.
Примечание:
МинимальныйРазмерЗаписываемыхДанных должен быть не менее 2048 байт. При попытке установить меньшее значение, устанавливается значение 2048 байт.
Пример:
СтрПодключения = Новый
ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных();
СтрПодключения.URL = "https://bucket.example.com";
СтрПодключения.ТипURL =
ТипURLВнешнегоХранилищаДвоичныхДанных.ВиртуальныйХостS3;
Доступ = Новый ПараметрыДоступаВнешнегоХранилищаДвоичныхДанных();
Доступ.ИдентификаторДоступа = "EXAMPLE";
Доступ.СекретныйКлюч = "wJalrXUtnFEMI/K7MDENG/bPxRfiCY";
Доступ.Регион = "US";
Мнджр = ВнешниеХранилищаДвоичныхДанных
.Добавить("manager", СтрПодключения, Доступ);
Мнджр.МинимальныйРазмерЗаписываемыхДанных = 4096;
Мнджр.Имя = "OtherName";
РежимЗаписи = РежимЧтенияЗаписиХранилищаДвоичныхДанных.ЧтениеЗапись;
Мнджр.РежимЧтенияЗаписи = РежимЗаписи;
Мнджр.Записать();
См. также:
МенеджерВнешнегоХранилищаДвоичныхДанных, свойство МинимальныйРазмерЗаписываемыхДанных
МенеджерВнешнегоХранилищаДвоичныхДанных, свойство РежимЧтенияЗаписи
Использование в версии:
Доступен, начиная с версии 8.3.24.
Описание изменено в версии 8.3.26.
Методическая информация
Практические примеры
Добавить и удалить собственную регистрацию внешнего хранилища
Настройки доступа берём из своего действительного хранилища. Новый объект — отдельная учебная регистрация, не произвольная структура доступа.
Где и как запускать
Серверный обработчик своей учебной базы. Это пример синтаксиса: здесь 1С, файлы, базы и сеть не запускались.
Подготовка
Только собственная учебная серверная ИБ в заранее установленном монопольном режиме и собственный отдельный S3-ресурс. Подготовьте регистрацию УчебноеИсходное с действительными доступом и параметрами.
АдресУчебногоS3 — реальная строка адреса своего учебного ресурса. study-extra — отдельное согласованное учебное размещение; имя УчебноеДополнительное должно быть свободно. Не выводите ключи доступа.
Менеджер = ВнешниеХранилищаДвоичныхДанных;
Источник = Менеджер.Найти("УчебноеИсходное");
Доступ = Источник.ПараметрыДоступа;
Подключение = Новый ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных;
Подключение.URL = АдресУчебногоS3;
Подключение.Каталог = "study-extra";
Подключение.ТипURL = Источник.ПараметрыПодключения.ТипURL;
Новое = Менеджер.Добавить("УчебноеДополнительное", Подключение, Доступ);
Новое.ХранилищеПоУмолчанию = Ложь;
Новое.Записать();
Сообщить(Новое.Имя);
Менеджер.Удалить(Новое);Разбор по шагам
Используем действительные параметры доступа своего источника.
Создаём и записываем отдельную регистрацию.
Удаляем только удержанный новый объект регистрации.
Как проверить результат
Прочитано собственное новое имя УчебноеДополнительное.
Удаление относится к новому объекту, не к источнику.
Ожидаемый результат
Контрольный результат описывает будущую ручную проверку в подготовленном учебном окружении. Выполнение в 1С здесь не проверялось.
На что обратить внимание
Добавить и Удалить требуют монопольного режима. Это будущие изменения своего стенда, не атомарный опыт: ошибка может оставить регистрацию; никаких обещаний удаления файлов S3 или отката.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.