Calgary Cross Count Tool
The Calgary CrossCount tool enables users to aggregate data across multiple Calgary database fields to return a count per record group.
Version information
As of the Alteryx 5.0 release, Calgary indexes are case insensitive. Calgary databases created in a version earlier than 5.0 will still be case sensitive.
Configure the tool
Calgary Data File: Specify the Calgary database to select records from, either type in the file path location of the input or click Browse to navigate to the file location.
Linked Data File: If the Calgary Database specified above (Primary file, Household) has been linked to another Calgary Database file (Secondary, Individual), the linked file will be exposed here with a few different options for either returning records or attributes from that linked file.
Linked Options: The different linked options will return records that meet the query criteria built in the subsequent section. It is important to understand that the records returned will consist of a combination of the Primary file and Secondary file only when the query criteria is met.
All Matches: Primary use of this option is when an OR Query is specified. Returns ALL Primary file records and ALL the Secondary file records that meet the query criteria.
The fields from either table can be all NULLs if the record did not link.
All Linked Matches: Returns only the Primary file records and Secondary file records that are LINKED AND meet the query criteria.
The secondary tables fields can all be NULLs if there was no matching linked record.
First Linked Match: All of the Primary file records that meet the query criteria are returned as well as the first linked record from the Secondary file that also met the query criteria.
Last Linked Match: All of the Primary file records that meet the query criteria are returned as well as the last linked record from the Secondary file that also met the query criteria.
Linked Count Only: Only a count is returned representing how many of the Secondary file records met the specified query criteria.
The primary tables fields are still output as normal.
None:No Secondary file records are returned, but the fields from the Secondary file are still available to select in the query criteria.
With the Cross Count Fields tab, choose which data Fields to aggregate in order to attain a record count per group. Define multiple Calgary data fields to group or create custom data fields to aggregate by.
To add fields:
- Select a Calgary database field from Fields.
- Select Add or double mouse click on a Calgary database field.
To create a custom field from the list of added fields:
- Highlight the field. The selected field can only be modified if it contains 1000 or less unique values.
- Select Edit.
This opens Custom Cross Count Interface, which users can use to construct a new value to cross count or to modify an existing cross count value.
Field Name: The name of a custom cross count field.
Cross Count Values
New: To create a new cross value, select New.
Copy: Creates a copy of the selected cross count value.
Up or Down: Reorders the cross count values.
Delete: Removes the cross count value from the list.
Properties
Value Name: The name of the new or modified value.
Fields: The Fields area will display every indexed field available to query from.
Query: The Query area will display the filters created through the Edit Query Item interface and provide you with an area to organize and group filters to effectively retrieve data from the Calgary database.
For further information on how to query a Calgary database, see Calgary Input Tool.
Up or Down: To Reorder CrossCount fields, highlight the field(s) to reorder, and click the UP or DOWN buttons until the desired field position is achieved.
Delete: To Remove CrossCount fields, highlight the field to remove and select Delete.
Cache Size: Define the size of the cache for optimal performance in order to easily and quickly access cross counted data. By default the Cache size is set to 256 MB.
Use the Additional Query Criteria tab to filter the Calgary database. See Calgary Input Tool.