Firebird 2.5 Language Reference → Firebird 2.5 Language Reference → Data Definition (DDL) Statements → VIEW |
Table of Contents
A view is a virtual table that is actually a stored and named SELECT query for retrieving data of any complexity. Data can be retrieved from one or more tables, from other views and also from selectable stored procedures.
Unlike regular tables in relational databases, a view is not an independent data set stored in the database. The result is dynamically created as a data set when the view is selected.
The metadata of a view are available to the process that generates the binary code for stored procedures and triggers, just as though they were concrete tables storing persistent data.
Table of Contents
Used for: Creating a view
Available in: DSQL
Syntax:
CREATE VIEW viewname [<full_column_list>] AS <select_statement> [WITH CHECK OPTION]; <full_column_list> ::= (colname [, colname ...])
Table 5.16. CREATE VIEW Statement Parameters
Parameter | Description |
---|---|
viewname | View name, maximum 31 characters |
select_statement | SELECT statement |
full_column_list | The list of columns in the view |
colname | View column name. Duplicate column names are not allowed. |
The CREATE VIEW statement creates a new view. The identifier (name) of a view must be unique among the names of all views, tables and stored procedures in the database.
The name of the new view can be followed by the list of column names that should be returned to the caller when the view is invoked. Names in the list do not have to be related to the names of the columns in the base tables from which they derive.
If the view column list is omitted, the system will use the column names and/or aliases from the SELECT statement. If duplicate names or non-aliased expression-derived columns make this impossible to obtain a valid list, creation of the view fails with an error.
The number of columns in the view's list must exactly match the number of columns in the selection list of the underlying SELECT statement in the view definition.
Additional Points | |
---|---|
|
A view can be updatable or read-only. If a view is updatable, the data retrieved when this view is called can be changed by the DML statements INSERT, UPDATE, DELETE, UPDATE OR INSERT or MERGE. Changes made in an updatable view are applied to the underlying table(s).
A read-only view can be made updateable with the use of triggers. Once triggers have been defined on a view, changes posted to it will never be written automatically to the underlying table, even if the view was updateable to begin with. It is the responsibility of the programmer to ensure that the triggers update (or delete from, or insert into) the base tables as needed.
A view will be automatically updatable if all of the following conditions are met:
The optional WITH CHECK OPTION clause requires an updatable view to check whether new or updated data meet the condition specified in the WHERE clause of the SELECT statement. Every attempt to insert a new record or to update an existing one is checked as to whether the new or updated record would meet the WHERE criteria. If they fail the check, the operation is not performed and an appropriate error message is returned.
WITH CHECK OPTION can be specified only in a CREATE VIEW statement in which a WHERE clause is present to restrict the output of the main SELECT statement. An error message is returned otherwise.
Please note: | |
---|---|
If WITH CHECK OPTION is used, the engine checks the input against the WHERE clause before passing anything to the base relation. Therefore, if the check on the input fails, any default clauses or triggers on the base relation that might have been designed to correct the input will never come into action. Furthermore, view fields omitted from the INSERT statement are passed as NULLs to the base relation, regardless of their presence or absence in the WHERE clause. As a result, base table defaults defined on such fields will not be applied. Triggers, on the other hand, will fire and work as expected. For views that do not have WITH CHECK OPTION, fields omitted from the INSERT statement are not passed to the base relation at all, so any defaults will be applied. |
The creator of a view becomes its owner.
To create a view, a non-admin user needs at least SELECT access to the underlying table(s) and/or view(s), and the EXECUTE privilege on any selectable stored procedures involved.
To enable insertions, updates and deletions through the view, the creator/owner must also possess the corresponding INSERT, UPDATE and DELETE rights on the base object(s).
Granting other users privileges on the view is only possible if the view owner himself has these privileges on the underlying objects WITH GRANT OPTION. It will always be the case if the view owner is also the owner of the underlying objects.
Examples of Creating Views:
CREATE VIEW ENTRY_LEVEL_JOBS AS SELECT JOB_CODE, JOB_TITLE FROM JOB WHERE MAX_SALARY < 15000;
CREATE VIEW ENTRY_LEVEL_JOBS AS SELECT JOB_CODE, JOB_TITLE FROM JOB WHERE MAX_SALARY < 15000 WITH CHECK OPTION;
CREATE VIEW PRICE_WITH_MARKUP ( CODE_PRICE, COST, COST_WITH_MARKUP ) AS SELECT CODE_PRICE, COST, COST * 1.1 FROM PRICE;
CREATE VIEW PRICE_WITH_MARKUP AS SELECT CODE_PRICE, COST, COST * 1.1 AS COST_WITH_MARKUP FROM PRICE;
CREATE VIEW GOODS_PRICE AS SELECT goods.name AS goodsname, price.cost AS cost, b.quantity AS quantity FROM goods JOIN price ON goods.code_goods = price.code_goods LEFT JOIN sp_get_balance(goods.code_goods) b ON 1 = 1;
See also: ALTER VIEW, CREATE OR ALTER VIEW, RECREATE VIEW, DROP VIEW
Used for: Modifying an existing view
Available in: DSQL
Syntax:
ALTER VIEW viewname [<full_column_list>] AS <select_statement> [WITH CHECK OPTION]; <full_column_list> ::= (colname [, colname ...])
Table 5.17. ALTER VIEW Statement Parameters
Parameter | Description |
---|---|
viewname | Name of an existing view |
select_statement | SELECT statement |
full_column_list | The list of columns in the view |
colname | View column name. Duplicate column names are not allowed. |
Use the ALTER VIEW statement for changing the definition of an existing view. Privileges for views remain intact and dependencies are not affected.
The syntax of the ALTER VIEW statement corresponds completely with that of CREATE VIEW.
Caution | |
---|---|
Be careful when you change the number of columns in a view. Existing application code and PSQL modules that access the view may become invalid. For information on how to detect this kind of problem in stored procedures and trigger, see The RDB$VALID_BLR Field in the Appendix. |
Only the view owner and administrators have the authority to use ALTER VIEW.
Example using ALTER VIEW: Altering the view PRICE_WITH_MARKUP
ALTER VIEW PRICE_WITH_MARKUP ( CODE_PRICE, COST, COST_WITH_MARKUP ) AS SELECT CODE_PRICE, COST, COST * 1.15 FROM PRICE;
See also: CREATE VIEW, CREATE OR ALTER VIEW, RECREATE VIEW
Used for: Creating a new view or altering an existing view.
Available in: DSQL
Syntax:
CREATE OR ALTER VIEW viewname [<full_column_list>] AS <select_statement> [WITH CHECK OPTION]; <full_column_list> ::= (colname [, colname ...])
Table 5.18. CREATE OR ALTER VIEW Statement Parameters
Parameter | Description |
---|---|
viewname | Name of a view which may or may not exist |
select_statement | SELECT statement |
full_column_list | The list of columns in the view |
colname | View column name. Duplicate column names are not allowed. |
Use the CREATE OR ALTER VIEW statement for changing the definition of an existing view or creating it if it does not exist. Privileges for an existing view remain intact and dependencies are not affected.
The syntax of the CREATE OR ALTER VIEW statement corresponds completely with that of CREATE VIEW.
Example: Creating the new view PRICE_WITH_MARKUP view or altering it if it already exists:
CREATE OR ALTER VIEW PRICE_WITH_MARKUP ( CODE_PRICE, COST, COST_WITH_MARKUP ) AS SELECT CODE_PRICE, COST, COST * 1.15 FROM PRICE;
See also: CREATE VIEW, ALTER VIEW, RECREATE VIEW
Used for: Deleting (dropping) a view
Available in: DSQL
Syntax:
DROP VIEW viewname;
The DROP VIEW statement deletes an existing view. The statement will fail if the view has dependencies.
Only the view owner and administrators have the authority to use DROP VIEW.
Example: Deleting the PRICE_WITH_MARKUP view.
DROP VIEW PRICE_WITH_MARKUP;
See also: CREATE VIEW, RECREATE VIEW, CREATE OR ALTER VIEW
Used for: Creating a new view or recreating an existing view
Available in: DSQL
Syntax:
RECREATE VIEW viewname [<full_column_list>] AS <select_statement> [WITH CHECK OPTION]; <full_column_list> ::= (colname [, colname ...])
Table 5.20. RECREATE VIEW Statement Parameters
Parameter | Description |
---|---|
viewname | View name, maximum 31 characters |
select_statement | SELECT statement |
full_column_list | The list of columns in the view |
colname | View column name. Duplicate column names are not allowed. |
Creates or recreates a view. If there is a view with this name already, the engine will try to drop it before creating the new instance. If the existing view cannot be dropped, because of dependencies or insufficient rights, for example, RECREATE VIEW fails with an error.
Example: Creating the new view PRICE_WITH_MARKUP view or recreating it, if it already exists.
RECREATE VIEW PRICE_WITH_MARKUP ( CODE_PRICE, COST, COST_WITH_MARKUP ) AS SELECT CODE_PRICE, COST, COST * 1.15 FROM PRICE;
See also: CREATE VIEW, DROP VIEW, CREATE OR ALTER VIEW
Firebird 2.5 Language Reference → Firebird 2.5 Language Reference → Data Definition (DDL) Statements → VIEW |