Глобальный контекст (Global context)

ПолучитьРазмерДанныхБазыДанныхИХранилищаДвоичныхДанных (GetDatabaseAndBinaryDataStorageDataSize)

Доступен, начиная с версии 8.3.24.

Синтаксис:

ПолучитьРазмерДанныхБазыДанныхИХранилищаДвоичныхДанных(<ОбластьПоиска>, <ВключитьОбъекты>, <ИсключитьОбъекты>)

Параметры:

<ОбластьПоиска> (необязательный)

Тип: Неопределено, Массив.
Определяет область поиска объектов путем задания комбинации разделителей, в состав которых включены объекты метаданных, по которым нужно посчитать размер данных. В данном параметре указываются не значения, а сами разделители (общий реквизит, разделяющий данные).
Элемент массива имеет тип Массив.
Элемент вложенного массива имеет тип:

• Объект метаданных – Общий реквизит, разделяющий данные.
• Строка – имя общего реквизита, разделяющего данные. Не полное, а короткое имя.

Допустимые значения:

• Неопределено - выбирает все объекты метаданных, если параметр <ВключитьОбъекты> также имеет значение Неопределено. Иначе равносильно передаче пустого массива.
• Массив с массивами разделителей - массив комбинаций разделителей, определяющий область учета данных:
  • Если массив пуст, то никакие объекты не выбираются и перечень объектов определяется другими параметрами.
  • Если массив содержит несколько комбинаций разделителей, то выбираются все объекты метаданных, состав разделителей которых полностью равен одной из заданных комбинаций.

Значение по умолчанию: Неопределено.

<ВключитьОбъекты> (необязательный)

Тип: Неопределено, Массив.
Позволяет явно указать объекты метаданных, которые должны присутствовать при подсчете размера данных.
Элементом массива могут быть:

• Объект метаданных.
• Строка – полное имя объекта метаданных.

Допустимые значения:

• Неопределено или пустой массив - нет объектов, которые необходимо дополнительно включить в область подсчета.
• Массив объектов метаданных.

Значение по умолчанию: Неопределено.

<ИсключитьОбъекты> (необязательный)

Тип: Неопределено, Массив.
Позволяет явно указать объекты метаданных, которые следует исключить из подсчета данных.
Элементом массива могут быть:

• Объект метаданных.
• Строка – полное имя объекта метаданных.

Допустимые значения:

• Неопределено или пустой массив - нет объектов, которые необходимо дополнительно исключить.
• Массив объектов метаданных.

Значение по умолчанию: Неопределено.

Возвращаемое значение:

Тип: Число.
Возвращает размер в байтах.

Описание:

Метод возвращает размер данных в таблицах в информационной базе для переданных объектов, с учетом данных хранилища двоичных данных (в байтах). Будут получены все данные, которые доступны пользователю для чтения.
Метод не учитывает размер истории данных, а также расширений конфигурации.
Если необходимо получить размер только данных, участвующих в разделении, следует установить значения для набора разделителей (тем самым "перейдя" в нужную область) и установить в <ОбластьПоиска> текущий набор разделителей.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер, интеграция.

Примечание:

Выполнение метода может занять длительное время при большом объеме данных.

Пример:

Использование в версии:

Доступен, начиная с версии 8.3.24.

     Методическая информация