Conventions de la syntaxe Transact-SQL (Transact-SQL)
S’applique à : 
SQL Server Base de données Azure SQL Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Point de terminaison d'analyse SQL dans Microsoft Fabric Entrepôt dans Microsoft Fabric Base de données SQL dans Microsoft Fabric
Le tableau suivant liste et décrit les conventions utilisées dans les diagrammes de syntaxe du guide de référence Transact-SQL.
| Convention | Utilisé pour |
|---|---|
MAJUSCULES ou UPPERCASE |
Mots clés Transact-SQL. |
| italique | Paramètres de syntaxe Transact-SQL fournis par l'utilisateur. |
| gras | Entrez les noms de bases de données, de tables, de colonnes, d'index, de procédures stockées, d'utilitaires, de types de données et de textes exactement comme ils sont indiqués. |
| (barre verticale) |
Sépare les éléments de syntaxe placés entre crochets ou entre accolades. Vous ne pouvez utiliser qu'un seul de ces éléments. |
[ ] (crochets) |
Élément de syntaxe facultatif. |
{ } (accolades) |
Éléments de syntaxe obligatoires. Ne tapez pas les accolades. |
[ , ...n ] |
Indique que l’élément précédent peut se répéter n fois. Les occurrences sont séparées par des virgules. |
[ ...n ] |
Indique que l’élément précédent peut se répéter n fois. Les occurrences sont séparées par des espaces. |
; |
Terminateur d'instruction Transact-SQL. Bien que le point-virgule ne soit pas requis pour la plupart des instructions dans cette version de SQL Server, il sera requis dans une version à venir. |
<label> ::= |
Nom d'un bloc de syntaxe. Utilisez cette convention pour regrouper et étiqueter des sections de syntaxe longue ou une unité de syntaxe que vous pouvez utiliser à plusieurs emplacements au sein d'une instruction. Chaque emplacement dans lequel le bloc de syntaxe peut être utilisé est indiqué avec l’étiquette placée entre chevrons : <étiquette>. Un jeu est une collection d’expressions, par exemple un <jeu de regroupement> ; et une liste est une collection de jeux, par exemple une <liste d’éléments composites>. |
Nom en plusieurs parties
Sauf indication contraire, toutes les références Transact-SQL au nom d'un objet de base de données peuvent prendre la forme d'un nom à quatre composantes, comme suit :
<server_name>.[<database_name>].[<schema_name>].<object_name>
| <database_name>.[<schema_name>].<object_name>
| <schema_name>.<object_name>
| <object_name>
server_name
Spécifie un nom de serveur lié ou un nom de serveur distant.
database_name
Spécifie le nom d'une base de données SQL Server lorsque l'objet réside dans une instance locale de SQL Server. Quand l’objet se trouve dans un serveur lié, database_name spécifie un catalogue OLE DB.
schema_name
Spécifie le nom du schéma contenant l'objet si celui-ci réside dans une base de données SQL Server. Lorsque l’objet se trouve dans un serveur lié, schema_name spécifie un nom de schéma OLE DB.
object_name
Fait référence au nom de l'objet.
Lorsque vous faites référence à un objet en particulier, il n'est pas toujours nécessaire de spécifier le serveur, la base de données et le schéma pour que le Moteur de base de données SQL Server l'identifie. Cependant, si l’objet est introuvable, un message d’erreur est retourné.
Pour éviter des erreurs relatives à la résolution du nom, nous vous recommandons de spécifier le nom du schéma chaque fois que vous indiquez un objet correspondant.
Pour omettre des nœuds intermédiaires, utilisez des points pour indiquer ces emplacements. Le tableau suivant répertorie les formats valides des noms d'objets.
| Format de la référence d'objet | Description |
|---|---|
<server_name>.<database_name>.<schema_name>.<object_name> |
Nom à quatre composantes. |
<server_name>.<database_name>..<object_name> |
Le nom du schéma est omis. |
<server_name>..<schema_name>.<object_name> |
Le nom de la base de données est omis. |
<server_name>...<object_name> |
Les noms de la base de données et du schéma sont omis. |
<database_name>.<schema_name>.<object_name> |
Le nom du serveur est omis. |
<database_name>..<object_name> |
Les noms du serveur et du schéma sont omis. |
<schema_name>.<object_name> |
Les noms du serveur et de la base de données sont omis. |
<object_name> |
Les noms du serveur, de la base de données et du schéma sont omis. |
Types de données
Lorsqu’ils sont utilisés dans un article, les types de données sont affichés en minuscules et en gras. Par exemple, int, varchar(255) et bit.
Lorsqu’ils sont utilisés dans les blocs de code Transact-SQL, les types de données sont rendus en majuscules. Par exemple :
DECLARE @int_example AS INT;
DECLARE @varchar_example AS VARCHAR(255);
DECLARE @bit_example AS BIT;
Conventions des exemples de code
Sauf indication contraire, les exemples fournis dans le guide de référence Transact-SQL ont été testés à l’aide de SQL Server Management Studio et de ses paramètres par défaut pour les options suivantes :
ANSI_NULLSANSI_NULL_DFLT_ONANSI_PADDINGANSI_WARNINGSCONCAT_NULL_YIELDS_NULLQUOTED_IDENTIFIER
La plupart des exemples de code de la référence Transact-SQL ont été testés sur les serveurs qui exécutent un ordre de tri respectant la casse. Généralement, les serveurs de test ont exécuté la page de codes ANSI/ISO 1252.
De nombreux exemples de code font précéder les constantes de chaînes de caractères Unicode de la lettre N. Sans le préfixe N, la chaîne est convertie en page de codes par défaut de la base de données. Cette page de codes par défaut peut ne pas reconnaître certains caractères.
Informations de référence de type « S’applique à »
Les articles de référence Transact-SQL couvrent plusieurs versions de SQL Server, à compter de SQL Server 2008 (10.0.x), ainsi qu’Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics et Analytics Platform System (PDW).
Une section située en haut de chaque article indique quels produits prennent en charge l’objet de l’article. Si un produit est omis, alors la fonctionnalité décrite par l’article n’est pas disponible dans ce produit.
Dans certains cas, le sujet général de l’article peut être utilisé dans un produit, mais tous les arguments ne sont pas pris en charge. Par exemple, les utilisateurs de base de données autonome ont été introduits dans SQL Server 2012 (11.x). Utilisez l’instruction CREATE USER dans n’importe quel produit SQL Server. Toutefois, la WITH PASSWORD syntaxe ne peut pas être utilisée avec les versions antérieures. Les sections supplémentaires sont insérées dans les descriptions d’argument appropriées dans le corps de l’article.