Syntaxe filtru SQL pravidla předplatného

Článek
10/18/2023

Filtr SQL je jedním z dostupných typů filtrů pro odběry témat služby Service Bus. Jedná se o textový výraz, který se spoléhá na podmnožinu standardu SQL-92. Výrazy filtru se používají s prvkem sqlExpression vlastnosti sqlFilter služby Service Bus Rule v šabloně Azure Resource Manageru nebo s argumentem příkazu --filter-sql-expression Azure CLI az servicebus topic subscription rule create a několika funkcemi sady SDK, které umožňují správu pravidel předplatného. Povolené výrazy se zobrazují v této části.

Service Bus Premium podporuje také syntaxi selektoru zpráv JMS SQL prostřednictvím rozhraní API JMS 2.0.

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

Argumenty

<scope> je volitelný řetězec označující obor <property_name>. Platné hodnoty jsou sys nebo user.
- Hodnota sys označuje systémový obor, kde <property_name> je libovolná z vlastností ve zprávě služby Service Bus, jak je popsáno v části Zprávy, datové části a serializace.
- Hodnota user označuje obor uživatele, kde <property_name> je klíč vlastních vlastností, které můžete nastavit ve zprávě při odesílání do služby Service Bus.
- Obor user je výchozí obor, pokud <scope> není zadaný.

Poznámky

Pokus o přístup k neexistující systémové vlastnosti je chyba, zatímco pokus o přístup k neexistující vlastnosti uživatele není chybou. Místo toho je neexistující vlastnost uživatele interně vyhodnocena jako neznámá hodnota. Neznámá hodnota je zpracována speciálně během vyhodnocení operátoru.

property_name

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

Argumenty

<regular_identifier> je řetězec reprezentovaný následujícím regulárním výrazem:

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

Tato gramatika znamená jakýkoli řetězec, který začíná písmenem a za ním následuje jedno nebo více podtržítko/písmeno/číslice.

[:IsLetter:] znamená jakýkoli znak Unicode, který je zařazen do kategorií jako písmeno Unicode. System.Char.IsLetter(c) vrátí true , pokud c je písmeno Unicode.

[:IsDigit:] znamená jakýkoli znak Unicode, který je zařazený do kategorií jako desetinná číslice. System.Char.IsDigit(c) vrátí true , pokud c je číslice Unicode.

Nelze <regular_identifier> použít vyhrazené klíčové slovo.

<delimited_identifier> je libovolný řetězec uzavřený s hranatými závorkami zleva/doprava ([]). Pravá hranatá závorka je reprezentována jako dvě pravé hranaté závorky. Tady jsou příklady <delimited_identifier>:

[Property With Space]  
[HR-EmployeeID]

<quoted_identifier> je libovolný řetězec uzavřený s dvojitými uvozovkami. Dvojitá uvozovka v identifikátoru je reprezentována jako dvě dvojité uvozovky. Nedoporučuje se používat uvozované identifikátory, protože se dají snadno zaměňovat s řetězcovou konstantou. Pokud je to možné, použijte identifikátor s oddělovači. Tady je příklad <quoted_identifier>:

"Contoso & Northwind"

vzor

<pattern> ::=  
      <expression>

Poznámky

<pattern> musí být výraz, který se vyhodnotí jako řetězec. Používá se jako vzor pro operátor LIKE. Může obsahovat následující zástupné znaky:

%: Libovolný řetězec s nulovými nebo více znaky.
_: Libovolný jeden znak.

escape_char

<escape_char> ::=  
      <expression>

Poznámky

<escape_char> musí být výraz, který se vyhodnotí jako řetězec délky 1. Slouží jako řídicí znak pro operátor LIKE.

Například property LIKE 'ABC\%' ESCAPE '\' odpovídá ABC% namísto řetězce, který začíná řetězcem ABC.

– konstanta

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

Argumenty

<integer_constant> je řetězec čísel, která nejsou uzavřena v uvozovkách a neobsahují desetinné čárky. Hodnoty se ukládají interně System.Int64 a dodržují stejný rozsah.

