Nested Tables
📖 Описание
Nested Tables — вложенные таблицы: коллекции с целочисленными индексами и без заранее заданного максимального числа элементов. После извлечения из базы данных элементы получают последовательные индексы от 1. При сохранении и повторном извлечении порядок и индексы могут измениться: порядок строк в хранимой вложенной таблице не гарантирован.
🧩 Синтаксис
Синтаксис определения типа вложенной таблицы и объявления переменной этого типа в Oracle PL/SQL:
TYPE nt_type IS TABLE OF element_type [NOT NULL];
var_nt nt_type;
⚙️ Параметры и аргументы
nt_type - имя типа, используемое позже для объявления коллекций.
element_type - любой тип данных PL/SQL, за исключением REF CURSOR и NCLOB
var_nt – переменная типа Nested Tables.
📝 Примечание
- Неинициализированная переменная имеет значение NULL (атомарно NULL-коллекция). Это отличается от существующей пустой коллекции с COUNT = 0.
- Перед работой инициализируйте коллекцию конструктором, например nt_type(), либо присвойте ей совместимую коллекцию, отличную от NULL.
- После DELETE в индексах могут появиться пропуски. Для обхода разреженной коллекции используйте FIRST/NEXT; после обычного заполнения конструктором она плотная.
💻 Nested Table как локальный тип
Коллекция хранит названия направлений мастерской. Процедура обходит её через FIRST и NEXT, поэтому работает и после удаления элемента:
DECLARE
TYPE workshop_list IS TABLE OF VARCHAR2(30);
v_workshops workshop_list := workshop_list('Clay', 'Paper', 'Wood', 'Glass');
PROCEDURE print_workshops(p_heading VARCHAR2) IS
v_index PLS_INTEGER;
BEGIN
DBMS_OUTPUT.PUT_LINE(p_heading);
v_index := v_workshops.FIRST;
WHILE v_index IS NOT NULL LOOP
DBMS_OUTPUT.PUT_LINE(v_index || ': ' || v_workshops(v_index));
v_index := v_workshops.NEXT(v_index);
END LOOP;
DBMS_OUTPUT.PUT_LINE('---');
END;
BEGIN
print_workshops('Initial:');
v_workshops(3) := 'Mosaic';
print_workshops('Changed:');
v_workshops.DELETE(2);
print_workshops('Sparse:');
v_workshops := workshop_list('Textile', 'Canvas');
print_workshops('Replaced:');
END;
/
Initial:
1: Clay
2: Paper
3: Wood
4: Glass
---
Changed:
1: Clay
2: Paper
3: Mosaic
4: Glass
---
Sparse:
1: Clay
3: Mosaic
4: Glass
---
Replaced:
1: Textile
2: Canvas
---
DELETE(2) оставляет пропуск: индексы 3 и 4 не сдвигаются. После нового конструктора существуют только 1 и 2. Обращение к третьему элементу после этого присваивания вызвало бы SUBSCRIPT_BEYOND_COUNT (ORA-06533); оно намеренно не включено в выполняемый блок.
Тип на уровне схемы
SQL-тип и отдельная процедура позволяют передавать коллекцию между подпрограммами. Здесь процедура принимает инициализированную коллекцию, которая может быть пустой:
CREATE OR REPLACE TYPE demo_fee_list AS TABLE OF NUMBER;
/
CREATE OR REPLACE PROCEDURE demo_print_fees(p_fees IN demo_fee_list) IS
v_index PLS_INTEGER;
BEGIN
v_index := p_fees.FIRST;
IF v_index IS NULL THEN
DBMS_OUTPUT.PUT_LINE('No fees');
ELSE
WHILE v_index IS NOT NULL LOOP
DBMS_OUTPUT.PUT_LINE(v_index || ': ' || p_fees(v_index));
v_index := p_fees.NEXT(v_index);
END LOOP;
END IF;
DBMS_OUTPUT.PUT_LINE('---');
END;
/
DECLARE
v_fees demo_fee_list := demo_fee_list();
BEGIN
demo_print_fees(v_fees);
v_fees := demo_fee_list(40, 65, 90, 120);
demo_print_fees(v_fees);
END;
/
No fees
---
1: 40
2: 65
3: 90
4: 120
---
demo_fee_list() создаёт существующую пустую коллекцию, а не NULL. Вызов этой процедуры с атомарно NULL-коллекцией не соответствует её условию использования: FIRST вызовет COLLECTION_IS_NULL. Создание объектов выполняйте в учебной схеме с нужными правами; DDL фиксирует текущую транзакцию.
📌 Использование Nested Tables
Вложенная таблица подходит, если:
- Количество элементов не задано.
- Значения индекса не являются последовательными.
- Вы должны удалить или обновить некоторые элементы, но не все элементы одновременно.
Если вложенная таблица используется как столбец таблицы базы данных, её элементы хранятся в отдельной таблице хранения. Это удобно для запросов и изменений отдельных элементов. Локальная переменная PL/SQL сама по себе такую таблицу хранения не создаёт.
См. документацию Oracle PL/SQL: nested-tables.
См. документацию Oracle PL/SQL: collection-variable.
Включите DBMS Output в клиенте. В SQL*Plus или SQLcl перед блоком используется SET SERVEROUTPUT ON, а отдельная строка / отправляет завершённый блок на выполнение.