Actualización del clúster de base de datos a una nueva versión

Las nuevas versiones de Babelfish están disponibles con algunas versiones nuevas del motor de base de datos Aurora PostgreSQL después de la versión 13.4. Cada nueva versión de Babelfish tiene su propio número de versión. Al igual que con Aurora PostgreSQL, Babelfish usa el esquema de nomenclatura principal.secundaria.revisión para las versiones. Por ejemplo, la primera versión de Babelfish, la versión 1.0.0, estuvo disponible como parte de Aurora PostgreSQL 13.4.0.

Babelfish no requiere un proceso de instalación independiente. Como se explica en Creación de un clúster de base de datos de Babelfish para Aurora PostgreSQL, Turn on Babelfish (Activar Babelfish) es una opción que se elige al crear un clúster de base de datos de Aurora PostgreSQL.

Del mismo modo, no puede actualizar Babelfish independientemente del clúster de base de datos de Aurora que es compatible. Para actualizar un clúster de base de datos de Babelfish para Aurora PostgreSQL existente a una nueva versión de Babelfish, actualice el clúster de base de datos de Aurora PostgreSQL a una nueva versión que sea compatible con la versión de Babelfish que desee utilizar. El procedimiento que siga para la actualización depende de la versión de Aurora PostgreSQL que sea compatible con la implementación de Babelfish, tal y como se indica a continuación.

Actualización de Babelfish a una nueva versión secundaria

Una nueva versión secundaria incluye solo los cambios que son compatibles con versiones anteriores. Una versión de revisión incluye correcciones importantes que se añaden a una versión secundaria después de su lanzamiento. Por ejemplo, la etiqueta de versión de la primera versión de Aurora PostgreSQL 13.4 era Aurora PostgreSQL 13.4.0. Hasta la fecha, se han publicado varias revisiones para esa versión secundaria, incluidas Aurora PostgreSQL 13.4.1, 13.4.2 y 13.4.4. Encontrará las revisiones disponibles para cada versión de Aurora PostgreSQL en la lista de versiones de revisiones que aparece en la parte superior de las notas de la versión de Aurora PostgreSQL. Para ver un ejemplo, consulte PostgreSQL 14.3 en las notas de la versión de Aurora PostgreSQL.

Si su clúster de base de datos de Aurora PostgreSQL está configurado con la opción Auto minor version upgrade (Actualización automática de versiones secundarias), su clúster de base de datos de Babelfish para Aurora PostgreSQL se actualiza automáticamente durante el período de mantenimiento del clúster. Para obtener más información acerca de la actualización automática de versiones secundarias (AmVU) y cómo utilizarla, consulte Actualizaciones de versiones secundarias automáticas para clústeres de base de datos de Aurora. Si su clúster no utiliza AmVU, puede actualizar manualmente su clúster de base de datos de Babelfish para Aurora PostgreSQL a las nuevas versiones secundarias, ya sea respondiendo a las tareas de mantenimiento o modificando el clúster para utilizar la nueva versión.

Al elegir una versión de Aurora PostgreSQL para instalar y al ver un clúster de base de datos de Aurora PostgreSQL existente en la AWS Management Console, la versión muestra solo los dígitos principal.secundaria. Por ejemplo, la siguiente imagen de la consola de un clúster de base de datos de Babelfish para Aurora PostgreSQL existente con Aurora PostgreSQL 13.4 recomienda actualizar el clúster a la versión 13.7, una nueva versión secundaria de Aurora PostgreSQL.

Para obtener todos los detalles de la versión, incluido el nivel de revisión, puede consultar el clúster de base de datos de Aurora PostgreSQL mediante la función aurora_version de Aurora PostgreSQL. Para obtener más información, consulte aurora_version en la Referencia de las funciones de Aurora PostgreSQL. Encontrará un ejemplo del uso de la función en el procedimiento To use the PostgreSQL port to query for version information en Identificación de la versión de Babelfish.

La siguiente tabla muestra las versiones de Aurora PostgreSQL y Babelfish y las versiones de destino disponibles que pueden admitir el proceso de actualización de la versión secundaria.

Actualización de Babelfish a una nueva versión principal

