订阅规则 SQL 过滤语法

SQL 过滤器是 服务总线 主题订阅可用的过滤类型之一。 它是一种文本表达式,依赖于 SQL-92 标准的一个子集。 过滤表达式与Azure 资源管理器模板中服务总线Rule的“sqlFilter”属性元素、Azure CLIaz servicebus topic subscription rule create命令--filter-sql-expression的参数以及若干SDK函数一起使用sqlExpression,这些函数允许管理订阅规则。 允许的表达式见本节。

服务总线 Premium 还支持 JMS 2.0 API 中的 JMS SQL 消息选择器语法。

<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>  

Arguments

  • <scope> 是一个可选字符串,指示范围 <property_name>。 有效值为 sys 或 user。
    • 该sys值表示系统范围,其中 <property_name> 是 服务总线 消息中描述的 Messages, payloads and serialization 中的任何属性。
    • 该user值表示用户范围,其中<property_name>是发送到服务总线时可在消息上设置的自定义属性的键。
    • user如果<scope>没有指定,则该范围是默认的范围。

Remarks

尝试访问不存在的系统属性是错误,而尝试访问不存在的用户属性则不是错误。 相反,用户属性不存在时会被内部评估为未知值。 未知值在算符评估中特别处理。

property_name

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

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

Arguments

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

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

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

[:IsLetter:] 表示分类为 Unicode 字母的任何 Unicode 字符。 System.Char.IsLetter(c)如果为 Unicode 字母,则truec返回。

[:IsDigit:] 表示分类为十进制数字的任何 Unicode 字符。 System.Char.IsDigit(c)如果为 Unicode 数字,则truec返回。

A <regular_identifier> 不能是保留的关键词。

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

[Property With Space]  
[HR-EmployeeID]  

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

"Contoso & Northwind"  

关于带有空格、标点符号和属性名称中嵌入闭合括号的完整过滤器表达式,请参见 带有特殊字符的消息属性过滤器。

模式

<pattern> ::=  
      <expression>  

Remarks

<pattern> 必须是作为字符串计算的表达式。 它被用作LIKE运算符的模式。 它可以包含以下万用字符:

  • %:任何包含零个或多个字符的字符串。

  • _:任何单个字符。

关于前缀、后缀、包含和单字符匹配示例,请参见 带万用字元匹配字符串。

escape_char

<escape_char> ::=  
      <expression>  

Remarks

<escape_char> 必须是计算为长度为 1 的字符串的表达式。 它被用作LIKE操作员的逃脱角色。

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

对于匹配字面字符 %、 _和脱义字符的例子,请参见 匹配字面通配符和脱义字符。

常数

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

Arguments

  • <integer_constant> 是未用引号括起来且不包含小数点的数字字符串。 这些值存储在 System.Int64 内部,并且遵循相同的范围。

    以下是长常数的例子:

    1894  
    2  
    
  • <decimal_constant> 是未用引号括起来且包含小数点的数字字符串。 这些数值存储在 System.Double 内部,并且遵循相同的范围/精度。

    在未来的版本中,这个数字可能会存储在不同的数据类型中以支持精确的数语义,因此你不应依赖底层数据类型是 System.Double 的 <decimal_constant>事实。

    以下是十进制常数的例子:

    1894.1204  
    2.0  
    
  • <approximate_number_constant> 是用科学表示法编写的数字。 这些数值存储在 System.Double 内部,并且遵循相同的范围/精度。 以下是近似数常数的例子:

    101.5E5  
    0.5E-2  
    

boolean_constant

<boolean_constant> :=  
      TRUE | FALSE  

Remarks

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

string_constant

<string_constant>  

Remarks

字符串常量用单引号包围,包含任何有效的Unicode字符。 嵌入字符串常数中的单个引号表示为两个单引号。

关于字符串中带有单引号和其他标点符号的例子,请参见 “带特殊字符的字符串值过滤器”。

函数

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

Remarks

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

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

注意事项

请考虑以下SQL过滤器语义:

  • 属性名称不区分大小写。

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

  • 系统属性是指在消息、有效载荷和串行化中描述的服务总线消息上的任何属性。

    请考虑以下 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# 算符绑定相同的语义。

Examples

有关示例,请参见服务总线滤波器示例。

后续步骤