Actualización de una aplicación para usar la biblioteca de cliente de base de datos elástica más reciente

Se aplica a:Azure SQL Database

Las nuevas versiones de la biblioteca cliente de Elastic Database están disponibles mediante NuGet y la interfaz del Administrador de paquetes NuGet en Visual Studio. Las actualizaciones contienen correcciones de errores y compatibilidad para nuevas capacidades de la biblioteca de clientes.

En la versión más reciente: vaya a Microsoft.Azure.SqlDatabase.ElasticScale.Client.

Vuelve a generar la aplicación con la nueva biblioteca y cambia los metadatos de Shard Map Manager existentes almacenados en tus bases de datos de Azure SQL Database para admitir nuevas características.

Al realizar estos pasos de actualización en orden se asegura de que las versiones anteriores de la biblioteca de cliente ya no está presentes en el entorno cuando se actualizan los objetos de metadatos, lo que significa que no se crearán objetos de metadatos de la antigua versión después de la actualización.

Pasos de actualización

1. Actualice sus aplicaciones. En Visual Studio, descargue y haga referencia a la versión más reciente de la biblioteca de clientes en todos los proyectos de desarrollo que usan la biblioteca; a continuación, vuelva a compilar e implementar.

• En la solución de Visual Studio, seleccione Herramientas-->Administrador de paquetes NuGet-->Administrar paquetes NuGet para la solución.
• (Visual Studio 2013) En el panel izquierdo, seleccione Actualizaciones y, a continuación, seleccione el botón Actualizar en el paquete Azure SQL Database Elastic Scale Client Library (Biblioteca de clientes de escala elástica de Azure SQL Database) que aparece en la ventana.
• (Visual Studio 2015) Establezca el cuadro de filtro en Actualización disponible. Selecciona el paquete que quieras actualizar y a continuación, selecciona el botón Actualizar.
• (Visual Studio 2017) En la parte superior del cuadro de diálogo, seleccione Actualizaciones. Selecciona el paquete que quieras actualizar y, a continuación, selecciona el botón Actualizar.
• Genere e implemente.

2. Actualice los scripts. Si estás utilizando scripts de PowerShell para administrar particiones, descarga la nueva versión de la biblioteca y cópiala en el directorio desde el que ejecuta los scripts.

3. Actualice el servicio de división y combinación. Si usa la herramienta de división y combinación de la base de datos elástica para reorganizar datos particionados, descargue e implemente la versión más reciente de la herramienta. Encontrará pasos detallados para la actualización del servicio aquí.

4. Actualice las bases de datos de Shard Map Manager. Actualice los metadatos compatibles con sus asignaciones de partición en Azure SQL Database. Hay dos maneras de hacerlo, mediante PowerShell o C#. Ambas opciones se muestran a continuación.

Opción 1: actualizar los metadatos mediante PowerShell

1. Descargue la utilidad de línea de comandos más reciente de NuGet desde aquí y guárdela en una carpeta.
2. Abra un símbolo del sistema, navegue a la misma carpeta y emita el comando: nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
3. Ve a la subcarpeta que contiene la nueva versión DLL de cliente que has descargado, por ejemplo: cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
4. Descargue el script de actualización del cliente de base de datos elástica del Centro de scriptsy guárdelo en la misma carpeta que contiene el archivo DLL.
5. Desde esa carpeta, ejecute PowerShell .\upgrade.ps1 desde el símbolo del sistema y siga las indicaciones.

Opción 2: actualizar los metadatos mediante C#

De forma alternativa, puede crear una aplicación de Visual Studio que abra ShardMapManager, recorra en iteración todas las particiones y realice la actualización de metadatos mediante una llamada a los métodos UpgradeLocalStore y UpgradeGlobalStore, como en este ejemplo:

    ShardMapManager smm =
       ShardMapManagerFactory.GetSqlShardMapManager
       (connStr, ShardMapManagerLoadPolicy.Lazy);
    smm.UpgradeGlobalStore();

    foreach (ShardLocation loc in
     smm.GetDistinctShardLocations())
    {
       smm.UpgradeLocalStore(loc);
    }

Estas técnicas para las actualizaciones de metadatos se pueden aplicar varias veces sin problema. Por ejemplo, si una versión anterior del cliente crea sin darse cuenta una partición después de haber actualizado, puede ejecutar la actualización de nuevo en todas las particiones para asegurarse de que la última versión de metadatos está presente en toda su infraestructura.

Nota:Las nuevas versiones de la biblioteca cliente publicadas hasta la fecha seguirán funcionando con versiones anteriores de los metadatos de Shard Map Manager en Azure SQL Database, y viceversa. Sin embargo, para aprovechar algunas de las nuevas características en el cliente más reciente, es necesario actualizar los metadatos. Las actualizaciones de metadatos no afectarán a los datos de usuario ni los datos específicos de la aplicación, solo a los objetos creados y utilizados por el Administrador de mapa de particiones. Las aplicaciones seguirán funcionando a través de la secuencia de actualización que se ha descrito anteriormente.

Historial de versiones de cliente de base de datos elástica

Para el historial de versiones: vaya a Microsoft.Azure.SqlDatabase.ElasticScale.Client

Recursos adicionales

¿Aún no ha usado las herramientas de base de datos elástica? Consulte la Guía de introducción. Si tiene alguna pregunta, póngase en contacto con nosotros en la Página de preguntas y respuestas de Microsoft sobre SQL Database y, para efectuar solicitudes de características, agregue nuevas ideas o vote por las ideas existentes en el foro de comentarios sobre SQL Database.