ALTER VIEW statement

Description

Replaces a view definition with a modified version.

Syntax

Syntax 1

ALTER VIEW
… [ owner.]view-name [ ( column-name [ , … ] ) ]
… AS select-statement
… [ WITH CHECK OPTION ]

Syntax 2

ALTER VIEW
… [ owner.]view-name 
… { SET HIDDEN | RECOMPILE | DISABLE | ENABLE }

Usage

AS Purpose and syntax Identical to CREATE VIEW statement. See “CREATE VIEW statement”

WITH CHECK OPTION Purpose and syntax Identical to CREATE VIEW statement. See “CREATE VIEW statement”

SET HIDDEN Use the SET HIDDEN clause to obfuscate the definition of the view and cause the view to become hidden from view, for example in Sybase Central. Explicit references to the view still works.

WARNING! The SET HIDDEN operation is irreversible.

RECOMPILE Recreates the column definitions for the view. Identical in functionality to the ENABLE clause, except you can use it on a view that is not disabled.

DISABLE Disables the view from use by the database server.

ENABLE Enables a disabled view, which causes the database server to recreate the column definitions for the view. Before you enable a view, you must enable any views on which it depends.

When you alter a view, existing permissions on the view are maintained and do not require reassignment. Instead of using the ALTER VIEW statement, you could also drop the view and recreate it using DROP VIEW and CREATE VIEW, respectively. If you do this, view permissions must be reassigned.

After completing the view alteration using Syntax 1, the database server recompiles the view. Depending on the type of change you made, if there are dependent views, the database server attempts to recompile them. If you made changes that impact a dependent view, you might need to alter the definition for the dependent view, as well. For more information about view alterations and how they impact view dependencies, see “View dependencies” in SQL Anywhere Server – SQL Usage > Creating Databases > Working with database objects > Working with views.

WARNING! If the SELECT statement defining the view contains an asterisk (*), the number of the columns in the view could change if columns were added or deleted from the underlying tables. The names and data types of the view columns could also change.

Syntax 1 Alters the structure of the view. Unlike altering tables, where your change might be limited to individual columns, altering the structure of a view requires that you replace the entire view definition with a new definition, much as you would when creating the view. For a description of the parameters used to define the structure of a view, see “CREATE VIEW statement”.

Syntax 2 Changes attributes for the view, such as whether the view definition is hidden.

When you use SET HIDDEN, you can unload and reload the view into other databases. Debugging using the debugger does not show the view definition, nor is it available through procedure profiling. If you need to change the definition of a hidden view, you must drop the view and create it again using the CREATE VIEW statement.

When you use the DISABLE clause, the view is no longer available for use by the database server to answer queries. Disabling a view is similar to dropping one, except that the view definition remains in the database. Disabling a view also disables any dependent views. Therefore, the DISABLE clause requires exclusive access, not only to the view being disabled, but to any dependent views, which are also disabled.


Side Effects

Automatic commit.

All procedures and triggers are unloaded from memory, so that any procedure or trigger that references the view reflects the new view definition. The unloading and loading of procedures and triggers can have a performance impact if you regularly alter views.

Standards

Permissions

Must be owner of the view or have DBA authority.

See also

CREATE VIEW statement

DROP statement

“sa_dependent_views procedure,” Chapter 7, “System Procedures,” in Reference: Building Blocks, Tables, and Procedures

“Hiding the contents of procedures, functions, and views” in Chapter 1, “Using Procedures and Batches” in System Administration Guide: Volume 2

“View dependencies” in SQL Anywhere Server – SQL Usage > Creating Databases > Working with database objects > Working with views