convenções de sintaxe Transact-SQL (Transact-SQL)
A tabela a seguir lista e descreve as convenções usadas nos diagramas de sintaxe na Referência Transact-SQL.
Convenção |
Usado para |
|---|---|
UPPERCASE |
Palavras-chave Transact-SQL. |
italic |
Parâmetros de sintaxe Transact-SQL fornecidos pelo usuário. |
bold |
Nomes de banco de dados, nomes de tabela, nomes de coluna, nomes de índice, procedimentos armazenados, utilitários, nomes de tipo de dados e texto que devem ser digitados exatamente como aparecem. |
underline |
Indica o valor padrão aplicado quando a cláusula que contém o valor sublinhado é omitida da instrução. |
| (barra vertical) |
Separa itens de sintaxe que se encontram entre colchetes ou entre chaves. Você pode usar só um dos itens. |
[ ] (colchetes) |
Itens de sintaxe opcionais. Não digite os colchetes. |
{ } (chaves) |
Itens de sintaxe exigidos. Não digite as chaves. |
[,...n] |
Indica que o item precedente pode ser repetido n vezes. As ocorrências são separadas por vírgulas. |
[...n] |
Indica que o item precedente pode ser repetido n vezes. As ocorrências são separadas por espaços em branco. |
; |
Terminador de instrução Transact-SQL. Embora o ponto-e-vírgula não seja obrigatório na maioria das instruções nesta versão do SQL Server, ele será necessário em uma versão futura. Para obter mais informações, consulte Recursos do Mecanismo de Banco de Dados preteridos no SQL Server 2008. |
<rótulo>:: = |
O nome de um bloco de sintaxe. Essa convenção é usada para agrupar e rotular seções de sintaxe extensa ou uma unidade de sintaxe que possa ser usada em mais de um local dentro de uma instrução. Cada local no qual o bloco de sintaxe pode ser usado é indicado com o rótulo entre colchetes: <rótulo>. Um conjunto é uma coleção de expressões (por exemplo, <conjunto de agrupamentos>) e uma lista é uma coleção de conjuntos (por exemplo, <lista de elementos composta>). |
Nomes de partes múltiplas
A menos que especificado de outra forma, todas as referências Transact-SQL ao nome de um objeto de banco de dados podem ser um nome de quatro partes, do seguinte modo:
server_name**.[database_name].[schema_name].**object_name
| database_name**.[schema_name].**object_name
| schema_name**.**object_name
| object_name
server_name
Especifica um nome de servidor vinculado ou remoto.database_name
Especifica o nome de um banco de dados do SQL Server quando o objeto reside em uma instância local do SQL Server. Quando o objeto está em um servidor vinculado, database_name especifica um catálogo de OLE DB.schema_name
Especifica o nome do esquema que contém o objeto, se o objeto estiver em um banco de dados SQL Server. Quando o objeto está em um servidor vinculado, schema_name especifica um nome de esquema de OLE DB. Para obter mais informações sobre esquemas, consulte Separação do esquema de usuário.object_name
Refere-se ao nome do objeto.
Quando se refere a um objeto específico, nem sempre é preciso especificar o servidor, o banco de dados e o esquema para que Mecanismo de Banco de Dados do SQL Server identifique o objeto. Porém, se o objeto não puder ser encontrado, será retornado um erro.
.gif "Observação") Observação |
|---|
Para evitar erros de resolução de nome, recomendamos especificar o nome de esquema sempre que você especificar um objeto no escopo do esquema. |
Para omitir nós intermediários, use pontos para indicar essas posições. A tabela a seguir mostra os formatos válidos de nomes de objetos.
Formato de referência de objeto |
Descrição |
|---|---|
server.database.schema.object |
Nome de quatro partes. |
server.database..object |
O nome do esquema é omitido. |
server..schema.object |
O nome do banco de dados é omitido. |
server...object |
Os nomes do banco de dados e do esquema são omitidos. |
database.schema.object |
O nome do servidor é omitido. |
database..object |
Os nomes do servidor e do esquema são omitidos. |
schema.object |
Os nomes do servidor e do banco de dados são omitidos. |
object |
Os nomes do servidor, do banco de dados e do esquema são omitidos. |
Convenções de exemplo de código
Salvo indicação em contrário, os exemplos fornecidos na Referência do Transact-SQL foram testados usando SQL Server Management Studio e suas configurações padrão para as seguintes opções:
ANSI_NULLS
ANSI_NULL_DFLT_ON
ANSI_PADDING
ANSI_WARNINGS
CONCAT_NULL_YIELDS_NULL
QUOTED_IDENTIFIER
A maioria dos exemplos de código na Referência do Transact-SQL foi testada em servidores executando uma ordem de classificação com diferenciação de maiúsculas e minúsculas. Os servidores de teste executaram, normalmente, a página de código ANSI/ISO 1252.
Muitos exemplos de código têm o prefixo de constantes de cadeias de caracteres Unicode com a letra N. Sem o prefixo N, a cadeia é convertida na página de código padrão do banco de dados. Essa página de código padrão pode não reconhecer certos caracteres. Para obter mais informações, consulte Programação do lado do servidor com Unicode.