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
有关示例,请参见服务总线滤波器示例。