Système de gestion de versions dans la documentation SQL

S’applique à : SQL Server Base de données Azure SQL Azure Synapse Analytics Analytics Platform System (PDW)

Cet article explique notre système de gestion de versions dans la documentation SQL. Le système de gestion de versions connaît les produits et leurs versions. Le système vous permet de choisir le produit et la version qui vous intéressent. Le système affiche ensuite la documentation appropriée.

Produits concernés (S’applique à)

Le titre de la plupart des articles SQL Server est suivi de la mention S’applique à. Vient ensuite sur la même ligne une liste pratique de produits SQL avec des indicateurs montrant si l’article est pertinent pour les produits. Par exemple, le produit SQL Server peut être indiqué comme pertinent, tandis qu’Azure SQL Database peut être indiqué comme non pertinent pour l’article.

La ligne S’applique à ignore les versions des produits. Nous nous efforçons d’éviter les incohérences entre la ligne S’applique à et l’aspect « produits » des configurations de notre système de gestion de versions.

Historique des jeux de fichiers distincts

Pour SQL Server 2014 et versions antérieures, chaque version a sa propre copie distincte complète des fichiers de documentation. Par exemple, la documentation relative à SQL Server 2014 a commencé sous la forme d’une copie de la documentation de SQL Server 2012. La copie 2014 a ensuite été modifiée pendant le cycle de développement du produit.

Cette ancienne approche signifiait que si un défaut était découvert dans la documentation 2014, il pouvait également être présent dans les documentations 2012 et 2008. Cela compliquait la résolution des défauts et la maintenance générale.

Plusieurs versions dans les mêmes fichiers

Pour cette raison et d’autres, les fichiers de documentation pour SQL Server 2016 concernent également les versions 2017, 2019 et probablement <vNext>. Cette consolidation se veut pratique, car nous attribuons maintenant des monikers de gestion de versions à nos fichiers de documentation SQL Server. Les monikers de gestion de versions sont assignés, ou explicitement incorporés, dès lors que le degré de granularité le justifie pour chaque fichier de documentation donné.

Contrôle de gestion de versions dans l’interface utilisateur

Quand vous consultez un article de documentation SQL à l’aide de notre site web Docs, le moniker de gestion de versions actuellement choisi est visible au-dessus de la table des matières. Le contrôle est une liste déroulante.

media_versioning-control-10-sql-server-2017.png

Si vous souhaitez consulter la documentation relative à une autre version de SQL Server, cliquez sur la flèche de développement située à la fin du moniker de la version actuelle. Cliquez ensuite pour choisir la combinaison de produit et de version qui vous intéresse. Quand vous cliquez sur une autre version, la documentation affichée change immédiatement pour montrer les différences relatives à la nouvelle version choisie. La documentation alors affichée peut contenir, ou non, des changements ; les deux cas sont courants.

media_versioning-control-20-expanded.png

Paramètre HTTPs view=

Chaque article dont l’adresse web commence par https://video2.skills-academy.com/sql/ a un paramètre nommé ?view= ajouté à son adresse. La valeur de ce paramètre est le code de moniker de gestion de versions.

Le code de moniker dans l’adresse https correspond toujours au nom de moniker affiché dans le contrôle de gestion de versions.

Prise en compte des produits, pas des éditions

Éditions

Dans les années 1990 jusqu’aux années 2000, Microsoft SQL Server n’avait qu’un seul produit. Il existait plusieurs éditions de chaque version de SQL Server, telles que les éditions Developer et Enterprise de SQL Server 2008. Les éditions représentaient des ensembles de fonctionnalités légèrement différents, mais le produit principal était le même. Les nouvelles versions de SQL Server peuvent toujours avoir plusieurs éditions.

Products

Avec l’essor plus récent du cloud computing et de Microsoft Azure, Microsoft a publié son produit Azure SQL Database. Bien que le produit local SQL Server traditionnel et le produit Azure SQL Database partagent une grande quantité de code, ce sont deux produits véritablement distincts.

