Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
van toepassing op:
SQL ServerAzure SQL DatabaseAzure Synapse AnalyticsAnalytics Platform System (PDW)
In dit artikel wordt ons versiebeheersysteem voor SQL-documentatie uitgelegd. Het versiebeheersysteem weet van producten en hun versies. Met het systeem kunt u het product en de versie kiezen waarin u geïnteresseerd bent. Het systeem geeft vervolgens de juiste documentatie weer.
Van toepassing op producten
De meeste SQL Server-artikelen bevatten de woorden Van toepassing op onder hun titel. Op dezelfde regel volgt een handige lijst met SQL-producten met indicatoren of het artikel relevant is voor het product. Het product SQL Server kan bijvoorbeeld worden aangegeven als relevant, terwijl Azure SQL Database kan worden aangegeven als irrelevant voor het artikel.
De regel Van toepassing op weet niet over versies van producten. We streven ernaar om discrepanties tussen de lijn en het productaspect van onze versiesysteemconfiguraties te voorkomen.
Geschiedenis van afzonderlijke bestandssets
Voor SQL Server 2014 en eerdere versies heeft elke versie een eigen volledige afzonderlijke kopie van de documentatiebestanden. De documentatie voor SQL Server 2014 is bijvoorbeeld begonnen als een kopie van de documentatie voor SQL Server 2012. De kopie van 2014 is vervolgens bewerkt tijdens de productontwikkelingscyclus.
Deze oude benadering betekende dat als er een fout werd ontdekt in de documentatie van 2014, de fout ook in 2012 en 2008 zou kunnen bestaan. Dit maakte het oplossen van fouten en algemeen onderhoud moeilijker.
Meerdere versies in dezelfde bestanden
Daarom en anderen zijn de documentatiebestanden voor SQL Server 2016 ook voor 2017, 2019 en waarschijnlijk voor <vNext>. Deze samenvoeging wordt praktisch gemaakt omdat we nu versiebeheer monikers toewijzen aan onze SQL Server-documentatiebestanden. De versiebeheer monikers worden toegewezen, of worden expliciet ingesloten, ongeacht de mate van granulariteit die zinvol is voor elk gegeven documentatiebestand.
Versiebeheer in de gebruikersinterface
Wanneer u een SQL-documentatieartikel bekijkt met behulp van onze Docs website, is de momenteel gekozen versiebeheerfunctie zichtbaar boven de inhoudsopgave (Inhoudsopgave). Het besturingselement is een vervolgkeuzelijst.
Als u de documentatie voor een andere versie van SQL Server wilt bekijken, selecteert u de uitbreidingspijl aan het einde van de huidige versie moniker. Kies vervolgens een product- en versiecombinatie die u wilt gebruiken. Wanneer u een andere versie selecteert, verandert de weergegeven documentatie plotseling om de verschillen voor de zojuist gekozen versie weer te geven. Er kunnen al dan niet wijzigingen zijn, en beide gevallen zijn gebruikelijk.
HTTPS-parameter view=
Elk artikel waarvan het webadres begint, https://free.blessedness.top/sql/ heeft een parameter met de naam ?view= toegevoegd aan het adres. Deze parameterwaarde is de monikercode voor versiebeheer.
De monikercode in het https adres komt altijd overeen met de naam van de moniker die wordt weergegeven in het versiebeheer.
Producten, niet edities
Edities
In de jaren '990 en in de jaren '2000 had Microsoft SQL Server slechts één product. Er waren verschillende edities van elke versie van SQL Server, zoals de Developer - en Enterprise-edities van SQL Server 2008. De edities vertegenwoordigden iets verschillende functiesets, maar het kernproduct was hetzelfde. Nieuwe SQL Server-releases kunnen nog steeds verschillende edities hebben.
Products
Met de recentere opkomst van cloud-computing en Microsoft Azure heeft Microsoft het Azure SQL Database-product uitgebracht. Hoewel er veel code wordt gedeeld door zowel het traditionele on-premises SQL Server-product als het Azure SQL Database-product, zijn deze producten twee echt afzonderlijke producten.
Voor SQL maken versiebeheer-monikers onderscheid tussen producten, maar niet tussen edities.
Azure Cloud SQL-producten
Voor artikelen beginnen hele webadressen met https://free.blessedness.top/sql/, bijna alle van toepassing op ten minste één versie van het product met de naam SQL Server. Een grote subset van deze artikelen is ook van toepassing op een of meer van onze SQL-serviceproducten die worden gehost in onze Azure-cloud. Een dergelijk SQL-cloudproduct heet Azure SQL Database.
Het Azure SQL Database-product heeft natuurlijk slechts één versie. Bijna alle artikelen die van toepassing zijn op Azure SQL Database, maar niet op SQL Server, hebben webadressen die beginnen met https://free.blessedness.top/azure/sql-database/.
Scenario's van versiefiltering
Het versiebeheersysteem werkt door alle documentatie-inhoud te filteren die niet van toepassing is op de momenteel actieve moniker. Telkens wanneer u een andere versiebeheer moniker kiest, bevat een set inhoud die verborgen wijzigingen bevat. Het filteren verbergt inhoud op de volgende niveaus:
- Secties of zinnen in een artikel.
- Vermeldingen voor artikelen in de inhoudsopgave (inhoudsopgave).
Hierna volgen scenario's waarin de effecten van het kiezen van een andere moniker worden uitgelegd.
Scenario 1: Binnen het huidige artikel
Het volgende scenario is gericht op secties in uw huidige artikel:
- De huidige versiebeheer moniker is SQL Server 2017.
- U leest een sectie met een beschrijving van een functie die voor het eerst is toegevoegd aan versie 2017 van SQL Server.
- U wijzigt de moniker in SQL Server 2016.
- U ziet dat de sectie die u hebt gelezen, is verdwenen.
- U wijzigt de moniker opnieuw, deze keer in SQL Server 2019.
- U ziet dat de sectie 2017 die u hebt gelezen, weer wordt weergegeven.
In het voorgaande scenario wordt de sectie over de nieuwe functie 2017 waarschijnlijk gemarkeerd met een monikerbereik dat de volgende monikercode bevat:
>=sql-server-2017
Toen de moniker SQL Server 2019 werd gekozen, realiseerde het versiebeheersysteem zich dat 2019 groter dan of gelijk aan 2017 is en dat de sectie werd weergegeven.
Scenario 2: Selecteer een koppeling naar een verborgen artikel
In het volgende ongebruikelijke scenario wordt uitgelegd wat er gebeurt als u een koppeling selecteert naar een artikel dat momenteel verborgen is in de inhoudsopgave (INHOUDSopgave). Kortom, de koppeling werkt:
- De huidige versiebeheer moniker is SQL Server 2017.
- In het huidige artikel Aselecteert u een koppeling naar een artikel B dat alleen van toepassing is op SQL Server 2016.
- Voordat de selectie wordt geselecteerd, heeft de inhoudsopgave de vermelding voor het artikel B verborgen.
- Na de selectie wordt het artikel B weergegeven.
- De weergave van artikel B dwingt het versiebeheer om over te schakelen naar de SQL Server 2016-moniker .
- Omdat de oorspronkelijke moniker SQL Server 2017 moest worden afgetrokken. Deze afbreking zorgt ervoor dat een informatief bericht boven aan de webpagina wordt weergegeven. In het bericht wordt uitgelegd dat de huidige moniker moest worden overgeschakeld naar het nieuwe artikel B.
Scenario 3: Naar een https-adres navigeren
Het volgende artikel is nieuw toegevoegd voor SQL Server 2017. In het artikel worden functies beschreven die zijn toegevoegd aan SQL Server in versie 2017. De meeste of alle nieuwe functies maken ook deel uit van versie 2019. Dit zijn de kenmerken van het artikel.
| Attribute | Waarde |
|---|---|
| Title | Nieuw in SQL Server 2017 |
| monikerbereik | =">= sql-server-2017" |
https adres |
https://free.blessedness.top/sql/sql-server/what-s-new-in-sql-server-2017 |
Op basis van het basisadres https wordt in de volgende tabel uitgelegd wat er gebeurt wanneer de ?view= parameter wordt toegevoegd door de gebruiker en met verschillende waarden.
Waarde van ?view= |
Gedrag van de https adresnavigatie |
|---|---|
| (Geen parameter) | Het versiebeheersysteem zou de standaardwaarde voor moniker proberen. Normaal gesproken stellen we dit in op de nieuwste niet-preview-versie van SQL Server. Een standaardwaarde van SQL Server 2017 of 2019 voldoet aan het kenmerk >= sql-server-2017.Het systeem zou de parameter toevoegen aan het https adres, misschien als ?view=sql-server-2017.Het besturingselement voor de vervolgkeuzelijst voor versiebeheer wordt vervolgens ingesteld op de naam van de overeenkomende moniker. |
sql-server-2016 |
Het versiebeheersysteem realiseert zich dat het monikerbereik van het artikel geen versie 2016 bevat. Het systeem zou vervolgens een van de monikers kiezen die wel aan het bereik voldoen. Net als in versie 2016 zou de parameter ?view= worden toegevoegd en komt de naam van het besturingselement overeen met de parameterwaarde. |
sql-server-2017 |
Het versiebeheersysteem begrijpt dat de parameterwaarde is opgenomen in het monikerbereik van het artikel. Het versiebeheer wordt ingesteld op overeenstemming met de parameterwaarde. |
sql-server-2019 |
Hetzelfde als voor het geval van waarde sql-server-2017, behalve de parameter en het besturingselement zijn ingesteld op 2019. |
Alle SQL- Niets verbergen, speciale moniker
Er is één speciale monikerproductnaam van All SQL en de enige versie is Hide nothing. Het doel van deze moniker is voor interne tests van bepaalde wijzigingen. Als deze wordt gebruikt door een klant, is deze moniker waarschijnlijk meer misleid dan om te informeren.
Sommige artikelen bevatten informatie over meerdere versies van SQL Server. Elke reguliere moniker verbergt versiesecties die anders informatie kunnen weergeven die onnauwkeurig, verwarrend of tegenstrijdig is voor de versie van de moniker. De speciale SQL-moniker zou alle versiesecties weergeven en het is mogelijk niet duidelijk dat onjuiste informatie wordt weergegeven.
Bericht: De aangevraagde pagina is niet beschikbaar voor <moniker>
Het volgende scenario leidt tot de weergave van een informatiebericht boven aan de Docs webpagina:
- Momenteel is de versiebeheer moniker SQL Server 2017.
- U leest een artikel dat relevant is voor SQL Server 2017.
- Het artikel is niet relevant voor het product Azure SQL Database.
- U probeert de moniker te wijzigen in Azure SQL Database - actueel.
- U ziet dat uw poging is geweigerd en er wordt een bericht weergegeven.
Aan het einde van dit scenario ziet u het volgende informatieve bericht boven aan de docs-webpagina:
De aangevraagde pagina is niet beschikbaar voor Azure SQL Database - actueel. U bent omgeleid naar de nieuwste productversie waarvoor deze pagina beschikbaar is.
De nieuwste versie kan versies uitsluiten die nog niet volledig zijn uitgebracht en de preview-status hebben.
Vorige versies van SQL Server
Het versiebeheersysteem is volledig geïmplementeerd voor SQL Server versie 2016.
2012 en eerder: Het versiebeheersysteem wordt niet gebruikt voor SQL Server 2012 of eerdere versies.
- De speciale moniker van SQL Server- ouder is bedoeld om bijna alle artikelen te verbergen. De zeldzame uitzonderingen zijn een aantal artikelen die klanten van oudere versies mogelijk eenmaal nodig hebben.
- Vorige versies van SQL Server-documentatie
2014: Het versiebeheersysteem is half geïmplementeerd voor SQL Server 2014. U kunt SQL Server 2014 kiezen in het versiebeheer en het werkt. Maar intern zijn de bestanden voor 2014 toegewezen aan slechts 2014, op dezelfde manier als de bestanden voor 2008 zijn toegewezen aan slechts 2008.
2016 en hoger: Het versiebeheersysteem is volledig geïmplementeerd voor SQL Server 2016 en nieuwere versies.