SQLFilter 语法

SqlFilter 是 SqlFilter 类的实例，代表基于 SQL 语言的筛选器表达式，该表达式针对 BrokeredMessage 进行计算。 SqlFilter 支持 SQL-92 标准的子集。

本主题列出有关 SqlFilter 语法的详细信息。

<predicate ::=  
      { NOT <predicate> }  
      | <predicate> AND <predicate>  
      | <predicate> OR <predicate>  
      | <expression> { = | <> | != | > | >= | < | <= } <expression>  
      | <property> IS [NOT] NULL  
      | <expression> [NOT] IN ( <expression> [, ...n] )  
      | <expression> [NOT] LIKE <pattern> [ESCAPE <escape_char>]  
      | EXISTS ( <property> )  
      | ( <predicate> )  

<expression> ::=  
      <constant>   
      | <function>  
      | <property>  
      | <expression> { + | - | * | / | % } <expression>  
      | { + | - } <expression>  
      | ( <expression> )  

<property> :=   
       [<scope> .] <property_name>  

参数

• <scope> 是一个可选字符串，指示 <property_name> 的范围。 有效值为 sys or user进行求值的基于 SQL 语言的筛选器表达式。 sys 值指示系统范围，其中 <property_name> 是 BrokeredMessage 类的公共属性名称。 user 指示用户范围，其中 <property_name> 是 BrokeredMessage 类字典的项。 user 范围是默认范围（如果 <scope> 未指定）。

备注

访问不存在的系统属性的尝试是错误，访问不存在的用户属性的尝试不是错误。 相反，不存在的用户属性在内部作为未知值进行求值。 运算符求值期间会对未知值进行特殊处理。

property_name

<property_name> ::=  
     <identifier>  
     | <delimited_identifier>  

<identifier> ::=  
     <regular_identifier> | <quoted_identifier> | <delimited_identifier>  

参数

<regular_identifier> 是字符串，由以下正则表达式表示：

[[:IsLetter:]][_[:IsLetter:][:IsDigit:]]*  

此语法是指任何以字母开头且后跟一个或多个下划线/字母/数字的字符串。

[:IsLetter:] 是指分类为 Unicode 字母的任何 Unicode 字符。 System.Char.IsLetter(c) 返回 true（如果 c 为 Unicode 字母）。

[:IsDigit:] 是指分类为十进制数字的任何 Unicode 字符。 System.Char.IsDigit(c) 返回 true（如果 c 为 Unicode 数字）。

<regular_identifier> 不能是保留关键字。

<delimited_identifier> 是用左/右方括号 ([]) 括起来的任何字符串。 右方括号以两个右方括号表示。 下面是 <delimited_identifier>的示例：

[Property With Space]  
[HR-EmployeeID]  

<quoted_identifier> 是指使用双引号引起来的任何字符串。 标识符中的双引号以两个双引号表示。 不建议使用带引号的标识符，因为很容易将其与字符串常量混淆。 如果可能，请使用分隔标识符。 下面是 <quoted_identifier>的示例：

"Contoso & Northwind"  

pattern

<pattern> ::=  
      <expression>  

备注

<pattern> 必须是作为字符串进行求值的表达式。 它用作 LIKE 运算符的模式。 它可以包含以下通配符：

• %：包含零个或多个字符的任意字符串。

• _：任何单个字符。

escape_char

<escape_char> ::=  
      <expression>  

备注

<escape_char> 必须是作为长度为 1 的字符串进行求值的表达式。 它用作 LIKE 运算符的转义符。

例如，property LIKE 'ABC\%' ESCAPE '\' 匹配 ABC%，而不匹配以 ABC 开头的字符串。

constant

<constant> ::=  
      <integer_constant> | <decimal_constant> | <approximate_number_constant> | <boolean_constant> | NULL  

参数

• <integer_constant> 是指不使用引号引起来且不包含小数点的数字字符串。 这些值作为 System.Int64 在内部存储，并具有相同的作用域。

  下面是长常量的示例：

  1894  
  2  
  

• <decimal_constant> 是指不使用引号引起来但包含小数点的数字字符串。 这些值作为 System.Double 在内部存储，并具有相同的作用域/精度。

  在未来版本中，此数字可能以其他数据类型存储，目的是支持确切的数字语义，因此不应依赖于 <decimal_constant> 的基础数据类型为 System.Double 这一事实。

  下面是十进制常量的示例：

  1894.1204  
  2.0  
  

• <approximate_number_constant> 是指使用科学记数法书写的数字。 这些值作为 System.Double 在内部存储，并具有相同的作用域/精度。 下面是近似数常量的示例：

  101.5E5  
  0.5E-2  
  

boolean_constant

<boolean_constant> :=  
      TRUE | FALSE  

备注

布尔常量以关键字 TRUE 或 FALSE 表示。 这些值作为 System.Boolean存储。

string_constant

<string_constant>  

备注

字符串常量使用单引号引起来，并包含任何有效的 Unicode 字符。 字符串常量中嵌入的单引号以两个单引号表示。

function

<function> :=  
      newid() |  
      property(name) | p(name)  

备注

newid() 函数返回 System.Guid.NewGuid() 方法生成的 System.Guid。

property(name) 函数返回 name 所引用的属性的值。 name 值可以是返回字符串值的任何有效表达式。

注意事项

请注意以下 SqlFilter 语义：

• 属性名称区分大小写。

• 运算符尽可能遵循 C# 隐式转换语义。

• 系统属性是值在 BrokeredMessage 实例中公开的公共属性。

  请注意以下 IS [NOT] NULL 语义：

  • property IS NULL 作为 true 求值（如果属性不存在，或者属性的值为 null）。

属性求值语义

• 尝试对不存在的系统属性求值会引发 FilterException 异常。

• 不存在的属性在内部作为 未知进行求值。

  算术运算符中的未知求值：

• 对于二元运算符，如果操作数的左侧和/或右侧的求值结果为未知，则结果为未知。

• 对于一元运算符，如果操作数的求值结果为未知，则结果为未知。

  二进制比较运算符中的未知求值：

• 如果操作数的左侧和/或右侧的求值结果为未知，则结果为未知。

  [NOT] LIKE中的未知求值：

• 如果任何操作数的求值结果为“未知”，则结果为“未知”。

  [NOT] IN中的未知求值：

• 如果左侧操作数的求值结果为“未知”，则结果为“未知”。

  AND 运算符中的未知求值：

+---+---+---+---+  
|AND| T | F | U |  
+---+---+---+---+  
| T | T | F | U |  
+---+---+---+---+  
| F | F | F | F |  
+---+---+---+---+  
| U | U | F | U |  
+---+---+---+---+  

OR 运算符中的未知求值：

+---+---+---+---+  
|OR | T | F | U |  
+---+---+---+---+  
| T | T | T | T |  
+---+---+---+---+  
| F | T | F | U |  
+---+---+---+---+  
| U | T | U | U |  
+---+---+---+---+  

运算符绑定语义

• 在进行数据类型提升和隐式转换时，比较运算符（例如 >、>=、<、<=、!= 和 =）与 C# 运算符绑定遵循相同的语义。

• 在进行数据类型提升和隐式转换时，算术运算符（例如 +、-、*、/ 和 %）与 C# 运算符绑定遵循相同的语义。

后续步骤

• SQLFilter 类
• SQLRuleAction 类