Add a note for create_immv in README.md

With PostgreSQL 17 or later, while `refresh_immv` is running, 
the `search_path` is temporarily changed to `pg_catalog, pg_temp`.
This commit is contained in:
Yugo Nagata 2024-08-06 04:11:25 +09:00 committed by GitHub
parent bb3c999c05
commit 85b11c359a
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -92,6 +92,8 @@ create_immv(immv_name text, view_definition text) RETURNS bigint
When an IMMV is created, some triggers are automatically created so that the view's contents are immediately updated when its base tables are modified. In addition, a unique index is created on the IMMV automatically if possible. If the view definition query has a GROUP BY clause, a unique index is created on the columns of GROUP BY expressions. Also, if the view has DISTINCT clause, a unique index is created on all columns in the target list. Otherwise, if the IMMV contains all primary key attributes of its base tables in the target list, a unique index is created on these attributes. In other cases, no index is created. When an IMMV is created, some triggers are automatically created so that the view's contents are immediately updated when its base tables are modified. In addition, a unique index is created on the IMMV automatically if possible. If the view definition query has a GROUP BY clause, a unique index is created on the columns of GROUP BY expressions. Also, if the view has DISTINCT clause, a unique index is created on all columns in the target list. Otherwise, if the IMMV contains all primary key attributes of its base tables in the target list, a unique index is created on these attributes. In other cases, no index is created.
Note that if you use PostgreSQL 17 or later, while `create_immv` is running, the `search_path` is temporarily changed to `pg_catalog, pg_temp`.
#### refresh_imm #### refresh_imm
Use `refresh_immv` function to refresh IMMV. Use `refresh_immv` function to refresh IMMV.