- Influence of sort items
- Handling the view items after a join
- Joins: different search results according to the order of the views in the join
- Hyper File 5.5
In french: HFusionneVue
Not available with this kind of connection
From version 20
, the SQL views and the materialized views are available.
The views handled by this function correspond to the former mechanism of views. They do not correspond to SQL views or to materialized views.
Creates a HFSQL view from two views created beforehand (HCreateView
). Several operations can be performed when merging the views.
Remark: From version 19, HFSQL is the new name of HyperFileSQL.
// Merge two views
MyView is Data Source
ViewCustomer84 is Data Source
HMergeView(MyView, ViewCustomer84, ViewCustomer84, hViewUnion, "+CustName")
<Result> = HMergeView(<Destination view> , <First view> , <Second view> , <Type of operation> , <Sort item of first view> [, <Sort item of second view> [, <Creation mode> [, <Page size>]]])
- True if the view was created,
- False if a problem occurred. HError is used to identify the error.
<Destination view>: Character string
Name of view to create, result of operation performed on the two specified views.
<First view>: Character string (with or without quotes)
Name of the first view participating in the operation.
<Second view>: Character string (with or without quotes)
Name of the second view participating in the operation.
<Type of operation>: Integer constant
Operation that will be performed between the two specified views:
|hViewIntersection||Rows common to <First view> and to <Second view>.|
|hViewJoin||Join between the first view and the second view.|
|hViewSubtraction||Rows of <First view> without the common rows of <Second view>.|
|hViewUnion||Combination of all rows of <First view> and <Second view>. |
The structure of views must be identical.
|hViewUnionEx||Combination of all non-common rows of <First view> and <Second view>. |
The structure of views must be identical.
<Sort item of first view>: Character string
Name of the field to be used on the first view to perform the operation. This item will also be used to sort the destination view.
<Sort item of second view>: Optional character string
Name of the field to be used on the second view to perform the operation. If this parameter is not specified, it is equal to the value of <Sorting field of the first view>.
<Creation mode>: Optional Integer constant (or combination of constants)
Configures the creation mode of view.
|hViewAdd||Stores the content of the view the next time HExecuteView is called.|
|hViewLocking||The records read in the data file and included in the view are locked.|
|hViewPostponed||The view is created but it will be run later by HExecuteView.|
|hViewDistinct||The view is created without duplicates according to the sort key.|
|hViewDefault||Default creation mode of view.|
|hViewExclusive||Optimizes the creation time of view by locking the entire source data file.|
|hViewBreakable||The view creation can be interrupted by pressing the ESC key.|
<Page size>: Optional integer
Number of records per page (for a view used by remote access).
Influence of sort items
The sort items are used to define the items on which the requested operation will be performed. Therefore, an intersection operation will return all the records of the first view for which <Sort item of first view> is equal to <Sort item of second view> for at least one record of the second view.
Handling the view items after a join
The items issued from a join are named as follows:
- if the item name exists in only one of the source views, this item name is kept in the join.
- if the item name exists in both source views, the item of the join corresponding to the item of the second view is renamed "NameView2_ItemName".
The following syntax also allows you to access the items found in the join:
<Name of Source View>_<Item Name>
- The View1 named "CustomerView" contains the items: CustomerID, OrderID, Name.
- The View2 named "OrderView" contains the items: OrderID, Name, Product.
- The join named "CustomerOrder" is created from the views named "CustomerView" and "OrderView" on the "OrderID" item. The "CustomerOrder" view contains the following items: CustomerID, OrderID, Name, OrderView_Name, Product.
|Accessing the item:||Syntax used|
Joins: different search results according to the order of the views in the join
During a join between two views, the index of second view is used to perform searches on the result of the join. The search result can differ depending on the characteristics of the index used in the join.
- Characteristics of key item named MyItem in View1: Case-insensitive searches.
- Characteristics of item named MyItem in View2: Case-sensitive search.
A merge is performed between these two views. Depending on the order of the merged views, the result of the search will be different:
- HMergeView(View3, View1, View2): the search is performed on view2: 15 records are found.
- HMergeView(View3, View2, View1): the search is performed on view1: 63 records are found.
Hyper File 5.5
To handle a database in Hyper File 5 format with HMergeView
, the merge must be performed by HCreateView_55
This page is also available for…