Convenzioni di sintassi Transact-SQL (Transact-SQL)

  • Articolo

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW) Endpoint di analisi SQL 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
MAIUSCOLO o UPPERCASE 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.
<label> ::= 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 è possibile usare il blocco di sintassi, è indicata con l'etichetta racchiusa tra chevrons: <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.

Tipo di dati

Se usato inline in un articolo, viene eseguito il rendering dei tipi di dati in lettere minuscole e grassetto. Ad esempio, int, varchar(255)e bit.

Se usato nei blocchi di codice Transact-SQL, viene eseguito il rendering dei tipi di dati in lettere maiuscole. Ad esempio:

DECLARE @int_example AS INT;
DECLARE @varchar_example AS VARCHAR(255);
DECLARE @bit_example AS BIT;

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. Questa tabella codici predefinita potrebbe non riconoscere determinati 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 Analitica e Analitica Platform System (PDW).

Una sezione nella parte superiore di ogni articolo 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. Tuttavia, la WITH PASSWORD sintassi non può essere usata con le versioni precedenti. Extra Si applica alle sezioni vengono inserite nelle descrizioni degli argomenti appropriate nel corpo dell'articolo.

Contenuto correlato