Fichiers include SQL Server pour la gestion des versions et applies-to

Les références de la documentation peuvent être facilement modifiées sans changer le texte des articles individuellement en utilisant des fichiers include dans Markdown. Il existe trois types de fichiers include dans le contenu SQL : versions SQL, applies-to et texte de référence. Les fichiers include de version SQL sont utilisés pour indiquer la version de SQL concernée, comme SQL Server 2016 ou 2017. Les fichiers include applies-to indiquent les services et produits SQL auquel s’applique le document, comme SQL Server sur Linux ou Azure SQL Database. Les fichiers include de texte de référence ne font pas partie des deux autres catégories, comme le fichier include « Get Help », qui est une liste de liens que les clients peuvent utiliser pour obtenir de l’aide sur SQL Server.

Cet article est destiné à être utilisé comme point de référence pour les deux premiers types de fichiers include. Vous pouvez parcourir la liste complète des fichiers include dans le dépôt sql-docs.

Fichiers include de version SQL Server

Les rédacteurs de contenu SQL ont souvent besoin d’inclure le nom du produit et de la version de SQL Server. De cette façon, si quelque chose change dans le nom, le fichier include est mis à jour au lieu de mettre à jour manuellement la valeur dans chacun des articles. Ces fichiers include sont utilisés comme espaces réservés pour les noms de produits, mais ne sont pas utilisés de manière cohérente dans toutes les documentations SQL. SQL Server vNext fait référence à une future version de SQL Server qui n’a pas encore de numéro de version et est l’exception à cette règle.

SQL Server s’applique à (non spécifique à la version)

Ces fichiers include applies-to omettent la version de SQL Server.

Nom de fichier	Exemple dans Markdown	Image
s’applique à-version/sql-asdbmi.md	[!INCLUDE [applies-to-version/sql-asdbmi.md](../includes/applies-to-version/sql-asdbmi.md)]	S’applique à :SQL ServerAzure SQL Managed Instance
s’applique à version/_ssnoversion.md	[!INCLUDE [applies-to-version/_ssnoversion.md](../includes/applies-to-version/sqlserver.md)]	S'applique à :SQL Server

SQL Server s’applique à (spécifique à la version)

Ces fichiers include applies-to indiquent les versions de SQL auxquelles s’applique la documentation.

Nom de fichier	Exemple dans Markdown	Image
applies-to-version/asa-pdw.md	[!INCLUDE [applies-to-version/asa-pdw.md](../includes/applies-to-version/asa-pdw.md)]	S’applique à: Azure Synapse Analytics Analytics Platform System (PDW)

Contenu connexe

• S’applique aux inclut