Record
📖 Описание
RECORD — запись, объединяющая связанные поля с собственными именами и типами данных. Запись может хранить строку таблицы, часть её столбцов или произвольный набор данных. Доступ к полю выполняется через точку: record_name.field_name.
📌 Определение и объявление RECORD
Атрибут %ROWTYPE позволяет объявить запись по видимым столбцам таблицы без их перечисления. Изменение структуры таблицы меняет структуру записи при перекомпиляции зависимого кода; совместимость остальных выражений и списков столбцов нужно проверить. Если вы хотите представить подмножество столбцов в таблице или столбцы из разных таблиц, вы можете определить VIEW или объявить CURSOR для выбора правильных столбцов и любых необходимых объединений, а затем применить атрибут %ROWTYPE к VIEW или CURSOR.
🧩 Синтаксис
Синтаксис определения типа Record и объявления переменной в Oracle PL/SQL:
TYPE type_rec_name IS RECORD (
field_1 datatype,
field_2 datatype [NOT NULL] [:= default_value]
);
var_rec type_rec_name;
⚙️ Параметры и аргументы
type_rec_name — имя типа записи, var_rec — переменная этого типа, field_1 и field_2 — поля. Можно объявить и другие поля через запятую. Квадратные скобки обозначают необязательные части синтаксиса. Для поля NOT NULL нужно начальное значение; вместо := допускается DEFAULT.
| Тип или форма объявления поля | Применение |
|---|---|
| NUMBER, VARCHAR2, DATE, BOOLEAN | Скалярные значения; для VARCHAR2 указывают размер. |
| table_name.column_name%TYPE | Тип и размер столбца таблицы или представления. |
| variable_name%TYPE | Тип ранее объявленной переменной. |
| table_name%ROWTYPE, cursor_name%ROWTYPE | Запись по структуре строки таблицы или результата курсора. |
| record_type_name | Ранее определённый тип вложенной записи. |
| collection_type_name | Ранее определённый тип коллекции. |
| object_type_name, ref_cursor_type_name | Соответствующий доступный тип объекта или курсорной переменной. |
📝 Примечание
- Для создания Record вы определяете тип записи, а затем объявляете переменную этого типа.
- Для объявления записи по структуре таблицы, представления или курсора используйте %ROWTYPE. Для типа отдельного столбца применяют %TYPE.
- Вы можете определять типы Record в декларативной части любого блока PL/SQL, подпрограммы или пакета. Когда вы определяете свой собственный тип Record, вы можете указать ограничение NOT NULL для полей или присвоить им значения по умолчанию.
- Тип Record, определенный в спецификации пакета, несовместим с идентично определенным локальным типом Record.
💻 Примеры
Ниже сохранены основные способы работы с записью: объявление, NOT NULL, %ROWTYPE, %TYPE, возврат из функции, параметры процедуры, присваивание, вложенные записи и коллекции, INSERT, UPDATE, RETURNING и BULK COLLECT. Самостоятельные блоки не требуют HR или SCOTT. Для блоков с запросами один раз создайте собственную учебную таблицу в отдельной учебной схеме. DDL выполняется до данных и SAVEPOINT; изменения отдельных опытов откатываются к своей точке сохранения.
CREATE TABLE demo_record_studios (
studio_id NUMBER PRIMARY KEY,
studio_name VARCHAR2(30 CHAR) NOT NULL,
city VARCHAR2(30 CHAR),
fee NUMBER(7,2)
);
INSERT INTO demo_record_studios VALUES (21, 'Clay Lab', 'Tashkent', 140);
INSERT INTO demo_record_studios VALUES (22, 'Paper House', 'Samarkand', 90);
INSERT INTO demo_record_studios VALUES (23, 'Wood Lab', 'Bukhara', 140);
INSERT INTO demo_record_studios VALUES (24, 'Glass Studio', 'Khiva', NULL);
💻 Record и объявление переменной
Начальные значения задаются в объявлении полей. Каждая новая переменная получает эти значения.
DECLARE
TYPE studio_rec IS RECORD (
studio_id NUMBER NOT NULL := 31,
studio_name VARCHAR2(30) NOT NULL := 'Textile Lab',
city VARCHAR2(30) := 'Namangan',
fee NUMBER := 110
);
v_studio studio_rec;
BEGIN
DBMS_OUTPUT.PUT_LINE(v_studio.studio_id || ': ' || v_studio.studio_name);
DBMS_OUTPUT.PUT_LINE(v_studio.city || ': ' || v_studio.fee);
END;
/
-- 31: Textile Lab
-- Namangan: 110
💻 Поля NOT NULL
Для поля NOT NULL обязательно начальное значение. Присвоение ему NULL недопустимо.
DECLARE
TYPE request_rec IS RECORD (
request_id PLS_INTEGER NOT NULL := 0,
status VARCHAR2(20) NOT NULL := 'Draft'
);
v_request request_rec;
BEGIN
DBMS_OUTPUT.PUT_LINE(v_request.request_id || ' / ' || v_request.status);
END;
/
-- 0 / Draft
💻 Запись с помощью %ROWTYPE
Первая переменная соответствует всей строке, вторая — двум столбцам результата курсора. Объявление переменной само по себе не читает таблицу.
DECLARE
v_full demo_record_studios%ROWTYPE;
CURSOR c_short IS
SELECT studio_id, studio_name FROM demo_record_studios;
v_short c_short%ROWTYPE;
BEGIN
SELECT * INTO v_full FROM demo_record_studios WHERE studio_id = 21;
SELECT studio_id, studio_name INTO v_short
FROM demo_record_studios WHERE studio_id = 22;
DBMS_OUTPUT.PUT_LINE(v_full.city || ' / ' || v_short.studio_name);
END;
/
-- Tashkent / Paper House
💻 Поля с помощью %TYPE
Типы полей можно связать со столбцами и дополнить собственным полем. %TYPE столбца не переносит его NOT NULL и DEFAULT.
DECLARE
TYPE rated_studio_rec IS RECORD (
studio_id demo_record_studios.studio_id%TYPE,
studio_name demo_record_studios.studio_name%TYPE,
rating NUMBER
);
v_studio rated_studio_rec;
BEGIN
SELECT studio_id, studio_name, 5 INTO v_studio
FROM demo_record_studios WHERE studio_id = 23;
DBMS_OUTPUT.PUT_LINE(v_studio.studio_name || ': ' || v_studio.rating);
END;
/
-- Wood Lab: 5
💻 Record как результат функции
Функция возвращает n-ю студию в порядке стоимости по убыванию. При равной стоимости меньший ID идёт раньше; NULL помещается в конец. Это позиция строки, а не номер уникальной стоимости.
DECLARE
TYPE priced_studio_rec IS RECORD (
studio_id demo_record_studios.studio_id%TYPE,
studio_name demo_record_studios.studio_name%TYPE,
fee demo_record_studios.fee%TYPE
);
v_studio priced_studio_rec;
FUNCTION nth_studio(p_position PLS_INTEGER) RETURN priced_studio_rec IS
v_result priced_studio_rec;
BEGIN
SELECT studio_id, studio_name, fee INTO v_result
FROM (
SELECT studio_id, studio_name, fee,
ROW_NUMBER() OVER (ORDER BY fee DESC NULLS LAST, studio_id) AS rn
FROM demo_record_studios
)
WHERE rn = p_position;
RETURN v_result;
END;
BEGIN
v_studio := nth_studio(2);
DBMS_OUTPUT.PUT_LINE(v_studio.studio_name || ': ' || v_studio.fee);
EXCEPTION
WHEN NO_DATA_FOUND THEN
DBMS_OUTPUT.PUT_LINE('Position not found');
END;
/
-- Wood Lab: 140
💻 Record как параметр процедуры
Параметр IN OUT передаёт изменение полей вызывающему блоку. Этот пример меняет только запись в памяти.
DECLARE
TYPE offer_rec IS RECORD (label VARCHAR2(30), fee NUMBER);
v_offer offer_rec;
PROCEDURE add_materials(p_offer IN OUT offer_rec) IS
BEGIN
p_offer.fee := p_offer.fee + 25;
END;
BEGIN
v_offer.label := 'Mosaic Intro';
v_offer.fee := 85;
add_materials(v_offer);
DBMS_OUTPUT.PUT_LINE(v_offer.label || ': ' || v_offer.fee);
END;
/
-- Mosaic Intro: 110
💻 Присваивание записей
Чтобы вернуть поля к объявленным начальным значениям, присвойте неизменённую переменную того же типа. Поля без DEFAULT будут NULL; поля с DEFAULT получат исходные значения.
DECLARE
TYPE draft_rec IS RECORD (quantity NUMBER, status VARCHAR2(20) DEFAULT 'Draft');
v_current draft_rec;
v_initial draft_rec;
BEGIN
v_current.quantity := 12;
v_current.status := 'Ready';
v_current := v_initial;
DBMS_OUTPUT.PUT_LINE(NVL(TO_CHAR(v_current.quantity), 'NULL') || ' / ' || v_current.status);
END;
/
-- NULL / Draft
Две переменные одного пользовательского RECORD-типа совместимы. Два отдельно объявленных типа остаются разными, даже если их поля совпадают:
DECLARE
TYPE label_rec_a IS RECORD (id NUMBER, label VARCHAR2(30));
TYPE label_rec_b IS RECORD (id NUMBER, label VARCHAR2(30));
v_a label_rec_a;
v_b label_rec_b;
v_copy label_rec_b;
BEGIN
v_b.id := 42;
v_b.label := 'Canvas';
v_copy := v_b;
-- v_a := v_b; -- ошибка: разные пользовательские типы.
DBMS_OUTPUT.PUT_LINE(v_copy.id || ': ' || v_copy.label);
END;
/
-- 42: Canvas
Это правило относится к двум пользовательским RECORD-типам. Для присваивания записи %ROWTYPE пользовательской записи Oracle также допускает соответствующие по порядку, числу и типам поля. Совпадения названий недостаточно. Присваивание самой записи значения NULL обнуляет её поля, а не восстанавливает DEFAULT; поля NOT NULL при этом нарушают ограничение.
💻 Record с вложенной записью
DECLARE
TYPE session_rec IS RECORD (title VARCHAR2(30), start_date DATE);
TYPE booking_rec IS RECORD (session_info session_rec, seats PLS_INTEGER);
v_booking booking_rec;
BEGIN
v_booking.session_info.title := 'Clay Weekend';
v_booking.session_info.start_date := DATE '2026-11-21';
v_booking.seats := 6;
DBMS_OUTPUT.PUT_LINE(v_booking.session_info.title || ' / ' ||
TO_CHAR(v_booking.session_info.start_date, 'YYYY-MM-DD') || ' / ' || v_booking.seats);
END;
/
-- Clay Weekend / 2026-11-21 / 6
Каждая точка выбирает поле следующего уровня вложенности.
💻 Record с полем VARRAY
Поле может содержать VARRAY; перед чтением его элементов коллекцию нужно инициализировать.
DECLARE
TYPE material_list IS VARRAY(2) OF VARCHAR2(20);
TYPE kit_rec IS RECORD (
materials material_list := material_list('Clay', 'Glaze'),
quantity PLS_INTEGER := 8
);
v_kit kit_rec;
BEGIN
DBMS_OUTPUT.PUT_LINE(v_kit.materials(1) || ' + ' ||
v_kit.materials(2) || ': ' || v_kit.quantity);
END;
/
-- Clay + Glaze: 8
💻 INSERT целой записи
В статическом PL/SQL INSERT может принять запись вместо списка значений. Поля должны соответствовать целевым столбцам по порядку и иметь совместимые типы. VALUES содержит имя записи без окружающих скобок.
DECLARE
v_studio demo_record_studios%ROWTYPE;
BEGIN
SAVEPOINT before_record_insert;
v_studio.studio_id := 25;
v_studio.studio_name := 'Textile Lab';
v_studio.city := 'Namangan';
v_studio.fee := 110;
INSERT INTO demo_record_studios VALUES v_studio;
DBMS_OUTPUT.PUT_LINE('Inserted: ' || SQL%ROWCOUNT);
ROLLBACK TO before_record_insert;
END;
/
-- Inserted: 1
💻 UPDATE через SET ROW
UPDATE с SET ROW заменяет всю строку значениями записи. Поэтому сначала читаем строку, затем меняем нужное поле: иначе неинициализированные поля перезапишут столбцы значением NULL. В рабочем коде при конкурирующих изменениях нужен подходящий контроль блокировок или версий.
DECLARE
v_studio demo_record_studios%ROWTYPE;
BEGIN
SAVEPOINT before_record_update;
SELECT * INTO v_studio
FROM demo_record_studios WHERE studio_id = 22 FOR UPDATE;
v_studio.city := 'Tashkent';
UPDATE demo_record_studios SET ROW = v_studio WHERE studio_id = 22;
DBMS_OUTPUT.PUT_LINE('Updated: ' || SQL%ROWCOUNT || ' / ' || v_studio.city);
ROLLBACK TO before_record_update;
END;
/
-- Updated: 1 / Tashkent
💻 RETURNING INTO Record
RETURNING возвращает значения затронутой строки без повторного SELECT. Здесь условие по первичному ключу выбирает ровно одну имеющуюся строку. Для набора строк используют RETURNING BULK COLLECT INTO с коллекциями.
DECLARE
TYPE changed_fee_rec IS RECORD (
studio_name demo_record_studios.studio_name%TYPE,
fee demo_record_studios.fee%TYPE
);
v_changed changed_fee_rec;
BEGIN
SAVEPOINT before_record_returning;
UPDATE demo_record_studios SET fee = fee + 20 WHERE studio_id = 21
RETURNING studio_name, fee INTO v_changed;
DBMS_OUTPUT.PUT_LINE(v_changed.studio_name || ': ' || v_changed.fee);
ROLLBACK TO before_record_returning;
END;
/
-- Clay Lab: 160
После отката стоимость в таблице снова 140. Если DML не затронул строку, значения целевых переменных RETURNING не определены; проверяйте SQL%ROWCOUNT перед их использованием.
📌 Ограничения на INSERT / UPDATE записей
Для использования целой записи в статических INSERT/UPDATE Oracle Database 19c действуют следующие ограничения:
Переменные Record допускаются только в следующих местах:
- В правой части предложения SET в инструкции UPDATE
- В предложении VALUES инструкции INSERT
- В подпункте INTO условия RETURNING
Целую переменную RECORD нельзя использовать как обычное SQL-выражение в списке SELECT, WHERE, GROUP BY или ORDER BY. Её отдельные скалярные поля можно использовать как PL/SQL-переменные.
Ключевое слово ROW разрешено только с левой стороны предложения SET. Кроме того, вы не можете использовать ROW с подзапросом.
В UPDATE разрешено только одно предложение SET, если используется ROW.
Если в VALUES оператора INSERT содержит переменную Record, то в этом предложении не допускается никакая другая переменная или значение.
Если INTO в предложении RETURNING содержит переменную Record, то не допускается никакая другая переменная или значение.
В описанной форме INSERT/UPDATE целой записи не поддерживаются:
- Типы вложенных записей
- Функции, возвращающие запись
- INSERT/UPDATE целой записи через EXECUTE IMMEDIATE.
💻 Запрос данных в коллекцию Record
BULK COLLECT получает набор строк в коллекцию записей. Первый запрос читает полные строки с известной стоимостью ниже 150; второй — ID и названия первых двух студий в определённом порядке.
DECLARE
TYPE studio_list IS TABLE OF demo_record_studios%ROWTYPE;
v_affordable studio_list;
CURSOR c_names IS SELECT studio_id, studio_name FROM demo_record_studios;
TYPE name_list IS TABLE OF c_names%ROWTYPE;
v_names name_list;
BEGIN
SELECT * BULK COLLECT INTO v_affordable
FROM demo_record_studios
WHERE fee < 150
ORDER BY fee DESC, studio_id;
DBMS_OUTPUT.PUT_LINE('Studios: ' || v_affordable.COUNT);
FOR i IN 1 .. v_affordable.COUNT LOOP
DBMS_OUTPUT.PUT_LINE(v_affordable(i).studio_name || ': ' || v_affordable(i).fee);
END LOOP;
SELECT studio_id, studio_name BULK COLLECT INTO v_names
FROM demo_record_studios
ORDER BY studio_id
FETCH FIRST 2 ROWS ONLY;
FOR i IN 1 .. v_names.COUNT LOOP
DBMS_OUTPUT.PUT_LINE(v_names(i).studio_id || ': ' || v_names(i).studio_name);
END LOOP;
END;
/
-- Studios: 3
-- Clay Lab: 140
-- Wood Lab: 140
-- Paper House: 90
-- 21: Clay Lab
-- 22: Paper House
После BULK COLLECT коллекция плотная с индексами от 1. При отсутствии строк COUNT равен 0 и цикл 1 .. COUNT пропускается; NO_DATA_FOUND не возникает. После удаления отдельных элементов используйте FIRST/LAST и PRIOR/NEXT. Для больших результатов применяют порционное FETCH BULK COLLECT с LIMIT, чтобы ограничить память.
Включите DBMS Output в клиенте; в SQL*Plus/SQLcl используется SET SERVEROUTPUT ON. Ожидаемый вывод рассчитан по данным примеров.
Документация Oracle 19c: record-variable-declaration, assigning-values-record-variables, inserting-records-tables, updating-rows-records, restrictions-record-inserts-and-updates, bulk-sql-and-bulk-binding.