A notação para documentação significa o seguinte:
{ }
ou < >
: o que está dentro de chaves é obrigatório, deve ser usado
{ x | y }
ou < x | y >
: deve ser escolhida uma opção, x ou y, é obrigatório
[ ]
: o que está dentro dos colchetes é opcional, pode ser usando ou não
Aqui mais detalhes sobre a notação usada na sintaxe: Sintax notation
Analisando seu exemplo:
1 BEGIN { TRAN | TRANSACTION }
2 [ { transaction_name | @tran_name_variable }
3 [ WITH MARK [ 'description' ] ]
4 ]
5 [ ; ]
- O comando começa com
BEGIN
e deve obrigatoriamente ser seguido por uma das opções ou TRAN
(versão resumida) ou TRANSACTION
- O
[
indica que é opcional declar ou não variáveis
- É opcional declarar ou não
WITH MARK
e ainda é opcional a descrição
- Esse colchete encerra o que foi aberto na linha 2
- É opcional encerrar com o
;
Outro exemplo é o Comando SELECT:
SELECT [ ALL | DISTINCT ]
[TOP ( expression ) [PERCENT] [ WITH TIES ] ]
< select_list >
[ INTO new_table ]
[ FROM { <table_source> } [ ,...n ] ]
[ WHERE <search_condition> ]
[ <GROUP BY> ]
[ HAVING < search_condition > ]
Veja que no comando SELECT
, usar ALL
ou DISTINCT
é opcional, assim como INTO
e WHERE
por exemplo, mas o < select_list >
é obrigatório, ou seja, a lista de campos, variáveis ou valores do comando SELECT
Um simples SELECT 1
então funciona, baseado na descrição da sintaxe acima :)