Archivos de inclusión de SQL Server para el control de versiones y "applies-to"

Artículo
04/03/2023

Las referencias de la documentación se pueden modificar fácilmente sin cambiar el texto real de los artículos individuales mediante archivos de inclusión en Markdown. Hay tres tipos de archivos de inclusión en el mundo del contenido de SQL: de versión de SQL, applies-to y texto referencial. Los archivos de inclusión de versión de SQL Server se usan para indicar la versión de SQL que se está analizando, como SQL Server 2016 o 2017. Los archivos de inclusión applies-to indican a qué servicios y productos de SQL se aplica el documento, como SQL Server en Linux o Azure SQL Database. Los archivos de inclusión de texto referencial no se corresponden a las otras dos categorías, como el archivo de inclusión "Obtener ayuda", una lista de vínculos que los clientes pueden usar para obtener ayuda con SQL.

Este artículo está pensado para usarse como punto de referencia solo para los dos primeros tipos de archivos de inclusión. Puede examinar la lista completa de los archivos de inclusión en el repositorio sql-docs.

Archivos de inclusión de versión de SQL Server

Los escritores de contenido de SQL suelen tener que incluir el nombre del producto y la versión de SQL Server. De esta forma, si cambia algo en el nombre, el archivo de inclusión se actualiza en lugar de actualizar de forma manual el valor en todos los artículos. Estos archivos de inclusión se usan como marcadores de posición para los nombres de productos, pero no se han usado de forma coherente en toda la documentación de SQL. SQL Server vNext hace referencia a una futura versión de SQL que aún no tiene número de versión y es la excepción a esto.

Versión de SQL	Nombre de archivo	Ejemplo de Markdown	Texto
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)

Archivo applies-to de SQL Server (no específico de la versión)

Estos archivos de inclusión applies-to omiten la versión de SQL Server.

Nombre de archivo	Ejemplo de Markdown	Imagen
appliesto-ss-asdb-asdw-xxx-md.md	`[!INCLUDE[SQL Server ASDB, ASDBMI, ASDW](../includes/applies-to-version/sql-asdb-asdbmi-asa.md)]`	Se aplica a: SQL Server Azure SQL Database 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)]`	Se aplica a: SQL Server Azure SQL Database 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)]`	Se aplica a: SQL Server Azure SQL Database
applies-to-version/sql-asdbmi.md	`[!INCLUDE[applies-to-version/sql-asdbmi.md](../includes/applies-to-version/sql-asdbmi.md)]`	Se aplica a: 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)]`	Se aplica a: SQL Server Azure SQL Database 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)]`	Se aplica a: SQL Server Azure SQL Database 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)]`	Se aplica a: SQL Server (Windows only) Azure SQL Database Azure Synapse Analytics Analytics Platform System (PDW)
applies-to-version/_ssnoversion.md	`[!INCLUDE[applies-to-version/_ssnoversion.md](../includes/applies-to-version/sqlserver.md)]`	Se aplica a: 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)]`	Se aplica a: SQL Server Azure SQL Database 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)]`	Se aplica a: SQL Server Azure SQL Database Azure Synapse Analytics Analytics Platform System (PDW)

Archivo applies-to de SQL Server (específico de la versión)

Estos archivos de inclusión applies-to especifican las versiones de SQL a las que se aplica la documentación.

Archivo applies-to de Analysis Services

Estos archivos de inclusión applies-to se usan con la documentación de Analysis Services.

Nombre de archivo	Ejemplo de Markdown	Imagen
ssas-appliesto-sql2016.md	`[!INCLUDE[ssas-appliesto-sql2016.md](../includes/ssas-appliesto-sql2016.md)]`	Se aplica a:✅ 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)]`	Se aplica a:✅ SQL Server 2016 (13.x) Analysis Services y posteriores 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)]`	Se aplica a:✅ SQL Server 2016 (13.x) Analysis Services y posteriores Azure Analysis Services Power BI Premium
ssas-appliesto-sql2017.md	`[!INCLUDE[ssas-appliesto-sql2017.md](../includes/ssas-appliesto-sql2017.md)]`	Se aplica a:✅ 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)]`	Se aplica a:✅ SQL Server 2017 Analysis Services y posteriores ✅ Azure Analysis Services ❌ Power BI Premium
ssas.md	`[!INCLUDE[ssas.md](../includes/applies-to-version/ssas.md)]`	Se aplica a: SQL Server Analysis Services
ssas-appliesto-sqlas-all-aas.md	`[!INCLUDE[ssas-aas.md](../includes/ssas-appliesto-sqlas-all-aas.md)]`	Se aplica a:✅ 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)]`	Se aplica a:✅ 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)]`	Se aplica a:✅ SQL Server Analysis Services ✅ Azure Analysis Services ❌ Power BI Premium

Archivo applies-to de Reporting Services

Estos archivos de inclusión applies-to se usan con la documentación de Reporting Services.

Nombre de archivo	Ejemplo de Markdown	Imagen
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 y versiones posteriores)
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)]`	Se aplica a: SQL Server 2016 (13.x) Power BI Report Server

Pasos siguientes

Para obtener más información sobre cómo usar estos archivos de inclusión, vea Archivos de inclusión applies-to.

Compartir vía