LIMIT
📖 Описание
В Oracle PL/SQL метод LIMIT - это функция, которая возвращает максимальное количество элементов, которые может иметь коллекция. Если коллекция не имеет максимального количества элементов, LIMIT возвращает NULL. Только Varray имеет максимальный размер.
🧩 Синтаксис
Синтаксис метода коллекций LIMIT в Oracle PL/SQL.
max_count := collection_name.LIMIT;
⚙️ Параметры и аргументы
collection_name — переменная коллекции.max_count — числовая переменная для результата. Для Varray это объявленная вместимость, для ассоциативного массива и Nested Tables — NULL.
📝 Примечание
- Смотрите также методы коллекций: PRIOR и NEXT, COUNT, FIRST и LAST, EXISTS, EXTEND, TRIM, DELETE.
- COUNT показывает текущее количество элементов, LIMIT — допустимую вместимость Varray. EXTEND и TRIM меняют COUNT, но не объявленный LIMIT.
- Метод коллекции LIMIT отличается от предложения LIMIT оператора FETCH BULK COLLECT.
- Для NULL-коллекции метод вызывает COLLECTION_IS_NULL. Это отличается от инициализированной пустой коллекции.
💻 Вместимость и текущее количество
Ассоциативный массив хранит три вместимости залов, VARRAY — две стоимости при объявленном лимите 6, вложенная таблица — четыре длительности. У всех есть COUNT; числовой LIMIT есть только у VARRAY.
DECLARE
TYPE capacity_map IS TABLE OF PLS_INTEGER INDEX BY PLS_INTEGER;
v_capacity capacity_map;
TYPE fee_array IS VARRAY(6) OF NUMBER;
v_fees fee_array := fee_array(80, 125);
TYPE minute_list IS TABLE OF PLS_INTEGER;
v_minutes minute_list := minute_list(30, 45, 60, 90);
BEGIN
v_capacity(10) := 8;
v_capacity(20) := 12;
v_capacity(40) := 6;
DBMS_OUTPUT.PUT_LINE('Map: ' || v_capacity.COUNT || ' / ' || NVL(TO_CHAR(v_capacity.LIMIT), 'NULL'));
DBMS_OUTPUT.PUT_LINE('Varray: ' || v_fees.COUNT || ' / ' || v_fees.LIMIT);
DBMS_OUTPUT.PUT_LINE('Nested: ' || v_minutes.COUNT || ' / ' || NVL(TO_CHAR(v_minutes.LIMIT), 'NULL'));
v_fees.EXTEND(2);
DBMS_OUTPUT.PUT_LINE('After EXTEND: ' || v_fees.COUNT || ' / ' || v_fees.LIMIT);
v_fees.TRIM;
DBMS_OUTPUT.PUT_LINE('After TRIM: ' || v_fees.COUNT || ' / ' || v_fees.LIMIT);
END;
/
-- Map: 3 / NULL
-- Varray: 2 / 6
-- Nested: 4 / NULL
-- After EXTEND: 4 / 6
-- After TRIM: 3 / 6
EXTEND добавляет существующие элементы со значением NULL, а не числом 0. Объявленный LIMIT остаётся 6. NULL как результат LIMIT не означает отсутствие ограничений памяти: это отсутствие заданной вместимости данного типа коллекции.
Для просмотра строк включите DBMS Output в клиенте; в SQL*Plus/SQLcl выполните SET SERVEROUTPUT ON. Ожидаемый вывод рассчитан для указанных данных.
Документация Oracle 19c: Collection Methods, Collection Method Invocation.