SQL 版本設定系統文件

適用於：SQL ServerAzure SQL DatabaseAzure Synapse AnalyticsAnalytics Platform System (PDW)

本文解釋我們的 SQL「版本設定系統」文件。 版本設定系統了解產品及其版本。 該系統使您能夠選擇您感興趣的產品和版本。 系統接著會顯示適當的文件。

適用對象產品

大多數的 SQL Server 文章都會在標題下方加上適用對象。 在同一行上，接著會列出方便使用的 SQL「產品」清單，指出文章是否與該產品相關。 例如，SQL Server 產品可能會標記為相關，但同時 Azure SQL Database 則可能會標記為與文章無關。

「 套用至」 行不知道產品 版本 。 我們會努力避免適用對象一行和我們版本設定系統設定產品面之間的不一致。

個別檔案集歷程記錄

針對 SQL Server 2014 及更早的版本，每個版本都有自己個別的完整文件檔案複本。 例如，SQL Server 2014 文件會從 SQL Server 2012 的文件複本開始。 2014 的複本接著會在產品開發週期期間進行編輯。

這種舊方法表示若在 2014 的文件中發現問題，2012 和 2008 的文件中也可能會存在該問題。 這會讓修正問題和一般維護變得更為困難。

相同檔案中的多個版本

基於此原因和其他因素，SQL Server 2016 的文件檔案也適用於 2017、2019，且可能適用於 <vNext>。 這項合併相當實用，因為我們現在會將「版本設定 moniker」指派給我們的 SQL Server 文件檔案。 版本設定 moniker 會根據每個指定文件檔案合理的細微性程度進行指派或明確內嵌。

UI 中的版本設定控制

當您使用我們的 Docs 網站檢視任何 SQL 文件文章時，您可以在目錄 (TOC) 的上方看見目前選擇的版本設定 moniker。 控制項是下拉式清單。

如果您想要查看不同版本 SQL Server 的檔，請選取位於目前版本名字名稱結尾的展開箭號。 然後選擇選擇您想要的任何產品和版本組合。 當您選取不同的版本時，顯示的文件會突然變更，以顯示新選擇版本的差異。 可能會有變更，也可能不會有任何變更；這兩種案例都很常見。

HTTPS 參數 view=

每個網址開頭是 https://learn.microsoft.com/sql/ 之文章都會在其網址上附加名為 ?view= 的參數。 此參數值是版本控制 moniker 程式碼。

網址中的 moniker「程式碼」一律會和版本設定控制項中顯示的 moniker「名稱」相符。

產品，並非版本

版本

在 1990 到 2000 年代間，Microsoft SQL Server 只有一個產品。 每個 SQL Server 版本都有各種「版本」，例如 SQL Server 2008 的 Developer 和 Enterprise 版本。 版本會包含稍微不同的功能集，但核心產品都是相同的。 新的 SQL Server 版本可能仍具有各種版本。

Products

隨著近年雲端運算和 Microsoft Azure 的崛起，Microsoft 發行了 Azure SQL Database 產品。 雖然傳統 SQL Server 內部部署產品和 Azure SQL 資料庫產品共用許多程式碼，但這些產品是兩個真正獨立的產品。

針對 SQL，版本設定 moniker 會區別產品間的差異，但不會區別版本間的差異。

Azure 雲端 SQL 產品

針對整個網址開頭為 https://learn.microsoft.com/sql/ 的文章，幾乎全部都適用於至少一個名為 SQL Server 產品的版本。 這些文章的大部分也適用於一或多個我們裝載在 Azure 雲端上 SQL 服務產品。 其中的一項 SQL 雲端產品名為 Azure SQL Database。

自然地，Azure SQL Database 產品只有一個版本。 幾乎所有適用於 Azure SQL Database 但不適用於 SQL Server 的文章，其網址開頭都是 https://learn.microsoft.com/azure/sql-database/。

版本篩選案例

版本控制系統的運作方式是過濾掉所有不適用於目前作用中名字名的文件內容。 每次您選擇不同的版本設定 moniker 時，隱藏的內容集便會變更。 篩選會在下列層級隱藏內容：

• 文章內的區段或句子。
• 目錄 (TOC) 中的文章項目。

以下是解釋選擇不同 moniker 效果的案例。

案例 1：在目前文章內

下列案例會聚焦於您目前文章內的區段：

1. 目前的版本設定 moniker 是 SQL Server 2017。
2. 您正在閱讀一節，說明首次新增至 SQL Server 2017 版的功能。
3. 您將 moniker 變更為 SQL Server 2016。
4. 您會察覺您正在閱讀的區段已消失。
5. 您再次變更 moniker，但這一次是變更為 SQL Server 2019。
6. 您會察覺您正在閱讀的 2017 區段已重新顯示。

在上述案例中，新的 2017 功能區段可能會以「moniker 範圍」進行標記，其中可能包含下列 moniker 程式碼：

• >=sql-server-2017

選擇 moniker SQL Server 2019 時，版本設定系統便會了解 2019 大於或等於 2017，並顯示該區段。

