Available with Data Reviewer license.
Summary
The Query Attributes check finds features based on a query against its attribute values.
Overview
The purpose of the Query Attributes check is to identify errors based on a Structured Query Language (SQL) query that can include one or more attribute values. Depending on the database type, this query can also include functions (string and numeric) to implement complex queries. Features or rows returned by the query are written as an error.
Industry scenarios
- In parcel management, features that contain invalid values in their parcel identification numbers, invalid conveyance type, and encumbrance type attributes impact attribute consistency between features and reporting.
- In gas utility management, pipe features that contain invalid values in the material and diameter fields impact asset reporting and modeling.
- In water utility management, network features that contain invalid values based on known construction methods (such as butterfly valves measuring less than 24 inches in diameter) impact asset reporting, modeling, and locator services.
Supported workflows
ArcGIS Data Reviewer checks support multiple methods for implementing automated review of data. The following table identifies the supported implementation methods for this check:
| Validation | Constraint | ||
|---|---|---|---|
Reviewer batch job | Reviewer map rule | Attribute (validation) rule | No |
Yes | Yes | Yes (ArcGIS Pro 2.5 or later) | |
Note:
Map-based Reviewer rules are deprecated as of ArcGIS Pro 2.8 and are no longer recommended for use. This functionality will be removed in the next major release of ArcGIS Pro. It is recommended that you migrate automated review workflows to Data Reviewer capabilities available in attribute rules.
Syntax
| Parameter | Required | Description | Workflows |
|---|---|---|---|
Input Layers/Standalone Tables | Yes | The input feature layers or stand-alone tables evaluated by the rule. Valid inputs for this rule type are feature
layers and stand-alone tables. Click the Forward button | Validation (map rules) |
Subtype | No | The subtype to which the rule is applied. | Validation (attribute rules) |
Attribute | No | A query that identifies the features to which the rule is applied. | Validation (attribute rules) |
Search Goal | Yes | The query expression to be applied to a feature layer or stand-alone table. All features or rows whose attributes match those defined in the query are returned as an error result. | Validation |
Title | No | A unique title or name for the rule. This information is used to support data quality requirement traceability, automated reporting, and corrective workflows. | Validation |
Notes | No | A description you define of the error when a noncompliant feature is found. This information is used to provide guidance to facilitate corrective workflows. | Validation |
Severity | No | The severity of the error assigned when a noncompliant feature is found. This value indicates the importance of the error relative to other errors. Values range from 1 to 5, with 1 being the highest priority and 5 being the lowest. | Validation |
Tags | No | The tag property of the rule. This information is used in rule authoring and management workflows to support traceability and reporting of data quality requirements. | Validation |
to apply filtering to specific features in the feature layer or specific rows in the stand-alone table.Notes
The following conditions apply when this check is authored as an attribute (validation) rule:
- The Attribute filter parameter is limited to comparison (=, <>, >, <, >=, <=) and logical (AND/OR, IN/NOT IN, LIKE/NOT LIKE, IS NULL) operators.
- The Search Goal parameter is limited to comparison (=, <>, >, <, >=, <=) and logical (AND/OR, IN/NOT IN, LIKE/NOT LIKE, IS NULL) operators.
The following conditions apply when this check is authored as a map-based validation rule:
- When this check is authored as a map-based rule, verify that the filter parameters using database-specific SQL functions are the same as from those supported in your production environment.
- When authoring a rule for multiple layers or stand-alone tables, only those fields that are common (matching name and data type) across all layers or tables can be used in the Search Goal parameter.