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.