HRefreshView (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / Managing databases / HFSQL / HFSQL functions

Necessary rights

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HRefreshView (Function)

In french: HRafraîchitVue

Available only with these kinds of connection

Asks to recalculate the content of a materialized view.

Remark: You also have the ability to refresh the view via the SQL statement "REFRESH MATERIALIZED VIEW".

Example

HRefreshView(MyConnection, MyView)

Syntax

<Result> = HRefreshView(<Connection> , <View> [, <Option>])

<Result>: Boolean

True if the materialized view was refreshed,
False if an error occurred. HErrorInfo is used to identify the error.

<Connection>: Character string or Connection variable

Connection to use. This connection corresponds to:
the name of the connection defined in the data model editor or with HDescribeConnection or HOpenConnection.
the name of a variable of type Connection.

<View>: Character string

Name of materialized view whose data must be recalculated. This view was created:
via the data model editor.
via the SQL "CREATE MATERIALIZED VIEW" command.

<Option>: Optional Integer constant

Mode for refreshing the materialized view.
hNoWait The refresh of materialized view is not a locking operation: it is performed in background task. HInfoView returns the information of the materialized view after being refreshed.
Parameter not specified (by default) The refresh of materialized view is locking for the one who requested it. <Result> is used to find out the status report of refresh.

Remarks

Necessary rights

To recalculate the content of materialized view, you must have:

the corresponding rights (hRightsManageTask constant) on the server,
for each relevant database (which means containing a view to process), the rights to connect (hRightsConnection or hRightsEncryptedConnection constant).

To find out whether these rights are granted to a user or to a group, use HInfoServerRights or HInfoDatabaseRights.

To modify the rights granted to a user or to a group of users, use HModifyServerRights or HModifyDatabaseRights.

Component: wd290hf.dll