Tady jsou příklady dlouhých konstant:
```
1894  
2  
```
<decimal_constant> je řetězec čísel, která nejsou uzavřena v uvozovkách a obsahují desetinnou čárku. Hodnoty se ukládají interně System.Double a odpovídají stejnému rozsahu a přesnosti.

V budoucí verzi může být toto číslo uloženo v jiném datovém typu, aby podporovalo přesnou sémantiku čísel, takže byste neměli spoléhat na skutečnost, že podkladový datový typ je System.Double určený <decimal_constant>.

Tady jsou příklady desetinných konstant:
```
1894.1204  
2.0  
```
<approximate_number_constant> je číslo napsané ve vědeckém zápisu. Hodnoty se ukládají interně System.Double a odpovídají stejnému rozsahu a přesnosti. Tady jsou příklady přibližných číselných konstant:
```
101.5E5  
0.5E-2  
```

boolean_constant

<boolean_constant> :=  
      TRUE | FALSE

Poznámky

Logické konstanty jsou reprezentovány klíčovými slovy PRAVDA nebo NEPRAVDA. Hodnoty jsou uloženy jako System.Boolean.

string_constant

<string_constant>

Poznámky

Řetězcové konstanty jsou uzavřeny v jednoduchých uvozovkách a obsahují všechny platné znaky Unicode. Jednoduchá uvozovka vložená do řetězcové konstanty je reprezentována jako dvě jednoduché uvozovky.

function

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

Poznámky

Funkce newid() vrátí vygenerovanou System.Guid metodou System.Guid.NewGuid() .

Funkce property(name) vrátí hodnotu vlastnosti, na kterou nameodkazuje . Hodnota name může být libovolný platný výraz, který vrací řetězcovou hodnotu.

Důležité informace

Zvažte následující sémantiku filtru SQL:

Názvy vlastností nerozlišují malá a velká písmena.
Operátory následují implicitní sémantiku převodu jazyka C#, kdykoli je to možné.
Systémové vlastnosti jsou některé vlastnosti zprávy služby Service Bus, jak je popsáno v části Zprávy, datové části a serializace.

Zvažte následující IS [NOT] NULL sémantiku:
- property IS NULL vyhodnotí se, jako true by vlastnost neexistuje nebo hodnota vlastnosti je null.

Sémantika vyhodnocení vlastností

Pokus o vyhodnocení neexistující systémové vlastnosti vyvolá FilterException výjimku.
Vlastnost, která neexistuje, se interně vyhodnotí jako neznámá.

Neznámé vyhodnocení v aritmetických operátorech:
Pokud se u binárních operátorů vyhodnotí levá nebo pravá strana operandů jako neznámá, pak je výsledek neznámý.
Pro unární operátory, pokud je operand vyhodnocen jako neznámý, je výsledek neznámý.

Neznámé vyhodnocení v binárních relačních operátorech:
Pokud je levá nebo pravá strana operandů vyhodnocena jako neznámá, výsledek je neznámý.

Neznámé vyhodnocení v [NOT] LIKE:
Pokud je některý operand vyhodnocen jako neznámý, je výsledek neznámý.

Neznámé vyhodnocení v [NOT] IN:
Pokud je levý operand vyhodnocen jako neznámý, je výsledek neznámý.

Neznámé vyhodnocení v operátoru AND :

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

Neznámé vyhodnocení v operátoru OR :

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

Sémantika vazby operátoru

Relační operátory, například >, , >=<, <=!=a = následují stejnou sémantiku jako vazba operátoru jazyka C# v povýšení datového typu a implicitní převody.
Aritmetické operátory, například +, -, */a % následují stejnou sémantiku jako vazba operátoru jazyka C# v povýšení datového typu a implicitní převody.

Příklady

Příklady najdete v příkladech filtru služby Service Bus.

Sdílet prostřednictvím

Syntaxe filtru SQL pravidla předplatného

Argumenty

Poznámky

property_name

Argumenty

vzor

Poznámky

escape_char

Poznámky

– konstanta

Argumenty

boolean_constant

Poznámky

string_constant

Poznámky

function

Poznámky

Důležité informace

Sémantika vyhodnocení vlastností

Sémantika vazby operátoru

Příklady

Další kroky

Váš názor

Další materiály