Pour SQL, les monikers de gestion de versions font la distinction entre les produits, mais pas entre les éditions.

Produits SQL cloud Azure

Presque tous les articles dont l’adresse web commence par https://video2.skills-academy.com/sql/ s’appliquent à au moins une version du produit nommé SQL Server. Un grand sous-ensemble de ces articles s’applique également à un ou plusieurs de nos produits de service SQL hébergés dans notre cloud Azure. Parmi ces produits cloud SQL, citons Azure SQL Database.

Naturellement, le produit Azure SQL Database n’a qu’une seule version. Presque tous les articles qui s’appliquent à Azure SQL Database, mais pas à SQL Server, ont une adresse web commençant par https://video2.skills-academy.com/azure/sql-database/.

Scénarios de filtrage de version

Le système de gestion de versions repose sur le filtrage de tout le contenu de documentation qui ne s’applique pas au moniker actuellement actif. Chaque fois que vous choisissez un moniker de gestion de versions différent, le jeu de contenu qui est masqué change. Le filtrage masque le contenu aux niveaux suivants :

  • Sections ou phrases dans un article.
  • Entrées d’articles dans la table des matières.

Les scénarios suivants décrivent les effets du choix d’un autre moniker.

Scénario 1 : Dans l’article actuel

Le scénario suivant porte sur les sections de votre article actuel :

  1. Le moniker de gestion de versions actuel est SQL Server 2017.
  2. Vous lisez une section qui décrit une fonctionnalité qui a été ajoutée pour la première fois à la version 2017 de SQL Server.
  3. Vous définissez le moniker sur SQL Server 2016.
  4. Vous remarquez que la section que vous étiez en train de lire a disparu.
  5. Vous définissez le moniker sur SQL Server 2019.
  6. Vous remarquez que la section 2017 que vous étiez en train de lire réapparaît.

Dans le scénario précédent, la section relative à la nouvelle fonctionnalité 2017 est probablement marquée avec une plage de monikers qui comprend le code de moniker suivant :

  • >=sql-server-2017

Quand le moniker SQL Server 2019 a été choisi, le système de gestion de versions a réalisé que 2019 est supérieur ou égal à 2017 et a donc affiché la section.

Scénario 2 : Cliquer sur un lien vers un article masqué

Le scénario rare suivant explique ce qui se passe si vous cliquez sur un lien vers un article qui est masqué dans la table des matières. En bref, le lien fonctionne :

  1. Le moniker de gestion de versions actuel est SQL Server 2017.
  2. Dans l’article actuel A, vous cliquez sur un lien vers un article B qui s’applique uniquement à SQL Server 2016.
    • Avant le clic, l’entrée de l’article B est masqué dans la table des matières.
  3. Après le clic, l’article B s’affiche.
    • L’affichage de l’article B force le contrôle de gestion de versions à basculer vers le moniker SQL Server 2016.
    • Le moniker d’origine SQL Server 2017 a dû être abandonné. Cet abandon provoque l’affichage d’un message d’information en haut de la page web. Le message explique que le moniker actuel a dû être basculé pour s’adapter au nouvel article B.

Scénario 3 : Accéder à une adresse https

L’article suivant a été ajouté pour SQL Server 2017. Il décrit les fonctionnalités qui ont été ajoutées à SQL Server dans la version 2017. La plupart ou la totalité de ces nouvelles fonctionnalités font également partie de la version 2019. Voici les attributs de l’article.

Attribut Valeur
Intitulé Nouveautés de SQL Server 2017
Plage de monikers =">= sql-server-2017"
Adresse https https://video2.skills-academy.com/sql/sql-server/what-s-new-in-sql-server-2017

À partir de l’adresse https de base, le tableau suivant explique ce qui se produit quand le paramètre ?view= est ajouté par l’utilisateur, en fonction de différentes valeurs.

Valeur de ?view= Comportement de la navigation depuis l’adresse https
(Aucun paramètre.) Le système de gestion de versions essaie sa valeur de moniker par défaut. En règle générale, nous définissons cette dernière sur la version non-préversion la plus récente de SQL Server.

