Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy:
programu SQL ServerAzure SQL DatabaseAzure Synapse AnalyticsAnalytics Platform System (PDW)
W tym artykule wyjaśniono nasz system przechowywania wersji dla dokumentacji sql. System przechowywania wersji wie o produktach i ich wersjach. System umożliwia wybranie interesującego Cię produktu i wersji. Następnie system wyświetla odpowiednią dokumentację.
Dotyczy produktów
Większość artykułów programu SQL Server ma wyrazy Dotyczy pod ich tytułem. W tym samym wierszu znajduje się przydatna lista produktów SQL ze wskaźnikami, czy artykuł jest odpowiedni dla produktu. Na przykład produkt SQL Server może być wskazany jako odpowiedni, podczas gdy usługa Azure SQL Database może być wskazana jako nieistotna dla artykułu.
Wiersz Dotyczy nie wie o wersjach produktów. Staramy się unikać rozbieżności między elementem Zastosuj do linii i aspektem produktów konfiguracji systemu przechowywania wersji.
Historia oddzielnych zestawów plików
W przypadku programu SQL Server 2014 i starszych wersji każda wersja ma własną pełną kopię plików dokumentacji. Na przykład dokumentacja programu SQL Server 2014 rozpoczęła się jako kopia dokumentacji programu SQL Server 2012. Kopia z 2014 r. została następnie edytowana podczas cyklu tworzenia produktu.
To stare podejście oznaczało, że jeśli w dokumentacji z 2014 r. wykryto wadę, w 2012 i 2008 r. może istnieć również wada. To sprawiło, że naprawienie wad i ogólnej konserwacji było trudniejsze.
Wiele wersji w tych samych plikach
Z tego powodu i inne pliki dokumentacji programu SQL Server 2016 są również przeznaczone dla wersji 2017, 2019 i prawdopodobnie dla programu <vNext>. Ta konsolidacja jest praktyczna, ponieważ teraz przypisujemy narzędzia do obsługi wersji do plików dokumentacji programu SQL Server. Elementy monikerów przechowywania wersji są przypisywane lub są jawnie osadzone, w jakimkolwiek stopniu szczegółowości ma sens dla każdego danego pliku dokumentacji.
Kontrola wersji w interfejsie użytkownika
Podczas przeglądania dowolnego artykułu dokumentacji SQL przy użyciu naszej Docs witryny internetowej aktualnie wybranego pseudonimu przechowywania wersji jest widoczny nad spisem treści (TOC). Kontrolka jest listą rozwijaną.
Jeśli chcesz wyświetlić dokumentację dla innej wersji programu SQL Server, wybierz strzałkę rozwijania znajdującą się na końcu bieżącego pseudonimu wersji. Następnie wybierz dowolną kombinację produktu i wersji. Po wybraniu innej wersji wyświetlana dokumentacja nagle zmieni się, aby pokazać różnice dla nowo wybranej wersji. Mogą występować jakiekolwiek zmiany, a oba przypadki są powszechne.
Parametr HTTPS view=
Każdy artykuł, którego adres internetowy zaczyna się od https://learn.microsoft.com/sql/ , ma parametr o nazwie ?view= dołączany do jego adresu. Ta wartość parametru jest wersjonowaniem kodu moniker.
Kod moniker w adresie https zawsze odpowiada nazwie moniker wyświetlanej w kontrolce przechowywania wersji.
Produkty, a nie wersje
Edycje
W 1990 roku i w 2000 roku program Microsoft SQL Server miał tylko jeden produkt. W każdej wersji programu SQL Server były różne wersje , takie jak wersje Developer i Enterprise programu SQL Server 2008. Wersje reprezentowały nieco inne zestawy funkcji, ale podstawowy produkt był taki sam. Nowe wersje programu SQL Server mogą nadal mieć różne wersje.
Products
Wraz z najnowszym wzrostem przetwarzania w chmurze i platformy Microsoft Azure firma Microsoft wydała swój produkt Azure SQL Database. Chociaż istnieje wiele kodu współużytkowanego zarówno przez tradycyjny produkt lokalny programu SQL Server, jak i produkt usługi Azure SQL Database, te produkty są dwoma naprawdę oddzielnymi produktami.
W przypadku języka SQL wersje monikers rozróżniają produkty, ale nie między wersjami.
Produkty Sql w chmurze platformy Azure
W przypadku artykułów całych adresów internetowych zaczyna się od https://learn.microsoft.com/sql/, prawie wszystkie dotyczą co najmniej jednej wersji produktu o nazwie SQL Server. Duży podzbiór tych artykułów dotyczy również co najmniej jednego produktu usługi SQL hostowanego w chmurze platformy Azure. Jeden z takich produktów w chmurze SQL nosi nazwę Azure SQL Database.
Oczywiście produkt usługi Azure SQL Database ma tylko jedną wersję. Prawie wszystkie artykuły dotyczące usługi Azure SQL Database, ale nie do programu SQL Server, mają adresy internetowe rozpoczynające się od https://learn.microsoft.com/azure/sql-database/.
Scenariusze filtrowania wersji
System przechowywania wersji działa przez odfiltrowanie całej zawartości dokumentacji, która nie ma zastosowania do aktualnie aktywnego pseudonimu. Za każdym razem, gdy wybierasz inny pseudonim przechowywania wersji, zestaw ukrytych zmian zawartości. Filtrowanie ukrywa zawartość na następujących poziomach:
- Sekcje lub zdania w artykule.
- Wpisy artykułów w spisie treści (SPIS TREŚCI).
Poniżej przedstawiono scenariusze, które wyjaśniają skutki wyboru innego pseudonimu.
Scenariusz 1: W bieżącym artykule
Poniższy scenariusz koncentruje się na sekcjach w bieżącym artykule:
- Bieżący pseudonim przechowywania wersji to SQL Server 2017.
- Czytasz sekcję opisjącą funkcję, która została po raz pierwszy dodana do wersji 2017 programu SQL Server.
- Zmień nazwę na SQL Server 2016.
- Zauważysz, że sekcja, którą czytałeś, zniknęła.
- Ponownie zmienisz nazwę , tym razem na SQL Server 2019.
- Zauważysz, że przeczytana sekcja z 2017 r. jest ponownie wyświetlana.
W poprzednim scenariuszu sekcja dotycząca nowej funkcji 2017 jest prawdopodobnie oznaczona zakresem moniker zawierającym następujący kod moniker:
>=sql-server-2017
Po wybraniu nazwy programu SQL Server 2019 system przechowywania wersji zdał sobie sprawę, że 2019 r. jest większy niż lub równy 2017 r. i wyświetlił sekcję.
Scenariusz 2. Wybieranie linku do ukrytego artykułu
W poniższym nietypowym scenariuszu wyjaśniono, co się stanie w przypadku wybrania linku do artykułu, który jest obecnie ukryty w spisie treści (SPIS TREŚCI). W skrócie link działa:
- Bieżący pseudonim przechowywania wersji to SQL Server 2017.
- W bieżącym artykule Awybierz link do artykułu B , który dotyczy tylko programu SQL Server 2016.
- Przed zaznaczeniem spis treści ma swój wpis w artykule B ukrytym.
- Po zaznaczeniu zostanie wyświetlony artykuł B .
- Wyświetlanie artykułu B wymusza kontrolę wersji, aby przełączyć się na moniker programu SQL Server 2016 .
- Ponieważ oryginalny pseudonim PROGRAMU SQL Server 2017 musiał zostać porzucony. To porzucenie powoduje wyświetlenie komunikatu informacyjnego w górnej części strony internetowej. Komunikat wyjaśnia, że bieżący pseudonim musiał zostać przełączony, aby uwzględnić nowy artykuł B.
Scenariusz 3. Przechodzenie do adresu HTTPS
W programie SQL Server 2017 dodano nowy artykuł. W tym artykule opisano funkcje dodane do programu SQL Server w wersji 2017. Większość lub wszystkie te nowe funkcje są również częścią wersji 2019. Oto atrybuty artykułu.
| Attribute | Wartość |
|---|---|
| Title | Co nowego w programie SQL Server 2017 |
| zakres moniker | =">= sql-server-2017" |
https adres |
https://learn.microsoft.com/sql/sql-server/what-s-new-in-sql-server-2017 |
Biorąc pod uwagę adres podstawowy https , w poniższej tabeli wyjaśniono, co się stanie, gdy ?view= parametr jest dołączany przez użytkownika i z różnymi wartościami.
Wartość ?view= |
Zachowanie nawigacji adresów https |
|---|---|
| (Brak parametru) | System przechowywania wersji spróbuje użyć domyślnej wartości moniker. Zazwyczaj ustawiamy tę opcję na najnowszą wersję spoza wersji zapoznawczej programu SQL Server. Wartość domyślna programu SQL Server 2017 lub 2019 spełnia atrybut >= sql-server-2017.System dołączy parametr do https adresu, być może jako ?view=sql-server-2017.Kontrolka listy rozwijanej przechowywania wersji zostanie następnie ustawiona na nazwę dopasowania moniker. |
sql-server-2016 |
System przechowywania wersji zda sobie sprawę, że zakres moniker artykułu nie zawiera wersji 2016. Następnie system wybierze jeden z monikers, który spełnia zakres. Następnie, podobnie jak w przypadku wersji 2016, parametr ?view= zostanie dołączony, a nazwa kontrolki będzie zgodna z wartością parametru. |
sql-server-2017 |
System przechowywania wersji rozumie, że wartość parametru jest zawarta w zakresie moniker artykułu. Kontrolka przechowywania wersji zostanie ustawiona tak, aby odpowiadała wartości parametru. |
sql-server-2019 |
Tak samo jak w przypadku wartości , z wyjątkiem parametru sql-server-2017i kontrolki ustawiono wartość 2019. |
Wszystkie sql — ukrywanie niczego, specjalnego pseudonimu
Istnieje jedna specjalna nazwa produktu typu moniker All SQL, a jej jedyną wersją jest Ukryj nic. Celem tego moniker jest wewnętrzne testowanie niektórych zmian. Jeśli jest używany przez klienta, ten pseudonim jest bardziej prawdopodobne, aby wprowadzić błąd niż poinformować.
Niektóre artykuły zawierają informacje dotyczące wielu wersji programu SQL Server. Każdy zwykły moniker ukrywa wersjonowane sekcje, które w przeciwnym razie mogą wyświetlać informacje, które są niedokładne, mylące lub sprzeczne dla wersji pseudonimu. Specjalny moniker All SQL wyświetla wszystkie sekcje wersji i może nie być oczywiste, że wyświetlane są niedokładne informacje.
Komunikat: Żądana strona nie jest dostępna dla moniker <>
Poniższy scenariusz prowadzi do wyświetlenia komunikatu informacyjnego w górnej Docs części strony internetowej:
- Obecnie wersjonowanie pseudonimu to SQL Server 2017.
- Czytasz artykuł dotyczący programu SQL Server 2017.
- Artykuł nie jest istotny dla produktu Azure SQL Database.
- Próbujesz zmienić nazwę moniker na Azure SQL Database — bieżąca.
- Zobaczysz, że próba została odrzucona, a zostanie wyświetlony komunikat.
Na końcu tego scenariusza zostanie wyświetlony następujący komunikat informacyjny w górnej części strony internetowej witryny Docs:
Żądana strona nie jest dostępna dla usługi Azure SQL Database — bieżąca. Przekierowano Cię do najnowszej wersji produktu, dla której ta strona jest dostępna.
Najnowsza wersja może wykluczać wersje, które nie zostały jeszcze w pełni wydane i mają stan wersji zapoznawczej.
Poprzednie wersje programu SQL Server
System przechowywania wersji jest w pełni zaimplementowany dla programu SQL Server w wersji 2016.
2012 i starsze: System przechowywania wersji nie jest używany dla programu SQL Server 2012 ani starszych wersji.
- Specjalny pseudonim programu SQL Server — starszy ma na celu ukrycie prawie wszystkich artykułów. Rzadkie wyjątki to kilka artykułów, których klienci starszych wersji mogą potrzebować raz.
- Poprzednie wersje dokumentacji programu SQL Server
2014: System przechowywania wersji jest w połowie implementowany dla programu SQL Server 2014. Możesz wybrać program SQL Server 2014 w kontroli wersji i działa. Jednak wewnętrznie pliki dla 2014 r. są przeznaczone tylko do 2014 r., tak samo jak pliki dla 2008 r. są przeznaczone tylko na rok 2008.
2016 i nowsze: System przechowywania wersji jest w pełni zaimplementowany dla programu SQL Server 2016 i nowszych wersji.