ドキュメント内の参照は、Markdown でインクルード ファイルを使用することにより、個々のアーティクルの実際のテキストを変更することなく簡単に変更できます。 SQL のコンテンツには、3 種類のインクルード ファイルがあります。SQL のバージョン、applies-to、および参照のテキストです。 SQL Server のバージョン インクルード ファイルは、SQL Server 2016 や 2017 など、説明している SQL のバージョンを示すために使用されます。 applies-to インクルード ファイルは、SQL Server on Linux や Azure SQL Database など、ドキュメントで適用される SQL 製品とサービスを示します。 参照のテキスト インクルード ファイルは、他の 2 つのカテゴリに該当しないインクルードです。たとえば "Get Help" インクルード (顧客が SQL Server でのヘルプを参照するために使用できるリンクの一覧) などです。
この記事は、最初の 2 種類のインクルード ファイルのみについて、参照ポイントとして使用することを目的としています。 インクルード ファイルの完全な一覧は、sql-docs リポジトリで参照できます。
SQL Server のバージョンのインクルード ファイル
SQL のコンテンツの作成者は、製品名や SQL Server のバージョンを含める必要が頻繁に生じます。 この方法では、名前に変更があると、各アーティクルごとに値を手動で更新する代わりに、インクルード ファイルが更新されます。 これらのインクルード ファイルは製品名のプレースホルダーとして使用されますが、すべての SQL ドキュメントで一貫して使用されているわけではありません。 SQL Server vNext は、バージョン番号がまだない SQL Server の将来のリリースを指し、この規則の例外です。
| SQL Server のバージョン | ファイル名 | Markdown の例 | テキスト |
|---|---|---|---|
| SQL Server | ssnoversion-md.md | [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] |
SQL Server |
| SQL Server 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 vNext | sssql22-md.md | [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] |
SQL Server 2022 (16.x) |
SQL Server の適用対象 (バージョン固有ではない)
次の applies-to インクルード ファイルでは、SQL Server のバージョンが省略されています。
| ファイル名 | Markdown の例 | Image |
|---|---|---|
| 適用対象バージョン/sql-asdbmi.md | [!INCLUDE [applies-to-version/sql-asdbmi.md](../includes/applies-to-version/sql-asdbmi.md)] |
適用対象: SQL ServerAzure SQL Managed Instance |
| applies-to-version/_ssnoversion.md | [!INCLUDE [applies-to-version/_ssnoversion.md](../includes/applies-to-version/sqlserver.md)] |
適用対象:SQL Server |
SQL Server の適用対象 (バージョン固有)
次の applies-to インクルード ファイルでは、ドキュメントを適用する SQL のバージョンが指定されます。
| ファイル名 | Markdown の例 | Image |
|---|---|---|
| applies-to-version/asa-pdw.md | [!INCLUDE [applies-to-version/asa-pdw.md](../includes/applies-to-version/asa-pdw.md)] |
適用対象:Azure Synapse AnalyticsAnalytics Platform System (PDW) |