La valeur par défaut SQL Server 2017 ou 2019 satisfait à l’attribut >= sql-server-2017.

Le système ajoute le paramètre à l’adresse https, peut-être sous la forme ?view=sql-server-2017.
Le contrôle de liste déroulante de gestion de versions est ensuite défini sur le nom du moniker correspondant.
sql-server-2016 Le système de gestion de versions se rend compte que la plage de monikers de l’article n’inclut pas la version 2016.

Le système choisit alors l’un des monikers qui satisfont à la plage.

Ensuite, comme dans le cas de la version 2016 , le paramètre ?view= est ajouté et le nom du contrôle correspond à la valeur du paramètre.
sql-server-2017 Le système de gestion de versions comprend que la valeur du paramètre est incluse dans la plage de monikers de l’article.

Le contrôle de gestion de versions est défini pour correspondre à la valeur du paramètre.
sql-server-2019 Identique au cas de la valeur sql-server-2017, sauf que le paramètre et le contrôle sont définis sur 2019.

Moniker spécial All SQL - Hide nothing (Tout SQL - Ne rien masquer)

Il existe un nom de produit de moniker spécial, All SQL (Tout SQL), dont l’unique version est Hide nothing (Ne rien masquer). Ce moniker est utilisé à des fins de test interne de certaines modifications. S’il est utilisé par un client, ce moniker est plus susceptible d’induire en erreur que d’informer.

Certains articles contiennent des informations relatives à plusieurs versions de SQL Server. Chaque moniker normal masque les sections avec version qui pourraient afficher des informations inexactes, confuses ou contradictoires pour la version du moniker. Le moniker All SQL (Tout SQL) spécial affichant toutes les sections avec version, l’affichage d’informations inexactes pourrait passer inaperçu.

Message : La page demandée n’est pas disponible pour <moniker>

Le scénario suivant entraîne l’affichage d’un message d’information en haut de la page web Docs :

  1. Le moniker de gestion de versions est SQL Server 2017.
  2. Vous lisez un article qui concerne SQL Server 2017.
    • L’article ne concerne pas le produit Azure SQL Database.
  3. Vous tentez de définir le moniker sur Azure SQL Database - current (Azure SQL Database - version actuelle).
  4. Vous voyez que votre tentative a été rejetée et un message s’affiche.

À la fin de ce scénario, le message d’information suivant s’affiche en haut de la page web Docs :

La page demandée n’est pas disponible pour Azure SQL Database - current (Azure SQL Database - version actuelle). Vous avez été redirigé vers la dernière version du produit pour laquelle cette page est disponible.

La versionla plus récente peut exclure les versions qui ne sont pas encore entièrement publiées et qui sont en préversion.

media_versioning-control-30-viewfallbackfrom.png

Versions antérieures de SQL Server

Le système de gestion de versions est entièrement implémenté pour SQL Server versions 2016 et ultérieures.

  • Versions 2012 et antérieures : le système de gestion de versions n’est pas utilisé pour SQL Server versions 2012 et antérieures.

    • Le moniker spécial SQL Server - older (SQL Server - version antérieure) est destiné à masquer presque tous les articles. Les rares exceptions sont quelques articles dont peuvent avoir besoin les clients de versions antérieures.
    • Versions antérieures de SQL Server, 2012-2005
  • 2014 : le système de gestion de versions est partiellement implémenté pour SQL Server 2014. Vous pouvez choisir SQL Server 2014 dans le contrôle de gestion de versions ; cela fonctionne. Toutefois, en interne, les fichiers pour 2014 sont dédiés uniquement à 2014, de la même façon que les fichiers pour 2008 sont dédiés uniquement à 2008.

  • Versions 2016 et ultérieures : le système de gestion de versions est entièrement implémenté pour SQL Server versions 2016 et ultérieures.

Voir aussi

Versions antérieures de SQL Server, 2014-2005
Guide de navigation dans la documentation de SQL Server
Guide pratique pour contribuer à la documentation SQL Server