DELETE

📖 Описание

Метод DELETE — процедура удаления элементов коллекции. Без аргументов он удаляет все элементы и освобождает выделенную им память. Формы с индексами удаляют отдельный элемент или диапазон элементов ассоциативного массива либо вложенной таблицы.


🧩 Синтаксис

Синтаксис метода коллекций DELETE в Oracle PL/SQL.

collection_name.DELETE;
collection_name.DELETE(n);
collection_name.DELETE(m, n);

⚙️ Параметры и аргументы

collection_name — переменная коллекции.
DELETE удаляет все элементы, в том числе у Varray.
DELETE(n) удаляет элемент с индексом n, если он существует.
DELETE(m, n) удаляет существующие элементы в диапазоне индексов от m до n включительно. Если m > n либо одна из границ равна NULL, операция ничего не меняет. Формы с индексами недоступны для Varray.


📝 Примечание

  • Смотрите также методы коллекций: PRIOR и NEXT, LIMIT, COUNT, FIRST и LAST, EXISTS, EXTEND, TRIM.
  • DELETE(n) и DELETE(m, n) могут оставлять во вложенной таблице места для удалённых элементов. Их можно восстановить присваиванием по прежнему индексу. COUNT, FIRST, LAST и EXISTS не считают такие элементы существующими.
  • Удаление методом коллекции DELETE изменяет коллекцию в памяти; это не SQL-оператор DELETE FROM.
  • Для NULL-коллекции метод вызывает COLLECTION_IS_NULL. Это отличается от инициализированной пустой коллекции.

💻 DELETE для Nested Table: восстановление индексов

Удалим второй тариф, восстановим его, удалим диапазон 2–4 и восстановим третий. Завершающий DELETE без аргументов полностью очищает коллекцию.

DECLARE
  TYPE fee_list IS TABLE OF NUMBER;
  v_fees fee_list := fee_list(60, 90, 120, 150, 180);
  PROCEDURE show_fees(p_label VARCHAR2) IS
    v_index PLS_INTEGER;
  BEGIN
    DBMS_OUTPUT.PUT_LINE(p_label || ': COUNT=' || v_fees.COUNT);
    v_index := v_fees.FIRST;
    WHILE v_index IS NOT NULL LOOP
      DBMS_OUTPUT.PUT_LINE(v_index || ': ' || NVL(TO_CHAR(v_fees(v_index)), 'NULL'));
      v_index := v_fees.NEXT(v_index);
    END LOOP;
  END;
BEGIN
  show_fees('Initial');
  v_fees.DELETE(2);
  show_fees('Delete 2');
  v_fees(2) := 95;
  show_fees('Restore 2');
  v_fees.DELETE(2, 4);
  show_fees('Delete 2 to 4');
  v_fees(3) := 135;
  show_fees('Restore 3');
  v_fees.DELETE;
  show_fees('Clear');
END;
/
Этап Индексы и значения COUNT
Initial 1:60, 2:90, 3:120, 4:150, 5:180 5
Delete 2 1:60, 3:120, 4:150, 5:180 4
Restore 2 1:60, 2:95, 3:120, 4:150, 5:180 5
Delete 2 to 4 1:60, 5:180 2
Restore 3 1:60, 3:135, 5:180 3
Clear нет элементов 0

После DELETE без аргументов коллекция остаётся инициализированной пустой. Для нового элемента вложенной таблицы сначала нужен EXTEND; старые внутренние места уже не сохраняются.

💻 DELETE для ассоциативного массива

Сначала очищаем массив залов, затем заполняем заново, удаляем один ключ и диапазон. Показанный результат соответствует бинарной сортировке CLAY, GLASS, PAPER, WOOD. При строковых ключах учитывайте NLS_SORT/NLS_COMP.

DECLARE
  TYPE capacity_map IS TABLE OF PLS_INTEGER INDEX BY VARCHAR2(12);
  v_capacity capacity_map;
  PROCEDURE show_rooms(p_label VARCHAR2) IS
    v_key VARCHAR2(12);
  BEGIN
    DBMS_OUTPUT.PUT_LINE(p_label || ': COUNT=' || v_capacity.COUNT);
    v_key := v_capacity.FIRST;
    WHILE v_key IS NOT NULL LOOP
      DBMS_OUTPUT.PUT_LINE(v_key || ': ' || v_capacity(v_key));
      v_key := v_capacity.NEXT(v_key);
    END LOOP;
  END;
BEGIN
  v_capacity('WOOD') := 6;
  v_capacity('CLAY') := 8;
  show_rooms('Initial');
  v_capacity.DELETE;
  show_rooms('Clear');
  v_capacity('CLAY') := 10;
  v_capacity('GLASS') := 4;
  v_capacity('PAPER') := 12;
  v_capacity('WOOD') := 7;
  show_rooms('Refill');
  v_capacity.DELETE('CLAY');
  show_rooms('Delete CLAY');
  v_capacity.DELETE('GLASS', 'PAPER');
  show_rooms('Delete range');
  v_capacity.DELETE('WOOD', 'CLAY');
  show_rooms('Reverse range');
END;
/
Этап Существующие ключи и значения COUNT
Initial CLAY:8, WOOD:6 2
Clear нет элементов 0
Refill CLAY:10, GLASS:4, PAPER:12, WOOD:7 4
Delete CLAY GLASS:4, PAPER:12, WOOD:7 3
Delete range WOOD:7 1
Reverse range WOOD:7 1

Обратный диапазон не меняет массив. В отличие от вложенной таблицы, новый ключ ассоциативного массива создаётся обычным присваиванием, без EXTEND.

Включите DBMS Output в клиенте; в SQL*Plus/SQLcl выполните SET SERVEROUTPUT ON. Вывод рассчитан по данным примеров.

Документация Oracle 19c: Collection Methods, Collection Method Invocation.