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, а отдельная строка / отправляет завершённый блок на выполнение.