Sdílet prostřednictvím


Dokumentace k systému správy verzí pro SQL

platí pro:SQL ServerAzure SQL DatabaseAzure Synapse AnalyticsAnalytics Platform System (PDW)

Tento článek vysvětluje náš systém správy verzí pro dokumentaci k SQL. Systém správy verzí zná produkty a jejich verze. Systém umožňuje zvolit produkt a verzi, které vás zajímají. Systém pak zobrazí příslušnou dokumentaci.

Platí pro produkty.

Většinačlánkůch Na stejném řádku následuje praktický seznam produktů SQL s indikátory, zda je článek relevantní pro produkt. Například produkt SQL Server může být označen jako relevantní, zatímco Azure SQL Database může být označen jako irelevantní pro článek.

Řádek Platí pro nevědí o verzích produktů. Snažíme se vyhnout nesrovnalostem mezi řádky a produkty našeho systému správy verzí.

Historie samostatných sad souborů

Pro SQL Server 2014 a starší verze má každá verze svou vlastní úplnou samostatnou kopii souborů dokumentace. Například dokumentace pro SQL Server 2014 začala jako kopie dokumentace pro SQL Server 2012. Kopie z roku 2014 byla poté upravena během cyklu vývoje produktu.

Tento starý přístup znamenal, že pokud se v dokumentaci z roku 2014 objevila chyba, může tato chyba existovat i v roce 2012 a 2008. To ztěžovalo opravy chyb a obecné údržby.

Více verzí ve stejných souborech

Z tohoto důvodu a další jsou soubory dokumentace pro SQL Server 2016 také pro 2017, 2019 a pravděpodobně pro <vNext>. Tato konsolidace je praktická, protože teď k souborům dokumentace k SQL Serveru přiřazujeme monikery správy verzí . Správce verzí se přiřazuje nebo explicitně vkládá v libovolné míře členitosti pro každý daný soubor dokumentace.

Správa verzí v uživatelském rozhraní

Při prohlížení libovolného článku dokumentace k SQL pomocí našeho Docs webu je aktuálně zvolený moniker správy verzí viditelný nad obsahem (TOC). Ovládací prvek je rozevírací seznam.

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

Pokud chcete zobrazit dokumentaci pro jinou verzi SQL Serveru, vyberte šipku rozbalovacího modulu umístěnou na konci monikeru aktuální verze. Pak vyberte libovolnou kombinaci produktu a verze, kterou chcete použít. Když vyberete jinou verzi, zobrazená dokumentace se náhle změní tak, aby zobrazovala rozdíly pro nově zvolenou verzi. Můžou nebo nemusí existovat žádné změny a oba případy jsou běžné.

media_versioning-control-20-expanded.png

Parametr HTTPS view=

Každý článek, jehož webová adresa začíná, https://learn.microsoft.com/sql/ má parametr s názvem ?view= připojený k jeho adrese. Tato hodnota parametru je kód monikeru pro správu verzí.

Kód monikeru https v adrese se vždy shoduje s názvem monikeru, který se zobrazí v ovládacím prvku správy verzí.

Produkty, ne edice

Edice

V roce 1990 a do roku 2000 měl Microsoft SQL Server pouze jeden produkt. Existují různé edice každé verze SQL Serveru, jako jsou edice Developer a Enterprise SYSTÉMU SQL Server 2008. Edice představovaly mírně odlišné sady funkcí, ale základní produkt byl stejný. Nové verze SQL Serveru můžou mít stále celou řadu edicí.

Products

S novějším nárůstem cloud computingu a Microsoft Azure společnost Microsoft vydala svůj produkt Azure SQL Database. I když existuje mnoho kódu, který sdílí tradiční místní produkt SQL Serveru i produkt Azure SQL Database, jsou tyto produkty dvěma skutečně samostatnými produkty.

V případě SQL se správa verzí liší mezi produkty, ale ne mezi edicemi.

Cloudové produkty SQL Azure

U článků, na https://learn.microsoft.com/sql/které začínají celé webové adresy, se téměř všechny vztahují alespoň na jednu verzi produktu s názvem SQL Server. Velká podmnožina těchto článků platí také pro jeden nebo více našich produktů služby SQL hostovaných v cloudu Azure. Jeden takový cloudový produkt SQL má název Azure SQL Database.

Produkt Azure SQL Database má přirozeně jenom jednu verzi. Téměř všechny články, které platí pro Azure SQL Database, ale ne pro SQL Server, mají webové adresy začínající https://learn.microsoft.com/azure/sql-database/na .

Scénáře filtrování verzí

Systém správy verzí funguje tak, že vyfiltruje veškerý obsah dokumentace, který se nevztahuje na aktuálně aktivní moniker. Pokaždé, když zvolíte jiný moniker správy verzí, sada obsahu, který je skrytý změny. Filtrování skryje obsah na následujících úrovních:

  • Oddíly nebo věty v článku
  • Položky článků v obsahu (TOC).

Dále jsou scénáře, které vysvětlují účinky výběru jiného monikeru.

Scénář 1: V aktuálním článku

