Выполнение командных файлов

Хотя команда GET и позволяет загрузить содержимое файла в SQL-буфер, откуда оно в дальнейшем может быть выполнено с помощью команды /, этот способ не является универсальным, так как накладывает существенные ограничения на содержимое командного файла (см. выше). Для загрузки и выполнения командных файлов, содержащих любое количество команд SQL*Plus, SQL-операторов и PL/SQL блоков, используется команда START и ее сокращенные варианты, @ и @@.

Команда START имеет следующий синтаксис:

<команда START> ::=

STA[RT] <имя или ссылка> [<аргумент>{ <аргумент>}]

<имя или ссылка> ::=

<имя файла>[.<расширение>] | <URI>

Файл, передаваемый команде START по имени (или по ссылке на Web-сайт в Oracle9i на платформе Windows), может содержать любые команды, которые можно вводить в диалоговом режиме. Если расширение в имени файла не указано, предполагается стандартное расширение (SQL или заданное командой SET SUFFIX).

Указанный по короткому имени файл будет сначала искаться в текущем каталоге, затем - в каталогах, входящих в стандартный путь поиска (обычно задается переменной среды SQLPATH).

Передача параметров командных файлов при вызове

При вызове командного файла можно передавать параметры в виде аргументов командной строки. Утилита SQL*Plus подставляет значение аргументов командной строки вместо позиционных параметров командного файла (&1, &2 и т.д.). Первый аргумент подставляется вместо параметра &1, второй - вместо &2, и так далее.

Рассмотрим простой пример:

SQL> clear buffer

buffer очищена

SQL> input

1 select ename, sal from emp

2 where deptno = &1

3

SQL> save test

Создано файл test

SQL> start test 10

прежний 2: where deptno = &1

новый 2: where deptno = 10

ENAME SAL

---------- ----------

CLARK 2450

KING 5000

MILLER 1300

Сокращенные формы команды start (@, @@)

Утилита SQL*Plus поддерживает две сокращенные формы команды START: @ и @@. Команда @ функционально аналогична команде START:

SQL> @test 20

прежний 2: where deptno = &1

новый 2: where deptno = 20

ENAME SAL

---------- ----------

SMITH 800

JONES 2975

SCOTT 3000

ADAMS 1100

FORD 3000

Примечание

Команда @ удаляет завершающий символ SQLTERMINATOR (по умолчанию - точка с запятой; см. SET SQLTERMINATOR) из последней команды. Если этот символ необходим, надо его удвоить.

Команда @@ работает так же, как и @, но дополнительно ищет командный файл в том же каталоге, что и командный файл, в котором она вызвана. Поэтому данная команда используется для вложенных вызовов командных файлов.

Рассмотрим типичное использование команды @@ в файле ex_all.sql:

set serverout on

@@ex0304

@@ex0305

@@ex0308

@@ex0309

@@ex0603

@@ex0606

@@ex0607

@@ex0608

@@ex0705

@@excurvar

При его запуске с помощью команды @ из того же каталога будут выполнены все перечисленные в нем командные файлы, а результаты их работы будут выданы на экран:

SQL> @f:\usr\doc\orasdev\ex_all.sql

SCOTT has a second highest salary!

Процедура PL/SQL успешно завершена.

Процедура создана.

Ошибок нет.

...