您可使用 Markdown 中的 include 檔案輕鬆修改文件中的參考,並不需變更個別文章的實際文字。 在 SQL 內容世界中,include 檔案有三種類型:SQL 版本、applies-to 與參考性文字。 SQL Server 版本 Include 檔案用來指出目前所討論的 SQL 版本,例如 SQL Server 2016 或 2017。 Applies-to Include 檔案指出文件適用於哪些 SQL 產品和服務,例如 Linux 上的 SQL Server 或 Azure SQL Database。 參考性文字 Include 檔案不屬於上述兩種類型,例如「取得說明」Include 檔案是客戶可用來取得 SQL Server 說明的連結清單。
此文章旨在作為前兩種 Include 檔案類型的參考點。 您可以在 sql-docs 存放庫中瀏覽 include 檔案的完整清單。
SQL Server 版本 Include 檔案
SQL 內容作者通常需要包括 SQL Server 的產品名稱與版本。 如此一來,若名稱有所變更,會更新 include 檔案,而不需在每篇文章中手動更新值。 這些包含的檔案用作產品名稱的佔位符,但並非在所有 SQL 文件中都一致使用。 SQL Server vNext 指的是尚未有版本號的未來版本,且是此規則的例外。
| SQL Server 版本 | 檔案名稱 | Markdown 範例 | 文字 |
|---|---|---|---|
| SQL Server | ssnoversion-md.md | [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] |
SQL Server |
| SQL 伺服器 2000 | ssversion2000-md.md | [!INCLUDE [ssversion2000-md](../includes/ssversion2000-md.md)] |
SQL Server 2000 (8.x) |
| SQL Server 2005 | ssversion2005-md.md | [!INCLUDE [ssversion2005-md](../includes/ssversion2005-md.md)] |
SQL Server 2005 (9.x) |
| SQL Server 2008 | sql2008-md.md | [!INCLUDE [sql2008-md](../includes/sql2008-md.md)] |
SQL Server 2008 (10.0.x) |
| SQL Server 2008 R2 | sql2008r2-md.md | [!INCLUDE [sql2008r2-md](../includes/sql2008r2-md.md)] |
SQL Server 2008 R2 (10.50.x) |
| SQL Server 2012 | sssql11-md.md | [!INCLUDE [sssql11-md](../includes/sssql11-md.md)] |
SQL Server 2012 (11.x) |
| SQL Server 2012 SP1 | sssql11sp1-md.md | [!INCLUDE [sssql11sp1-md](../includes/sssql11sp1-md.md)] |
SQL Server 2012 SP1 (11.0.3x) |
| SQL Server 2014 | sssql14-md.md | [!INCLUDE [sssql14-md](../includes/sssql14-md.md)] |
SQL Server 2014 (12.x) |
| SQL Server 2016 | sssql16-md.md | [!INCLUDE [sssql16-md](../includes/sssql16-md.md)] |
SQL Server 2016 (13.x) |
| SQL Server 2017 | sssql17-md.md | [!INCLUDE [sssql17-md](../includes/sssql17-md.md)] |
SQL Server 2017 (14.x) |
| SQL Server 2019 | sssql19-md.md | [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] |
SQL Server 2019 (15.x) |
| SQL Server 2022 | sssql22-md.md | [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] |
SQL Server 2022 (16.x) |
| SQL Server 2025 | sssql25-md.md | [!INCLUDE [sssql25-md](../includes/sssql25-md.md)] |
SQL Server 2025 (17.x) |
| SQL Server 下一版本 | sssql22-md.md | [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] |
SQL Server 2022 (16.x) |
SQL Server 適用於(無版本限制)
這些 Applies-to Include 檔案會省略 SQL Server 版本。
| 檔案名稱 | Markdown 範例 | 影像 |
|---|---|---|
| 適用版本/sql-asdbmi.md | [!INCLUDE [applies-to-version/sql-asdbmi.md](../includes/applies-to-version/sql-asdbmi.md)] |
適用於: |
| 適用版本/_無版本.md | [!INCLUDE [applies-to-version/_ssnoversion.md](../includes/applies-to-version/sqlserver.md)] |
適用於: |
SQL Server 適用於 (版本特定)
這些 Applies-to Include 檔案會指定文件適用於哪些 SQL 版本。
| 檔案名稱 | Markdown 範例 | 影像 |
|---|---|---|
| applies-to-version/asa-pdw.md | [!INCLUDE [applies-to-version/asa-pdw.md](../includes/applies-to-version/asa-pdw.md)] |
適用於: |