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.