sa_recompile_views system procedure

Locates view definitions stored in the catalog that do not have column definitions and causes the column definitions to be created.

Syntax

sa_recompile_views( [ ignore_errors ] )

Arguments

ignore_errors Use this optional INTEGER parameter to specify whether to return errors during the recompilation. If you specify 0, an error is returned for each view for which column definition failed. If you specify 1, or any value other than 0, no errors are returned. If no value is specified, 0 is used by default.

Remarks

This procedure is used to locate views in the catalog that do not have column definitions and execute an ALTER VIEW statement with the RECOMPILE clause to create the column definitions. The procedure does this for each view that does not have a column definition until there are none left that require compilation or until any remaining column definitions cannot be created. If the procedure is unable to recompile any views, an error is reported. Errors can be suppressed by specifying a non-zero parameter to this procedure.

Caution

The sa_recompile_views system procedure should only be called from within a reload.sql script. This procedure is used by the Unload utility (dbunload) and should not be used explicitly.

The sa_recompile_views system procedure does not attempt to recompile materialized views or any view marked DISABLED.

Permissions

DBA authority required

Side effects

For each regular view that does not have a VALID status, an ALTER VIEW owner.viewname ENABLE statement is executed, causing an automatic commit.