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