Convenzioni di sintassi Transact-SQL (Transact-SQL)
Si applica a: SQL Server
database SQL di Azure
Istanza gestita di SQL di Azure
endpoint di analisi SQL di Azure Synapse Analytics
Platform System (PDW)
in Microsoft Fabric
Warehouse in Microsoft Fabric
Nella tabella seguente sono elencate e descritte le convenzioni usate nei diagrammi di sintassi nel riferimento Transact-SQL.
Convenzione | Utilizzo |
---|---|
LETTERE MAIUSCOLE | Parole chiave di Transact-SQL. |
corsivo | Parametri della sintassi Transact-SQL specificati dall'utente. |
grassetto | Digitare nomi di database, tabelle, colonne, indici, stored procedure, utilità, tipi di dati e testo esattamente come indicato. |
|(barra verticale) | Separazione di elementi sintattici racchiusi tra parentesi quadre o graffe. Indica che è possibile utilizzare solo uno degli elementi. |
[ ] (parentesi quadre) | Elemento di sintassi facoltativo. |
{ } (parentesi graffe) | Elementi sintattici obbligatori. Le parentesi graffe non devono essere digitate. |
[ , ...n ] | Indica che l'elemento precedente può essere ripetuto n volte. Le occorrenze sono separate da virgole. |
[ ...n ] | Indica che l'elemento precedente può essere ripetuto n volte. Le varie occorrenze dell'elemento sono separate da spazi. |
; | Carattere di terminazione delle istruzioni Transact-SQL. Anche se per la maggior parte delle istruzioni in questa versione di SQL Server non è necessario usare il punto e virgola, questo requisito verrà introdotto in una versione futura. |
Nome di un blocco della sintassi. Usare questa convenzione per raggruppare ed etichettare sezioni di sintassi estese oppure un'unità sintattica che è possibile usare in più posizioni di un'istruzione. Ogni posizione in cui si potrebbe usare il blocco di sintassi è indicata dall'etichetta racchiusa tra parentesi angolari: <label>. Un set è una raccolta di espressioni, ad esempio <set di raggruppamento>, mentre un elenco è una raccolta di set, ad esempio <elenco di elementi composti>. |
Nomi di più parti
Se non specificato diversamente, tutti i riferimenti Transact-SQL al nome di un oggetto di database possono essere composti da quattro elementi nel formato seguente:
server_name.[database_name].[schema_name].object_name
| database_name.[schema_name].object_name
| schema_name.object_name
| object_name
server_name
Specifica il nome del server collegato o remoto.
database_name
Specifica il nome di un database di SQL Server quando l'oggetto è contenuto in una istanza locale di SQL Server. Se l'oggetto è disponibile in un server collegato, database_name specifica un catalogo OLE DB.
schema_name
Specifica il nome dello schema che contiene l'oggetto se l'oggetto è disponibile in un database di SQL Server. Se l'oggetto è disponibile in un server collegato, schema_name specifica il nome di uno schema OLE DB.
object_name
Fa riferimento al nome dell'oggetto.
Quando si fa riferimento a un oggetto specifico, non è sempre necessario specificare server, database e schema per l'identificazione dell'oggetto nel motore di database di SQL Server. Se tuttavia l'oggetto non viene trovato viene restituito un errore.
Per evitare errori di risoluzione dei nomi, è consigliabile specificare il nome dello schema ogni volta che si specifica un oggetto con ambito schema.
Per omettere i nodi intermedi, contrassegnare queste posizioni con un punto. Nella tabella seguente sono inclusi i formati validi per i nomi di oggetto.
Formato per i riferimenti agli oggetti. | Descrizione |
---|---|
server_name.database_name.schema_name.object_name | Nome composto da quattro parti. |
server_name.database_name..object_name | Il nome dello schema viene omesso. |
server_name..schema_name.object_name | Il nome del database viene omesso. |
server_name...object_name | Il nome del database e dello schema viene omesso. |
database_name.schema_name.object_name | Il nome del server viene omesso. |
database_name..object_name | Il nome del server e del database viene omesso. |
schema_name.object_name | Il nome del server e del database viene omesso. |
object_name | Il nome dello schema, del database e del server viene omesso. |
Convenzioni di esempio di codice
Se non diversamente specificato, gli esempi forniti nel riferimento Transact-SQL sono stati testati usando SQL Server Management Studio e le relative impostazioni predefinite per le opzioni seguenti:
- ANSI_NULLS
- ANSI_NULL_DFLT_ON
- ANSI_PADDING
- ANSI_WARNINGS
- CONCAT_NULL_YIELDS_NULL
- QUOTED_IDENTIFIER
La maggior parte degli esempi di codice nel riferimento Transact-SQL è stata testata nei server che eseguono un ordinamento con distinzione tra maiuscole e minuscole. e in cui è attiva la tabella codici ANSI/ISO 1252.
Molti esempi di codice prefissino costanti stringa di caratteri Unicode con la lettera N
. Senza il N
prefisso, la stringa viene convertita nella tabella codici predefinita del database. La tabella codici predefinita potrebbe non riconoscere certi caratteri.
Riferimenti "Si applica a"
Gli articoli di riferimento di Transact-SQL includono più versioni di SQL Server, a partire da SQL Server 2008 (10.0.x), oltre a database SQL di Azure, Istanza gestita di SQL di Azure, Azure Synapse Analytics e platform system (PDW).
Nella parte superiore di ogni articolo c'è una sezione che indica i prodotti che supportano l'oggetto dell'articolo. Se un prodotto viene omesso, la funzionalità illustrata dall'articolo non è disponibile in quel prodotto.
Il tema generale dell'articolo potrebbe essere usato in un prodotto, ma in alcuni casi non sono supportati tutti gli argomenti. Ad esempio gli utenti di database indipendenti sono stati introdotti in SQL Server 2012 (11.x). Usare l'istruzione CREATE USER
in qualsiasi prodotto SQL Server, ma la WITH PASSWORD
sintassi non può essere usata con le versioni precedenti. Alcune sezioni Si applica a aggiuntive vengono inserite nelle descrizioni di argomento appropriate nel corpo dell'articolo.