Читать онлайн «Firebird РУКОВОДСТВО РАЗРАБОТЧИКА БАЗ ДАННЫХ». Страница 173

Пример:

SQL> OUTPUT d:\data\employees.dta ;

SQL> SELECT EMP_NO, EMP_NftME FROM EMPLOYEE ;

/* вывод отправляется в файл */

SQL> OUTPUT ; /* переключает вывод опять на монитор */

! ! !

СОВЕТ. Если вы используете OUTPUT для создания скриптов, то может понадобиться их отредактировать, чтобы удалить случайные интерактивные команды isql. Однако, когда вы направляете этот вывод в isql, используя INPUT, isql обычно просто игнорирует отраженные интерактивные команды.

. ! .

QUIT отменяет текущую транзакцию и закрывает окно isql.

SQL> QUIT ;

QUIT не принимает аргументов. Если вам нужно подтвердить транзакцию вместо ее отката, используйте EXIT.

SHELL предоставляет временный доступ к окну командной строки без подтверждения или отката любой транзакции.

SQL> SHELL [команда операционной системы] ;

где команда операционной системы- (необязательно) команда или вызов, допустимый в командной строке, из которой была запущена isql. Команда будет выполнена, а управление возвращено isql. Если команда не указана, isql открывает интерактивную сессию в командной строке. Ввод EXIT возвращает управление isql.

Пример:

SQL> SHELL dir /mydir | more ;

Этот пример отобразит содержимое каталога /mydir и возвратит управление isql, когда отображение будет завершено или завершится утилита more при нажатии комбинации клавиш <Ctrl>+<C>.

Команды SHOW используются для отображения метаданных, включая таблицы, индексы, процедуры, триггеры и привилегии. Они могут отображать список имен всех объектов указанного типа или предоставлять детальную информацию о конкретном объекте, заданном в команде.

Команды SHOW являются (приблизительным) интерактивным эквивалентом командной строки -extract, -x или -а режим (см. разд. "Извлечение метаданных"). Однако, хотя вы можете использовать команду OUTPUT для пересылки выхода команд SHOW в файл, сохраненный текст не будет готов к использованию в качестве скрипта схемы без редактирования. Используйте опции командной строки, если получение скрипта схемы является вашей целью.

Каждая команда SHOW выполняется в своей собственной транзакции READ COMMITTED, гарантируя, что каждый вызов вернет самый последний вид состояния базы данных.

SHOW CHECK отображает имена и тексты всех определенных пользователем ограничений CHECK, заданных для указанной таблицы.

SQL> SHOW CHECK имя-таблицы ;

где имя-таблицы- имя таблицы, которая существует в подключенной базе данных. Пример:

SQL> SHOW CHECK JOB ;

CONSTRAINT INTEG_12

CHECK (min_salary < max_salary)

SHOW DATABASE отображает информацию о подключенной базе данных (имя файла, размер и количество выделенных страниц, интервал очистки, номера транзакций, статус Forced Writes, набор символов по умолчанию), SHOW DB является сокращенной версией этой команды.

SQL> SHOW DATABASE | DB ;

SHOW DATABASE не принимает аргументов. На рис. 37.5 показан результат, который вы можете ожидать от команды SHOW DATABASE.

! ! !

СОВЕТ. Для получения информации о версии и структуре на диске (ODS) используйте SHOW VERSION.

. ! .

SHOW DCMAXN[S] отображает информацию домена.

SQL> SHOW { DOMAINS | DOMAIN имя };

DOMAINS - отображает список имен всех доменов, объявленных в базе данных. DOMAIN ИМЯ- отображает определение одного указанного домена.

Рис. 37.5. Результат выполнения SHOW DATABASE

Примеры:

SQL> SHOW DOMAINS ;

D_CURRENCY D_NOTES

D_BOOLEAN D_PHONEFAX

. . .

SQL> SHOW DOMAIN D_BOOLEAN ;

D_BOOLEAN SMALLINT NOT NULL

DEFAULT 0

