Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Область применения:
SQL Server База данных SQL Azure Azure Synapse Analytics
В этой статье описывается система управления версиями в документации по SQL. Система управления версиями различает продукты и их версии. Система позволяет выбрать нужный продукт и версию. После этого выводится соответствующая документация.
Применимо к продуктам
В большинстве статей об SQL Server под заголовком есть строка, начинающаяся со слов Область применения. В той же строке далее приведён удобный список SQL-продуктов с указателями того, относится ли статья к продукту. Например, продукт SQL Server можно указать как релевантный, а База данных SQL Azure — как нерелевантный для статьи.
Строка Применяется к не учитывает версии продуктов. Мы стремимся избегать расхождений между содержимым строки Область применения и продуктами в конфигурациях системы управления версиями.
История отдельных наборов файлов
Для SQL Server 2014 и более ранних версий существует отдельная полная копия файлов документации для каждой версии. Например, разработка документации по SQL Server 2014 начиналась с копии документации по SQL Server 2012. Затем в процессе развития продукта копия для версии 2014 редактировалась.
Этот старый подход означал, что если в документации за 2014 год обнаруживалась ошибка, то эта же ошибка могла также присутствовать в документации за 2012 и 2008 годы. Это усложняло устранение ошибок и обслуживание в целом.
Несколько версий в одних и тех же файлах
По этой и другим причинам файлы документации для SQL Server 2016 также относятся к версиям 2017, 2019 и, вероятно, к <vNext>. Такое объединение стало возможным благодаря моникерам версий, которые назначаются файлам документации по SQL Server. Идентификаторы версий назначаются или явным образом встраиваются на том уровне детализации, который имеет смысл для каждого конкретного файла документации.
Управление версиями в пользовательском интерфейсе
При просмотре любой статьи документации по SQL с помощью нашего веб-сайта Docs выбранное в данный момент обозначение версии отображается над оглавлением (TOC). Элемент управления — это раскрывающийся список.
Если вы хотите просмотреть документацию для другой версии SQL Server, щелкните стрелку расширения, расположенную в конце моникера текущей версии. Затем выберите любую комбинацию продуктов и версий, которую вы хотите. При выборе другой версии отображаемая документация внезапно изменяется, чтобы отобразить различия для новой выбранной версии. Изменения могут иметься или отсутствовать. Оба варианта вполне обычны.
Параметр HTTPS view=
К каждому веб-адресу статьи, начинающемуся с https://learn.microsoft.com/sql/, добавляется параметр ?view=. Его значение — это код моникера версии.
Псевдоним code в адресе https всегда соответствует псевдониму name, отображаемому в элементе управления версиями.
Продукты, а не редакции
Выпуски
В 1990-х и в 2000-х годах у Microsoft SQL Server был только один продукт. Каждая версия SQL Server имела различные выпуски, например Developer и Enterprise для версии SQL Server 2008. Выпуски имели немного разные наборы возможностей, но базовый продукт был один и тот же. Новые версии SQL Server могут по-прежнему выходить в различных редакциях.
Продукты
С развитием облачных вычислений и платформы Microsoft Azure корпорация Майкрософт выпустила новый продукт "База данных SQL Azure". Хотя существует большой объем кода, совместно используемый традиционным локальным продуктом SQL Server и продуктом Базы данных SQL Azure, эти продукты являются двумя действительно отдельными продуктами.
Для SQL обозначения версий позволяют различать продукты, но не редакции.
Облачные продукты SQL Azure
Почти все статьи, веб-адрес которых начинается с https://learn.microsoft.com/sql/, относятся по крайней мере к одной версии продукта SQL Server. Значительная часть этих статей также относится к одному или нескольким продуктам SQL, размещенным в облаке Azure. Один из таких облачных продуктов SQL называется "База данных SQL Azure".
Разумеется, база данных SQL Azure имеет только одну версию. Почти все статьи, относящиеся к базе данных SQL Azure, но не к SQL Server, имеют веб-адрес, начинающийся с https://learn.microsoft.com/azure/sql-database/.
Сценарии фильтрации версий
Система управления версиями работает, отфильтровывая всё содержимое документации, которое не относится к текущему активному моникеру. Каждый раз, когда вы выбираете другое обозначение версии, меняется набор скрытого содержимого. При фильтрации содержимое скрывается на следующих уровнях:
- разделы или предложения в статье;
- Элементы оглавления (TOC) для статей.
Ниже описывается, что происходит при выборе другого моникера.
Сценарий 1. В рамках текущей статьи
Следующий сценарий посвящён разделам вашей текущей статьи:
- Текущее обозначение версии — SQL Server 2017.
- Вы читаете раздел, описывающий функцию, которая была впервые добавлена в SQL Server версии 2017.
- Вы меняете моникер на SQL Server 2016.
- Раздел, который вы читали, пропадает.
- Вы снова меняете моникер, на этот раз на SQL Server 2019.
- Вы замечаете, что раздел 2017 года, который вы читали, снова отображается.
В описанном выше сценарии раздел о новой функции в версии 2017, скорее всего, помечен диапазоном моникеров, включающим в себя следующий код моникера:
>=sql-server-2017
Когда было выбрано имя SQL Server 2019, система управления версиями определила, что 2019 больше либо равно 2017, и отобразила этот раздел.
Сценарий 2. Выбор ссылки на скрытую статью
В следующем необычном сценарии объясняется, что произойдет, если вы выберете ссылку на статью, которая в настоящее время скрыта в оглавлении (TOC). Если говорить коротко, ссылка работает.
- Текущее имя версии — SQL Server 2017.
- В текущей статье Aвы выбираете ссылку на статью B , которая применяется только к SQL Server 2016.
- До выбора запись для статьи B в оглавлении скрыта.
- После выбора появится статья B .
- Отображение статьи B приводит к тому, что система управления версиями переключается на моникер SQL Server 2016.
- Поскольку от исходного названия SQL Server 2017 пришлось отказаться. Этот отказ приводит к отображению информационного сообщения в верхней части веб-страницы. В сообщении объясняется, что текущий идентификатор пришлось изменить, чтобы учесть новую статью B.
Сценарий 3. Переход к адресу https
Указанная ниже статья была добавлена для версии SQL Server 2017. В ней описываются возможности, появившиеся в SQL Server 2017. Большинство этих новых возможностей также имеются в версии 2019. Ниже приведены атрибуты статьи.
| Атрибут | Значение |
|---|---|
| Заголовок | Новые возможности SQL Server 2017 |
| диапазон моникеров | =">= sql-server-2017" |
https адрес |
https://learn.microsoft.com/sql/sql-server/what-s-new-in-sql-server-2017 |
В таблице ниже объясняется, что происходит при добавлении пользователем параметра https с различными значениями к базовому адресу ?view=.
Значение параметра ?view= |
Что происходит при переходе по адресу https |
|---|---|
| (Нет параметра) | Система управления версиями пытается использовать значение моникера по умолчанию. Обычно мы выбираем последнюю версию SQL Server, не относящуюся к Preview. Атрибуту >= sql-server-2017 по умолчанию будет соответствовать версия SQL Server 2017 или 2019.Система добавит параметр к адресу https, например ?view=sql-server-2017.Затем для элемента управления раскрывающимся списком версий будет задано имя соответствующего моникера. |
sql-server-2016 |
Система управления версиями будет понимать, что диапазон моникера статьи не включает версию 2016. Затем система выбрала бы один из идентификаторов, который соответствует заданному диапазону. Затем, так же, как в случае версии 2016, будет добавлен параметр ?view=, а имя элемента управления будет соответствовать значению параметра. |
sql-server-2017 |
Система управления версиями определяет, что значение параметра входит в диапазон моникеров статьи. Для элемента управления управлением версиями будет установлено значение, соответствующее значению параметра. |
sql-server-2019 |
То же, что и в случае со значением sql-server-2017, но параметр и элемент управления устанавливаются в значение 2019. |
Весь SQL — ничего не скрывая, особое название
Существует только одно особое кодовое название продукта — All SQL, и его единственная версия — Ничего не скрывать. Назначение этого идентификатора заключается во внутреннем тестировании некоторых изменений. Если клиент будет использовать это название, оно, скорее всего, скорее введёт в заблуждение, чем проинформирует.
Некоторые статьи содержат сведения, относящиеся к нескольким версиям SQL Server. Каждый обычный моникер скрывает разделы с привязкой к версии, которые в противном случае могли бы отображать неточную, вводящую в заблуждение или противоречивую информацию для версии, соответствующей этому моникеру. Специальный моникер All SQL отображал бы все разделы версий, и могло бы быть неочевидно, что отображается неточная информация.
Сообщение: запрошенная страница недоступна для <моникера>
В описанной ниже ситуации в верхней части веб-страницы Docs появляется информационное сообщение.
- Текущий моникер версии — SQL Server 2017.
- Вы читаете статью, которая относится к SQL Server 2017.
- Эта статья не относится к базе данных SQL Azure.
- Вы пытаетесь изменить моникер на База данных SQL Azure — current (База данных SQL Azure — текущая).
- Попытка отклоняется, и выводится сообщение.
В итоге в верхней части веб-страницы документации отображается следующее информационное сообщение:
Запрошенная страница недоступна для Базы данных SQL Azure — текущая версия. Вы перенаправлены на последнюю версию продукта, для которой доступна эта страница.
Последняя версия может исключить версии, которые еще не полностью выпущены и находятся в состоянии предварительной версии.
Предыдущие версии SQL Server
Система управления версиями полностью реализована для SQL Server 2016 и последующих версий.
2012 и более ранних версий: Система управления версиями не используется для SQL Server 2012 или более ранних версий.
- Специальный моникер SQL Server - older предназначен для скрытия почти всех статей. Исключениями являются несколько статей, которые иногда могут потребоваться пользователям старых версий.
- Предыдущие версии документации по SQL Server
2014: система управления версиями для SQL Server 2014 реализована лишь частично. Вы можете выбрать SQL Server 2014 в средстве выбора версий, и это работает. Однако на внутреннем уровне файлы для версии 2014 связаны только с ней, так же как файлы для версии 2008 связаны только с версией 2008.
2016 и более поздних версий: система управления версиями полностью реализована для SQL Server 2016 и более поздних версий.