Para actualizar una versión principal, primero debe actualizar su clúster de base de datos de Babelfish para Aurora PostgreSQL a una versión que sea compatible con la actualización de la versión principal. Para ello, aplique actualizaciones de revisiones o actualizaciones de versiones secundarias a su clúster de base de datos. Para obtener más información, consulte Actualización de Babelfish a una nueva versión secundaria.

La siguiente tabla muestra la versión de Aurora PostgreSQL y la versión de Babelfish que pueden ser compatibles con una actualización de la versión principal.

Antes de actualizar Babelfish a una nueva versión principal

Una actualización puede implicar breves interrupciones. Por este motivo, le recomendamos que realice o programe actualizaciones durante el período de mantenimiento o durante otros períodos de poca utilización.

Realización de una actualización de la versión principal

Después de actualizar a una nueva versión principal

Tras una actualización de la versión principal a una nueva versión de Aurora PostgreSQL, el valor de IDENTITY de las tablas con una columna IDENTITY puede ser mayor (+32) que el valor anterior a la actualización. El resultado es que, cuando se inserta la siguiente fila en dichas tablas, el valor de la columna de identidad generado salta al número +32 y comienza la secuencia desde allí. Esta condición no afectará negativamente a las funciones del clúster de base de datos de Babelfish. Sin embargo, si lo desea, puede restablecer el objeto de secuencia en función del valor máximo de la columna. Para ello, conéctese al puerto T-SQL de la instancia de escritor de Babelfish mediante sqlcmd u otro cliente de SQL Server. Para obtener más información, consulte Uso de un cliente de SQL Server para conectarse al clúster de su base de datos.

sqlcmd -S bfish-db.cluster-123456789012.aws-region.rds.amazonaws.com,1433 -U
     sa -P ******** -d dbname

Cuando esté conectado, utilice el siguiente comando SQL para generar instrucciones que pueda utilizar para iniciar el objeto de secuencia asociado. Este comando SQL funciona tanto para configuraciones de Babelfish de una sola base de datos como de múltiples bases de datos. Para obtener más información acerca de estos dos modelos de implementación, consulte Uso de Babelfish con una base de datos única o varias bases de datos.

DECLARE @schema_prefix NVARCHAR(200) = ''
IF current_setting('babelfishpg_tsql.migration_mode') = 'multi-db'
    SET @schema_prefix = db_name() + '_'
