Varrays

📖 Описание

В Oracle PL/SQL Varray (массив с переменным размером) - это массив, число элементов которого может варьироваться от нуля (пусто) до объявленного максимального размера.
Чтобы получить доступ к элементу переменной Varray, используйте синтаксис variable_name(index).
Нижняя граница index равна 1; верхняя граница - это текущее количество элементов.
Верхняя граница изменяется при добавлении или удалении элементов, но она не может превышать максимальный размер.
Когда вы храните и извлекаете varray из базы данных, его индексы и порядок элементов остаются стабильными.


🧩 Синтаксис

Синтаксис определения типа VARRAY и объявления переменной этого типа в Oracle PL/SQL:

TYPE type_varray IS {VARRAY | VARYING ARRAY} (size_limit)  OF element_type [NOT NULL];
v_arr type_varray;

⚙️ Параметры и аргументы

type_varray – имя типа Varray
element_type - любой тип данных PL/SQL, за исключением REF CURSOR
size_limit - это положительный целочисленный литерал, представляющий максимальное количество элементов в массиве (от 1 до 2147483647 для локального объявления PL/SQL Oracle 19c).
v_arr - имя переменной типа Varray


📝 Примечание

  • При определении типа Varray укажите максимальное число элементов. LIMIT возвращает этот предел, а COUNT — текущее число элементов.
  • Неинициализированный Varray равен NULL. Конструктор team_type() создаёт пустую коллекцию.
  • Varray всегда плотный: индексы существующих элементов идут от 1 до COUNT. EXTEND добавляет элементы в пределах LIMIT, TRIM удаляет элементы с конца. Удалять отдельные элементы методом DELETE(n) нельзя.

💻 Пример

В команде мастерской максимум четыре человека. Покажем исходный состав, замену двух участников и полную замену коллекции в течение 2026 года:

DECLARE
  TYPE team_type IS VARRAY(4) OF VARCHAR2(30);
  v_team team_type := team_type('Aziza', 'Nodira', 'Timur', 'Kamol');

  PROCEDURE print_team(p_heading VARCHAR2) IS
  BEGIN
    DBMS_OUTPUT.PUT_LINE(p_heading);
    FOR i IN 1..v_team.COUNT LOOP
      DBMS_OUTPUT.PUT_LINE(i || '. ' || v_team(i));
    END LOOP;
    DBMS_OUTPUT.PUT_LINE('---');
  END;
BEGIN
  print_team('Spring 2026:');
  v_team(3) := 'Zarina';
  v_team(4) := 'Jasur';
  print_team('Summer 2026:');
  v_team := team_type('Malika', 'Dilshod', 'Sabina', 'Bekzod');
  print_team('Autumn 2026:');
END;
/
Spring 2026:
1. Aziza
2. Nodira
3. Timur
4. Kamol
---
Summer 2026:
1. Aziza
2. Nodira
3. Zarina
4. Jasur
---
Autumn 2026:
1. Malika
2. Dilshod
3. Sabina
4. Bekzod
---

Все три состояния имеют COUNT = 4 и LIMIT = 4. Конструктор заменяет значения целиком, а присваивание v_team(3) изменяет один существующий элемент.

COUNT и LIMIT при изменении размера

DECLARE
  TYPE team_type IS VARRAY(4) OF VARCHAR2(30);
  v_team team_type := team_type('Aziza', 'Nodira', 'Timur', 'Kamol');
BEGIN
  v_team.TRIM(2);
  DBMS_OUTPUT.PUT_LINE(v_team.COUNT || '/' || v_team.LIMIT);
  v_team.EXTEND;
  v_team(3) := 'Shahnoza';
  DBMS_OUTPUT.PUT_LINE(v_team.COUNT || '/' || v_team.LIMIT);
END;
/
2/4
3/4

TRIM удаляет элементы с конца, EXTEND добавляет новый элемент перед присваиванием. LIMIT остаётся прежним; COUNT меняется. В этой коллекции элементы допускают NULL, поэтому EXTEND без копирования элемента допустим.


📌 Использование Varray

Varray целесообразно использовать, когда:

  • Вы знаете максимальное количество элементов.
  • Вы получаете доступ к элементам последовательно.
  • Поскольку вы должны хранить или извлекать все элементы одновременно, Varray может оказаться непрактичным для большого количества элементов.

См. документацию Oracle PL/SQL: varrays-variable-size-arrays.

См. документацию Oracle PL/SQL: collection-variable.

См. документацию Oracle PL/SQL: collection-methods.

Включите DBMS Output в клиенте. В SQL*Plus или SQLcl перед блоком используется SET SERVEROUTPUT ON, а отдельная строка / отправляет завершённый блок на выполнение.