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.