Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
gäller för:
SQL ServerAzure SQL DatabaseAzure Synapse AnalyticsAnalytics Platform System (PDW)
Den här artikeln beskriver vårt versionshanteringssystem för SQL-dokumentationen. Versionssystemet känner till produkter och deras versioner. Med systemet kan du välja den produkt och version som du är intresserad av. Systemet visar sedan lämplig dokumentation.
Gäller för produkter
De flesta SQL Server-artiklar har orden Gäller för under rubriken. På samma rad följer en praktisk lista över SQL-produkter med indikatorer på om artikeln är relevant för produkten. Till exempel kan produkten SQL Server anges som relevant, medan Azure SQL Database kan anges som irrelevant för artikeln.
Raden Gäller känner inte till versioner av produkter. Vi strävar efter att undvika avvikelser mellan raden Gäller för och produktaspekten i våra versionssystemkonfigurationer.
Historik för separata filuppsättningar
För SQL Server 2014 och tidigare versioner har varje version en egen separat kopia av dokumentationsfilerna. Dokumentationen för SQL Server 2014 började till exempel som en kopia av dokumentationen för SQL Server 2012. 2014-kopian redigerades sedan under produktutvecklingscykeln.
Detta gamla tillvägagångssätt innebar att om en brist upptäcktes i 2014-dokumentationen kan felet också finnas 2012 och 2008. Detta gjorde det svårare att åtgärda brister och allmänt underhåll.
Flera versioner i samma filer
Därför är dokumentationsfilerna för SQL Server 2016 också för 2017, 2019 och förmodligen för <vNext>. Den här konsolideringen är praktisk eftersom vi nu tilldelar versionsmonikers till våra SQL Server-dokumentationsfiler. Versionsmonikers tilldelas, eller är uttryckligen inbäddade, oavsett vilken grad av kornighet som passar för varje angiven dokumentationsfil.
Versionshanteringskontroll i användargränssnittet
När du visar en SQL-dokumentationsartikel med hjälp av vår Docs webbplats visas den aktuella versionsmonikern ovanför innehållsförteckningen (TOC). Kontrollen är en listruta.
Om du vill se dokumentationen för en annan version av SQL Server väljer du expanderpilen som finns i slutet av den aktuella versionens moniker. Välj sedan vilken kombination av produkt och version du vill ha. När du väljer en annan version ändras den visade dokumentationen plötsligt för att visa skillnaderna för den nyligen valda versionen. Det kan finnas eller kanske inte finns några ändringar, och båda fallen är vanliga.
HTTPS-parameter view=
Varje artikel vars webbadress börjar med har en parameter med https://free.blessedness.top/sql/ namnet ?view= bifogad till adressen. Det här parametervärdet är versionsmonikerkoden.
Moniker-koden i https adressen matchar alltid monikernamnet som visas i versionskontrollen.
Produkter, inte utgåvor
Upplagor
Under 1990-talet och in på 2000-talet hade Microsoft SQL Server bara en produkt. Det fanns olika utgåvor av varje version av SQL Server, till exempel developer - och Enterprise-utgåvorna av SQL Server 2008. Utgåvorna representerade något olika funktionsuppsättningar, men kärnprodukten var densamma. Nya SQL Server-versioner kan fortfarande ha en mängd olika utgåvor.
Produkter
Med den senaste ökningen av molnbaserad databehandling och Microsoft Azure släppte Microsoft sin Azure SQL Database-produkt. Även om det finns mycket kod som delas av både den traditionella lokala SQL Server-produkten och Azure SQL Database-produkten, är dessa produkter två verkligt separata produkter.
För SQL gör versionsmonikers skillnad mellan produkter, men inte mellan utgåvor.
Azure Cloud SQL-produkter
För artiklar som hela webbadresser börjar med https://free.blessedness.top/sql/gäller nästan alla för minst en version av produkten med namnet SQL Server. En stor delmängd av dessa artiklar gäller även för en eller flera av våra SQL-tjänstprodukter som finns i vårt Azure-moln. En sådan SQL-molnprodukt heter Azure SQL Database.
Azure SQL Database-produkten har naturligtvis bara en version. Nästan alla artiklar som gäller för Azure SQL Database, men inte för SQL Server, har webbadresser som börjar med https://free.blessedness.top/azure/sql-database/.
Scenarier med versionsfiltrering
Versionssystemet fungerar genom att filtrera bort allt dokumentationsinnehåll som inte gäller för den aktiva monikern. Varje gång du väljer en annan versionsmoniker, uppsättning innehåll som är dolda ändringar. Filtreringen döljer innehåll på följande nivåer:
- Avsnitt eller meningar i en artikel.
- Poster för artiklar i innehållsförteckningen (TOC).
Nästa är scenarier som förklarar effekterna av att välja en annan moniker.
Scenario 1: I den aktuella artikeln
Följande scenario fokuserar på avsnitt i din aktuella artikel:
- Den aktuella versionsmonikern är SQL Server 2017.
- Du läser ett avsnitt som beskriver en funktion som först lades till i version 2017 av SQL Server.
- Du ändrar monikern till SQL Server 2016.
- Du märker att avsnittet du läste är borta.
- Du ändrar monikern igen, den här gången till SQL Server 2019.
- Du märker att avsnittet 2017 som du läste visas igen.
I föregående scenario är avsnittet om den nya 2017-funktionen troligen markerat med ett monikerintervall som innehåller följande monikerkod:
>=sql-server-2017
När moniker SQL Server 2019 valdes insåg versionssystemet att 2019 är större än eller lika med 2017, och det visade avsnittet.
Scenario 2: Välj en länk till en dold artikel
Följande ovanliga scenario förklarar vad som händer om du väljer en länk till en artikel som för närvarande är dold från innehållsförteckningen (TOC). I korthet fungerar länken:
- Den aktuella versionsmonikern är SQL Server 2017.
- I den aktuella artikeln Aväljer du en länk till en artikel B som endast gäller för SQL Server 2016.
- Innan markeringen har innehållsförteckningen dess post för artikeln B dold.
- Efter markeringen visas artikeln B .
- Visningen av artikeln B tvingar versionskontrollen att växla till SQL Server 2016-monikern .
- Eftersom den ursprungliga monikern SQL Server 2017 måste överges. Detta innebär att ett informationsmeddelande visas överst på webbsidan. Meddelandet förklarar att den aktuella monikern måste bytas för att rymma den nya artikeln B.
Scenario 3: Navigera till en https-adress
Följande artikel har lagts till som ny för SQL Server 2017. Artikeln beskriver funktioner som lades till i SQL Server i version 2017. De flesta eller alla dessa nya funktioner är också en del av version 2019. Här är artikelns attribut.
| Attribute | Värde |
|---|---|
| Titel | Nyheter i SQL Server 2017 |
| monikerintervall | =">= sql-server-2017" |
https adress |
https://free.blessedness.top/sql/sql-server/what-s-new-in-sql-server-2017 |
Med tanke på basadressen https förklarar följande tabell vad som händer när parametern ?view= läggs till av användaren och med olika värden.
Värdet för ?view= |
Beteende för https adressnavigering |
|---|---|
| (Ingen parameter) | Versionssystemet skulle prova sitt standardmonikervärde. Vanligtvis anger vi detta till den senaste versionen av SQL Server som inte är förhandsversion. Ett standardvärde för SQL Server 2017 eller 2019 skulle uppfylla attributet >= sql-server-2017.Systemet skulle lägga till parametern till https adressen, kanske som ?view=sql-server-2017.Listrutekontrollen för versionshantering skulle sedan ställas in på matchningsmonikernamnet. |
sql-server-2016 |
Versionssystemet skulle inse att artikelns monikerintervall inte innehåller version 2016. Systemet skulle sedan välja en av de monikers som uppfyller intervallet. Precis som i fallet med version 2016 läggs parametern ?view= till och kontrollnamnet matchar parametervärdet. |
sql-server-2017 |
Versionssystemet förstår att parametervärdet ingår i artikelns monikerintervall. Versionskontrollen skulle anges så att den matchar parametervärdet. |
sql-server-2019 |
Samma som för värdet sql-server-2017, förutom att parametern och kontrollen är inställda på 2019. |
Alla SQL - Dölj ingenting, speciell moniker
Det finns ett särskilt monikerproduktnamn för All SQL, och dess enda version är Dölj ingenting. Syftet med denna moniker är för intern testning av vissa ändringar. Om den används av en kund är det mer sannolikt att den här monikern vilseleder än informerar.
Vissa artiklar innehåller information som rör flera versioner av SQL Server. Varje vanlig moniker döljer versionsavsnitt som annars kan visa information som är felaktig, förvirrande eller motstridig för monikerns version. Den speciella All SQL-monikern skulle visa alla versionsavsnitt och det kanske inte är uppenbart att felaktig information visas.
Meddelande: Den begärda sidan är inte tillgänglig för <moniker>
Följande scenario leder till att ett informationsmeddelande visas längst upp på webbsidan Docs :
- Versionsmonikern är för närvarande SQL Server 2017.
- Du läser en artikel som är relevant för SQL Server 2017.
- Artikeln är inte relevant för produkten Azure SQL Database.
- Du försöker ändra monikern till Azure SQL Database – aktuell.
- Du ser att ditt försök avvisades och ett meddelande visas.
I slutet av det här scenariot visas följande informationsmeddelande längst upp på Docs-webbsidan:
Den begärda sidan är inte tillgänglig för Azure SQL Database – aktuell. Du har omdirigerats till den senaste produktversionen som den här sidan är tillgänglig för.
Den senaste versionen kan exkludera versioner som ännu inte har släppts helt och är i förhandsversionsstatus .
Tidigare versioner av SQL Server
Versionssystemet är fullständigt implementerat för SQL Server version 2016 och senare.
2012 och tidigare: Versionssystemet används inte för SQL Server 2012 eller tidigare versioner.
- Den speciella monikern för SQL Server – äldre är avsedd att dölja nästan alla artiklar. De sällsynta undantagen är ett par artiklar som kunder med äldre versioner kan behöva en gång.
- Tidigare versioner av SQL Server-dokumentation
2014: Versionssystemet är hälften implementerat för SQL Server 2014. Du kan välja SQL Server 2014 i versionskontrollen och det fungerar. Men internt är filerna för 2014 dedikerade till bara 2014, på samma sätt som filerna för 2008 är dedikerade till bara 2008.
2016 och senare: Versionssystemet är fullständigt implementerat för SQL Server 2016 och senare versioner.