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