Пакеты
📖 Описание
В Oracle PL/SQL набор элементов: процедур, функций, определения типов; объявления переменных, констант можно объединить в пакет. После написания пакет PL/SQL компилируется, а затем сохраняется в базе данных Oracle, где его содержимое может использоваться многими приложениями.
- Что такое пакет Oracle PL/SQL?
- Синтаксис
- Пример пакета PL/SQL
- Преимущества пакетов Oracle PL/SQL
- Понимание спецификации пакета.
- Понимание тела пакета.
- Некоторые примеры функций пакета.
- Частные и публичные предметы в пакетах.
- Перегрузка подпрограмм пакета.
- Как пакет STANDARD определяет среду Oracle PL/SQL
- Руководство по написанию пакетов
📌 Что такое пакет Oracle PL/SQL?
Пакет Oracle PL/SQL - это объект схемы, который группирует логически связанные типы, элементы и подпрограммы. Пакеты обычно состоят из двух частей: спецификации и тела, хотя иногда тело не нужно. Спецификация - это интерфейс для ваших приложений.
В спецификации пакета объявляются типы, переменные, константы, исключения, курсоры и подпрограммы, доступные для использования.
Тело пакета полностью определяет курсоры и подпрограммы и реализует спецификацию.
Можно думать о спецификации как о рабочем интерфейсе, а о теле - как о «черном ящике». Вы можете отлаживать, улучшать или изменять тело пакета без изменения интерфейса (спецификации) пакета.
Для создания пакетов используйте оператор CREATE PACKAGE.
🧩 Синтаксис
Синтаксис CREATE PACKAGE в Oracle PL/SQL:
CREATE [OR REPLACE] PACKAGE package_name
[AUTHID {CURRENT_USER | DEFINER}]
{IS | AS}
[PRAGMA SERIALLY_REUSABLE;]
[collection_type_definition ...]
[record_type_definition ...]
[subtype_definition ...]
[collection_declaration ...]
[constant_declaration ...]
[exception_declaration ...]
[object_declaration ...]
[record_declaration ...]
[variable_declaration ...]
[cursor_spec ...]
[function_spec ...]
[procedure_spec ...]
[call_spec ...]
[PRAGMA RESTRICT_REFERENCES(assertions) ...]
END [package_name];
[CREATE [OR REPLACE] PACKAGE BODY package_name {IS | AS}
[PRAGMA SERIALLY_REUSABLE;]
[collection_type_definition ...]
[record_type_definition ...]
[subtype_definition ...]
[collection_declaration ...]
[constant_declaration ...]
[exception_declaration ...]
[object_declaration ...]
[record_declaration ...]
[variable_declaration ...]
[cursor_body ...]
[function_spec ...]
[procedure_spec ...]
[call_spec ...]
[BEGIN
sequence_of_statements]
END [package_name];]
collection_type_definition - определение типа коллекции
record_type_definition - определение типа записи
subtype_definition - определение подтипа
collection_declaration - объявление коллекции
constant_declaration - объявление константы
exception_declaration - объявление исключения
object_declaration - объявление объекта
record_declaration - объявление записи
variable_declaration - объявление переменной
cursor_spec - спецификация курсора
function_spec - спецификация функции
procedure_spec - спецификация процедуры
call_spec - спецификация вызова
Спецификация пакета содержит публичные объявления, которые видны вашему приложению. Размещайте объявления так, чтобы используемые типы и идентификаторы были объявлены до обращения к ним.
Тело пакета содержит детали реализации и приватные объявления, которые скрыты от вашего приложения. За декларативной частью тела пакета следует необязательная часть инициализации, которая обычно содержит операторы, которые инициализируют переменные пакета.
Приведённая развёрнутая схема — шаблон, а не готовый скрипт: многоточия и скобки не вводят буквально. Для основных примеров ниже не нужны SERIALLY_REUSABLE и устаревшая RESTRICT_REFERENCES. AUTHID DEFINER используется по умолчанию; AUTHID CURRENT_USER задаёт контекст прав вызывающего, но не предоставляет ему дополнительных привилегий.
💻 Подготовка и простой пакет
Пример сохраняет идею набора операций добавления и удаления сотрудника, но использует собственный каталог наставников. В учебной схеме нужны CREATE TABLE, CREATE SEQUENCE, CREATE PROCEDURE и квота.
CREATE TABLE demo_pkg_mentors (
mentor_id NUMBER PRIMARY KEY,
mentor_name VARCHAR2(40 CHAR) NOT NULL,
joined_on DATE NOT NULL,
monthly_fee NUMBER(8,2) NOT NULL CHECK (monthly_fee > 0)
);
CREATE SEQUENCE demo_pkg_mentor_seq START WITH 601;
CREATE TABLE demo_pkg_grades (
grade_id NUMBER PRIMARY KEY,
minimum_fee NUMBER NOT NULL,
maximum_fee NUMBER NOT NULL
);
CREATE TABLE demo_pkg_audit (
started_at TIMESTAMP,
actor VARCHAR2(128 CHAR),
package_name VARCHAR2(128 CHAR)
);
INSERT ALL
INTO demo_pkg_mentors VALUES (41, 'Aziza', DATE '2026-02-03', 6200)
INTO demo_pkg_mentors VALUES (42, 'Temur', DATE '2026-03-10', 7400)
INTO demo_pkg_mentors VALUES (43, 'Zarina', DATE '2026-04-14', 7400)
SELECT 1 FROM dual;
INSERT INTO demo_pkg_grades VALUES (7, 3000, 10000);
COMMIT;
CREATE OR REPLACE PACKAGE demo_mentor_basic AS
TYPE mentor_rec IS RECORD (mentor_id NUMBER, monthly_fee NUMBER);
CURSOR fees_desc RETURN mentor_rec;
PROCEDURE add_mentor(p_name VARCHAR2, p_joined DATE, p_fee NUMBER);
PROCEDURE remove_mentor(p_id NUMBER);
END demo_mentor_basic;
/
CREATE OR REPLACE PACKAGE BODY demo_mentor_basic AS
CURSOR fees_desc RETURN mentor_rec IS
SELECT mentor_id, monthly_fee FROM demo_pkg_mentors
ORDER BY monthly_fee DESC, mentor_id;
PROCEDURE add_mentor(p_name VARCHAR2, p_joined DATE, p_fee NUMBER) IS
BEGIN
INSERT INTO demo_pkg_mentors (mentor_id, mentor_name, joined_on, monthly_fee)
VALUES (demo_pkg_mentor_seq.NEXTVAL, p_name, p_joined, p_fee);
END;
PROCEDURE remove_mentor(p_id NUMBER) IS
BEGIN
DELETE FROM demo_pkg_mentors WHERE mentor_id = p_id;
END;
END demo_mentor_basic;
/
Тип записи, курсор и две процедуры объявлены в спецификации. Реализация находится в теле. Вызов через точку:
SAVEPOINT before_basic_package;
BEGIN
demo_mentor_basic.add_mentor('Malika', DATE '2026-12-05', 8300);
END;
/
SELECT mentor_name, monthly_fee FROM demo_pkg_mentors WHERE mentor_name = 'Malika';
-- Malika | 8300
ROLLBACK TO before_basic_package;
После отката добавленная строка исчезает. Номер последовательности уже использован и не возвращается; повторный опыт может получить другой идентификатор.
💻 Расширенный пакет: функции, проверка и состояние
Следующий пакет имеет другое имя. Он добавляет приватную проверку диапазона, публичное исключение, счётчик добавлений и получение n-й строки по убыванию ставки. Тип studio_rec иллюстрирует дополнительный публичный тип записи.
CREATE OR REPLACE PACKAGE demo_mentor_admin AS
TYPE mentor_rec IS RECORD (mentor_id NUMBER, monthly_fee NUMBER);
TYPE studio_rec IS RECORD (studio_id NUMBER, city VARCHAR2(40 CHAR));
CURSOR fees_desc RETURN mentor_rec;
invalid_fee EXCEPTION;
FUNCTION add_mentor(p_name VARCHAR2, p_joined DATE, p_fee NUMBER) RETURN NUMBER;
PROCEDURE remove_mentor(p_id NUMBER);
PROCEDURE increase_fee(p_id NUMBER, p_grade NUMBER, p_amount NUMBER);
FUNCTION nth_fee(p_position NUMBER) RETURN mentor_rec;
FUNCTION added_count RETURN PLS_INTEGER;
END demo_mentor_admin;
/
CREATE OR REPLACE PACKAGE BODY demo_mentor_admin AS
g_number_added PLS_INTEGER;
CURSOR fees_desc RETURN mentor_rec IS
SELECT mentor_id, monthly_fee FROM demo_pkg_mentors
ORDER BY monthly_fee DESC, mentor_id;
FUNCTION fee_allowed(p_grade NUMBER, p_fee NUMBER) RETURN BOOLEAN IS
l_min NUMBER;
l_max NUMBER;
BEGIN
SELECT minimum_fee, maximum_fee INTO l_min, l_max
FROM demo_pkg_grades WHERE grade_id = p_grade;
RETURN p_fee BETWEEN l_min AND l_max;
END;
FUNCTION add_mentor(p_name VARCHAR2, p_joined DATE, p_fee NUMBER) RETURN NUMBER IS
l_id NUMBER;
BEGIN
l_id := demo_pkg_mentor_seq.NEXTVAL;
INSERT INTO demo_pkg_mentors (mentor_id, mentor_name, joined_on, monthly_fee)
VALUES (l_id, p_name, p_joined, p_fee);
g_number_added := g_number_added + 1;
RETURN l_id;
END;
PROCEDURE remove_mentor(p_id NUMBER) IS
BEGIN
DELETE FROM demo_pkg_mentors WHERE mentor_id = p_id;
END;
PROCEDURE increase_fee(p_id NUMBER, p_grade NUMBER, p_amount NUMBER) IS
l_fee NUMBER;
BEGIN
IF p_amount IS NULL OR p_amount < 0 THEN RAISE invalid_fee; END IF;
SELECT monthly_fee INTO l_fee FROM demo_pkg_mentors
WHERE mentor_id = p_id FOR UPDATE;
IF fee_allowed(p_grade, l_fee + p_amount) THEN
UPDATE demo_pkg_mentors SET monthly_fee = l_fee + p_amount WHERE mentor_id = p_id;
ELSE
RAISE invalid_fee;
END IF;
END;
FUNCTION nth_fee(p_position NUMBER) RETURN mentor_rec IS
l_result mentor_rec;
CURSOR c_rank IS
SELECT mentor_id, monthly_fee FROM demo_pkg_mentors
ORDER BY monthly_fee DESC, mentor_id;
BEGIN
IF p_position IS NULL OR p_position < 1 OR p_position != TRUNC(p_position) THEN
RAISE_APPLICATION_ERROR(-20092, 'Position must be a positive integer');
END IF;
OPEN c_rank;
FOR i IN 1 .. p_position LOOP
FETCH c_rank INTO l_result;
IF c_rank%NOTFOUND THEN
CLOSE c_rank;
RAISE NO_DATA_FOUND;
END IF;
END LOOP;
CLOSE c_rank;
RETURN l_result;
END;
FUNCTION added_count RETURN PLS_INTEGER IS
BEGIN
RETURN g_number_added;
END;
BEGIN
g_number_added := 0;
INSERT INTO demo_pkg_audit (started_at, actor, package_name)
VALUES (SYSTIMESTAMP, SYS_CONTEXT('USERENV', 'SESSION_USER'), 'DEMO_MENTOR_ADMIN');
END demo_mentor_admin;
/
Для nth_fee используются стабильный порядок и локальный курсор: функция не открывает общий публичный fees_desc, который мог открыть вызывающий код. При n вне выборки возникает NO_DATA_FOUND; при NULL, нуле, отрицательном или дробном n — ошибка -20092. Это номер строки, а не номер различной ставки.
SAVEPOINT before_admin_package;
DECLARE
l_mentor demo_mentor_admin.mentor_rec;
l_new_id NUMBER;
BEGIN
l_mentor := demo_mentor_admin.nth_fee(2);
DBMS_OUTPUT.PUT_LINE(l_mentor.mentor_id || ' / ' || l_mentor.monthly_fee);
demo_mentor_admin.increase_fee(41, 7, 350);
BEGIN
demo_mentor_admin.increase_fee(41, 7, 20000);
EXCEPTION
WHEN demo_mentor_admin.invalid_fee THEN
DBMS_OUTPUT.PUT_LINE('Fee increase rejected');
END;
l_new_id := demo_mentor_admin.add_mentor('Malika', DATE '2026-12-12', 8300);
demo_mentor_admin.remove_mentor(l_new_id);
DBMS_OUTPUT.PUT_LINE('added=' || demo_mentor_admin.added_count);
END;
/
SELECT monthly_fee FROM demo_pkg_mentors WHERE mentor_id = 41;
-- 6550
ROLLBACK TO before_admin_package;
SELECT monthly_fee FROM demo_pkg_mentors WHERE mentor_id = 41;
-- 6200
BEGIN
DBMS_OUTPUT.PUT_LINE('added after rollback=' || demo_mentor_admin.added_count);
END;
/
При первом запуске в свежем сеансе вывод: 43 / 7400, Fee increase rejected, added=1; после отката added after rollback=1. Счётчик отражает успешные вызовы добавления в сеансе, а не число строк после отката. Инициализация вставляет строку аудита при создании экземпляра пакета; если она попала после SAVEPOINT, откат удалит запись, но сам по себе не запустит инициализацию повторно. Значения времени и пользователя аудита зависят от среды.
📌 Преимущества пакетов Oracle PL/SQL
📌 Модульность
Пакеты позволяют инкапсулировать логически связанные типы, элементы и подпрограммы в именованный модуль PL/SQL. Каждый пакет прост для понимания, а интерфейсы между пакетами просты, понятны и хорошо определены. Это помогает разработке приложений.
📌 Более простой дизайн приложений
При разработке приложения все, что вам первоначально нужно, это информация об интерфейсе в спецификации пакета. Вы можете кодировать и компилировать спецификацию без ее тела. Затем сохраненные подпрограммы, которые ссылаются на пакет, также могут быть скомпилированы.
📌 Сокрытие информации
С помощью пакетов вы можете указать, какие типы, элементы и подпрограммы являются общедоступными (видимыми и доступными) или приватными (скрытыми и недоступными). Например, если пакет содержит четыре подпрограммы, три могут быть открытыми и одна закрытая. Пакет скрывает реализацию закрытой подпрограммы, поэтому при изменении реализации затрагивается только пакет (не ваше приложение). Это упрощает обслуживание и улучшение. Кроме того, скрывая детали реализации от пользователей, вы защищаете целостность пакета.
📌 Добавленная функциональность
Обычный пакет может хранить переменные и состояние курсоров в течение сеанса. У SERIALLY_REUSABLE и при перекомпиляции действуют отдельные правила. Таким образом, они могут быть общими для всех подпрограмм, которые выполняются в среде. Кроме того, они позволяют поддерживать данные между транзакциями, не сохраняя их в базе данных.
📌 Лучшая производительность
Разделение интерфейса и реализации позволяет менять тело, сохраняя спецификацию и вызовы публичных элементов. Это уменьшает ненужные зависимости от деталей реализации. Само объединение в пакет не гарантирует ускорения конкретного запроса: измеряйте рабочую нагрузку.
📌 Понимание спецификации
Спецификация — публичный интерфейс. По заголовку видно, какие аргументы нужны и какой тип возвращается; алгоритм скрыт в теле. Например, объявление внутри спецификации:
FUNCTION total_fee(p_seats NUMBER) RETURN NUMBER;
Если спецификация содержит только типы, константы, переменные и исключения, тело не требуется. Пример с вложенной записью:
CREATE OR REPLACE PACKAGE demo_booking_data AS
TYPE slot_rec IS RECORD (starts_at DATE, duration_minutes PLS_INTEGER);
TYPE booking_rec IS RECORD (
workshop_name VARCHAR2(60 CHAR),
registration_id NUMBER,
seats PLS_INTEGER,
slot slot_rec
);
seat_fee CONSTANT NUMBER := 45;
number_processed PLS_INTEGER := 0;
invalid_booking EXCEPTION;
END demo_booking_data;
/
Тип используется как demo_booking_data.booking_rec, константа — demo_booking_data.seat_fee. Для доступа из другой схемы обычно указывают и владельца, и имеют необходимое право EXECUTE. Публичность объявления сама по себе не выдаёт это право всем пользователям.
📌 Ограничения удалённых ссылок
Удалённые переменные пакета нельзя читать прямо или косвенно. Например, значение по умолчанию ниже ссылается на состояние пакета:
CREATE OR REPLACE PACKAGE demo_random_state AS
seed NUMBER := 17;
PROCEDURE initialize(p_start NUMBER := seed);
END demo_random_state;
/
CREATE OR REPLACE PACKAGE BODY demo_random_state AS
PROCEDURE initialize(p_start NUMBER := seed) IS
BEGIN
seed := p_start;
END;
END demo_random_state;
/
Это локальный пример; он не настраивает связь баз. При проектировании RPC не переносите ссылку на seed через удалённый вызов: передавайте необходимое значение явным аргументом. Пакет также не должен зависеть от переменных хоста SQL-клиента.
📌 Тело пакета и соответствие заголовков
Тело реализует объявления спецификации и может содержать приватные элементы. Использование DATE в теле вместо указанного в спецификации %TYPE не считается одинаковым объявлением, даже если базовый тип совпадает. Следующий отдельный диагностический пример намеренно создаёт ошибку тела:
CREATE OR REPLACE PACKAGE demo_pkg_date_match AS
PROCEDURE show_day(p_day demo_pkg_mentors.joined_on%TYPE);
END demo_pkg_date_match;
/
CREATE OR REPLACE PACKAGE BODY demo_pkg_date_match AS
PROCEDURE show_day(p_day DATE) IS
BEGIN
DBMS_OUTPUT.PUT_LINE(TO_CHAR(p_day, 'YYYY-MM-DD'));
END;
END demo_pkg_date_match;
/
Ожидается ошибка соответствия объявления, например PLS-00323. Исправленное тело использует то же объявление параметра:
CREATE OR REPLACE PACKAGE BODY demo_pkg_date_match AS
PROCEDURE show_day(p_day demo_pkg_mentors.joined_on%TYPE) IS
BEGIN
DBMS_OUTPUT.PUT_LINE(TO_CHAR(p_day, 'YYYY-MM-DD'));
END;
END demo_pkg_date_match;
/
BEGIN
demo_pkg_date_match.show_day(DATE '2026-12-19');
END;
/
-- 2026-12-19
📌 Приватные, публичные элементы и состояние
В demo_mentor_admin счётчик g_number_added и функция fee_allowed доступны только телу. Тип mentor_rec, исключение invalid_fee и объявленные подпрограммы доступны через спецификацию. Счётчик можно прочесть только через публичную added_count.
Каждый сеанс имеет свой экземпляр пакета. Инициализация относится к этому экземпляру, а не ко всем пользователям сразу. COMMIT и ROLLBACK не откатывают обычные переменные пакета. Перекомпиляция тела пакета с состоянием может привести к сбросу состояния и ORA-04068 при следующем обращении. SERIALLY_REUSABLE ограничивает срок состояния серверным вызовом; это отдельный выбор конструкции пакета.
💻 Учебная модель банковских операций
Пример показывает очередь операций, приватные подпрограммы, предварительные объявления и обработку ожидаемых ошибок. Он рассчитан на один учебный сеанс обработки и не описывает полноценную банковскую систему. Все таблицы имеют отдельные имена:
CREATE TABLE demo_pkg_accounts (
account_id NUMBER PRIMARY KEY,
balance NUMBER(10,2) NOT NULL
);
CREATE TABLE demo_pkg_transactions (
transaction_id NUMBER PRIMARY KEY,
account_id NUMBER NOT NULL,
kind CHAR(1) NOT NULL,
amount NUMBER(10,2) NOT NULL CHECK (amount > 0),
status VARCHAR2(30 CHAR) NOT NULL,
recorded_on DATE NOT NULL
);
CREATE SEQUENCE demo_pkg_tx_seq START WITH 701;
CREATE TABLE demo_pkg_ledger (
account_id NUMBER,
kind CHAR(1),
new_balance NUMBER(10,2),
recorded_at TIMESTAMP
);
INSERT INTO demo_pkg_accounts VALUES (51, 1200);
COMMIT;
CREATE OR REPLACE PACKAGE demo_bank_actions AS
minimum_balance CONSTANT NUMBER := 200;
PROCEDURE enqueue(p_account NUMBER, p_kind CHAR, p_amount NUMBER, p_day DATE);
PROCEDURE apply_pending;
END demo_bank_actions;
/
CREATE OR REPLACE PACKAGE BODY demo_bank_actions AS
g_status VARCHAR2(30 CHAR);
PROCEDURE credit_account(p_account NUMBER, p_amount NUMBER);
PROCEDURE debit_account(p_account NUMBER, p_amount NUMBER);
PROCEDURE enqueue(p_account NUMBER, p_kind CHAR, p_amount NUMBER, p_day DATE) IS
BEGIN
INSERT INTO demo_pkg_transactions
(transaction_id, account_id, kind, amount, status, recorded_on)
VALUES (demo_pkg_tx_seq.NEXTVAL, p_account, p_kind, p_amount, 'Pending', p_day);
END;
PROCEDURE apply_pending IS
CURSOR c_pending IS
SELECT account_id, kind, amount FROM demo_pkg_transactions
WHERE status = 'Pending'
ORDER BY recorded_on, transaction_id
FOR UPDATE OF status;
BEGIN
FOR tx IN c_pending LOOP
g_status := 'Rejected';
IF tx.kind = 'C' THEN
credit_account(tx.account_id, tx.amount);
ELSIF tx.kind = 'D' THEN
debit_account(tx.account_id, tx.amount);
END IF;
UPDATE demo_pkg_transactions SET status = g_status WHERE CURRENT OF c_pending;
END LOOP;
END;
PROCEDURE journal_entry(p_account NUMBER, p_kind CHAR, p_balance NUMBER) IS
BEGIN
INSERT INTO demo_pkg_ledger (account_id, kind, new_balance, recorded_at)
VALUES (p_account, p_kind, p_balance, SYSTIMESTAMP);
END;
PROCEDURE credit_account(p_account NUMBER, p_amount NUMBER) IS
l_balance NUMBER;
BEGIN
SELECT balance INTO l_balance FROM demo_pkg_accounts
WHERE account_id = p_account FOR UPDATE;
l_balance := l_balance + p_amount;
UPDATE demo_pkg_accounts SET balance = l_balance WHERE account_id = p_account;
journal_entry(p_account, 'C', l_balance);
g_status := 'Credit applied';
EXCEPTION
WHEN NO_DATA_FOUND THEN g_status := 'Bad account number';
END;
PROCEDURE debit_account(p_account NUMBER, p_amount NUMBER) IS
l_balance NUMBER;
insufficient_funds EXCEPTION;
BEGIN
SELECT balance INTO l_balance FROM demo_pkg_accounts
WHERE account_id = p_account FOR UPDATE;
l_balance := l_balance - p_amount;
IF l_balance < minimum_balance THEN RAISE insufficient_funds; END IF;
UPDATE demo_pkg_accounts SET balance = l_balance WHERE account_id = p_account;
journal_entry(p_account, 'D', l_balance);
g_status := 'Debit applied';
EXCEPTION
WHEN NO_DATA_FOUND THEN g_status := 'Bad account number';
WHEN insufficient_funds THEN g_status := 'Insufficient funds';
END;
END demo_bank_actions;
/
Предварительные объявления позволяют apply_pending вызывать приватные процедуры, определённые ниже. Для каждой строки статус начинается с Rejected и не наследуется от предыдущей операции. Ограничение CHECK отклоняет нулевую или отрицательную сумму; отсутствующий счёт намеренно не блокируется внешним ключом, чтобы показать обработчик.
SAVEPOINT before_bank_package;
BEGIN
demo_bank_actions.enqueue(51, 'C', 150, DATE '2026-12-20');
demo_bank_actions.enqueue(51, 'D', 200, DATE '2026-12-20');
demo_bank_actions.enqueue(51, 'D', 2000, DATE '2026-12-20');
demo_bank_actions.enqueue(99, 'C', 50, DATE '2026-12-20');
demo_bank_actions.enqueue(51, 'X', 25, DATE '2026-12-20');
demo_bank_actions.apply_pending;
END;
/
SELECT account_id, kind, amount, status
FROM demo_pkg_transactions ORDER BY transaction_id;
SELECT balance FROM demo_pkg_accounts WHERE account_id = 51;
SELECT COUNT(*) AS ledger_rows FROM demo_pkg_ledger;
| ACCOUNT_ID | KIND | AMOUNT | STATUS |
|---|---|---|---|
| 51 | C | 150 | Credit applied |
| 51 | D | 200 | Debit applied |
| 51 | D | 2000 | Insufficient funds |
| 99 | C | 50 | Bad account number |
| 51 | X | 25 | Rejected |
Баланс равен 1200 + 150 − 200 = 1150, в журнале две строки. Повторный apply_pending не применит обработанные строки снова, поскольку выбирает только Pending.
ROLLBACK TO before_bank_package;
SELECT balance FROM demo_pkg_accounts WHERE account_id = 51;
-- 1200
SELECT COUNT(*) FROM demo_pkg_transactions;
-- 0
SELECT COUNT(*) FROM demo_pkg_ledger;
-- 0
COMMIT внутри пакета отсутствует. Баланс, статусы и журнал изменяются в транзакции вызывающего кода; неожиданные ошибки не скрываются. Для совместной обработки несколькими сеансами потребовалось бы отдельно спроектировать порядок блокировок, повторные попытки и управление очередью.
📌 Перегрузка подпрограмм
Одинаковое имя допустимо при различимых списках параметров. Здесь две процедуры принимают дату либо строкой YYYY-MM-DD, либо числом юлианского дня. Таблица журнала отдельная и не конфликтует с банковским примером.
CREATE TABLE demo_pkg_date_journal (
amount NUMBER(8,2),
event_day DATE
);
CREATE OR REPLACE PACKAGE demo_date_entries AS
PROCEDURE journalize(p_amount NUMBER, p_day VARCHAR2);
PROCEDURE journalize(p_amount NUMBER, p_day NUMBER);
END demo_date_entries;
/
CREATE OR REPLACE PACKAGE BODY demo_date_entries AS
PROCEDURE journalize(p_amount NUMBER, p_day VARCHAR2) IS
BEGIN
INSERT INTO demo_pkg_date_journal (amount, event_day)
VALUES (p_amount, TO_DATE(p_day, 'FXYYYY-MM-DD'));
END;
PROCEDURE journalize(p_amount NUMBER, p_day NUMBER) IS
BEGIN
IF p_day IS NULL OR p_day != TRUNC(p_day) THEN
RAISE_APPLICATION_ERROR(-20093, 'Julian day must be an integer');
END IF;
INSERT INTO demo_pkg_date_journal (amount, event_day)
VALUES (p_amount, TO_DATE(TO_CHAR(p_day, 'TM9'), 'J'));
END;
END demo_date_entries;
/
SAVEPOINT before_overload_demo;
BEGIN
demo_date_entries.journalize(125, '2026-12-20');
demo_date_entries.journalize(75, TO_NUMBER(TO_CHAR(DATE '2026-12-20', 'J')));
END;
/
SELECT amount, TO_CHAR(event_day, 'YYYY-MM-DD') AS event_day
FROM demo_pkg_date_journal ORDER BY amount;
ROLLBACK TO before_overload_demo;
| AMOUNT | EVENT_DAY |
|---|---|
| 75 | 2026-12-20 |
| 125 | 2026-12-20 |
Перегрузка выбрана по типу второго аргумента. Одного различия возвращаемого типа функции недостаточно. Явные типы и преобразования помогают избежать неоднозначности при NULL и неявных преобразованиях.
📌 Пакет STANDARD
STANDARD объявляет встроенные типы, исключения и подпрограммы, доступные без префикса пакета. Например, заголовок ABS:
FUNCTION ABS(n NUMBER) RETURN NUMBER;
Это справочное объявление, а не команда создания встроенной функции. Вызов ABS(-45) возвращает 45. Локальная одноимённая функция скрывает встроенное имя; квалификация STANDARD.ABS выбирает встроенную реализацию:
DECLARE
FUNCTION abs(p_value NUMBER) RETURN NUMBER IS
BEGIN
RETURN 0; -- Намеренная учебная заглушка для демонстрации скрытия имени.
END;
BEGIN
DBMS_OUTPUT.PUT_LINE('local=' || abs(-45));
DBMS_OUTPUT.PUT_LINE('standard=' || STANDARD.ABS(-45));
END;
/
-- local=0
-- standard=45
Перегруженные варианты TO_CHAR принимают разные типы и наборы аргументов; среди них:
FUNCTION TO_CHAR(right DATE) RETURN VARCHAR2;
FUNCTION TO_CHAR(left NUMBER) RETURN VARCHAR2;
FUNCTION TO_CHAR(left DATE, right VARCHAR2) RETURN VARCHAR2;
FUNCTION TO_CHAR(left NUMBER, right VARCHAR2) RETURN VARCHAR2;
Эти справочные заголовки иллюстрируют выбор по числу и типам аргументов. Для вывода дат в примерах используется явный формат.
📌 Руководство по написанию пакетов
При написании пакетов держите их как можно более общими, чтобы их можно было использовать в будущих приложениях. Избегайте написания пакетов, которые дублируют некоторые функции, уже предоставленные Oracle.
Спецификации пакета отражают дизайн вашего приложения. Определяйте их перед телом пакета. Поместите в спецификацию только те типы, элементы и подпрограммы, которые должны быть видны пользователям пакета. Таким образом, другие разработчики не могут неправильно использовать пакет, основывая свой код на нерелевантных деталях реализации.
Чтобы уменьшить необходимость перекомпиляции при изменении кода, поместите как можно меньше элементов в спецификацию пакета. Изменения в теле пакета не требуют, чтобы Oracle перекомпилировал зависимые процедуры. Изменения спецификации могут инвалидировать зависимые объекты; последствия зависят от изменённого интерфейса и зависимостей.
📌 Проверка и запуск
У каждого сценария свои имена. DDL создаёт объекты до SAVEPOINT, а тестовые изменения откатываются до следующего DDL. Не запускайте отрицательный пример несовпадения заголовков без последующего исправления. Ошибки компиляции видны в USER_ERRORS:
SELECT name, type, line, position, text
FROM user_errors
WHERE name IN ('DEMO_MENTOR_BASIC', 'DEMO_MENTOR_ADMIN', 'DEMO_BANK_ACTIONS',
'DEMO_BOOKING_DATA', 'DEMO_RANDOM_STATE', 'DEMO_PKG_DATE_MATCH',
'DEMO_DATE_ENTRIES')
ORDER BY name, type, sequence;
После исправленного тела список ошибок должен быть пуст. Включите DBMS Output в клиенте; в SQL*Plus/SQLcl — SET SERVEROUTPUT ON. Числа счётчиков приведены для первого запуска соответствующего пакета в новом сеансе.
Связанные темы: процедуры, функции, записи и последовательности.
Документация Oracle: plsql-packages, package-body, package-instantiation-and-initialization, package-state, how-standard-package-defines-pl-sql-environment.