バージョン管理と applies-to に関する SQL Server インクルード ファイル
ドキュメント内の参照は、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 の将来のリリースを指します。
| SQL バージョン | ファイル名 | Markdown の例 | Text |
|---|---|---|---|
| SQL Server | ssnoversion-md.md | [!INCLUDE[ssSQL11](../includes/ssnoversion-md.md)] |
SQL Server |
| SQL Server 2000 | ssversion2000-md.md | [!INCLUDE[ssSQL11](../includes/ssversion2000-md.md)] |
SQL Server 2000 (8.x) |
| SQL Server 2005 | ssversion2005-md.md | [!INCLUDE[ssSQL11](../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](../includes/sssql11-md.md)] |
SQL Server 2012 (11.x) |
| SQL Server 2012 SP1 | sssql11sp1-md.md | [!INCLUDE[ssSQL11SP1](../includes/sssql11sp1-md.md)] |
SQL Server 2012 SP1 (11.0.3x) |
| SQL Server 2014 | sssql14-md.md | [!INCLUDE[ssSQL14](../includes/sssql14-md.md)] |
SQL Server 2014 (12.x) |
| SQL Server 2016 | sssql16-md.md | [!INCLUDE[sssql15-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 vNext | sssql22-md.md | [!INCLUDE[sssql22-md](../includes/sssql22-md.md)] |
SQL Server 2022 (16.x) |
SQL Server applies-to (バージョン固有ではない)
次の applies-to インクルード ファイルでは、SQL Server のバージョンが省略されています。
| ファイル名 | Markdown の例 | Image |
|---|---|---|
| appliesto-ss-asdb-asdw-xxx-md.md | [!INCLUDE[SQL Server ASDB, ASDBMI, ASDW](../includes/applies-to-version/sql-asdb-asdbmi-asa.md)] |
適用対象:  SQL Server Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics |
| appliesto-ss-asdb-xxxx-pdw-md.md | [!INCLUDE[appliesto-ss-asdb-xxxx-pdw-md.md](../includes/appliesto-ss-asdb-xxxx-pdw-md.md)] |
適用対象: SQL Server Azure SQL データベース  Azure Synapse Analytics Analytics Platform System (PDW) |
| appliesto-ss-asdb-xxxx-xxx-md.md | [!INCLUDE[appliesto-ss-asdb-xxxx-xxx-md.md](../includes/applies-to-version/sql-asdb.md)] |
適用対象: SQL Server Azure SQL データベース |
| applies-to-version/sql-asdbmi.md | [!INCLUDE[applies-to-version/sql-asdbmi.md](../includes/applies-to-version/sql-asdbmi.md)] |
適用対象: SQL Server Azure SQL Managed Instance |
| appliesto-ss-xxxx-asdw-pdw-md.md | [!INCLUDE[appliesto-ss-xxxx-asdw-pdw-md.md](../includes/appliesto-ss-xxxx-asdw-pdw-md.md)] |
適用対象: SQL Server Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| appliesto-ss-xxxx-xxxx-pdw-md.md | [!INCLUDE[appliesto-ss-xxxx-xxxx-pdw-md.md](../includes/appliesto-ss-xxxx-xxxx-pdw-md.md)] |
適用対象: SQL Server Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| appliesto-ss-xxxx-xxxx-xxx-md-winonly.md | [!INCLUDE[appliesto-ss-xxxx-xxxx-xxx-md-winonly.md](../includes/appliesto-ss-xxxx-xxxx-xxx-md-winonly.md)] |
適用対象: SQL Server (Windows のみ) Azure SQL データベース Azure Synapse Analytics 分析プラットフォームシステム (PDW) |
| applies-to-version/_ssnoversion.md | [!INCLUDE[applies-to-version/_ssnoversion.md](../includes/applies-to-version/sqlserver.md)] |
適用対象: SQL Server |
| appliesto-xx-asdb-asdw-xxx-md.md | [!INCLUDE[appliesto-xx-asdb-asdw-xxx-md.md](../includes/appliesto-xx-asdb-asdw-xxx-md.md)] |
適用対象: SQL Server Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| appliesto-xx-asdb-xxxx-xxx-md.md | [!INCLUDE[appliesto-xx-asdb-xxxx-xxx-md.md](../includes/appliesto-xx-asdb-xxxx-xxx-md.md)] |
適用対象: SQL Server Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
SQL Server applies-to (バージョン固有である)
次の 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 Analytics Analytics Platform System (PDW) |
| appliesto-ss-asdb-asdw-xxx-md.md | [!INCLUDE[appliesto-ss-asdb-asdw-xxx-md.md](../includes/appliesto-ss-asdb-asdw-xxx-md.md)] |
適用対象: SQL Server Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| appliesto-ss-asdb-xxxx-pdw-md.md | [!INCLUDE[appliesto-ss-asdb-xxxx-pdw-md.md](../includes/appliesto-ss-asdb-xxxx-pdw-md.md)] |
適用対象: SQL Server Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| appliesto-ss-asdb-xxxx-xxx-md.md | [!INCLUDE[appliesto-ss-asdb-xxxx-xxx-md.md](../includes/appliesto-ss-asdb-xxxx-xxx-md.md)] |
適用対象: SQL Server Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| appliesto-ss-xxxx-asdw-pdw-md.md | [!INCLUDE[appliesto-ss-xxxx-asdw-pdw-md.md](../includes/appliesto-ss-xxxx-asdw-pdw-md.md)] |
適用対象: SQL Server Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| appliesto-ss-xxxx-xxxx-pdw-md.md | [!INCLUDE[appliesto-ss-xxxx-xxxx-pdw-md.md](../includes/appliesto-ss-xxxx-xxxx-pdw-md.md)] |
適用対象: SQL Server Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| appliesto-ss2016-asdb-asdw-pdw-md.md | [!INCLUDE[appliesto-ss2016-asdb-asdw-pdw-md.md](appliesto-ss2016-asdb-asdw-pdw-md.md)] |
適用対象: SQL Server 2016 (13.x) 以降のバージョン Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| appliesto-xx-asdb-asdw-xxx-md.md | [!INCLUDE[appliesto-xx-asdb-asdw-xxx-md.md](../includes/appliesto-xx-asdb-asdw-xxx-md.md)] |
適用対象: SQL Server Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| appliesto-xx-asdb-xxxx-xxx-md.md | [!INCLUDE[appliesto-xx-asdb-xxxx-xxx-md.md](../includes/appliesto-xx-asdb-xxxx-xxx-md.md)] |
適用対象: SQL Server Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| sqlserver2017-asdb.md | [!INCLUDE[sqlserver2017-asdb.md](../includes/applies-to-version/sqlserver2017-asdb.md)] |
適用対象: SQL Server 2017 (14.x) 以降 Azure SQL データベース |
| tsql-appliesto-2014sp2-asdb-xxxx-xxx-md.md | [!INCLUDE[tsql-appliesto-2014sp2-asdb-xxxx-xxx-md.md](../includes/tsql-appliesto-2014sp2-asdb-xxxx-xxx-md.md)] |
適用対象: SQL Server 2014 Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| tsql-appliesto-2016sp2-asdb-xxxx-xxx-md.md | [!INCLUDE[tsql-appliesto-2016sp2-asdb-xxxx-xxx-md.md](../includes/tsql-appliesto-2016sp2-asdb-xxxx-xxx-md.md)] |
適用対象: SQL Server 2016 (13.x) SP 2 以降 Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| tsql-appliesto-ss2008-asdbmi-xxxx-pdw-md.md | [!INCLUDE[tsql-appliesto-ss2008-asdbmi-xxxx-pdw-md.md](../includes/tsql-appliesto-ss2008-asdbmi-xxxx-pdw-md.md)] |
適用対象: SQL Server Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) |
| tsql-appliesto-ss2008-xxxx-xxxx-xxx-md.md | [!INCLUDE[tsql-appliesto-ss2008-xxxx-xxxx-xxx-md.md](../includes/applies-to-version/sqlserver.md)] |
適用対象: SQL Server |
| tsql-appliesto-ss2016-asdb-asdw-xxx-md.md | [!INCLUDE[tsql-appliesto-ss2016-asdb-asdw-xxx-md.md](../includes/tsql-appliesto-ss2016-asdb-asdw-xxx-md.md)] |
適用対象: SQL Server 2016 (13.x) 以降のバージョン Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| tsql-appliesto-ss2016-asdb-xxxx-xxx-md.md | [!INCLUDE[tsql-appliesto-ss2016-asdb-xxxx-xxx-md.md](../includes/tsql-appliesto-ss2016-asdb-xxxx-xxx-md.md)] |
適用対象: SQL Server 2016 (13.x) 以降のバージョン Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| tsql-appliesto-ss2016-xxxx-asdw-pdw-md.md | [!INCLUDE[tsql-appliesto-ss2016-xxxx-asdw-pdw-md.md](../includes/tsql-appliesto-ss2016-xxxx-asdw-pdw-md.md)] |
適用対象: SQL Server 2016 (13.x) 以降のバージョン Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| tsql-appliesto-ss2016-xxxx-asdw-xxx-md.md | [!INCLUDE[tsql-appliesto-ss2016-xxxx-asdw-xxx-md.md](../includes/tsql-appliesto-ss2016-xxxx-asdw-xxx-md.md)] |
適用対象: SQL Server 2016 (13.x) 以降のバージョン Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| tsql-appliesto-ss2016-xxxx-xxxx-xxx-md.md | [!INCLUDE[tsql-appliesto-ss2016-xxxx-xxxx-xxx-md.md](../includes/tsql-appliesto-ss2016-xxxx-xxxx-xxx-md.md)] |
適用対象: SQL Server 2016 (13.x) 以降のバージョン Azure SQL データベース Azure Synapse Analytics Analytics Platform System (PDW) |
| tsql-appliesto-ss2017-xxxx-xxxx-xxx-md.md | [!INCLUDE[tsql-appliesto-ss2017-xxxx-xxxx-xxx-md.md](../includes/applies-to-version/sqlserver2017.md)] |
適用対象: SQL Server 2017 (14.x) 以降 |
Analysis Services の applies-to
次の applies-to インクルード ファイルは、Analysis Services のドキュメントで使用します。
| ファイル名 | Markdown の例 | Image |
|---|---|---|
| ssas-appliesto-sql2016.md | [!INCLUDE[ssas-appliesto-sql2016.md](../includes/ssas-appliesto-sql2016.md)] |
適用対象:✅ SQL Server 2016 (13.x) Analysis Services Azure Analysis Services Power BI Premium |
| ssas-appliesto-sql2016-later.md | [!INCLUDE[ssas-appliesto-sql2016-later.md](../includes/ssas-appliesto-sql2016-later.md)] |
適用対象:✅ SQL Server 2016 (13.x) Analysis Services and later Azure Analysis Services Power BI Premium |
| ssas-appliesto-sql2016-later-aas.md | [!INCLUDE[ssas-appliesto-sql2016-later-aas.md](../includes/ssas-appliesto-sql2016-later-aas.md)] |
適用対象:✅ SQL Server 2016 (13.x) Analysis Services and later Azure Analysis Services Power BI Premium |
| ssas-appliesto-sql2017.md | [!INCLUDE[ssas-appliesto-sql2017.md](../includes/ssas-appliesto-sql2017.md)] |
適用対象:✅ SQL Server 2017 Analysis Services ❌ Azure Analysis Services ❌ Power BI Premium |
| ssas-appliesto-sql2017-later-aas.md | [!INCLUDE[ssas-appliesto-sql2017-later-aas.md](../includes/ssas-appliesto-sql2017-later-aas.md)] |
適用対象:✅ SQL Server 2017 Analysis Services 以降 ✅ Azure Analysis Services ❌ Power BI Premium |
| ssas.md | [!INCLUDE[ssas.md](../includes/applies-to-version/ssas.md)] |
適用対象: SQL Server Analysis Services |
| ssas-appliesto-sqlas-all-aas.md | [!INCLUDE[ssas-aas.md](../includes/ssas-appliesto-sqlas-all-aas.md)] |
適用対象:✅ SQL Server Analysis Services ✅ Azure Analysis Services ❌ Power BI Premium |
| ssas-appliesto-sqlas-all.md | [!INCLUDE[ssas-all.md](../includes/ssas-appliesto-sqlas-all.md)] |
適用対象:✅ SQL Server Analysis Services ❌ Azure Analysis Services ❌ Power BI Premium |
| ssas-appliesto-sqlas-all-aas.md | [!INCLUDE[ssas-all-aas.md](../includes/ssas-appliesto-sqlas-all-aas.md)] |
適用対象:✅ SQL Server Analysis Services ✅ Azure Analysis Services ❌ Power BI Premium |
Reporting Services の applies-to
次の applies-to インクルード ファイルは、Reporting Services のドキュメントで使用します。
| ファイル名 | Markdown の例 | Image |
|---|---|---|
| ssrs-appliesto-2017-and-later.md | [!INCLUDE[ssrs-appliesto-2017-and-later.md](../includes/ssrs-appliesto-2017-and-later.md)] |
SQL Server Reporting Services (2017 以降) |
| ssrs-appliesto-not-pbirs.md | [!INCLUDE[ssrs-appliesto-not-pbirs.md](../includes/ssrs-appliesto-not-pbirs.md)] |
❌ Power BI Report Server |
| ssrs-appliesto-pbirs.md | [!INCLUDE[ssrs-appliesto-pbirs.md](../includes/ssrs-appliesto-pbirs.md)] |
Power BI Report Server |
| ssrs-appliesto-sharepoint-2013-2016.md | [!INCLUDE[ssrs-appliesto-sharepoint-2013-2016.md](../includes/ssrs-appliesto-sharepoint-2013-2016.md)] |
SharePoint |
| ssrs-appliesto-sql2016-preview.md | [!INCLUDE[ssrs-appliesto-sql2016-preview.md](../includes/ssrs-appliesto-sql2016-preview.md)] |
適用対象: SQL Server 2016 (13.x) Power BI Report Server |
次のステップ
これらのインクルード ファイルを使用する方法の詳細については、「applies-to インクルード」を参照してください。