Skip to main content

Calgary Cross Count Tool Icon Calgary Cross Count Tool

One Tool Example

Calgary Cross Count has a One Tool Example. Visit Sample Workflows to learn how to access this and many other examples directly in Alteryx Designer.

Use Calgary Cross Count to aggregate data across multiple Calgary database fields to return a count per record group.


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 key in the file path location of the input or select 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 return records that meet the query criteria built in the subsequent section. It is important to understand that the records returned 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.

Cross Count Fields Tab

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.

Add Fields

To add fields...

  1. Select a Calgary database field from Fields.

  2. Select Add or double mouse click on a Calgary database field.

  3. Move the field up/down in the list via the Up and Down buttons.

  4. Use the Delete button to remove a field from the list.

Create a Custom Field

To create a custom field from the list of added fields...

  1. Highlight the field. The selected field can only be modified if it contains 1000 or fewer unique values.

  2. Select Edit. This opens Custom CrossCount Fields interface, which users can use to construct a new value to cross count or to modify an existing cross count value.

  3. Field Name: Enter the name of a custom cross count field.

  4. Set 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.

  5. Set the value Properties:

    • Value Name: The name of the new or modified value.

    • Fields: The Fields area displays every indexed field available to query from.

    • Query: The Query area displays the filters created through the Edit Query Item interface and provides 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, visit Calgary Input Tool.

    • Up or Down: To Reorder Cross Count fields, highlight the fields to reorder, and select 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.

Additional Query Criteria Tab

Use the Additional Query Criteria tab to filter the Calgary database. Visit Calgary Input Tool for more information.