SELECT 'SELECT setval(pg_get_serial_sequence(''' + @schema_prefix + schema_name(tables.schema_id)
    + '.' + tables.name + ''', ''' + columns.name + '''),(select max(' + columns.name + ')
    FROM ' + schema_name(tables.schema_id) + '.' + tables.name + '));
    'FROM sys.tables tables JOIN sys.columns
    columns ON tables.object_id = columns.object_id
    WHERE columns.is_identity = 1
GO

La consulta genera una serie de instrucciones SELECT que puede ejecutar luego para restablecer el valor máximo de IDENTITY y cerrar cualquier brecha. A continuación, se muestra el resultado cuando se utiliza la base de datos SQL Server de ejemplo, Northwind, que se ejecuta en un clúster de Babelfish.

--------------------------------------------------------
SELECT setval(pg_get_serial_sequence('northwind_dbo.categories', 'categoryid'),(select max(categoryid)
    FROM dbo.categories));

SELECT setval(pg_get_serial_sequence('northwind_dbo.orders', 'orderid'),(select max(orderid)
    FROM dbo.orders));
                                                                                                                        
SELECT setval(pg_get_serial_sequence('northwind_dbo.products', 'productid'),(select max(productid)
    FROM dbo.products));
                                                                                                                        
SELECT setval(pg_get_serial_sequence('northwind_dbo.shippers', 'shipperid'),(select max(shipperid)
    FROM dbo.shippers));
                                                                                                                        
SELECT setval(pg_get_serial_sequence('northwind_dbo.suppliers', 'supplierid'),(select max(supplierid)
    FROM dbo.suppliers));
                                                                                                                        
(5 rows affected)

Ejecute las instrucciones una por una para restablecer los valores de la secuencia.

Ejemplo: Actualización del clúster de base de datos de Babelfish a una versión principal

En este ejemplo, puede encontrar la serie de comandos de AWS CLI para explicar cómo se actualiza un clúster de base de datos de Aurora PostgreSQL 13.6.4 que ejecuta la versión 1.2.2 de Babelfish a Aurora PostgreSQL 14.6. En primer lugar, cree un grupo de parámetros de clúster de base de datos personalizado para Aurora PostgreSQL 14. A continuación, modifique los valores de los parámetros para que coincidan con los de su origen de Aurora PostgreSQL versión 13. Por último, realice la actualización modificando el clúster de origen. Para obtener más información, consulte Configuración del grupo de parámetros del clúster de base de datos para Babelfish. En ese tema, también encontrará información sobre el uso de la AWS Management Console para realizar la actualización.

Utilice el comando de la CLI create-db-cluster-parameter-group ara crear el grupo de parámetros del clúster de base de datos para la nueva versión.

Para Linux, macOS, o Unix:

aws rds create-db-cluster-parameter-group \
    --db-cluster-parameter-group-name docs-lab-babelfish-apg-14 \
    --db-parameter-group-family aurora-postgresql14 \
    --description 'New custom parameter group for upgrade to new major version' \
    --region us-west-1

Al ejecutar este comando, el grupo de parámetros del clúster de base de datos personalizado se crea en la Región de AWS. Se muestra una salida similar a la siguiente.

{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "docs-lab-babelfish-apg-14",
        "DBParameterGroupFamily": "aurora-postgresql14",
        "Description": "New custom parameter group for upgrade to new major version",
        "DBClusterParameterGroupArn": "arn:aws:rds:us-west-1:111122223333:cluster-pg:docs-lab-babelfish-apg-14"
    }
}

Para obtener más información, consulte Creación de un grupo de parámetros de clúster de base de datos.

Utilice el comando de la CLI modify-db-cluster-parameter-group para modificar la configuración de forma que coincida con el clúster de origen.

En Windows:

aws rds modify-db-cluster-parameter-group --db-cluster-parameter-group-name docs-lab-babelfish-apg-14 ^
  --parameters "ParameterName=rds.babelfish_status,ParameterValue=on,ApplyMethod=pending-reboot" ^
 "ParameterName=babelfishpg_tds.tds_default_numeric_precision,ParameterValue=38,ApplyMethod=pending-reboot" ^
 "ParameterName=babelfishpg_tds.tds_default_numeric_scale,ParameterValue=8,ApplyMethod=pending-reboot" ^
 "ParameterName=babelfishpg_tsql.database_name,ParameterValue=babelfish_db,ApplyMethod=pending-reboot" ^
 "ParameterName=babelfishpg_tsql.default_locale,ParameterValue=en-US,ApplyMethod=pending-reboot" ^
 "ParameterName=babelfishpg_tsql.migration_mode,ParameterValue=single-db,ApplyMethod=pending-reboot" ^
 "ParameterName=babelfishpg_tsql.server_collation_name,ParameterValue=sql_latin1_general_cp1_ci_as,ApplyMethod=pending-reboot"

La respuesta tiene un aspecto similar a la siguiente.

{
    "DBClusterParameterGroupName": "docs-lab-babelfish-apg-14"
}

Utilice el comando de la CLI modify-db-cluster para modificar el clúster y utilizar la nueva versión y el nuevo grupo de parámetros del clúster de base de datos personalizado. También especifica el argumento --allow-major-version-upgrade, como se muestra en el siguiente ejemplo.

aws rds modify-db-cluster \
--db-cluster-identifier docs-lab-bfish-apg-14 \
--engine-version 14.6 \
--db-cluster-parameter-group-name docs-lab-babelfish-apg-14 \
--allow-major-version-upgrade \
--region us-west-1 \
--apply-immediately

Utilice el comando de la CLI reboot-db-instance para reiniciar la instancia de escritor del clúster, de modo que la configuración de los parámetros se aplique.

aws rds reboot-db-instance \
--db-instance-identifier docs-lab-bfish-apg-14-instance-1\
--region us-west-1