場景 2：選擇隱藏文章的鏈接

下列不常見的案例說明如果您選取目前從目錄 （TOC） 中隱藏之文章的連結，會發生什麼情況。 簡單來說，連結的運作方式為：

1. 目前的版本設定 moniker 是 SQL Server 2017。
2. 在目前的文章 A中，您可以選取僅適用於 SQL Server 2016 的文章 B 連結。
   • 在選擇之前，目錄的條目 B 已隱藏。
3. 選擇後，將顯示文章 B 。
   • 顯示文章 B 會強制版本設定控制項切換至 SQL Server 2016 moniker。
   • 因為必須放棄原始的 moniker SQL Server 2017。 這段放棄的過程會在網頁接近頂端的位置顯示一個資訊訊息。 該訊息會解釋目前的 moniker 必須進行切換，以適應新的文章 B。

案例 3：巡覽至 HTTPS 位址

下列文章是針對 SQL Server 2017 新增的。 文章會描述在版本 2017 中新增至 SQL Server 的功能。 大多數或所有這些新功能也都是版本 2019 的一部分。 以下是文章的屬性。

屬性	值
Title	SQL Server 2017 的新功能
moniker 範圍	=">= sql-server-2017"
https 位址	https://learn.microsoft.com/sql/sql-server/what-s-new-in-sql-server-2017

有鑑於基底 https 位址，下表會解釋在使用者附加 ?view= 參數及各種值時會發生什麼情況。

?view= 的值	https 位址導覽的行為
（無參數）	版本設定系統會嘗試其預設的 moniker 值。 通常我們會將此設為最新的 SQL Server 非預覽版本。 SQL Server 2017 或 2019 的預設會滿足屬性 >= sql-server-2017。 系統會將參數附加到 https 位址 (也許是 ?view=sql-server-2017)。 然後，版本設定下拉式清單控制項會設定為比對 Moniker 名稱。
sql-server-2016	版本控制系統會意識到文章的綽號範圍不包括 2016 版本。 系統接著會選擇其中一個滿足範圍的 moniker。 然後正如同版本 2016 的案例，會附加 ?view= 參數，且控制項名稱會和參數值相符。
sql-server-2017	版本設定系統了解參數值包含在文章的 moniker 範圍內。 版本設定控制項會設為與參數值相符。
sql-server-2019	這也適用於值為 sql-server-2017 的案例，差別僅在參數和控制項會設為 2019。

所有 SQL - 不隱藏項目，特殊的 moniker

All SQL 有一個特殊的 Moniker 產品名稱，其唯一的版本是 Hide nothing。 此 moniker 的目的是用於在內部測試特定變更。 若由客戶使用，則相較於通知，此 moniker 更可能會誤導客戶。

有些文章包含與多個 SQL Server 版本相關的資訊。 每個一般 moniker 都會隱藏已建立版本的區段；這些區段原先可能會顯示 moniker 版本的不正確、令人困惑或矛盾資訊。 特殊的所有 SQL moniker 會顯示所有版本區段，且顯示不正確的資訊時可能並不明顯。

訊息：要求的頁面不適用於 <Moniker>

下列案例會導致在 Docs 網頁接近頂端的位置顯示資訊訊息：

1. 目前的版本設定 moniker 為 SQL Server 2017。
2. 您正在閱讀與 SQL Server 2017 相關的文章。
   • 文章與 Azure SQL Database 產品「無關」。
3. 您嘗試將 moniker 變更為 Azure SQL Database - 目前。
4. 您會看到您的嘗試遭到拒絕，且顯示一個訊息。

在此案例的最後，您會看到資訊訊息顯示在 Docs 網頁接近頂端的位置：

要求的頁面不適用於 Azure SQL 資料庫 - 目前。 您已重新導向到此頁面適用的最新產品版本。

最新版本可能會排除尚未完全發行且處於預覽狀態的版本。

先前的 SQL Server 版本

版本設定系統已為 SQL Server 2016 版本之後的版本完全實作。

• 2012 年及更早： 版本設定系統不用於 SQL Server 2012 或更早版本。

  • SQL Server - 舊版的特殊 moniker 旨在隱藏幾乎所有文章。 少見的例外狀況是舊版客戶可能一次只需要幾篇文章。
  • 舊版 SQL Server 檔

• 2014：版本設定系統在 SQL Server 2014 已實作一半。 您可以在版本設定控制項中選擇 SQL Server 2014，它會正常運作。 但是在內部，2014 的檔案仍僅專屬於 2014，也就是和 2008 的檔案僅專屬於 2008 相同。

  • 安裝 SQL Server 檔以在 SSMS 中離線檢視

• 2016 及更新版本：版本設定系統在 SQL Server 2016 及更新版本中已完全實作。

  • 歡迎使用 SQL Server 文件 2016 及更新版本
  • 安裝 SQL Server 檔以在 SSMS 中離線檢視

相關內容

• 舊版 SQL Server 檔
• SQL Server 文件導覽指南
• 如何參與 SQL Server 檔