本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Rule
<a name="API_Rule"></a>

表示应在此数据集范围内验证的单个数据质量要求。

## 目录
<a name="API_Rule_Contents"></a>

**注意**  
下表中首先描述了必需参数。

 ** CheckExpression **   <a name="databrew-Type-Rule-CheckExpression"></a>
包括列引用、条件名称并后跟变量引用的表达式，可能与其他条件一同分组并组合使用。例如 `(:col1 starts_with :prefix1 or :col1 starts_with :prefix2) and (:col1 ends_with :suffix1 or :col1 ends_with :suffix2)`。列和值引用是应以“:”符号开头的替代变量。根据上下文，替代变量的值可以是实际值或列名。这些值在 SubstitutionMap 中定义。如果 CheckExpression 以列引用开头，则规则中的 ColumnSelectors 应为 null。如果已经定义了 ColumnSelectors，则条件的左侧不应有列引用，例如 `is_between :val1 and :val2`。  
有关更多信息，请参阅[可用检查](https://docs.aws.amazon.com/databrew/latest/dg/profile.data-quality-available-checks.html)。  
类型：字符串  
长度限制：最小长度为 4。最大长度为 1024。  
模式：`^[<>0-9A-Za-z_.,:)(!= ]+$`  
必需：是

 ** Name **   <a name="databrew-Type-Rule-Name"></a>
规则的名称。  
类型：字符串  
长度限制：长度下限为 1。最大长度为 128。  
必需：是

 ** ColumnSelectors **   <a name="databrew-Type-Rule-ColumnSelectors"></a>
列选择器列表。选择器可用于使用数据集中的名称或正则表达式选择列。规则将应用于选定的列。  
类型：[ColumnSelector](API_ColumnSelector.md) 对象数组  
数组成员：最少 1 个物品。  
必需：否

 ** Disabled **   <a name="databrew-Type-Rule-Disabled"></a>
指定是否禁用规则的值。禁用规则后，配置文件作业将不会在作业运行期间对其进行验证。默认值为 false。  
类型：布尔值  
必需：否

 ** SubstitutionMap **   <a name="databrew-Type-Rule-SubstitutionMap"></a>
替换变量名称与此检验表达式中所用值的映射。变量名称应以“:”（冒号）开头。变量值可以是实际值或列名称。为了区分两者，列名称应该用反引号括起来，例如，`":col1": "`Column A`".`  
类型：字符串到字符串映射  
密钥长度限制：最小长度为 2。最大长度为 128。  
键模式：`^:[A-Za-z0-9_]+$`  
值长度约束：最大长度为 1024。  
必需：否

 ** Threshold **   <a name="databrew-Type-Rule-Threshold"></a>
与非聚合校验表达式一起使用的阈值。非聚合校验表达式将应用于特定列中的每一行，阈值将用于确定验证是否成功。  
类型：[Threshold](API_Threshold.md) 对象  
必需：否

## 另请参阅
<a name="API_Rule_SeeAlso"></a>

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/databrew-2017-07-25/Rule) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/databrew-2017-07-25/Rule) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/databrew-2017-07-25/Rule)