> DECLARE num NUMBER; BEGIN ... FOR num IN 1..10 LOOP ... IF main.num > 5 THEN -- обращается к явно объявленной ... -- переменной num, а не индексу END IF; END LOOP; END main; Внутри цикла ИНДЕКС рассматривается как константа. Его можно использовать в выражениях, но вы не можете присвоить ему значение, находясь внутри цикла. Элементы языка 9-71  целое_выр Этот параметр является выражением, результатом вычисления которого должно быть целое число. Это выражение вычисляется лишь при первом входе в цикл. По умолчанию, ИНДЕКСУ присваивается значение левого ЦЕЛОГО_ВЫР. Если ИНДЕКС не превышает значения правого ЦЕЛОГО_ВЫР, РЯД_ПРЕДЛОЖЕНИЙ выполняется. Затем ИНДЕКС увеличивается на 1. Если ИНДЕКС по-прежнему не превышает значения правого ЦЕЛОГО_ВЫР, РЯД_ПРЕДЛОЖЕНИЙ снова выполняется. Этот процесс повторяется до тех пор, пока ИНДЕКС не станет больше значения правого ЦЕЛОГО_ВЫР. В этот момент цикл заканчивается. REVERSE По умолчанию индекс наращивается на 1 от нижней до верхней границы. Однако, если вы используете ключевое слово REVERSE, индекс будет изменяться в обратном направлении, от верхней границы к нижней. После каждой итерации индекс цикла уменьшается на 1. Процесс организуется противоположно умалчиваемому случаю, описанному выше. ИНДЕКСУ присваивается значение правого ЦЕЛОГО_ВЫР. Если ИНДЕКС не меньше значения левого ЦЕЛОГО_ВЫР, РЯД_ПРЕДЛОЖЕНИЙ выполняется. Затем ИНДЕКС уменьшается на 1. Если ИНДЕКС по-прежнему не меньше значения левого ЦЕЛОГО_ВЫР, РЯД_ПРЕДЛОЖЕНИЙ снова выполняется. Этот процесс повторяется до тех пор, пока ИНДЕКС не станет меньше значения левого ЦЕЛОГО_ВЫР. В этот момент цикл заканчивается. Пример: FOR i IN REVERSE 1..10 LOOP -- i уменьшается с 10 до 1 -- поместите здесь предложения; они выполнятся 10 раз ... END LOOP; Курсорные циклы FOR ------------------- параметр_курсорного_цикла Курсорный цикл FOR неявно объявляет свой индекс цикла как запись типа %ROWTYPE, открывает курсор, в цикле извлекает строки из активного множества в поля записи, и закрывает курсор, когда все строки обработаны или когда вы выходите из цикла. Когда управление попадает на курсорный цикл FOR, выполняется неявное предложение OPEN ИМЯ_КУРСОРА. Затем, для каждой строки, которая удовлетворяет запросу, ассоциированному с ИМЕНЕМ_КУРСОРА, выполняется неявная операция FETCH в неявно объявленную запись ИМЯ_ЗАПИСИ и исполняется РЯД_ПРЕДЛОЖЕНИЙ. Когда все строки исчерпаны, выполняется неявное предложение CLOSE ИМЯ_КУРСОРА, и цикл заканчивается. Таким образом, РЯД_ПРЕДЛОЖЕНИЙ выполняется один раз для каждой строки, которая удовлетворяет запросу, ассоциированному с ИМЕНЕМ_КУРСОРА. 9-72 Руководство пользователя и справочник по PL/SQL  имя_записи Этот идентификатор именует неявно объявляемую запись. Синтаксис ИМЕНИ_ЗАПИСИ совпадает с синтаксисом ИДЕНТИФИКАТОРА, который определен в разделе "Идентификаторы" в главе 2. Неявно объявляемая запись имеет структуру строки данных, извлекаемой курсором ИМЯ_КУРСОРА. Эта запись определена так, как если бы она была объявлена следующим образом: имя_записи имя_курсора%ROWTYPE; Поля этой записи содержат значения из столбцов строки, извлекаемой неявной операцией FETCH. Эти поля имеют имена, совпадающие с именами соответствующих столбцов. Для обращения к значениям этих полей используйте следующий синтаксис: имя_записи.имя_столбца Чтобы такое неявное объявление было успешным, необходимо, чтобы каждый столбец, извлекаемый курсором, имел имя в форме простого идентификатора, или, если это выражения, для них должны быть предоставлены алиасы. В следующем примере для вычисляемого элемента sal+NVL(comm,0) используется алиас wages: CURSOR c1 IS SELECT empno, sal+NVL(comm,0) wages, job ... имя_курсора Этот идентификатор является именем ранее объявленного курсора PL/SQL. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. При входе в курсорный цикл FOR курсор ИМЯ_КУРСОРА не должен оказаться открытым (в результате явной операции OPEN или из-за того, что этот курсор использовался в окружающем курсорном цикле FOR). параметр Этот идентификатор именует формальный параметр курсора. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. Синтаксис ПАРАМЕТРА совпадает с синтаксисом PLSQL_ВЫРАЖЕНИЯ, который определен в разделе "Выражения" выше в этой главе. Если курсор ИМЯ_КУРСОРА был объявлен с формальными параметрами, то курсору должны быть переданы фактические параметры. Значения этих параметров используются при неявном открытии курсора перед первым выполнением цикла. Каждый передаваемый параметр должен иметь тип данных, который совместим с типом данных соответствующего параметра курсора, определенного в первоначальном объявлении курсора, или может быть преобразован в него. Для дополнительной информации обратитесь к разделу "Типы данных" в главе 2. Элементы языка 9-73  select_предложение Это - запрос, который ассоциируется с недоступным вам внутренним курсором. PL/SQL автоматически объявляет, открывает, извлекает данные и закрывает этот внутренний курсор. Так как SELECT_ПРЕДЛОЖЕНИЕ здесь не является независимым предложением, к нему неприменим идентификатор неявного курсора SQL. Синтаксис SELECT_ПРЕДЛОЖЕНИЯ совпадает с синтаксисом конструкта SELECT_INTO_ПРЕДЛОЖЕНИЕ, которое определено в разделе "SELECT INTO" ниже в этой главе, с той разницей, что SELECT_ПРЕДЛОЖЕНИЕ не может иметь фразы INTO. Замечания по использованию -------------------------- Вы можете использовать предложение EXIT для принудительного выхода из любого цикла. Как только условие, специфицированное в предложении EXIT, станет истинным, вы немедленно выйдете из цикла. Для дополнительной информации обратитесь к разделу "EXIT" выше в этой главе. При выходе из курсорного цикла FOR курсор автоматически закрывается, даже если вы использовали предложение EXIT или GOTO для преждевременного выхода из цикла. Курсор также автоматически закрывается при возбуждении исключения внутри цикла. Пример ------ DECLARE bonus REAL; CURSOR c1 IS SELECT empno, sal, comm FROM emp; BEGIN FOR c1rec IN c1 LOOP bonus := (c1rec.sal * 0.05) + (c1rec.comm * 0.25); INSERT INTO bonuses VALUES (c1rec.empno, bonus); END LOOP; COMMIT; END; Связанные темы -------------- CLOSE, Условия, Курсоры, EXIT, FETCH, OPEN, %ROWTYPE 9-74 Руководство пользователя и справочник по PL/SQL  ---------------- Атрибут %NOTFOUND Описание -------- Курсоры PL/SQL имеют четыре атрибута, включая %NOTFOUND. Эти атрибуты, присоединяемые к имени курсора, помогают обращаться к полезной информации курсора. Для дополнительной информации см. раздел "Управление курсорами" в главе 4. PL/SQL использует два типа курсоров: явные и неявные. PL/SQL неявно объявляет курсор (с именем SQL) для любого предложения манипулирования данными SQL, включая однострочные запросы. Перед выполнением первого предложения SQL, не ассоциированного с явным курсором, SQL%NOTFOUND дает NULL. Впоследствии, этот атрибут дает FALSE, если операция INSERT, UPDATE или DELETE затронула хотя бы одну строку, или если операция SELECT INTO вернула хотя бы одну строку. В противном случае SQL%NOTFOUND дает TRUE. В случае многострочных предложений SELECT вы можете явно объявить курсор для обработки возвращаемых строк. После открытия курсора, но до выполнения первой операции FETCH, атрибут ИМЯ_КУРСОРА%NOTFOUND дает NULL. После каждой операции FETCH этот атрибут дает FALSE, если операция вернула очередную строку данных, и TRUE в противном случае. Синтаксис --------- атрибут_%notfound ::= --------------------- имя_курсора%NOTFOUND-------------------------- Ключевые слова и параметры -------------------------- имя_курсора Этот параметр должен быть именем явно объявленного курсора или именем неявного курсора (SQL). Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. Замечания по использованию -------------------------- Атрибут %NOTFOUND можно использовать в процедурных предложениях, но НЕ в предложениях SQL. Атрибут %NOTFOUND ассоциирован с каждым явным курсором. Вы можете открыть одновременно несколько курсоров и в каждый момент времени знать, какие из них еще имеют доступные строки в их активных множествах. Если курсор не открыт, то обращение к нему через атрибут %NOTFOUND возбуждает предопределенное исключение INVALID_CURSOR. Когда явный курсор открыт, строки базы данных, удовлетворяющие запросу этого курсора, идентифицированы и образуют активное множество. Атрибут %NOTFOUND указывает, была ли возвращена строка последней операцией FETCH для соответствующего открытого курсора. Когда активное множество становится пустым, очередная операция FETCH устанавливает атрибут %NOTFOUND в TRUE. Элементы языка 9-75  Примеры ------- В следующем примере %NOTFOUND используется для того, чтобы возбудить исключение, если удаление сбивается: DELETE FROM parts WHERE status = 'OBSOLETE'; IF SQL%NOTFOUND THEN RAISE none_purged; END IF; В следующем примере, блок PL/SQL извлекает по одному числу из каждой из двух таблиц и вставляет их сумму в третью таблицу. Блок завершает свою работу по исчерпании любой из первых двух таблиц. -- доступен на диске в файле EXAMP13 DECLARE CURSOR num1_cur IS SELECT num FROM num1_tab ORDER BY sequence; CURSOR num2_cur IS SELECT num FROM num2_tab ORDER BY sequence; num1 num1_tab.num%TYPE; num2 num2_tab.num%TYPE; pair_num NUMBER := 0; BEGIN OPEN num1_cur; OPEN num2_cur; LOOP -- loop through the two tables and get -- pairs of numbers FETCH num1_cur INTO num1; FETCH num2_cur INTO num2; EXIT WHEN (num1_cur%NOTFOUND) OR (num2_cur%NOTFOUND); pair_num := pair_num + 1; INSERT INTO sum_tab VALUES (pair_num, num1 + num2); END LOOP; CLOSE num1_cur; CLOSE num2_cur; END; Связанные темы -------------- CLOSE, Курсоры, DELETE, FETCH, %FOUND, INSERT, OPEN, SELECT INTO, UPDATE 9-76 Руководство пользователя и справочник по PL/SQL  ---------------- NULL Описание -------- Предложение NULL явно специфицирует отсутствие действия. Выполнение этого предложения не имеет никакого эффекта, кроме передачи управления следующему предложению. PL/SQL предоставляет это предложение для улучшения читабельности. Для дополнительной информации см. раздел "Последовательное управление" в главе 3. Синтаксис --------- null_предложение ::= -------------------------- NULL ------ ; --------------------------- Замечания по использованию -------------------------- Предложение NULL рекомендуется использовать для улучшения читабельности условных предложений. В конструкте, предполагающем альтернативные действия, явное предложение NULL говорит читателю о том, что соответствующая альтернатива не пропущена случайно, а, действительно, никакого действия не требуется. Предложение NULL не имеет никакого отношения к пустым значениям (значениям NULL). Примеры ------- В следующем примере предложение NULL подчеркивает, что только продавцы получают премии. IF job_title = 'SALESPERSON' THEN compute_commission(emp_id); ELSE NULL; END IF; В следующем примере предложение NULL подчеркивает, что обработчик не обрабатывает никаких исключений, кроме явно перечисленных. EXCEPTION WHEN ZERO_DIVIDE THEN ROLLBACK; ... WHEN OTHERS THEN NULL; END; Элементы языка 9-77  ---------------- OPEN Описание -------- Предложение OPEN вычисляет запрос, ассоциированный с явно объявленным курсором. Оно также распределяет ресурсы, используемые ORACLE для выполнения этого запроса. В процессе выполнения запроса строки таблиц, удовлетворяющие поисковым условиям запроса, идентифицируются и образуют активное множество. Курсор устанавливается непосредственно перед первой строкой активного множества. Для дополнительной информации см. раздел "Обработка транзакций" в главе 4. Синтаксис --------- open_предложение ::= --- OPEN --- имя_курсора ---T--------------------------------T- ; -- ¦ --------- , ---------¬ ¦ L- ( -- входной_параметр -+- ) -- Ключевые слова и параметры -------------------------- имя_курсора Этот идентификатор задает имя курсора, ранее объявленного через ОБЪЯВЛЕНИЕ_КУРСОРА и в настоящий момент не открытого. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. входной_параметр Этот идентификатор именует формальный параметр курсора и обычно используется в фразе WHERE. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. Синтаксис ВХОДНОГО_ПАРАМЕТРА совпадает с синтаксисом PLSQL_ВЫРАЖЕНИЯ (см. раздел "Выражения" выше в этой главе). Если у вас были определены формальные параметры в объявлении курсора, то вы ДОЛЖНЫ включить фактические параметры в предложение OPEN. Все фактические параметры в предложении OPEN должны иметь типы данных, совместимые (или преобразуемые) с типами данных соответствующих формальных параметров. Для дополнительной информации о обратитесь к разделу "Типы данных" в главе 2. Помимо фактических параметров, запрос может обращаться к переменным PL/SQL, определенным в его сфере. 9-78 Руководство пользователя и справочник по PL/SQL  Если вы не хотите принять умалчиваемые значения, каждому формальному параметру в объявлении курсора следует сопоставить соответствующий фактический параметр в предложении OPEN. Формальные параметры, объявленные с умалчиваемым значением, могут и не иметь соответствующих им фактических параметров. В этом случае они просто принимают свое умалчиваемое значение во время выполнения OPEN. Не забывайте, что формальные параметры курсора должны быть параметрами IN, так что они не могут возвращать значений фактическим параметрам. Чтобы сопоставить фактические параметры в предложении OPEN формальным параметрам в объявлении курсора, вы можете использовать позиционную или именную нотацию. (См. раздел "Позиционная и именная нотация" в главе 6.) Замечания по использованию -------------------------- В общем случае, PL/SQL выполняет синтаксический разбор явного курсора лишь при его первом открытии, а разбор предложения SQL (и тем самым создание неявного курсора) - лишь при первом выполнении этого предложения. Все синтаксически разобранные предложения SQL кэшируются. Повторный разбор предложения SQL необходим лишь в том случае, если это предложение было вытеснено из кэша другим предложением SQL. Поэтому, хотя вы должны закрывать (CLOSE) курсор перед его повторным открытием, PL/SQL, вообще говоря, не будет осуществлять повторный разбор соответствующего предложения SELECT. Если вы закрываете и немедленно вновь открываете курсор, то повторного разбора не будет гарантированно. Выполнение предложения OPEN не извлекает никаких строк активного множества. Извлекает строки предложение FETCH. В курсоре, объявленном FOR UPDATE, строки активного множества блокируются при открытии курсора. Если курсор в настоящий момент открыт предложением OPEN, вы не можете использовать этот курсор в курсорном цикле FOR. Элементы языка 9-79  Примеры ------- При данном объявлении курсора: CURSOR parts_cur IS SELECT part_num, part_price FROM parts; следующее предложение открывает этот курсор: OPEN parts_cur; При данном объявлении курсора: CURSOR emp_cur(my_ename CHAR, my_comm NUMBER DEFAULT 0) IS SELECT ...; любое из следующих предложений открывает этот курсор: OPEN emp_cur('BLAKE', 300); OPEN emp_cur(employee_name, 150); OPEN emp_cur('LEE'); OPEN emp_cur('TRUSDALE', my_comm); Обратите внимание, что, как показывает последний пример, переменная, используемая как входной параметр в предложении OPEN, может иметь такое же имя, что и формальный параметр в объявлении курсора. Когда имя my_comm встречается в объявлении курсора, оно относится к формальному параметру. Вне объявления курсора это же имя относится к переменной PL/SQL. Для ясности, однако, рекомендуется использовать уникальные имена. Связанные темы -------------- CLOSE, Курсоры, FETCH, LOOP 9-80 Руководство пользователя и справочник по PL/SQL  ---------------- Пакеты Описание -------- Пакет - это объект базы данных, который группирует логически связанные типы, программные объекты и подпрограммы PL/SQL. Пакеты обычно состоят из двух частей, спецификации и тела, хотя иногда в теле нет необходимости. Спефицикация пакета - это интерфейс с вашими приложениями; она объявляет типы, переменные, константы, исключения, курсоры и подпрограммы, доступные для использования в пакете. Тело пакета полностью определяет курсоры и подпрограммы, тем самым реализуя спецификацию пакета. Для более подробной информации обратитесь к главе 7. Синтаксис --------- спецификация_пакета ::= ----- PACKAGE --- имя_пакета ---- IS -------------------------------- -------------------------------------¬ ------------------T-- объявление_переменной; ----T---+-------------- +-- объявление_курсора; -------+ +-- спецификация_курсора; -----+ +-- объявление_исключения; ----+ +-- объявление_записи; --------+ +-- объявление_plsql_таблицы; -+ +-- объявление_процедуры; -----+ L-- объявление_функции; -------- ------------------- END -------T----------------T---- ; ------------ L-- имя_пакета --- тело_пакета ::= ----- PACKAGE BODY --- имя_пакета ---- IS --------------------------- -------------------------------------¬ ------------------T-- объявление_переменной; ----T---+-------------- +-- объявление_курсора; -------+ +-- тело_курсора; -------------+ +-- объявление_исключения; ----+ +-- объявление_записи; --------+ +-- объявление_plsql_таблицы; -+ +-- тело_процедуры; -----------+ L-- тело_функции; -------------- ------------------- END -------T----------------T---- ; ------------ L-- имя_пакета --- Элементы языка 9-81  Ключевые слова и параметры -------------------------- имя_пакета Этот идентификатор именует пакет. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. объявление_переменной Этот конструкт объявляет переменные и константы. Его синтаксис описан в разделе "Переменные и константы" ниже в этой главе. объявление_курсора Этот конструкт объявляет явный курсор. Его синтаксис описан в разделе "Курсоры" выше в этой главе. спецификация_курсора Этот конструкт объявляет интерфейс к явному курсору. Его синтаксис описан в разделе "Курсоры" выше в этой главе. объявление_исключения Этот конструкт объявляет исключения. Его синтаксис описан в разделе "Исключения" выше в этой главе. объявление_записи Этот конструкт объявляет пользовательские записи. Его синтаксис описан в разделе "Записи" ниже в этой главе. объявление_plsql_таблицы Этот конструкт объявляет таблицы PL/SQL. Его синтаксис описан в разделе "Таблицы PL/SQL" ниже в этой главе. спецификация_процедуры Этот конструкт объявляет интерфейс к процедуре. Его синтаксис описан в разделе "Процедуры" ниже в этой главе. спецификация_функции Этот конструкт объявляет интерфейс к функции. Его синтаксис описан в разделе "Функции" выше в этой главе. тело_курсора Этот конструкт определяет реализацию явного курсора. Его синтаксис описан в разделе "Курсоры" выше в этой главе. тело_процедуры Этот конструкт определяет реализацию процедуры. Его синтаксис описан в разделе "Процедуры" выше в этой главе. 9-82 Руководство пользователя и справочник по PL/SQL  тело_функции Этот конструкт определяет реализацию функции. Его синтаксис описан в разделе "Функции" выше в этой главе. ряд_предложений Это последовательность предложений. Ее синтаксис описан в разделе "Блоки" выше в этой главе. обработчик_исключений Этот конструкт ассоциирует исключение с последовательностью предложений, которая будет выполняться при возбуждении исключения. Синтаксис ОБРАБОТЧИКА_ИСКЛЮЧЕНИЙ описан в разделе "Исключения" выше в этой главе. Замечания по использованию -------------------------- Пакеты нельзя встраивать в блок или подпрограмму PL/SQL. Однако определять пакеты можно с помощью любого инструмента ORACLE, поддерживающего PL/SQL. Чтобы быть доступными для общего пользования, пакеты должны быть созданы (CREATE) и сохранены в базе данных ORACLE. Вы можете выдавать предложения CREATE PACKAGE и CREATE PACKAGE BODY интерактивно, из SQL*Plus или SQL*DBA, или из хост-программы прекомпилятора ORACLE. Для полного синтаксиса предложения CREATE обратитесь к документу ORACLE7 Server SQL Language Manual. Все, что вам надо изначально знать при проектировании приложения - это информация интерфейса в спецификациях пакетов. Вы можете кодировать и компилировать спецификацию без тела. После того, как спецификация откомпилирована, хранимые подпрограммы, обращающиеся к пакету, также могут быть откомпилированы. Вы не обязаны полностью определять тела пакетов до тех пор, пока не будете готовы к реализации деталей приложения. Более того, вы можете отлаживать, развивать или заменять тело пакета, не изменяя интерфейса с этим телом (т.е. спецификации пакета). Это значит, что вы не обязаны перекомпилировать программы, вызывающие данный пакет. Курсоры и подпрограммы, объявленные в спецификации пакета, должны быть определены в теле пакета. Другие программные объекты, объявленные в спецификации пакета, не могут быть переобъявлены в теле пакета. Связанные темы -------------- Курсоры, Исключения, Функции, Таблицы PL/SQL, Процедуры, Записи Элементы языка 9-83  ---------------- Таблицы PL/SQL Описание -------- Таблицы PL/SQL - это объекты типа TABLE, которые моделируют таблицы базы данных (но не являются таковыми). Таблицы PL/SQL используют первичный ключ, чтобы предоставить вам доступ к строкам по аналогии с массивом. Как и размер таблицы базы данных, размер таблицы PL/SQL не ограничивается. Иными словами, число строк в таблице PL/SQL может возрастать динамически. Поэтому ваша таблица PL/SQL растет по мере добавления в нее новых строк. Для более подробной информации см. раздел "Таблицы PL/SQL" в главе 2. Таблицы PL/SQL должны объявляться за два шага. Сначала вы объявляете (поименованный) тип TABLE, а затем объявляете таблицы PL/SQL этого типа. Синтаксис --------- объявление_plsql_таблицы ::= ------ TYPE ----- имя_типа ----- IS ---- TABLE OF ------------------- ----T-- тип_столбца ------------T----T------------T----------------- +-- переменная%TYPE --------+ L- NOT NULL -- L- таблица.столбец%TYPE ----- ----------------- INDEX BY BINARY INTEGER -------------- ; --------- plsql_таблица ::= ----------- имя_plsql_таблицы --- тип_plsql_таблицы ---- ; --------- Ключевые слова и параметры -------------------------- имя_типа Этот идентификатор именует определенный пользователем спецификатор типа, который используеипя в последующих объявлениях таблиц PL/SQL. Соглашения об именах обсуждаются в разделе "Идентификаторы" в главе 2. тип_столбца Специфицирует тип данных столбца в таблице PL/SQL. Это может быть любой скалярный (не составной) тип данных, такой как CHAR, DATE или NUMBER. Для дополнительной информации см. раздел "Типы данных" в главе 2. таблица.столбец Ссылка на таблицу и столбец базы данных, которые должны быть доступны в момент обработки объявления. 9-84 Руководство пользователя и справочник по PL/SQL  INDEX BY BINARY INTEGER Первичный ключ таблицы PL/SQL должен иметь тип данных BINARY_INTEGER, который может представлять целые со знаком практически любой величины. Допустимый диапазон значений BINARY_INTEGER - от -2**31 - 1 до 2**31 - 1 (-2147483647 .. 2147483647). имя_plsql_таблицы Этот идентификатор именует всю таблицу PL/SQL. Соглашения об именах обсуждаются в разделе "Идентификаторы" в главе 2. Замечания по использованию -------------------------- Вы можете объявлять типы TABLE в декларативной части любого блока, подпрограммы или пакета, Таблица PL/SQL может иметь один столбец и один первичный ключ, оба непоименованные. Столбец может принадлежать любому скалярному типу, но первичный ключ должен принадлежать типу BINARY_INTEGER. Для спецификации типа столбца можно использовать атрибут %TYPE. В отличие от массива, таблица PL/SQL не ограничена (не имеет фиксированного размера), потому что ее первичный ключ может принимать любое значение в интервале допустимых значений для BINARY_INTEGER. Как следствие, вы не можете инициализировать таблицу PL/SQL в ее объявлении. Например, следующее объявление незаконно: job_tab JobTabTyp := ('CLERK','ANALYST','MANAGER'); Пока строке таблицы PL/SQL не присвоено значение, эта строка не существует. При попытке обратиться к неинициализированной строке PL/SQL возбуждает предопределенное исключение NO_DATA_FOUND. Таблицы PL/SQL подчиняются обычным правилам сферы и инстанциации (инстанциация - это создание нового экземпляра программного объекта). В пакете, таблицы PL/SQL инстанциируются при первом обращении к этому пакету, и перестают существовать, когда вы выходите из приложения или заканчиваете сессию базы данных. В блоке или подпрограмме, таблицы PL/SQL инстанциируются при входе в блок или подпрограмму, и перестают существовать, когда вы выходите из блока или подпрограммы. Как и скалярные переменные, таблицы PL/SQL могут объявляться как формальные параметры процедур и функций. Ограничения, которые применяются к скалярным параметрам, применимы и к таблицам PL/SQL. Элементы языка 9-85  Примеры ------- В следующем примере вы объявляете тип TABLE с именем SalTabTyp: DECLARE TYPE SalTabTyp IS TABLE OF NUMBER(7,2) INDEX BY BINARY INTEGER; ... Вы можете использовать атрибут %TYPE, чтобы представить тип данных столбца, например: DECLARE TYPE SalTabTyp IS TABLE OF emp.sal%TYPE INDEX BY BINARY INTEGER; ... После определения типа SalTabTyp вы можете объявлять таблицы PL/SQL этого типа, например: sal_tab SalTabTyp; Идентификатор sal_tab представляет всю таблицу PL/SQL. В следующем примере вы присваиваете сумму значений переменных salary и increase десятой строке таблицы PL/SQL sal_tab: sal_tab(10) := salary + increase; Связанные темы -------------- Предложение присваивания, Функции, Процедуры, Записи 9-86 Руководство пользователя и справочник по PL/SQL  ---------------- Процедуры Описание -------- Процедура - это поименованный блок PL/SQL, которому можно передавать параметры и который можно вызывать. Обычно вы используете процедуру, чтобы выполнить некоторое действие. Для дополнительной информации обратитесь к разделу "Процедуры" в главе 6. Процедура имеет две части: спецификацию и тело. Спецификация процедура начинается ключевым словом PROCEDURE и заканчивается именем процедуры или списком параметров. Объявления параметров необязательны. Процедуры, не принимающие параметров, записываются без скобок. Тело процедуры начинается ключевым словом IS и заканчивается ключевым словом END, за которым может следовать необязательное имя процедуры. Тело процедуры имеет три части: декларативную часть, исполняемую часть и необязательную часть обработки исключений. Декларативная часть содержит объявления типов, курсоров, констант, переменных, исключений и подпрограмм. Эти объекты локальны и перестают существовать при выходе из процедуры. Исполняемая часть содержит предложения, которые присваивают значения, управляют выполнением и манипулируют данными ORACLE. Часть обработки исключений содержит обработчики исключений, которые имеют дело с исключениями, возбуждаемыми во время выполнения процедуры. Элементы языка 9-87  Синтаксис --------- спецификация_процедуры ::= --- PROCEDURE --- имя_процедуры ---T--------------------------T- ; -- ¦ ----- , -----¬ ¦ L-- ( -- параметр -+- ) --- объявление_процедуры ::= тело_процедуры тело_процедуры ::= ---- PROCEDURE -- имя_процедуры --T--------------------------T- IS -- ¦ ----- , -----¬ ¦ L-- ( -- параметр -+- ) --- --------------T------------------------------------------T----------- ¦ -------------------------------------¬ ¦ L---T-- объявление_переменной; ----T---+--- +-- объявление_курсора; -------+ +-- объявление_исключения; ----+ +-- объявление_записи; --------+ +-- объявление_plsql_таблицы; -+ +-- объявление_процедуры; -----+ L-- объявление_функции; -------- ---------------------- BEGIN ----- ряд_предложений ------------------ -----T------------------------------------------------T--------------- ¦ -----------------------------¬ ¦ L-- EXCEPTION ----- обработчик_исключений; --+--- ------------------- END -------T-------------------T---- ; --------- L-- имя_процедуры --- где ПАРАМЕТР имеет следующий синтаксис: ---- имя_параметра --T-----------T---T- имя_типа -------------T------ +- IN ------+ +- переменная%TYPE ------+ +- OUT -----+ +- таблица.столбец%TYPE -+ L- IN OUT --- L- таблица%ROWTYPE ------- ----------------T----------------------------T---------------------- +----- := -----T-- значение -- L-- DEFAULT ---- 9-88 Руководство пользователя и справочник по PL/SQL  Ключевые слова и параметры -------------------------- имя_процедуры Этот идентификатор именует процедуру. Соглашения об именах описаны в разделе "Идентификаторы" в главе 2. объявление_переменной Этот конструкт объявляет переменные и константы. Его синтаксис описан в разделе "Переменные и константы" ниже в этой главе. объявление_курсора Этот конструкт объявляет явный курсор. Его синтаксис описан в разделе "Курсоры" выше в этой главе. объявление_исключения Этот конструкт объявляет исключения. Его синтаксис описан в разделе "Исключения" выше в этой главе. объявление_записи Этот конструкт объявляет пользовательские записи. Его синтаксис описан в разделе "Записи" ниже в этой главе. объявление_plsql_таблицы Этот конструкт объявляет таблицы PL/SQL. Его синтаксис описан в разделе "Таблицы PL/SQL" ниже в этой главе. объявление_процедуры Этот конструкт объявляет вложенную процедуру. объявление_функции Этот конструкт объявляет функцию. Его синтаксис описан в разделе "Функции" ниже в этой главе. ряд_предложений Это последовательность предложений. Ее синтаксис описан в разделе "Блоки" выше в этой главе. обработчик_исключений Этот конструкт ассоциирует исключение с последовательностью предложений, которая будет выполняться при возбуждении исключения. Синтаксис ОБРАБОТЧИКА_ИСКЛЮЧЕНИЙ описан в разделе "Исключения" выше в этой главе. имя_параметра Этот идентификатор именует формальный параметр и представляет собой переменную, объявленную в спецификации процедуры и адресуемую в теле процедуры. Соглашения об именах описаны в разделе "Идентификаторы" в главе 2. Элементы языка 9-89  IN, OUT, IN OUT Эти моды параметров определяют поведение формальных параметров. Мода IN позволяет передавать значения вызываемой подпрограмме. Мода OUT позволяет возвращать значения вызывающей программе. Мода IN OUT позволяет передавать входные значения вызываемой подпрограмме и возвращать обновленные значения вызывающей программе. имя_типа Специфицирует тип данных формального параметра или результирующего значения. Для дополнительной информации см. раздел "Типы данных" в главе 2. В отличие от спецификатора типа в объявлении переменной, спецификатор типа в объявлении параметра не может иметь ограничения. Например, следующее объявление emp_name незаконно: PROCEDURE ... (emp_namt CHAR(20)) IS -- незаконно BEGIN ... END; таблица.столбец Ссылка на таблицу и столбец базы данных, которые должны быть доступны в момент обработки объявления. %TYPE Атрибут %TYPE представляет тип данных переменной, константы или столбца базы данных. таблица Ссылка на таблицу базы данных, которая должна быть доступна в момент обработки объявления. %ROWTYPE Атрибут %ROWTYPE указывает запись, представляющую строку таблицы базы данных. Столбцы в строке и соответствующие поля записи имеют одинаковые имена и типы данных. DEFAULT или := Это ключевое слово или оператор присваивания позволяют вам инициализировать параметры IN умалчиваемыми значениями. Замечания по использованию -------------------------- Исполняемая часть любой процедуры должна содержать хотя бы одно предложение. Предложение NULL удовлетворяет этому требованию. Процедура вызывается как предложение PL/SQL. Например, процедура raise_salary может быть вызвана следующим образом: raise_salary(emp_num, amount); Внутри процедуры параметр IN выступает как константа. Поэтому ему нельзя присвоить значение. Параметр OUT выступает как неинициализированная переменная. Поэтому его значение нельзя присваивать другим переменным или переприсвоить самому себе. Параметр IN OUT выступает как инициализированная переменная. Поэтому ему можно присвоить значение, а его значение можно присваивать другим переменным. Сводка информации о модах параметров приведена в табл.6-1 в главе 6. 9-90 Руководство пользователя и справочник по PL/SQL  Перед выходом из процедуры не забывайте явно присвоить значения параметрам OUT. В противном случае значения соответствующих фактических параметров будут не определены. При успешном выходе из процедуры PL/SQL присваивает значения фактическим параметрам. Однако, если вы выходите с необработанным исключением, PL/SQL НЕ присваивает значений фактическим параметрам. В отличие от параметров OUT и IN OUT, параметры IN могут быть инициализированы умалчиваемыми значениями. Для дополнительной информации см. раздел "Умалчиваемые значения параметров" в главе 6. Вы можете написать спецификацию процедуры и ее тело как единицу. Альтернативно, вы можете отделить спецификацию процедуры от ее тела. Таким способом вы можете скрыть детали реализации, помещая процедуру в пакет. Вы можете определять процедуры в теле пакета, не объявляя их спецификаций в спецификации пакета. Однако такие процедуры можно будет вызывать только изнутри пакета. Процедуры можно определять с помощью любого инструмента ORACLE, поддерживающего PL/SQL. Однако, для того, чтобы быть доступными для общего пользования, процедуры необходимо создавать (CREATE) и сохранять в базе данных ORACLE. Вы можете выдавать предложение CREATE PROCEDURE интерактивно из SQL*Plus или SQL*DBA. Полный синтаксис предложения CREATE PROCEDURE приведен в документе ORACLE7 Server SQL Language Reference Manual. Пример ------ Следующая процедура дебитует указанный банковский счет: PROCEDURE debit_account (acct_id INTEGER, amount REAL) IS old_balance REAL; new_balance REAL; overdrawn EXCEPTION; BEGIN SELECT bal INTO old_balance FROM accts WHERE acctno = acct_id; new_balance := old_balance - amount; IF new_balance < 0 THEN RAISE overdrawn; ELSE UPDATE accts SET bal = new_balance WHERE acctno = acct_id; END IF; EXCEPTION WHEN overdrawn THEN ... END debit_account; В следующем примере вы вызываете эту процедуру, используя именную нотацию: debit_account(amount => 500, acct_id => 10261); Связанные темы -------------- Курсоры, Исключения, Функции, Пакеты, Таблицы PL/SQL, Записи Элементы языка 9-91  ---------------- RAISE Описание -------- Предложение RAISE останавливает нормальное выполнение блока или подпрограммы PL/SQL и передает управление на соответствующий обработчик исключений. Для более подробной информации см. раздел "Пользовательские исключения" в главе 5. Обычно предопределенные исключения возбуждаются неявно исполнительной системой. Однако такие исключения можно возбуждать и предложением RAISE. Пользовательские исключения возбуждаются только явно, посредством RAISE. Синтаксис --------- raise_предложение ::= -------- RAISE ---T--------------------T---- ; --------------------- L-- имя_исключения --- Ключевые слова и параметры -------------------------- имя_исключения Этот идентификатор именует возбуждаемое исключение. Он должен быть именем либо предопределенного, либо пользовательского исключения, объявленного через ОБЪЯВЛЕНИЕ_ИСКЛЮЧЕНИЯ. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. Перечень предопределенных исключений приведен в разделе "Обработчики исключений" выше в этой главе. Замечания по использованию -------------------------- Блоки и подпрограммы PL/SQL должны возбуждать исключения лишь в тех случаях, когда встречается ошибка, делающая продолжение обработки невозможным или нежелательным. Вы можете закодировать предложение RAISE для данного исключения в любом месте внутри сферы этого исключения. Если вы возбуждаете исключение, а в текущем блоке PL/SQL нет обработчика для этого исключения, то данное исключение продвигается в блок, окружающий текущий блок. Этот процесс повторяется, пока не будет найден обработчик для данного исключения, или пока не будут исчерпаны окружающие блоки. В последнем случае возникает ошибка "необрабатываемое исключение", и управление возвращается в ту среду, из которой был вызван блок PL/SQL. Предложение RAISE можно также использовать без имени исключения. Это допускается только в обработчике исключений, и приводит к повторному возбуждению текущего исключения. PL/SQL ищет подходящий обработчик исключений в окружающих блоках, начиная с того блока, который окружает текущий блок, а не с текущего блока. 9-92 Руководство пользователя и справочник по PL/SQL  Примеры ------- IF quantity_on_hand = 0 THEN RAISE out_of_stock; END IF; Как показывает следующий пример, предопределенное исключение также можно возбуждать явно: RAISE INVALID_NUMBER; Связанные темы -------------- Исключения Элементы языка 9-93  ---------------- Записи Описание -------- Записи - это объекты типа RECORD. Записи состоят из уникально поименованных полей, в которых могут храниться данные разных типов. Для дополнительной информации см. раздел "Пользовательские записи" в главе 2. Записи должны объявляться за два шага. Сначала определяется (поименованный) тип RECORD, а затем объявляются пользовательские записи этого типа. Синтаксис --------- объявление_записи ::= тип_записи + запись тип_записи ::= ------ TYPE ----- имя_типа ----- IS ---- RECORD --------------------- -------------------- , ----------------------¬ ---- ( ---- имя_поля ---- тип_данных--T------------T-+-- ) --- ; -- L- NOT NULL -- где ТИП_ДАННЫХ имеет следующий синтаксис: ----------------------T-- тип_поля ---------------T----------------- +-- переменная%TYPE --------+ +-- таблица.столбец%TYPE ---+ L-- таблица%ROWTYPE --------- запись ::= --------------- имя_записи --- тип_записи ---- ; ------------------- Ключевые слова и параметры -------------------------- имя_типа Этот идентификатор именует спецификатор пользовательского типа записи и используется в последующих объявлениях записей. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. имя_поля Этот идентификатор именует поле в пользовательской записи. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. тип_поля Специфицирует тип данных поля в пользовательской записи. Это может быть любой тип данных, включая RECORD и TABLE. Для дополнительной информации см. раздел "Типы данных" в главе 2. 9-94 Руководство пользователя и справочник по PL/SQL  таблица.столбец Ссылка на таблицу и столбец, которые должны быть доступны в момент обработки объявления. таблица Ссылка на таблицу, которая должна быть доступна в базе данных в момент обработки объявления. NOT NULL Это ограничение предотвращает присваивание полю пустых значений. При попытке присвоить такому полю пустое значение возбуждается предопределенное исключение VALUE_ERROR. имя_записи Этот идентификатор именует пользовательскую запись. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. Замечания по использованию -------------------------- Вы можете объявлять типы RECORD в декларативной части любого блока, подпрограммы или пакета. Более того, запись может быть инициализирована в своем объявлении, как показывает следующий пример: DECLARE TYPE TimeTyp IS RECORD (second SMALLINT := 0, minute SMALLINT := 0, hour SMALLINT := 0); ... Следующий пример показывает, что вы можете использовать атрибут %TYPE, чтобы специфицировать тип данных для поля. Из него также видно, что вы можете применить ограничение NOT NULL к объявлению любого поля, чтобы предотвратить присваивание пустых значений полю: DECLARE TYPE DeptRecTyp IS RECORD (deptno NUMBER(2) NOT NULL, dname dept.dname%TYPE, loc dept.loc%TYPE); dept_rec DeptRecTyp; ... Элементы языка 9-95  Чтобы обращаться к индивидуальным полям в записи, вы используете квалифицированные ссылки. Например, чтобы присвоить значение полю dname в записи dept_rec, вы можете написать: dept_rec.dname := 'PURCHASING'; Вместо присваивания значений отдельным полям записи можно присвоить значения сразу всем полям в записи. Это можно сделать двумя способами. Во-первых, вы можете присвоить одну запись другой, если обе записи принадлежат одному и тому же типу. Заметим, однако, что даже при полном совпадении полей пользовательская запись и запись %ROWTYPE принадлежат разным типам. Во-вторых, вы можете присвоить записи список значений столбцов при помощи предложения SELECT или FETCH. Вы должны лишь обеспечить, чтобы имена столбцов появлялись в том же порядке, что и поля в вашей записи. PL/SQL позволяет вам объявлять и ссылаться на ВЛОЖЕННЫЕ записи. Иными словами, запись может быть компонентой другой записи, как показывает следующий пример: DECLARE TYPE TimeTyp IS RECORD (minute SMALLINT, hour SMALLINT); TYPE MeetingTyp IS RECORD (day DATE, time TimeTyp, -- вложенная запись place CHAR(20), purpose CHAR(50)); TYPE PartyTyp IS RECORD (day DATE, time TimeTyp, -- вложенная запись loc CHAR(15)); meeting MeetingTyp; seminar MeetingTyp; party PartyTyp; ... Следующий пример показывает, что вы можете присваивать одну вложенную запись другой, если обе они принадлежат одному типу: seminar.time := meeting.time; Такие присваивания разрешаются даже в тех случаях, когда содержащие записи относятся к разным типам данных, как показывает следующий пример: party.time := meeting.time; 9-96 Руководство пользователя и справочник по PL/SQL  Пользовательские записи подчиняются обычным правилам сферы и инстанциации. В пакете, записи инстанциируются при первом обращении к этому пакету, и перестают существовать, когда вы выходите из приложения или заканчиваете сессию базы данных. В блоке или подпрограмме, записи инстанциируются при входе в блок или подпрограмму, и перестают существовать, когда вы выходите из блока или подпрограммы. Как и скалярные переменные, пользовательские записи могут объявляться как формальные параметры процедур и функций. Ограничения, применимые к скалярным параметрам, применяются и к пользовательским записям. Примеры ------- В следующем примере вы объявляете тип RECORD с именем DeptRecTyp и запись этого типа с именем dept_rec, а затем выбираете строку значений в эту запись: DECLARE TYPE DeptRecTyp IS RECORD (deptno NUMBER(2), dname CHAR(14), loc CHAR(13)); dept_rec DeptRecTyp; ... BEGIN SELECT deptno, dname, loc INTO dept_rec FROM dept WHERE deptno = 20; ... END; Связанные темы -------------- Предложение присваивания, Функции, Таблицы PL/SQL, Процедуры Элементы языка 9-97  ---------------- Предложение RETURN Описание -------- Предложение RETURN немедленно завершает выполнение подпрограммы и возвращает управление вызывающей программе. Выполнение продолжается с предложения, следующего за вызовом подпрограммы. В функции, предложение RETURN также присваивает результирующее значение идентификатору функции. (Не путайте предложение RETURN с фразой RETURN, которая специфицирует тип данных результирующего значения в спецификации функции.) Для дополнительной информации обратитесь к разделу "Функции" в главе 6. Синтаксис --------- return_предложение ::= ----------- RETURN ---T----------------------T--- ; ---------------- L-- plsql_выражение ---- Ключевые слова и параметры -------------------------- plsql_выражение Это - выражение произвольной сложности, вычисляемое при выполнении предложения RETURN. Синтаксис PLSQL_ВЫРАЖЕНИЯ определен в разделе "Выражения" выше в этой главе. Значение plsql_выражения присваивается идентификатору функции. Тип данных plsql_выражения должен быть совместимым с типом данных, указанном в фразе RETURN в спецификации функции. Для дополнительной информации см. раздел "Преобразование типов данных" в главе 2. Замечания по использованию -------------------------- Подпрограмма может содержать несколько предложений RETURN, ни одно из которых не обязано быть последним лексическим предложением в подпрограмме. Выполнение любого из них немедленно завершает подпрограмму. Однако наличие в подпрограмме нескольких точек выхода не является хорошей практикой программирования. В процедурах предложение RETURN не может содержать выражение. Это предложение просто возвращает управление вызывающей программе до достижения нормального конца процедуры. Однако в функциях предложение RETURN ДОЛЖНО содержать выражение, которое вычисляется при выполнении предложения RETURN. Результирующее значение присваивается идентификатору функции. Поэтому функция должна содержать хотя бы одно предложение RETURN. В противном случае PL/SQL возбуждает предопределенное исключение PROGRAM_ERROR во время выполнения. 9-98 Руководство пользователя и справочник по PL/SQL  Предложение RETURN можно также использовать в анонимном блоке для немедленного выхода из этого и всех окружающих блоков. Однако в этом случае предложение RETURN не может содержать выражения. Пример ------ В следующем примере функция balance возвращает баланс заданного бухгалтерского счета: FUNCTION balance (acct_id NUMBER) RETURN REAL IS acct_bal REAL; BEGIN SELECT bal INTO acct_bal FROM accts WHERE acctno = acct_id; RETURN acct_bal; END balance; Элементы языка 9-99  ---------------- ROLLBACK Описание -------- Предложение ROLLBACK противоположно предложению COMMIT. Оно явно отменяет все или некоторые из изменений, внесенных в базу данных в течение текущей транзакции. Для дополнительной информации обратитесь к разделу "Обработка транзакций" в главе 4. Синтаксис --------- rollback_предложение ::= ------------------- ROLLBACK --T--------T---------------------------- L- WORK -- -----T----------------------------------T-T-------------------T- ; - L- TO -T-------------T- имя_точки -- L- COMMENT 'текст' -- L- SAVEPOINT -- Ключевые слова и параметры -------------------------- ROLLBACK Если предложение ROLLBACK закодировано без ключевого слова TO, выполняется откат всех изменений текущей транзакции. WORK Это ключевое слово необязательно и не оказывает никакого эффекта. ROLLBACK TO имя_точки ROLLBACK TO отменяет все изменения, внесенные в базу данных после выполнения предложения SAVEPOINT с этим именем точки сохранения, и снимает соответствующие блокировки. Идентификатор ИМЯ_ТОЧКИ должен быть именем точки сохранения, которая была ранее создана в текущей транзакции предложением SAVEPOINT. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. SAVEPOINT Это ключевое слово необязательно и не оказывает никакого эффекта. COMMENT Ключевое слово COMMENT задает комментарий, ассоциируемый с текущей транзакцией и обычно используемый в распределенных транзакциях. Текст комментария должен быть литералом в апострофах длиной не более 50 символов. 9-100 Руководство пользователя и справочник по PL/SQL  Замечания по использованию -------------------------- Все точки сохранения, которые были созданы после той точки, к которой вы выполняете откат, стираются. Однако сама точка, к которой выполняется откат, не стирается. Например, если вы создаете точки сохранения A, B, C и D (в этом порядке), а потом выполняете ROLLBACK TO B, то стираются лишь точки C и D. Перед выполнением каждого предложения INSERT, UPDATE и DELETE создается неявная точка сохранения. Если предложение сбивается, то выполняется откат к этой неявной точке. Обычно отменяется лишь сбившееся предложение SQL, а не вся транзакция. Однако, если это предложение возбудило необрабатываемое исключение, то хост-окружение определяет, что следует отменить. Для более подробной информации обратитесь к разделу "Необрабатываемые исключения" в главе 5. Когда распределенная транзакция сбивается, текст, заданный в фразе COMMENT, помогает вам диагностировать проблему. При любом сомнении в успехе транзакции ORACLE сохраняет этот текст в словаре данных вместе с идентификатором транзакции. Для дополнительной информации о распределенных транзакциях см. документ ORACLE7 Server Application Developer's Guide. Связанные темы -------------- COMMIT, SAVEPOINT Элементы языка 9-101  ---------------- Атрибут %ROWCOUNT Описание -------- Курсоры PL/SQL имеют четыре атрибута, включая %ROWCOUNT. Эти атрибуты, присоединяемые к имени курсора, помогают обращаться к полезной информации курсора. Для дополнительной информации см. раздел "Управление курсорами" в главе 4. PL/SQL использует два типа курсоров: явные и неявные. PL/SQL неявно объявляет курсор (с именем SQL) для любого предложения манипулирования данными SQL, включая однострочные запросы. Перед выполнением первого предложения SQL, не ассоциированного с явным курсором, SQL%ROWCOUNT дает NULL. Впоследствии, этот атрибут возвращает число строк, затронутых операцией INSERT, UPDATE или DELETE, либо возвращенных операцией SELECT INTO. %ROWCOUNT возвращает 0, если операция INSERT, UPDATE или DELETE не затронула ни одной строки, или если операция SELECT INTO не вернула ни одной строки. В случае многострочных предложений SELECT вы можете явно объявить курсор для обработки возвращаемых строк. После открытия курсора, но до выполнения первой операции FETCH, атрибут ИМЯ_КУРСОРА%ROWCOUNT дает 0. После каждой операции FETCH этот атрибут увеличивается, если операция вернула очередную строку данных. Синтаксис --------- атрибут_%rowcount ::= --------------------- имя_курсора%ROWCOUNT ------------------------- Ключевые слова и параметры -------------------------- имя_курсора Этот идентификатор должен быть именем явно объявленного курсора или именем неявного курсора (SQL). Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. 9-102 Руководство пользователя и справочник по PL/SQL  Замечания по использованию -------------------------- Вы можете использовать атрибут %ROWCOUNT в процедурных предложениях, но НЕ в предложениях SQL. Атрибут %ROWCOUNT ассоциирован с каждым явным курсором. Это позволяет вам открыть одновременно несколько курсоров и в каждый момент времени знать, сколько строк извлечено из их активных множеств. Если курсор не открыт, обращение к нему через атрибут %ROWCOUNT возбуждает предопределенное исключение INVALID_CURSOR. Если операция SELECT INTO возвращает более одной строки, возбуждается предопределенное исключение TOO_MANY_ROWS, и %ROWCOUNT будет иметь значение 1, но не истинное значение строк, удовлетворяющих запросу. Примеры ------- Блок в следующем примере возвращает имя, номер и жалованье для пяти самых высокооплачиваемых сотрудников: -- доступен на диске в файле EXAMP14 DECLARE CURSOR c1 IS SELECT ename, empno, sal FROM emp ORDER BY sal DESC; -- начать с наибольшего жалованья my_ename CHAR(10); my_empno NUMBER(4); my_sal NUMBER(7,2); BEGIN OPEN c1; LOOP FETCH c1 INTO my_ename, my_empno, my_sal; EXIT WHEN (c1%ROWCOUNT > 5) OR (c1%NOTFOUND); INSERT INTO temp VALUES (my_sal, my_empno, my_ename); COMMIT; END LOOP; CLOSE c1; END; В следующем примре %ROWCOUNT используется, чтобы возбудить исключение, если удалено неожиданно большое число строк. DELETE FROM accounts WHERE status = 'BAD DEPT'; IF SQL%ROWCOUNT > 10 THEN RAISE out_of_bounds; END IF; Связанные темы -------------- CLOSE, Курсоры, DELETE, FETCH, INSERT, OPEN, SELECT INTO, UPDATE Элементы языка 9-103  ---------------- Атрибут %ROWTYPE Описание -------- Атрибут %ROWTYPE используется для того, чтобы объявить переменную-запись с такой же структурой, как у строки таблицы или обзора, или у строки, возвращаемой курсором. Такая строка представляется записью, поля которой имеют такие же имена и типы данных, что и столбцы таблицы или обзора, или столбцы, возвращаемые курсором. Этот атрибут используется в ОБЪЯВЛЕНИИ_ПЕРЕМЕННОЙ как тип данных объявляемой переменной. Переменные, объявленные со спецификатором %ROWTYPE, рассматриваются так же, как переменные, объявленные с явным типом данных. Для дополнительной информации обратитесь к разделу "Использование %ROWTYPE" в главе 2. Синтаксис --------- атрибут_%rowtype ::= --------------------- идентификатор%ROWTYPE ------------------------ Ключевые слова и параметры -------------------------- идентификатор Этот параметр должен специфицировать имя курсора, ранее объявленного в этом блоке. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. Альтернативно, этот идентификатор может именовать таблицу или обзор в базе данных. Вы можете квалифицировать имя таблицы именем владельца (ВЛАДЕЛЕЦ.ИМЯ). Таблица должна быть доступна во время обработки объявления. Замечания по использованию -------------------------- Атрибут %ROWTYPE позволяет вам объявлять записи, структурированные как строки данных в таблице базы данных. В следующем примере вы объявляете запись, которая может хранить целую строку из таблицы emp: emp_rec emp%ROWTYPE; Значения столбцов строки, возвращаемые предложением SELECT, записываются в индивидуальные поля записи. Вы обращаетесь к конкретному полю, используя квалифицированные ссылки. Например, вы могли бы обратиться к полю deptno следующим образом: IF emp_rec.deptno = 20 THEN ... Вы можете присваивать значение выражения PL/SQL конкретному полю, как показывает следующий пример: emp_rec.sal := average * 1.15; 9-104 Руководство пользователя и справочник по PL/SQL  Есть два способа присвоить значения сразу всем полям записи. Во-первых, PL/SQL разрешает агрегатные присваивания между целыми записями, если их объявления ссылаются на одну и ту же таблицу или курсор. Во-вторых, вы можете присвоить записи список значений столбцов, используя предложения SELECT INTO или FETCH. Имена столбцов должны появляться в том порядке, в каком они были объявлены в предложениях CREATE TABLE или CREATE VIEW при создании таблицы или обзора. Каждый столбец из строки, извлекаемой операцией FETCH из курсора, ассоциированного с атрибутом %ROWTYPE, должен именоваться простым идентификатором, или, если это выражение, должен иметь алиас. Примеры ------- В следующем примере вы используете %ROWTYPE, чтобы объявить две записи. Первая запись хранит строки, выбираемые из таблицы emp, вторая - строки, извлекаемые курсором c1. DECLARE emp_rec emp%ROWTYPE; CURSOR c1 IS SELECT deptno, dname, loc FROM dept; dept_rec c1%ROWTYPE; ... В следующем примере вы выбираете строку из таблицы emp в запись %ROWTYPE: DECLARE emp_rec emp%ROWTYPE; ... BEGIN SELECT * INTO emp_rec FROM emp WHERE empno = my_empno; IF (emp_rec.deptno = 20) AND (emp_rec.sal > 2000) THEN ... END IF; END; Связанные темы -------------- Курсоры, Переменные и константы Элементы языка 9-105  ---------------- SAVEPOINT Описание -------- SAVEPOINT именует и отмечает текущую точку в ходе обработки транзакции. Точки сохранения, используемые в предложениях ROLLBACK TO, позволяют вам отменять части транзакций, а не полные транзакции. Для дополнительной информации обратитесь к разделу "Обработка транзакций" в главе 4. Синтаксис --------- savepoint_предложение ::= ------------ SAVEPOINT ----- имя_точки_сохранения ---- ; ----------- Ключевые слова и параметры -------------------------- имя_точки_сохранения Этот необъявляемый идентификатор обозначает имя, которое вы даете текущей точке в ходе вашей транзакции. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. Замечания по использованию -------------------------- При откате к точке сохранения (ROLLBACK TO) все точки сохранения, созданные после данной точки, стираются. Однако сама точка, к которой выполняется откат, не стирается. ROLLBACK без аргумента и COMMIT стирают все точки сохранения. Если вы создаете точку сохранения в рекурсивной подпрограмме, на каждом уровне рекурсивного спуска будут выполняться новые экземпляры предложения SAVEPOINT. Однако ROLLBACK TO всегда осуществляет откат к самой последней точке сохранения с данным именем. Имена точек сохранения можно повторно использовать внутри одной и той же транзакции. Это перемещает запомненную точку сохранения со старой позиции на текущую точку в транзакции. Перед выполнением предложения INSERT, UPDATE или DELETE ORACLE создает неявную точку сохранения. Если предложение сбивается, выполняется откат к этой неявной точке. Обычно откатывается лишь сбившееся предложение SQL, а не вся транзакция. Однако, если предложение возбудило необрабатываемое исключение, то хост-окружение само определяет, что подлежит откату. Для дополнительной информации см. раздел "Необработанные исключения" в главе 5. Число точек сохранения, допускаемых в одной транзакции, по умолчанию равно 5. Ваш АБД может поднять этот лимит (до 255), увеличив значение параметра инициализации ORACLE SAVEPOINTS. Связанные темы -------------- COMMIT, ROLLBACK 9-106 Руководство пользователя и справочник по PL/SQL  ---------------- SELECT INTO Описание -------- Предложение SELECT INTO извлекает данные из одной или нескольких баз данных и помещает их в одну или несколько переменных. Для полного описания предложения SELECT обратитесь к документу ORACLE7 Server SQL Language Reference Manual. Синтаксис --------- select_into_предложение ::= ------------ , -------------------------¬ -- SELECT -- элемент_списка_select --T---------T--+----------------- L- алиас -- -------- , --------¬ ------ INTO --T-- имя_переменной -+-T------------------------------- L--- имя_записи -------- ---------- , ---------¬ --- FROM -- ссылка_на_таблицу -+- остаток_select_предложения -- ; -- где ССЫЛКА_НА_ТАБЛИЦУ имеет следующий синтаксис: ------------T----------T-----T- таблица -T-----T------------T------- L- схема. -- L- обзор ---- L- @связьБД -- Ключевые слова и параметры -------------------------- элемент_списка_select Этот параметр задает значение, выбираемое предложением SELECT INTO и помещаемое в соответствующую переменную или запись. INTO имя_переменной Этот параметр определяет скалярные переменные, в которые помещаются выбираемые данные. Все переменные в списке ИМЕН_ПЕРЕМЕННЫХ должны быть заранее объявлены. Для каждого ЭЛЕМЕНТА_СПИСКА_SELECT должна быть соответствующая переменная в списке ИМЕН_ПЕРЕМЕННЫХ. Кроме того, типы данных соответствующих друг другу ЭЛЕМЕНТОВ_СПИСКА_SELECT и ИМЕН_ПЕРЕМЕННЫХ должны быть совместимыми (или преобразуемыми друг к другу). Для дополнительной информации обратитесь к разделу "Преобразование типов данных" в главе 2. Элементы языка 9-107  INTO имя_записи Этот параметр указывает, что выбираемые данные должны быть помещены в переменную-запись, которая была объявлена через атрибут %ROWTYPE, как в следующем примере: DECLARE dept_rec dept%ROWTYPE; ... BEGIN SELECT deptno, dname, loc INTO dept_rec FROM dept WHERE deptno = 20; ... END; С помощью конструкта ИМЯ_ЗАПИСИ.ИМЯ_СТОЛБЦА вы можете затем обращаться к данным, возвращенным запросом для каждого столбца. Например, department_rec.deptno ссылается на данные, возвращенные для столбца deptno. ссылка_на_таблицу Таблица (или обзор) должна существовать в базе данных, с которой вы соединены во время выполнения предложения SELECT INTO. остаток_select_предложения Этот параметр обозначает что угодно, что может синтаксически законно следовать за фразой FROM в предложении SELECT. Замечания по использованию -------------------------- Неявный курсор SQL% и атрибуты курсора %NOTFIUND, %FOUND, %ROWCOUNT и %ISOPEN позволяют вам получать полезную информацию о выполнении предложения SELECT INTO. Для подробностей обратитесь к разделу "Управление курсорами" в главе 4. Предложение SELECT INTO должно возвращать ровно одну строку из таблицы. Если это предложение возвращает несколько строк, происходит следующее: * возбуждается предопределенное исключение TOO_MANY_ROWS * SQLCODE возвращает -1422 (код ошибки ORACLE ORA-01422) * SQLERRM возвращает ошибку ORACLE "однострочный запрос возвращает более одной строки" * SQL%NOTFOUND дает FALSE * SQL%FOUND дает TRUE * SQL%ROWCOUNT возвращает число 1 9-108 Руководство пользователя и справочник по PL/SQL  Если не возвращено ни одной строки, происходит следующее: * возбуждается предопределенное исключение NO_DATA_FOUND, если предложение SELECT не обращалось к групповой функции SQL (см. замечание ниже) * SQLCODE возвращает +100 (код ошибки ORACLE ORA-01403) * SQLERRM возвращает ошибку ORACLE "данные не найдены" * SQL%NOTFOUND дает TRUE * SQL%FOUND дает FALSE * SQL%ROWCOUNT возвращает число 0 Групповые функции SQL, такие как AVG и SUM, ВСЕГДА возвращают значение, даже если это значение есть NULL. Поэтому операция SELECT, вызывающая групповую функцию, НИКОГДА не возбудит исключение NO_DATA_FOUND, ибо какое-то значение будет всегда "найдено". Пример ------ SELECT ename, job, sal*1.1 INTO my_ename, my_job, wages FROM emp WHERE empno = my_empno; Связанные темы -------------- Предложение присваивания, FETCH, %ROWTYPE Элементы языка 9-109  ---------------- SET TRANSACTION Описание -------- Предложение SET TRANSACTION позволяет вам установить транзакцию в режиме только-чтения, что позволяет запросу опрашивать несколько таблиц, тогда как другие пользователи одновременно обновляют эти таблицы. Для дополнительной информации обратитесь к разделу "Использование SET TRANSACTION" в главе 4. Синтаксис --------- set_transaction_предложение ::= ----------- SET TRANSACTION ---- READ ONLY ---- ; ------------------ Ключевые слова и параметры -------------------------- READ ONLY Этот параметр обязателен. Когда транзакция установлена в этот режим, последующие запросы видят лишь то состояние базы данных, которое было в момент начала транзакции. Использование этого режима не влияет на других пользователей и другие транзакции. Замечания по использованию -------------------------- Предложение SET TRANSACTION должно быть первым предложением SQL в транзакции и может встретиться в транзакции лишь один раз. Далее, в этом режиме транзакции можно использовать только предложения SELECT, COMMIT и ROLLBACK. Например, предложение INSERT или DELETE возбудит исключение. Пример ------ COMMIT; SET TRANSACTION READ ONLY; SELECT ... FROM emp WHERE ... SELECT ... FROM dept WHERE ... SELECT ... FROM emp WHERE ... COMMIT; Связанные темы -------------- COMMIT, ROLLBACK, SAVEPOINT 9-110 Руководство пользователя и справочник по PL/SQL  ---------------- Курсор SQL ORACLE неявно открывает курсор для обработки каждого предложения SQL, не ассоциированного с явным курсором. PL/SQL позволяет вам обращаться к самому последнему неявно открывавшемуся курсору как к курсору "SQL". Курсор SQL имеет четыре атрибута: %NOTFOUND, %FOUND, %ROWCOUNT и %ISOPEN. В сочетании с именем курсора (SQL) эти атрибуты дают информацию о выполнении последней операции INSERT, UPDATE, DELETE и SELECT INTO. Для дополнительной информации см. раздел "Управление курсорами" в главе 4. Синтаксис --------- sql_курсор ::= -------------- SQL ----------T-- %NOTFOUND --T---------------------- +-- %FOUND -----+ +-- %ROWCOUNT --+ L-- %ISOPEN ----- Ключевые слова и параметры -------------------------- %NOTFOUND Перед выполнением первого предложения SQL, не ассоциированного с явным курсором, SQL%NOTFOUND дает NULL. Впоследствии, этот атрибут дает TRUE, если операция INSERT, UPDATE или DELETE не затронула ни одной строки, или если операция SELECT INTO не вернула ни одной строки. В последнем случае возбуждается предопределенное исключение NO_DATA_FOUND, если в операции SELECT INTO не использовалась групповая функция SQL. Однако, если операция SELECT INTO вызывает групповую функцию SQL, исключение NO_DATA_FOUND никогда не возбуждается, ибо групповые функции всегда возвращают значение (даже пустое). В таких случаях случае SQL%NOTFOUND всегда дает FALSE. %FOUND SQL%FOUND логически противоположен атрибуту SQL%NOTFOUND. Перед выполнением первого предложения SQL, не ассоциированного с явным курсором, SQL%FOUND дает NULL. Впоследствии, этот атрибут дает TRUE, если операция INSERT, UPDATE или DELETE затронула хотя бы одну строку, или если операция SELECT INTO вернула хотя бы одну строку. В противном случае SQL%FOUND дает FALSE. %ROWCOUNT SQL%ROWCOUNT возвращает число строк, затронутых операцией INSERT, UPDATE или DELETE либо возвращенных операцией SELECT INTO. %ISOPEN ORACLE автоматически закрывает курсор SQL после выполнения ассоциированного с ним предложения SQL. Как результат, атрибут SQL%ISOPEN всегда дает FALSE. Элементы языка 9-111  Замечания по использованию -------------------------- Вы можете использовать атрибуты курсора в процедурных предложениях, но НЕ в предложениях SQL. Перед выполнением первого предложения SQL, не ассоциированного с явным курсором, все атрибуты неявного курсора дают NULL. Значения атрибутов курсора SQL всегда ссылаются на последнее выполненное предложение SQL, не ассоциированное с явным курсором, сколь бы давно и где бы это предложение не было выполнено. Не забывайте, что SQL% всегда подразумевает именно последнее такое предложение, даже если оно исполнялось в другой сфере (скажем, во вложенном блоке). Поэтому, если вы хотите сохранить значение такого атрибута для последующего использования, немедленно присвойте его булевской переменной. Примеры ------- В следующем примере %NOTFOUND используется, чтобы вставить строку в случае неуспеха обновления: UPDATE emp SET sal = sal * 1.05 WHERE empno = my_empno; IF SQL%NOTFOUND THEN INSERT INTO emp VALUES (my_empno, my_ename, ...); END IF; В следующем примере SQL%ROWCOUNT используется, чтобы предпринять действие, если удалено более 100 строк: DELETE FROM parts WHERE status = 'OBSOLETE'; IF SQL%ROWCOUNT > 100 THEN ... -- удалено больше 100 строк END IF; Связанные темы -------------- %FOUND, %NOTFOUND, %ISOPEN, %ROWCOUNT 9-112 Руководство пользователя и справочник по PL/SQL  ---------------- SQLCODE Описание -------- Функция SQLCODE возвращает номер, ассоциированный с последним возбужденным исключением. Эту функцию имеет смысл использовать только в обработчике исключений. Вне обработчика SQLCODE всегда возвращает 0. Для внутренне определенных исключений, SQLCODE возвращает номер ошибки ORACLE, передавшей управление обработчику. Этот номер отрицателен, исключая случай ошибки ORACLE "no data found", когда SQLCODE возвращает +100. Для пользовательских исключений, SQLCODE возвращает +1, если вы не использовали прагму EXCEPTION_INIT, чтобы ассоциировать ваше исключение с номером ошибки ORACLE; в этом случае SQLCODE возвращает этот номер ошибки. Для дополнительной информации обратитесь к разделу "Использование SQLCODE и SQLERRM" в главе 5. Синтаксис --------- функция_sqlcode ::= ------------------------ SQLCODE ----------------------------------- Замечания по использованию -------------------------- Нельзя использовать функцию SQLCODE непосредственно в предложениях SQL. Например, следующее предложение НЕКОРРЕКТНО: INSERT INTO errors VALUES (SQLCODE, ...); Вместо этого вы должны присвоить значение этой функции локальной переменной, а затем использовать эту переменную в вашем предложении SQL, как показано ниже: DECLARE my_sqlcode NUMBER; BEGIN ... EXCEPTION ... WHEN OTHERS THEN my_sqlcode := SQLCODE; INSERT INTO errors VALUES (my_sqlcode, ...); END; Функция SQLCODE особенно полезна в обработчике исключений OTHERS, потому что она позволяет установить, какое внутреннее исключение было возбуждено. Связанные темы -------------- Исключения, SQLERRM Элементы языка 9-113  ---------------- SQLERRM Описание -------- Функция SQLERRM возвращает сообщение об ошибке, ассоциированное с указанным номером ошибки, или, если аргумент опущен, с текущим значением SQLCODE. SQLERRM без аргумента имеет смысл только в обработчике исключений. Вне обработчика, т.е. если не возбуждено никакое исключение, SQLERRM возвращает сообщение ORA-0000: normal, successful completion Для внутренне определенных исключений SQLERRM возвращает сообщение, ассоциированное с возникшей ошибкой ORACLE. Это сообщение начинается с кода ошибки ORACLE. Для пользовательских исключений SQLERRM возвращает сообщение User-Defined Exception если вы не использовали прагму EXCEPTION_INIT, чтобы ассоциировать ваше исключение с номером ошибки ORACLE; в этом случае SQLERRM возвращает соответствующее сообщение об ошибке. Для дополнительной информации обратитесь к разделу "Использование SQLCODE и SQLERRM" в главе 5. Синтаксис --------- функция_sqlerrm ::= ------------------ SQLERRM ---T--------------------T---------------- L-- (номер_ошибки) --- Ключевые слова и параметры -------------------------- номер_ошибки Этот аргумент должен быть действительным номером ошибки ORACLE. Для перечня номеров ошибок ORACLE обратитесь к документу ORACLE7 Server Messages and Codes Manual. 9-114 Руководство пользователя и справочник по PL/SQL  Замечания по использованию -------------------------- Вы можете передать функции SQLERRM номер ошибки; в этом случае SQLERRM возвратит сообщение, ассоциированное с этим номером ошибки. Номер ошибки, передаваемый SQLERRM, должен быть отрицателен. Нулевой код, передаваемый SQLERRM, всегда возвращает сообщение ORA-0000: normal, successful completion Передача SQLERRM положительного номера ошибки (за исключением +100) всегда возвратит сообщение User-Defined Exception а передача SQLERRM кода +100 возвратит сообщение ORA-01403: no data found Нельзя использовать функцию SQLERRM непосредственно в предложениях SQL. Например, следующее предложение НЕКОРРЕКТНО: INSERT INTO errors VALUES (SQLERRM, ...); Вместо этого вы должны присвоить значение этой функции локальной переменной, а затем использовать эту переменную в вашем предложении SQL, как показано ниже: DECLARE my_sqlerrm CHAR(100); ... BEGIN ... EXCEPTION ... WHEN OTHERS THEN my_sqlerrm := SUBSTR(SQLERRM, 1, 150); INSERT INTO errors VALUES (my_sqlerrm, ...); END; Строковая функция SUBSTR() гарантирует, что возможное усечение при присваивании переменной my_sqlerrm не возбудит исключения VALUE_ERROR. Функция SQLERRM особенно полезна в обработчике исключений OTHERS, потому что она позволяет установить, какое внутреннее исключение было возбуждено. Связанные темы -------------- Исключения, SQLCODE Элементы языка 9-115  ---------------- Атрибут %TYPE Описание -------- Атрибут %TYPE служит для того, чтобы объявить переменную с тем же типом, что у столбца таблицы или обзора, либо у ранее объявленной переменной или константы PL/SQL. Этот атрибут используется как тип данных в ОБЪЯВЛЕНИИ_ПЕРЕМЕННОЙ или ОБЪЯВЛЕНИИ_КОНСТАНТЫ. Переменные или константы, объявленные со спецификатором типа %TYPE, рассматриваются так, как если бы они были объявлены с явным именем типа. Для дополнительной информации см. раздел "Использование %TYPE" в главе 2. Синтаксис --------- атрибут_%type ::= ----------T-- имя_переменной ------------------------T- %TYPE ------ L---T---------------T--- таблица.столбец --- L-- владелец. --- Ключевые слова и параметры -------------------------- имя_переменной Этот идентификатор должен быть именем переменной или константы PL/SQL, ранее объявленной в данном блоке. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. владелец. Этот параметр должен ссылаться на владельца таблицы или обзора, который должен быть доступен в момент обработки объявления. таблица.столбец Этот параметр должен ссылаться на столбец таблицы (или обзора), существующей в базе данных, к которой вы присоединены в момент обработки объявления. Замечания по использованию -------------------------- Атрибут %TYPE особенно полезен при объявлении переменных, ссылающихся на столбцы базы данных. Вы можете сослаться на таблицу и столбец, либо на владельца, таблицу и столбец. Кроме того, объявление с атрибутом %TYPE может включать фразу инициализации, как показывает следующий пример: my_comm scot.emp.comm%TYPE DEFAULT 0.0; 9-116 Руководство пользователя и справочник по PL/SQL  Однако ограничение столбца NOT NULL НЕПРИМЕНИМО к переменным, объявленным через атрибут %ROWTYPE. В следующем примере, несмотря на то, что столбец базы данных empno определен как NOT NULL, вы можете присваивать пустые значения переменной my_empno: DECLARE my_empno emp.empno%TYPE; ... BEGIN my_empno := NULL; -- это работает ... END; Связанные темы -------------- %ROWTYPE, переменные и константы Элементы языка 9-117  ---------------- UPDATE Описание -------- UPDATE изменяет значения указанных столбцов в одной или нескольких строках таблицы или представления. Для полного описания предложения UPDATE обратитесь к документу ORACLE7 Server SQL Language Reference Manual. Синтаксис --------- update_предложение ::= ----------- UPDATE ----- ссылка_на_таблицу -----T---------T---------- L- алиас -- ------------------------- , --------------------------¬ -- SET --T-- имя_столбца --- = ---T-- sql_выражение ----------T-+--T- ¦ L-- (однострочное_select) --- ¦ ¦ ------- , ------¬ ¦ L- ( -- имя_столбца -+- ) --- = --- (select_предложение) -- ---------T--------------------------------------------T--- ; -------- L-- WHERE --T-------- условие_поиска --------+ L-- CURRENT OF --- имя_курсора --- где ССЫЛКА_НА_ТАБЛИЦУ имеет следующий синтаксис: ------------T----------T-----T- таблица -T-----T------------T------- L- схема. -- L- обзор ---- L- @связьБД -- Ключевые слова и параметры -------------------------- ссылка_на_таблицу Таблица (или обзор), специфицируемая ССЫЛКОЙ_НА_ТАБЛИЦУ, должна существовать в базе данных, с которой вы соединены во время выполнения предложения UPDATE, и вы должны иметь привилегии UPDATE. алиас Это другое (обычно краткое) имя таблицы или обзора, обычно используемое в фразе WHERE. имя_столбца Этот параметр указывает обновляемый столбец. Он должен быть именем столбца в таблице (или обзоре), указываемой ССЫЛКОЙ_НА_ТАБЛИЦУ. Имена столбцов не должны повторяться в списке ИМЕН_СТОЛБЦОВ. Эти имена не обязаны появляться в предложении UPDATE в том порядке, в каком они определены в таблице или обзоре. 9-118 Руководство пользователя и справочник по PL/SQL  SET имя_столбца = sql_выражение Этот параметр присваивает столбцу значение SQL_ВЫРАЖЕНИЯ. Терм SQL_ВЫРАЖЕНИЕ обозначает здесь любое действительное выражение SQL. Если SQL_ВЫРАЖЕНИЕ содержит ссылки на столбцы обновляемой таблицы, то эти ссылки разрешаются в контексте текущей строки таблицы. Справа от знака равенства будут использоваться старые значения столбцов. В следующем примере вы увеличиваете жалованье каждого сотрудника на 10%. Исходное значение столбца sal умножается на 1.1, после чего результат записывается обратно в столбец sal. UPDATE emp SET sal = sal * 1.1; SET имя_столбца = однострочное_select Эта фраза присваивает значение, извлеченное из базы данных однострочным предложением SELECT, одиночному столбцу из списка ИМЕН_СТОЛБЦОВ. Синтаксис конструкта ОДНОСТРОЧНОЕ_SELECT совпадает с синтаксисом SELECT_INTO_ПРЕДЛОЖЕНИЯ, который определен в разделе "SELECT INTO" выше в этой главе, с той разницей, что данное предложение не может иметь фразы INTO и должно возвращать ровно одну строку и ровно один столбец. SET (имя_столбца, ...) = select_предложение Эта фраза присваивает значения, извлеченные из базы данных предложением SELECT, столбцам из списка ИМЕН_СТОЛБЦОВ. SELECT_ПРЕДЛОЖЕНИЕ должно возвращать ровно одну строку, включающую все столбцы, перечисленные в скобках слева от знака равенства. Синтаксис конструкта SELECT_ПРЕДЛОЖЕНИЕ совпадает с синтаксисом SELECT_INTO_ПРЕДЛОЖЕНИЯ, который определен в разделе "SELECT INTO" выше в этой главе, с той разницей, что данное предложение не может иметь фразы INTO. Значения столбцов, возвращенные SELECT_ПРЕДЛОЖЕНИЕМ, присваиваются столбцам по порядку, т.е. значение первого столбца присваивается первому столбцу из списка ИМЕН_СТОЛБЦОВ, второго - второму, и т.д. В следующем коррелированном запросе, столбец item_id получает значение, которое хранится в столбце item_id_num, а столбец price получает значение из столбца item_price. UPDATE inventory inv -- алиас SET (item_id, price) = (SELECT item_id_num, item_price FROM item_table WHERE item_name = inv.item_name); Элементы языка 9-119  WHERE условие_поиска УСЛОВИЕ_ПОИСКА описывает критерий выбора обновляемых строк таблицы. Обновляются лишь те строки, которые удовлетворяют УСЛОВИЮ_ПОИСКА. Если оно опущено, обновляются все строки. WHERE CURRENT OF имя_курсора Этот параметр ссылается на последнюю строку, извлеченную предложением FETCH, ассоциированным с курсором ИМЯ_КУРСОРА. Указанный курсор должен был быть объявлен с фразой FOR UPDATE OF, и должен быть открыт и позиционирован на строку. Если курсор не открыт, фраза WHERE CURRENT OF приведет к ошибке. Если курсор открыт, но еще не выполнялась ни одна операция FETCH или последняя операция FETCH не возвратила строку, то возбуждается предопределенное исключение NO_DATA_FOUND. Замечания по использованию -------------------------- Предложение UPDATE ... WHERE CURRENT OF ИМЯ_КУРСОРА можно использовать после операции FETCH на открытом курсоре, при условии, что соответствующий запрос был объявлен с фразой FOR UPDATE OF. Предложение UPDATE ... WHERE CURRENT OF ИМЯ_КУРСОРА обновляет текущую строку, т.е. строку, только что возвращенную операцией FETCH. Неявный курсор SQL и атрибуты курсора %NOTFOUND, %FOUND, %ROWCOUNT и %ISOPEN позволяют вам получать полезную информацию о выполнении предложения UPDATE. Для подробностей обратитесь к разделу "Управление курсорами" в главе 4. Предложение UPDATE может обновить одну или несколько строк, но может и не обновить ни одной строки. Если это предложение обновляет одну или несколько строк, происходит следующее: * SQL%NOTFOUND дает FALSE * SQL%FOUND дает TRUE * SQL%ROWCOUNT возвращает число обновленных строк Если не обновлено ни одной строки, происходит следующее: * SQL%NOTFOUND дает TRUE * SQL%FOUND дает FALSE * SQL%ROWCOUNT возвращает число 0 Примеры ------- В следующем примере, 10-процентная прибавка дается всем аналитикам и клеркам в отделе 20: UPDATE emp SET sal = sal * 1.10 WHERE (job = 'ANALYST' OR job = 'CLERK') AND deptno = 20; В следующем примере изменяется как должность, так и жалованье конкретного сотрудника: UPDATE emp SET job = 'ANALYST', sal = sal * 1.15 WHERE ename = 'FORD'; 9-120 Руководство пользователя и справочник по PL/SQL  ---------------- Переменные и константы Описание -------- Вы можете объявлять переменные и константы в декларативной части любого блока PL/SQL, подпрограммы или пакета. Объявление переменной распределяет память для хранения значений этой переменной, определяет ее тип данных и дает имя переменной, что позволяет обращаться к ее значению. Объявление может также присвоить начальное значение переменной и/или ограничение NOT NULL. Для дополнительной информации см. раздел "Объявления и присваивания" в главе 2. Синтаксис --------- объявление_переменной ::= -------- имя_переменной -----T--------------T------------------------ L-- CONSTANT --- ------T-- имя_типа --------------T-----T--------------T--------------- +-- переменная%TYPE -------+ L-- NOT NULL --- +-- таблица.столбец%TYPE --+ L-- таблица%ROWTYPE -------- --------T---------------------------------------T----- ; ------------ L--T---- := -----T-- plsql_выражение ---- L-- DEFAULT --- Ключевые слова и параметры -------------------------- имя_переменной Этот параметр является именем, которое вы даете переменной или константе. Соглашения об именах приведены в разделе "Идентификаторы" в главе 2. CONSTANT Ключевое слово CONSTANT обозначает, что вы объявляете константу, т.е. начальное значение переменной нельзя модифицировать. Для константы вы должны предоставить PLSQL_ВЫРАЖЕНИЕ, которое инициализирует ее значение. имя_типа Этот параметр специфицирует тип данных, хранящихся в переменной или константе. Для дополнительной информации см. раздел "Типы данных" в главе 2. Элементы языка 9-121  %TYPE Атрибут %TYPE представляет тип данных переменной, константы или столбца базы данных. таблица.столбец Ссылка на таблицу и столбец базы данных, которые должны быть доступны в момент обработки объявления. таблица Ссылка на таблицу базы данных, которая должна быть доступна в момент обработки объявления. %ROWTYPE Атрибут %ROWTYPE объявляет переменную-запись с полями, имеющими такие же имена и типы данных, что и столбцы таблицы или столбцы строки, извлекаемой курсором. NOT NULL NOT NULL объявляет, что переменная или константа не может иметь пустого значения. При попытке присвоить объекту значение NULL возбуждается предопределенное исключение VALUE_ERROR. Если вы используете фразу NOT NULL в объявлении переменной, то за ней должна следовать фраза инициализации. plsql_выражение Это - произвольно сложное выражение, которое используется для инициализации переменной или константы. Его синтаксис определен в разделе "Выражения" выше в этой главе. Тип данных PLSQL_ВЫРАЖЕНИЯ должен быть совместим с типом данных объявляемой переменной или константы (либо преобразуем в него). Для дополнительной информации обратитесь к разделу "Преобразование типов данных" в главе 2. 9-122 Руководство пользователя и справочник по PL/SQL  Замечания по использованию -------------------------- Переменные и константы инициализируются при каждом входе в блок или подпрограмму. По умолчанию, т.е. если PLSQL_ВЫРАЖЕНИЕ не включено в объявление переменной, начальное значение такой переменной есть NULL. Как общие, так и личные переменные и константы, объявленные в спецификации пакета, инициализируются лишь один раз на всю сессию. Инциализирующее PLSQL_ВЫРАЖЕНИЕ обязательно при объявлении переменных NOT NULL и при объявлении констант. Нельзя использовать атрибут %ROWTYPE при объявлении константы. Если %ROWTYPE используется в объявлении переменной, то инициализирующее выражение не допускается. Примеры ------- Ниже приведено несколько примеров объявлений переменных и констант: salary REAL; invalid BOOLEAN; minimum_balance CONSTANT := 10.00; acct_id INTEGER NOT NULL := 1000; В следующем примере атрибут %TYPE предоставляет тип данных столбца: my_ename emp.ename%TYPE; Связанные темы -------------- Предложение присваивания, Выражения, %ROWTYPE, %TYPE