Následující scénář se zaměřuje na oddíly v aktuálním článku:

  1. Aktuální moniker správy verzí je SQL Server 2017.
  2. Čtete část, která popisuje funkci, která byla poprvé přidána do verze 2017 SQL Serveru.
  3. Změníte moniker na SQL Server 2016.
  4. Všimli jste si, že oddíl, který jste četli, je pryč.
  5. Znovu změníte moniker, tentokrát na SQL Server 2019.
  6. Všimli jste si, že oddíl 2017, který jste četli, je zpátky na displeji.

V předchozím scénáři je část o nové funkci 2017 pravděpodobně označena rozsahem moniker , který obsahuje následující kód monikeru:

  • >=sql-server-2017

Když byl vybrán moniker SQL Server 2019 , systém správy verzí zjistil, že 2019 je větší než nebo rovno 2017 a zobrazil oddíl.

Scénář 2: Výběr odkazu na skrytý článek

Následující neobvyklý scénář vysvětluje, co se stane, když vyberete odkaz na článek, který je aktuálně skrytý z obsahu (TOC). Stručně řečeno, odkaz funguje:

  1. Aktuální moniker správy verzí je SQL Server 2017.
  2. V aktuálním článku Avyberete odkaz na článek B , který se vztahuje pouze na SQL Server 2016.
    • Před výběrem má obsah jeho položku pro článek B skrytý.
  3. Po výběru B se článek zobrazí.
    • Zobrazení článku B vynutí ovládací prvek správy verzí přepnout na moniker SQL Serveru 2016 .
    • Protože původní moniker SQL Server 2017 musel být opuštěn. Toto opuštění způsobí, že se v horní části webové stránky zobrazí informační zpráva. Zpráva vysvětluje, že aktuální moniker musel být přepínán tak, aby vyhovoval novému článku B.

Scénář 3: Přechod na adresu HTTPS

Následující článek byl přidán nový pro SQL Server 2017. Článek popisuje funkce přidané do SQL Serveru ve verzi 2017. Většina nebo všechny tyto nové funkce jsou také součástí verze 2019. Tady jsou atributy článku.

Vlastnost Hodnota
Title Novinky v SQL Serveru 2017
Rozsah monikerů =">= sql-server-2017"
https adresa https://learn.microsoft.com/sql/sql-server/what-s-new-in-sql-server-2017

Vzhledem k základní https adrese vysvětluje následující tabulka, co se stane, když ?view= uživatel připojí parametr a s různými hodnotami.

Hodnota ?view= Chování navigace v https adrese
(Žádný parametr) Systém správy verzí by zkusil výchozí hodnotu monikeru. Obvykle jsme tuto možnost nastavili na nejnovější verzi SQL Serveru, která není ve verzi Preview.

Výchozí hodnota SQL Serveru 2017 nebo 2019 by splňovala atribut >= sql-server-2017.

Systém by připojil parametr k https adrese, možná jako ?view=sql-server-2017.
Ovládací prvek rozevíracího seznamu správy verzí by se pak nastavil na odpovídající název monikeru.
sql-server-2016 Systém správy verzí by si uvědomil, že rozsah moniker článku neobsahuje verzi 2016.

Systém by pak zvolil jeden z monikers, který vyhovuje rozsahu.

Stejně jako v případě verze 2016 se parametr ?view= připojí a název ovládacího prvku bude odpovídat hodnotě parametru.
sql-server-2017 Systém správy verzí rozumí tomu, že hodnota parametru je zahrnuta v rozsahu moniker článku.

Ovládací prvek správy verzí by se nastavil tak, aby odpovídal hodnotě parametru.
sql-server-2019 Stejné jako pro případ hodnoty sql-server-2017, s výjimkou parametru a ovládacího prvku jsou nastaveny na 2019.

Vše SQL – Skrytí nic, speciální moniker

Existuje jeden speciální název produktu Moniker All SQL a jeho jediná verze je Skrýt nic. Účelem tohoto monikeru je interní testování určitých změn. Pokud ho zákazník používá, bude tento moniker pravděpodobně omylem, než informovat.

Některé články obsahují informace týkající se více verzí SQL Serveru. Každý běžný moniker skryje oddíly s verzemi, které by jinak mohly zobrazovat informace, které jsou nepřesné, matoucí nebo v rozporu s verzí monikeru. Speciální moniker SQL by zobrazil všechny oddíly verze a nemusí být zřejmé, že se zobrazují nepřesné informace.

Zpráva: Požadovaná stránka není k dispozici pro <moniker>

Následující scénář vede k zobrazení informační zprávy v horní části Docs webové stránky:

  1. V současné době je moniker správy verzí SQL Server 2017.
  2. Čtete článek, který je relevantní pro SQL Server 2017.
    • Článek není relevantní pro produkt Azure SQL Database.
  3. Pokusíte se změnit moniker na Azure SQL Database – aktuální.
  4. Uvidíte, že váš pokus byl odmítnut a zobrazí se zpráva.

Na konci tohoto scénáře se zobrazí následující informační zpráva zobrazená v horní části webové stránky Docs:

Požadovaná stránka není dostupná pro Azure SQL Database – aktuální. Byli jste přesměrováni na nejnovější verzi produktu, pro kterou je tato stránka k dispozici.

Nejnovější verze může vyloučit verze, které ještě nejsou plně vydané a jsou ve stavu Preview.

media_versioning-control-30-viewfallbackfrom.png

Předchozí verze SQL Serveru

Systém správy verzí je plně implementovaný pro SQL Server verze 2016.