Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se aplica a:
SQL ServerAzure SQL DatabaseAzure Synapse AnalyticsAnalytics Platform System (PDW)
En este artículo se explica el sistema de control de versiones de la documentación de SQL. El sistema de control de versiones conoce los productos y sus versiones. El sistema le permite elegir el producto y la versión que le interesa. Después, el sistema muestra la documentación adecuada.
Productos con Se aplica a
La mayoría de los artículos de SQL Server contienen las palabras Se aplica a debajo del título. En la misma línea, se incluye una lista útil de productos de SQL con indicadores de si el artículo es relevante para el producto. Por ejemplo, el producto SQL Server se podría indicar como relevante, mientras que Azure SQL Database se podría indicar como irrelevante para el artículo.
La línea Se aplica a no conoce las versiones de los productos. Nos esforzamos por evitar discrepancias entre la línea Se aplica a y el aspecto de los productos de nuestras configuraciones del sistema de control de versiones.
Historial de conjuntos de archivos independientes
En SQL Server 2014 y versiones anteriores, cada versión tiene su propia copia independiente completa de los archivos de documentación. Por ejemplo, la documentación de SQL Server 2014 comenzó como una copia de la de SQL Server 2012. Después, la copia de 2014 se editó durante el ciclo de desarrollo del producto.
Este enfoque anterior significaba que, si se detectaba un error en la documentación de 2014, el error también podría existir en las de 2012 y 2008. Esto dificultaba la corrección de los errores y el mantenimiento general.
Varias versiones en los mismos archivos
Por este y otros motivos, los archivos de documentación para SQL Server 2016 también son para 2017, 2019 y, probablemente, para <vNext>. Esta consolidación se ha hecho práctica porque ahora se asignan monikers de control de versiones a los archivos de documentación de SQL Server. Los monikers de control de versiones se asignan, o se insertan explícitamente, en el grado de granularidad que tenga sentido para cada archivo de documentación determinado.
Control de versiones en la interfaz de usuario
Al ver un artículo de documentación de SQL mediante el sitio web Docs, el moniker de control de versiones seleccionado actualmente es visible encima de la tabla de contenido (TDC). El control es una lista desplegable.
Si desea ver la documentación de una versión diferente de SQL Server, seleccione la flecha del expansador ubicada al final del moniker de versión actual. A continuación, seleccione para elegir cualquier combinación de producto y versión que desee. Al seleccionar una versión diferente, la documentación mostrada cambia repentinamente para mostrar las diferencias de la versión recién elegida. Es posible que haya cambios, o no, y ambos casos son comunes.
Parámetro HTTPS view=
Cada artículo cuya dirección web comienza con https://learn.microsoft.com/sql/ tiene un parámetro denominado ?view= anexado a su dirección. Este valor de parámetro es el código de moniker de control de versiones.
El código de moniker de la dirección https siempre coincide con el nombre del moniker que se muestra en el control de versiones.
Productos, no ediciones
Ediciones
En los años 90 y en los 2000, Microsoft SQL Server solo tenía un producto. Había varias ediciones de cada versión de SQL Server, como las ediciones Developer y Enterprise de SQL Server 2008. Las ediciones representaban conjuntos de características ligeramente distintas, pero el producto principal era el mismo. Es posible que las nuevas versiones de SQL Server sigan teniendo una variedad de ediciones.
Productos
Con el aumento más reciente de la informática en la nube y Microsoft Azure, Microsoft ha lanzado su producto Azure SQL Database. Aunque hay mucho código compartido por el producto local tradicional de SQL Server y el producto de Azure SQL Database, estos productos son dos productos verdaderamente independientes.
En el caso de SQL, los monikers de control de versiones distinguen entre los productos, pero no entre las ediciones.
Productos SQL de la nube de Azure
Casi todos los artículos cuyas direcciones web empiezan con https://learn.microsoft.com/sql/ se aplican al menos a una versión del producto denominado SQL Server. Un gran subconjunto de esos artículos también se aplica a uno o varios de nuestros productos de servicio SQL que se hospedan en nuestra nube de Azure. Uno de estos productos de nube de SQL se denomina Azure SQL Database.
Naturalmente, el producto Azure SQL Database solo tiene una versión. Casi todos los artículos que se aplican a Azure SQL Database, pero no a SQL Server, tienen direcciones web que comienzan por https://learn.microsoft.com/azure/sql-database/.
Escenarios de filtrado de versiones
El sistema de control de versiones funciona filtrando todo el contenido de documentación que no se aplica al moniker activo actualmente. Cada vez que selecciona otro moniker de control de versiones, cambia el conjunto de contenido que está oculto. El filtrado oculta el contenido en los niveles siguientes:
- Secciones u oraciones dentro de un artículo.
- Entradas para los artículos de la tabla de contenido (TDC).
A continuación se muestran escenarios en los que se explican los efectos de elegir otro moniker.
Escenario 1: En el artículo actual
El escenario siguiente se centra en las secciones del artículo actual:
- El moniker de control de versiones actual es SQL Server 2017.
- Está leyendo una sección que describe una característica que se agregó por primera vez a la versión 2017 de SQL Server.
- Cambie el moniker a SQL Server 2016.
- Observe que la sección que estaba leyendo desaparece.
- Vuelva a cambiar el moniker, esta vez a SQL Server 2019.
- Observe que la sección 2017 que estaba leyendo vuelve a aparecer en la pantalla.
En el escenario anterior, es probable que la sección sobre la nueva característica de 2017 esté marcada con un intervalo de moniker que incluye el código de moniker siguiente:
>=sql-server-2017
Cuando se ha elegido el moniker SQL Server 2019, el sistema de control de versiones ha comprobado que 2019 es mayor o igual que 2017, y ha mostrado la sección.
Escenario 2: Selección de un vínculo a un artículo oculto
En el siguiente escenario poco común se explica lo que sucede si selecciona un vínculo a un artículo que está oculto actualmente de la tabla de contenido (TOC). En resumen, el vínculo funciona:
- El moniker de control de versiones actual es SQL Server 2017.
- En el artículo Aactual, seleccione un vínculo a un artículo B que solo se aplique a SQL Server 2016.
- Antes de la selección, la tabla de contenido tiene su entrada para el artículo B oculto.
- Después de la selección, se muestra el artículo B .
- La representación del artículo B obliga al control de versiones a cambiar al moniker SQL Server 2016.
- Porque el moniker original SQL Server 2017 se ha tenido que abandonar. Este abandono provoca que se muestre un mensaje informativo junto a la parte superior de la página web. En el mensaje se explica que se ha tenido que cambiar el moniker actual para acomodar el nuevo artículo B.
Escenario 3: Navegación a una dirección https
El siguiente artículo se ha agregado como novedad para SQL Server 2017. En el artículo se describen las características que se han agregado a la versión 2017 de SQL Server. La mayoría o todas esas características nuevas también forman parte de la versión 2019. Estos son los atributos del artículo.
| Atributo | Valor |
|---|---|
| Título | Novedades de SQL Server 2017 |
| Intervalo de moniker | =">= sql-server-2017" |
Dirección https |
https://learn.microsoft.com/sql/sql-server/what-s-new-in-sql-server-2017 |
Dada la dirección https base, en la tabla siguiente se explica lo que sucede cuando el usuario anexa el parámetro ?view=, con varios valores.
Valor de ?view= |
Comportamiento de la navegación a direcciones https |
|---|---|
| (Sin parámetro) | El sistema de control de versiones probaría su valor de moniker predeterminado. Normalmente, se establece en la última versión que no es una versión preliminar de SQL Server. Un valor predeterminado de SQL Server 2017 o 2019 coincidiría con el atributo >= sql-server-2017.El sistema anexaría el parámetro a la dirección https, posiblemente como ?view=sql-server-2017.El control de lista desplegable de control de versiones se establecería en el nombre del moniker coincidente. |
sql-server-2016 |
El sistema de control de versiones se da cuenta de que el intervalo de moniker del artículo no incluye la versión 2016. Después, el sistema elegiría uno de los monikers que satisface el intervalo. Como en el caso de la versión 2016, se anexaría el parámetro ?view= y el nombre del control coincidiría con el valor del parámetro. |
sql-server-2017 |
El sistema de control de versiones entiende que el valor del parámetro se incluye en el intervalo de moniker del artículo. El control de versiones se establecerá para coincidir con el valor del parámetro. |
sql-server-2019 |
Es similar al caso del valor sql-server-2017, excepto que el parámetro y el control se establecen en 2019. |
Moniker especial All SQL - Hide nothing (Todo SQL: no ocultar nada)
Hay un nombre de producto de moniker especial de All SQL y su única versión es Hide nothing. El propósito de este moniker es realizar pruebas internas de determinados cambios. Si lo usa un cliente, es probable que este moniker desoriente más que informar.
Algunos artículos tienen información relacionada con varias versiones de SQL Server. Cada moniker normal oculta las secciones con versiones que, de lo contrario, podrían mostrar información inexacta, confusa o contradictoria para la versión del moniker. El moniker All SQL especial mostraría todas las secciones de la versión y es posible que no sea evidente que se muestra información inexacta.
Mensaje: La página solicitada no está disponible para <el moniker>
El siguiente escenario conduce a la presentación de un mensaje informativo junto a la parte superior de la página web Docs:
- El moniker de control de versiones actual es SQL Server 2017.
- Está leyendo un artículo relevante para SQL Server 2017.
- El artículo no es relevante para el producto Azure SQL Database.
- Intenta cambiar el moniker a Azure SQL Database: actual.
- Comprueba que el intento se ha rechaza y se muestra un mensaje.
Al final de este escenario, verá que se muestra el siguiente mensaje informativo junto a la parte superior de la página web de documentación:
La página solicitada no está disponible para Azure SQL Database: actual. Se le ha redirigido a la versión más reciente del producto para la que está disponible esta página.
La versión más reciente podría excluir las versiones que aún no están totalmente publicadas y que están en estado de versión preliminar .
Versiones anteriores de SQL Server
El sistema de control de versiones está totalmente implementado para SQL Server, desde la versión 2016 en adelante.
2012 y versiones anteriores: El sistema de control de versiones no se usa para SQL Server 2012 ni para versiones anteriores.
- El moniker especial SQL Server - older (SQL Server: anterior) está diseñado para ocultar prácticamente todos los artículos. Las excepciones poco frecuentes son un par de artículos que los clientes de versiones anteriores podrían necesitar una vez.
- Versiones anteriores de la documentación de SQL Server
2014: el sistema de control de versiones está implementado parcialmente para SQL Server 2014. Puede elegir SQL Server 2014 en el control de versiones y funcionará. Pero los archivos de 2014 están dedicados exclusivamente a 2014, al igual que los archivos de 2008 están dedicados únicamente a 2008.
2016 y versiones posteriores: el sistema de control de versiones está totalmente implementado para SQL Server 2016 y versiones posteriores.