%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.