CHECK(VALUE IN (0,1)

SHOW EXCEPTION[S] отображает информацию исключения.

SQL> SHOW { EXCEPTIONS | EXCEPTION имя };

EXCEPTIONS- отображает список имен и текстов всех исключений, объявленных в базе данных.

EXCEPTION имя - отображает текст одного указанного исключения. Примеры:

SQL> SHOW EXCEPTIONS ; Exception Name Used by, Type

BAD_WIZ_TYPE UPD_FAVEFOOD, Stored procedure Invalid Wiz type, check CAPS LOCK

SQL> SHOW EXCEPTION BAD_WIZ_TYPE ; Exception Name Used by, Type

BAD_WIZ_TYPE UPD_FAVEFOOD, Stored procedure Invalid Wiz type, check CAPS LOCK

SHOW FUNCTION[s] отображает информацию о внешних функциях, объявленных в подключенной базе данных.

SQL> SHOW { FUNCTIONS | FUNCTION имя };

FUNCTIONS- отображает список имен всех внешних функций, объявленных в базе данных.

FUNCTION ИМЯ- отображает объявление указанной внешней функции. Примеры:

SQL> SHOW FUNCTIONS ;

ABS MAXNUM

LOWER SUBSTRLEN

. . .

SQL> SHOW FUNCTION maxnum ;

Function MAXNUM:

Function library is /usr/firebird/udf/ib_udf.so

Entry point is FN_MAX

Returns BY VALUE DOUBLE PRECISION

Argument 1: DOUBLE PRECISION

Argument 2: DOUBLE PRECISION

SHOW GENERATOR[S] отображает информацию о генераторах, объявленных в подключенной базе данных.

SQL> SHOW { GENERATORS | GENERATOR имя };

GENERATORS - отображает список имен всех генераторов, объявленных в базе данных вместе с их текущими значениями.

GENERATOR имя- отображает объявление указанного генератора вместе с его текущим значением.

Примеры:

. . .

SQL> SHOW GENERATORS ;

Generator GEN_EMPNO, Next value: 1234

Generator GEN_JOBNO, Next value: 56789

Generator GEN_ORDNO, Next value: 98765

. . .

SQL> SHOW GENERATOR gen_ordno ;

Generator GEN_ORDNO, Next value: 98765

SHOW GRANT отображает информацию привилегий и ролей по отношению к указанному объекту в подключенной базе данных или отображает членство пользователей в роли.

SQL> SHOW GRANT { объект \ имя-роли } ;

где объект- имя существующей таблицы, просмотра или процедуры в текущей базе данных.

имя-роли- имя существующей роли в текущей базе данных. Используйте SHOW ROLE для получения списка всех ролей, определенных в этой базе данных.

Примеры:

SQL> SHOW GRANT JOB ;

GRANT SELECT ON JOB TO ALL

GRANT DELETE, INSERT, SELECT, UPDATE ON JOB TO MANAGER

SQL> SHOW GRANT DO_THIS ;

GRANT DO THIS TO MAGICIAN

SHOW INDEX (SHOW INDICES) отображает информацию об указанном индексе, об индексах для указанной таблицы или обо всех индексах для всех таблиц в подключенной базе данных. Эта команда может быть сокращена: SHOW IND.

SQL> SHOW {INDICES | INDEX { индекс \ таблица }};

где индекс- имя существующего индекса в текущей базе данных. таблица - имя существующей таблицы в текущей базе данных. Примеры:

. . .

SQL> SHOW INDEX ;

RDB$PRIMARY1 UNIQUE INDEX ON COUNTRY(COUNTRY)

CUSTNAMEX INDEX ON CUSTOMER(CUSTOMER)

CUSTREGION INDEX ON CUSTOMER(COUNTRY, CITY)

RDB$FOREIGN23 INDEX ON CUSTOMER(COUNTRY)

. . .

SQL> SHOW IND COUNTRY ;

RDB$PRIMARY20 UNIQUE INDEX ON COUNTRY(COSTNO)

CUSTNAMEX INDEX ON CUSTOMER(CUSTOMER)

! ! !

ПРИМЕЧАНИЕ. Для получения информации о текущем состоянии индексов в базе данных используйте gstat -i. Применение утилиты gstat обсуждалось в конце главы 18.

. ! .

SHOW PROCEDURE[S] отображает все процедуры в подключенной базе данных с их зависимостями или отображает текст указанной процедуры с объявлениями и типами (входной/выходной) каждого аргумента. Команда может иметь сокращенный вид SHOW PROC.

SQL> SHOW {PROCEDURES | PROCEDURE имя } ;

PROCEDURES - отображает список имен всех процедур вместе с их зависимостями.

PROCEDURE имя- для указанной процедуры отображает исходный текст, зависимости и аргументы.

Примеры:

SQL> SHOW PROCEDURES ;

Procedure Name

Dependency

Type

ADD EMP PROJ

EMPLOYEE PROJECT

Table

UNKNOWN_EMP_ID

Exception

DELETE EMPLOYEE

DEPARTMENT

Table

EMPLOYEE

Table

EMPLOYEE PROJECT

Table

SQL> SHOW PROC ADD_EMP_PROJ ;

Procedure text:

BEGIN

BEGIN

INSERT INTO EMPLOYEE_PROJECT (

EMP_NO, PROJ_ID) VALUES (

:emp_no, :proj_id) ;

WHEN SQLCODE -530 DO

EXCEPTION UNKNOWN_EMP_ID;

END

RETURN ;

END

Parameters:

EMP_NO INPUT SMALLINT

PROJ_ID INPUT CHAR(5)

SHOW ROLE [s] отображает имена ролей SQL в подключенной базе данных.

SQL> SHOW ROLES ;

SHOW ROLES не принимает аргументов. Примеры:

SQL> SHOW ROLES ; MAGICIAN MANAGER PARIAH SLEEPER

SHOW GRANT имя роли используется для отображения членства пользователей в ролях.

SHOW SQL DIALECT отображает диалекты SQL клиента и подключенной базы данных, если такая есть.

SQL> SHOW SQL DIALECT;

Пример:

SQL> SHOW SQL DIALECT;

Client SQL dialect is set: 3 and database SQL dialect is: 3

SHOW SYSTEM отображает имена системных таблиц и системных просмотров в подключенной базе данных. Команда имеет сокращение SHOW SYS.

SQL> SHOW SYS [ TABLES ] ;

Команда не принимает аргументов, TABLES является необязательным ключевым словом, которое не влияет на поведение команды.

Примеры:

SQL> SHOW SYS ;

RDB$CHARACTER_SETS RDB$CHECK_CONSTRAINTS RDB S COLLATION S RDB $ DATABASE

Подробную информацию о системных таблицах см. в приложении 9.

SHOW TABLE[S] отображает все таблицы или просмотры либо информацию об указанной таблице или просмотре.

SQL> SHOW { TABLES | TABLE имя };

SHOW TABLES - отображает список имен всех таблиц и просмотров в алфавитном порядке.

SHOW TABLE имя- показывает подробности указанной таблицы или просмотра. Если объект является таблицей, вывод содержит имена столбцов и их определение, PRIMARY KEY, FOREIGN KEY, ограничения CHECK и триггеры. Если объект является просмотром, то вывод содержит имена столбцов и оператор SELECT, на котором основывается просмотр.

Примеры:

SQL> SHOW TABLES ; COUNTRY CUSTOMER

DEPARTMENT EMPLOYEE EMPLOYEE?PROJECT JOB

SQL> SHOW TABLE COUNTRY ; COUNTRY COUNTRYNAME VARCHAR (15) NOT NULL CURRENCY VARCHAR(10) NOT NULL PRIMARY KEY (COUNTRY)

См. также SHOW VIEWS позже в этой главе.

SHOW TRiGGER[S] отображает все триггеры, определенные в базе данных вместе с их таблицами, или для указанного триггера отображает его последовательный номер, тип, статус активности (активен/не активен) и определение PSQL. Сокращенный вариант команды SHOW TRIG.