Получает количество таблиц в коллекции.
Синтаксис
Количество()Примеры платформы
РезультатЗапроса.Колонки.Количество();Полное описание, параметры и ограничения
ВременныеТаблицыЗапроса.Количество (QueryTempTables.Count)
ВременныеТаблицыЗапроса (QueryTempTables)
Количество (Count)
Доступен, начиная с версии 8.3.8.
Синтаксис:
Количество()
Возвращаемое значение:
Тип: Число.
Описание:
Получает количество таблиц в коллекции.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Пример:
РезультатЗапроса.Колонки.Количество();
Использование в версии:
Доступен, начиная с версии 8.3.8.
Методическая информация
Практические примеры
Уничтожить только свою временную таблицу запросом
В пакете создаём собственную временную таблицу с числами, читаем её и добавляем отдельный ЗапросУничтоженияТаблицыСхемыЗапроса. Это не удаление таблицы СУБД или регистра 1С.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В учебной обработке или общем модуле выполните каждый фрагмент отдельно на сервере. Все запросы используют только свои числа и параметры, без справочников, документов и регистров рабочей базы.
СхемаЗапроса редактирует структуру и формирует текст, а Запрос выполняет этот текст. Родительская схема должна оставаться в переменной, пока используются её дочерние объекты.
Не переносите полученные дочерние объекты между разными схемами и не обращайтесь к элементу после его удаления. Упражнения удаления работают только со своей структурой в памяти.
Схема = Новый СхемаЗапроса;
Схема.УстановитьТекстЗапроса("ВЫБРАТЬ 3 КАК Количество, 250 КАК Цена ПОМЕСТИТЬ УчебныеКниги; ВЫБРАТЬ Количество * Цена КАК Сумма ИЗ УчебныеКниги");
Уничтожение = Схема.ПакетЗапросов.Добавить(Тип("ЗапросУничтоженияТаблицыСхемыЗапроса"));
Если ТипЗнч(Уничтожение) <> Тип("ЗапросУничтоженияТаблицыСхемыЗапроса") Тогда
ВызватьИсключение "Не создан собственный запрос уничтожения";
КонецЕсли;
Уничтожение.ИмяТаблицы = "УчебныеКниги";
Сообщить(Уничтожение.ИмяТаблицы = "УчебныеКниги");
Сообщить(Схема.ПакетЗапросов.Количество() = 3);
Менеджер = Новый МенеджерВременныхТаблиц;
Попытка
Запрос = Новый Запрос(Схема.ПолучитьТекстЗапроса());
Запрос.МенеджерВременныхТаблиц = Менеджер;
Результаты = Запрос.ВыполнитьПакет();
Если Результаты.Количество() <> 3 Тогда
ВызватьИсключение "Ожидались три результата своего пакета";
КонецЕсли;
Таблица = Результаты[1].Выгрузить();
Если Таблица.Количество() <> 1 Тогда
ВызватьИсключение "Ожидалась одна строка собственных книг";
КонецЕсли;
Сообщить(Таблица[0].Сумма = 750);
Сообщить(Менеджер.Таблицы.Количество() = 0);
Исключение
Менеджер.Закрыть();
ВызватьИсключение;
КонецПопытки;
Менеджер.Закрыть();Разбор по шагам
Две первые операции пакета целиком описаны в уроке: создают временную таблицу и читают её числовые данные.
Добавить получает объект Тип, а не строку имени типа. После проверки типа устанавливаем имя только своей временной таблицы.
Новый МенеджерВременныхТаблиц принадлежит этому фрагменту, не взят из внешнего рабочего запроса.
Результаты[1] — результат чтения, а не операции создания или уничтожения. Сначала проверяем размер массива.
После уничтожения свой менеджер не содержит таблиц. Он закрывается и на успешном, и на ошибочном пути.
Как проверить результат
Четыре сравнения Истина: имя, размер пакета, сумма 750, отсутствие временных таблиц.
Никакой справочник, регистр, документ или физическая таблица СУБД не удаляются.
Ожидаемый результат
Проверена отдельная операция уничтожения собственной временной таблицы в полном пакете.
На что обратить внимание
УНИЧТОЖИТЬ относится к временной таблице языка запросов, не к команде DROP TABLE.
Не выполняйте этот фрагмент с чужим менеджером временных таблиц.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Прочитать описание собственной временной таблицы
Второй запрос пакета видит описание УчебныеКниги ещё до исполнения. Его поля описывают типы; реальные числа получаем отдельным выполнением.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В учебной обработке или общем модуле выполните каждый фрагмент отдельно на сервере. Все запросы используют только свои числа и параметры, без справочников, документов и регистров рабочей базы.
СхемаЗапроса редактирует структуру и формирует текст, а Запрос выполняет этот текст. Родительская схема должна оставаться в переменной, пока используются её дочерние объекты.
Не переносите полученные дочерние объекты между разными схемами и не обращайтесь к элементу после его удаления. Упражнения удаления работают только со своей структурой в памяти.
Схема = Новый СхемаЗапроса;
Схема.УстановитьТекстЗапроса("ВЫБРАТЬ 3 КАК Количество, 250 КАК Цена ПОМЕСТИТЬ УчебныеКниги;
|ВЫБРАТЬ Книги.Количество * Книги.Цена КАК Сумма ИЗ УчебныеКниги КАК Книги");
Если Схема.ПакетЗапросов.Количество() <> 2 Тогда
ВызватьИсключение "Ожидались создание и чтение собственной временной таблицы";
КонецЕсли;
Создание = Схема.ПакетЗапросов.Получить(0);
Чтение = Схема.ПакетЗапросов.Получить(1);
Если ТипЗнч(Создание) <> Тип("ЗапросВыбораСхемыЗапроса") Или ТипЗнч(Чтение) <> Тип("ЗапросВыбораСхемыЗапроса") Тогда
ВызватьИсключение "Обе операции должны быть собственными выборками";
КонецЕсли;
Если Создание.ТаблицаДляПомещения <> "УчебныеКниги" Тогда
ВызватьИсключение "Первый запрос не создаёт нашу временную таблицу";
КонецЕсли;
Если Чтение.Операторы.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один оператор чтения своей таблицы";
КонецЕсли;
Оператор = Чтение.Операторы.Получить(0);
Источник = Оператор.Источники.НайтиПоПсевдониму("Книги");
Если Источник = Неопределено Тогда
ВызватьИсключение "Нет собственного источника Книги";
КонецЕсли;
ОписаниеТаблицы = Источник.Источник;
Если ТипЗнч(ОписаниеТаблицы) <> Тип("ОписаниеВременнойТаблицыСхемыЗапроса") Тогда
ВызватьИсключение "Ожидалось описание собственной временной таблицы";
КонецЕсли;
Сообщить(ОписаниеТаблицы.ИмяТаблицы = "УчебныеКниги");
Сообщить(ОписаниеТаблицы.Псевдоним = "Книги");
Поля = ОписаниеТаблицы.ДоступныеПоля;
КоличествоПоле = Поля.Найти("Количество");
Если КоличествоПоле = Неопределено Тогда
ВызватьИсключение "Описание не содержит собственного количества";
КонецЕсли;
Если ТипЗнч(КоличествоПоле) <> Тип("ДоступноеПолеСхемыЗапроса") Тогда
ВызватьИсключение "Ожидалось простое описание числового поля";
КонецЕсли;
Сообщить(Поля.Количество() = 2);
Сообщить(КоличествоПоле.ТипЗначения.СодержитТип(Тип("Число")));
Менеджер = Новый МенеджерВременныхТаблиц;
Попытка
Запрос = Новый Запрос(Схема.ПолучитьТекстЗапроса());
Запрос.МенеджерВременныхТаблиц = Менеджер;
Результаты = Запрос.ВыполнитьПакет();
Если Результаты.Количество() <> 2 Тогда
ВызватьИсключение "Ожидались два результата собственного пакета";
КонецЕсли;
Таблица = Результаты[1].Выгрузить();
Если Таблица.Количество() <> 1 Тогда
ВызватьИсключение "Ожидалась одна собственная строка";
КонецЕсли;
Сообщить(Таблица[0].Сумма = 750);
Сообщить(Менеджер.Таблицы.Количество() = 1);
Исключение
Менеджер.Закрыть();
ВызватьИсключение;
КонецПопытки;
Менеджер.Закрыть();Разбор по шагам
Схема знает описание временной таблицы из первой операции пакета. Но физическая временная таблица появится лишь при исполнении.
Источник находится по псевдониму Книги и проверяется до чтения Источник.
Дополнительно проверяем точный тип ОписаниеВременнойТаблицыСхемыЗапроса: его нельзя путать с вложенным запросом или реальной таблицей метаданных.
ИмяТаблицы обозначает УчебныеКниги, Псевдоним — Книги в тексте второй операции. ДоступныеПоля даёт два описания, а не две строки товаров.
Тип количества числовой; значение 3 и расчёт 750 проверяет только выполненный пакет со своим менеджером.
Как проверить результат
Шесть сообщений Истина.
Описание двух колонок получено до выполнения; реальная строка и сумма 750 проверены после.
Ожидаемый результат
Показана граница между объектной схемой и созданной временной таблицей.
На что обратить внимание
ОписаниеТаблицы не имеет метода Выгрузить для строк данных.
Не подставляйте чужой менеджер и не изменяйте произвольные имена временных таблиц в рабочем пакете.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.