%ROWTYPE

📖 Описание

В Oracle PL/SQL атрибут %ROWTYPE предоставляет тип записи, представляющий строку в таблице (или представлении) базы данных Oracle. Запись может хранить целую строку данных, выбранных из таблицы, или извлекаться из курсора или строго типизированной переменной курсора.


🧩 Синтаксис

Синтаксис объявления переменной с атрибутом %ROWTYPE в Oracle PL/SQL:

v_rec table_name%ROWTYPE;
cursor_rec cursor_name%ROWTYPE;

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

v_rec и cursor_rec — переменные записи.
table_name — таблица или представление.
cursor_name — ранее объявленный курсор; его список SELECT определяет поля записи.

📝 Примечание

  • Видимые столбцы строки и соответствующие поля в записи имеют одинаковые имена и типы данных.
  • Поля %ROWTYPE не наследуют ограничения столбцов, включая NOT NULL, и их значения по умолчанию.

💻 Пример

Используем собственные таблицы студий и преподавателей. Создайте их один раз в учебной схеме. DDL фиксирует текущую транзакцию:

CREATE TABLE demo_row_studios (
  studio_id NUMBER PRIMARY KEY,
  studio_name VARCHAR2(40) NOT NULL,
  tutor_id NUMBER,
  city VARCHAR2(40)
);
CREATE TABLE demo_row_tutors (
  tutor_id NUMBER PRIMARY KEY,
  tutor_name VARCHAR2(40) NOT NULL,
  hourly_fee NUMBER(8,2)
);
INSERT INTO demo_row_studios VALUES (11, 'Clay Lab', 71, 'Tashkent');
INSERT INTO demo_row_studios VALUES (12, 'Paper House', 72, 'Samarkand');
INSERT INTO demo_row_studios VALUES (13, 'Wood Lab', NULL, 'Bukhara');
INSERT INTO demo_row_tutors VALUES (71, 'Aziza', 120);
INSERT INTO demo_row_tutors VALUES (72, 'Nodira', 90);

Одна запись имеет структуру всей таблицы, другая — двух столбцов курсора, третья — результата соединения:

DECLARE
  v_tutor demo_row_tutors%ROWTYPE;
  CURSOR c_studios IS
    SELECT studio_id, studio_name FROM demo_row_studios;
  v_studio c_studios%ROWTYPE;
  CURSOR c_assignments IS
    SELECT t.tutor_id, t.tutor_name, s.studio_name
    FROM demo_row_tutors t
    JOIN demo_row_studios s ON s.tutor_id = t.tutor_id;
  v_assignment c_assignments%ROWTYPE;
BEGIN
  SELECT * INTO v_tutor FROM demo_row_tutors WHERE tutor_id = 71;
  IF v_tutor.tutor_name = 'Aziza' AND v_tutor.hourly_fee = 120 THEN
    v_tutor.hourly_fee := v_tutor.hourly_fee * 1.15;
  END IF;
  DBMS_OUTPUT.PUT_LINE(v_tutor.tutor_name || ': ' || v_tutor.hourly_fee);

  SELECT studio_id, studio_name INTO v_studio
  FROM demo_row_studios WHERE studio_id = 11;
  DBMS_OUTPUT.PUT_LINE(v_studio.studio_id || ': ' || v_studio.studio_name);

  SELECT t.tutor_id, t.tutor_name, s.studio_name INTO v_assignment
  FROM demo_row_tutors t
  JOIN demo_row_studios s ON s.tutor_id = t.tutor_id
  WHERE s.studio_id = 11;
  DBMS_OUTPUT.PUT_LINE(v_assignment.tutor_name || ' / ' || v_assignment.studio_name);
END;
/
-- Aziza: 138
-- 11: Clay Lab
-- Aziza / Clay Lab

Изменение v_tutor.hourly_fee относится только к памяти. В таблице остаётся 120. Курсоры c_studios и c_assignments здесь задают форму записей; данные загружаются отдельными SELECT INTO по уникальному ключу. При отсутствии строки возникнет NO_DATA_FOUND, при нескольких строках — TOO_MANY_ROWS.

💻 Присваивание целой записи

DECLARE
  v_original demo_row_studios%ROWTYPE;
  v_copy demo_row_studios%ROWTYPE;
  CURSOR c_short IS SELECT studio_id, city FROM demo_row_studios;
  v_short c_short%ROWTYPE;
BEGIN
  SELECT * INTO v_original FROM demo_row_studios WHERE studio_id = 12;
  v_copy := v_original;
  v_copy.city := 'Tashkent';
  DBMS_OUTPUT.PUT_LINE(v_original.city || ' / ' || v_copy.city);
  -- v_copy := v_short; -- недопустимо: у v_short только два поля, у v_copy четыре.
END;
/
-- Samarkand / Tashkent

Записи v_original и v_copy основаны на одной таблице. Присваивание копирует все поля; дальнейшая замена поля копии не меняет исходную запись. Объявление структуры с другим числом полей не совместимо с этим присваиванием.

💻 Загрузка всей строки через SELECT INTO

DECLARE
  v_studio demo_row_studios%ROWTYPE;
BEGIN
  SELECT * INTO v_studio FROM demo_row_studios WHERE studio_id = 13;
  DBMS_OUTPUT.PUT_LINE(v_studio.studio_name || ' / ' || v_studio.city);
END;
/
-- Wood Lab / Bukhara

ROWNUM здесь не требуется: studio_id — первичный ключ. %ROWTYPE не читает данные автоматически и не наследует NOT NULL или DEFAULT столбцов. При изменении видимых столбцов меняется структура записи; зависимый код может потребовать перекомпиляции.

Для пользовательского набора полей см. RECORD, для одного столбца — %TYPE. В Oracle 19c %ROWTYPE не поддерживает привязку к символьным столбцам с collation, отличным от USING_NLS_COMP.

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

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

Для вывода строк включите DBMS Output в клиенте; SQL*Plus/SQLcl поддерживают SET SERVEROUTPUT ON.