Associative Arrays
📖 Описание
Associative Arrays — ассоциативные массивы, или индексные таблицы: наборы пар «ключ — значение». Ключ уникален и позволяет обращаться к элементу как array_name(key). Индексы могут быть целыми числами или строками, а их значения не обязаны быть последовательными.
🧩 Синтаксис
Синтаксис определения типа ассоциативного массива и объявления переменной этого типа в Oracle PL/SQL:
TYPE type_assoc_arr IS TABLE OF element_type [NOT NULL]
INDEX BY key_type;
var_type type_assoc_arr;
⚙️ Параметры и аргументы
type_assoc_arr — имя типа массива.element_type — тип элемента PL/SQL, кроме REF CURSOR.key_type — PLS_INTEGER/BINARY_INTEGER либо VARCHAR2(size_limit) и строковые подтипы VARCHAR/STRING. Устаревший LONG тоже поддерживается для совместимости; для нового кода используйте VARCHAR2.var_type — переменная объявленного типа. Квадратные скобки обозначают необязательное ограничение NOT NULL и не входят в код.
📝 Примечание
- Типы RAW, LONG RAW, ROWID, CHAR и CHARACTER не разрешены в качестве ключей для Associative Arrays.
- Associative Arrays могут хранить данные с использованием значения первичного ключа в качестве индекса, где значения ключа не являются последовательными.
- Когда вы ссылаетесь на элемент Associative Arrays, который использует ключ на основе VARCHAR2, вы можете использовать другие типы, такие как DATE или TIMESTAMP, если они могут быть преобразованы в VARCHAR2 с помощью функции TO_CHAR.
- Для ключей, получаемых из даты, указывайте явную маску TO_CHAR. Преобразование без маски зависит от настроек NLS и может давать неоднозначные ключи.
- Новый ассоциативный массив уже пуст и готов к заполнению: конструктор и EXTEND не нужны.
- FIRST и NEXT обходят существующие ключи в порядке сортировки. Для строк он зависит от NLS_SORT и NLS_COMP, а не от порядка добавления.
Не меняйте NLS_SORT/NLS_COMP после заполнения строковых ключей: это может изменить порядок обхода и вызвать ошибки. В примерах ниже показан результат для бинарного порядка строковых ключей. Числовые ключи не обязаны начинаться с 1.
💻 Примеры
Массив, индексированный VARCHAR2
DECLARE
TYPE capacity_map IS TABLE OF PLS_INTEGER INDEX BY VARCHAR2(20);
v_capacity capacity_map;
v_room VARCHAR2(20);
BEGIN
v_capacity('WOOD') := 6;
v_capacity('CLAY') := 8;
v_capacity('PAPER') := 12;
v_capacity('CLAY') := 10;
v_room := v_capacity.FIRST;
WHILE v_room IS NOT NULL LOOP
DBMS_OUTPUT.PUT_LINE(v_room || ': ' || v_capacity(v_room));
v_room := v_capacity.NEXT(v_room);
END LOOP;
END;
/
CLAY: 10
PAPER: 12
WOOD: 6
WOOD добавлен первым, но печатается последним. Повторное присваивание ключу CLAY заменяет 8 на 10, не добавляя новый элемент. Новый массив сразу пуст; конструктор и EXTEND не требуются.
Массив с целочисленными индексами, возвращаемый функцией
Для каждой позиции i вычислим накопленную сумму размеров партий 6, 12, 18, …, 6·i:
DECLARE
TYPE batch_sums IS TABLE OF PLS_INTEGER INDEX BY PLS_INTEGER;
v_sums batch_sums;
FUNCTION build_sums(p_step PLS_INTEGER, p_count PLS_INTEGER)
RETURN batch_sums
IS
v_result batch_sums;
BEGIN
FOR i IN 1..p_count LOOP
v_result(i) := p_step * i * (i + 1) / 2;
END LOOP;
RETURN v_result;
END;
BEGIN
v_sums := build_sums(6, 7);
DBMS_OUTPUT.PUT_LINE('First 4 batches: ' || v_sums(4));
END;
/
First 4 batches: 60
6 + 12 + 18 + 24 = 60. Создано семь элементов; читается четвёртый. Пример использует небольшие целые значения, помещающиеся в PLS_INTEGER. Обращение к отсутствующему ключу вызывает NO_DATA_FOUND; перед необязательным чтением проверяют метод EXISTS.
📌 Когда использовать ассоциативный массив
Он подходит для небольшого справочника в памяти, поиска по ключу и передачи наборов данных между PL/SQL-подпрограммами. Возможности передачи из клиентского приложения зависят от драйвера и используемых типов ключей.
📌 Тип в спецификации пакета
Ассоциативный тип нельзя создать через CREATE TYPE на уровне схемы. Для общей сигнатуры отдельной хранимой процедуры объявите тип в спецификации пакета: и процедура, и вызывающий блок будут ссылаться на один тип.
📌 Передача массива в отдельную подпрограмму
CREATE OR REPLACE PACKAGE demo_slot_types IS
TYPE slot_map IS TABLE OF PLS_INTEGER INDEX BY VARCHAR2(15);
END demo_slot_types;
/
CREATE OR REPLACE PROCEDURE demo_print_slots(p_slots IN demo_slot_types.slot_map) IS
v_key VARCHAR2(15);
BEGIN
v_key := p_slots.FIRST;
WHILE v_key IS NOT NULL LOOP
DBMS_OUTPUT.PUT_LINE(v_key || ': ' || p_slots(v_key));
v_key := p_slots.NEXT(v_key);
END LOOP;
END;
/
DECLARE
v_slots demo_slot_types.slot_map;
BEGIN
v_slots('TUE_AM') := 3;
v_slots('MON_PM') := 6;
v_slots('MON_AM') := 4;
demo_print_slots(v_slots);
END;
/
MON_AM: 4
MON_PM: 6
TUE_AM: 3
Порядок показан для бинарной сортировки. Создание пакета и процедуры требует прав в учебной схеме; DDL фиксирует текущую транзакцию. Пустой массив просто не войдёт в WHILE.
📌 Хранение и пакетная обработка
Ассоциативные массивы удобны для временных таблиц поиска и пакетной обработки. Для BULK COLLECT и FORALL применяют коллекции с целочисленными индексами с учётом ограничений этих операторов. Переменная обычного пакета может хранить данные между вызовами в рамках сеанса; данные такого массива не сохраняются как строки таблицы базы данных.
Для сравнения: Nested Tables допускают пропуски после DELETE, а VARRAY сохраняет плотные индексы и имеет объявленный предел.
См. документацию Oracle PL/SQL: associative-arrays.
См. документацию Oracle PL/SQL: collection-variable.
Включите DBMS Output в клиенте. В SQL*Plus или SQLcl перед блоком используется SET SERVEROUTPUT ON, а отдельная строка / отправляет завершённый блок на выполнение.