Babelfish를 새 메이저 버전으로 업그레이드

메이저 버전 업그레이드에서는 먼저 Babelfish for Aurora PostgreSQL DB 클러스터를 메이저 버전 업그레이드를 지원하는 버전으로 업그레이드해야 합니다. 이를 위해서 패치 업데이트 또는 마이너 버전 업그레이드를 DB 클러스터에 적용하세요. 자세한 내용은 Babelfish를 새 마이너 버전으로 업그레이드를 참조하세요.

다음 테이블에는 메이저 버전 업그레이드를 지원할 수 있는 Aurora PostgreSQL 버전과 Babelfish 버전이 나와 있습니다.

Babelfish를 새 메이저 버전으로 업그레이드하기 전

업그레이드하는 과정에서 일시적인 중단이 발생할 수 있습니다. 따라서 유지 관리 기간 동안 또는 사용량이 많지 않은 기간에 업그레이드를 수행하거나 예약하는 것이 좋습니다.

메이저 버전 업그레이드 수행

새 메이저 버전으로 업그레이드한 후

새 Aurora PostgreSQL 버전으로 메이저 버전을 업그레이드한 후 IDENTITY 열이 있는 테이블의 IDENTITY 값은 업그레이드 전 값보다 클 수 있습니다(+32). 따라서 다음 행이 이러한 테이블에 삽입될 때 생성된 ID 열 값이 +32 숫자로 이동하고 거기에서 시퀀스를 시작합니다. 이 조건은 Babelfish DB 클러스터의 기능에 부정적인 영향을 미치지 않습니다. 하지만 원하는 경우 열의 최대값을 기준으로 시퀀스 객체를 재설정할 수 있습니다. 그러려면 sqlcmd 또는 다른 SQL Server 클라이언트를 사용하여 Babelfish 작성자 인스턴스의 T-SQL 포트에 연결합니다. 자세한 내용은 SQL Server 클라이언트 도구를 사용하여 DB 클러스터에 연결 단원을 참조하십시오.

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

연결되면 다음 SQL 명령을 사용하여 연결된 시퀀스 객체를 시드하는 데 사용할 수 있는 문을 생성합니다. 이 SQL 명령은 단일 데이터베이스 및 다중 데이터베이스 Babelfish 구성 모두에서 작동합니다. 이러한 두 가지 배포 모델에 대한 자세한 내용은 단일 데이터베이스 또는 여러 데이터베이스에서 Babelfish 사용을 참조하세요.

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

쿼리는 최대 IDENTITY 값을 재설정하고 간격을 좁히기 위해 실행할 수 있는 일련의 SELECT 문을 생성합니다. 다음은 Babelfish 클러스터에서 실행되는 샘플 SQL Server 데이터베이스인 Northwind를 사용할 때 나오는 출력값을 보여줍니다.

--------------------------------------------------------
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)

명령문을 하나씩 실행하여 시퀀스 값을 재설정합니다.

예: Babelfish DB 클러스터를 메이저 릴리스로 업그레이드

이 예시에서는 Babelfish 버전 1.2.2를 실행하는 Aurora PostgreSQL 13.6.4 DB 클러스터를 Aurora PostgreSQL 14.6으로 업그레이드하는 방법을 설명하는 일련의 AWS CLI 명령을 확인할 수 있습니다. 먼저 Aurora PostgreSQL 14에 사용할 사용자 지정 DB 클러스터 파라미터 그룹을 생성합니다. 다음으로 Aurora PostgreSQL 버전 13 소스의 파라미터 값과 일치하도록 파라미터 값을 수정합니다. 마지막으로 소스 클러스터를 수정하여 업그레이드를 수행합니다. 자세한 내용은 Babelfish용 DB 클러스터 파라미터 그룹 설정 단원을 참조하십시오. 해당 주제에서는 AWS Management Console에서 업그레이드를 수행하는 방법에 대한 내용도 찾을 수 있습니다.

create-db-cluster-parameter-group CLI 명령을 사용하여 새 버전에 사용할 DB 클러스터 파라미터 그룹을 생성합니다.

대상 LinuxmacOS, 또는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

이 명령을 실행하면 사용자 지정 DB 클러스터 파라미터 그룹이 AWS 리전에 생성됩니다. 출력은 다음과 비슷합니다.

{
    "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"
    }
}

자세한 내용은 Amazon Aurora에서 DB 클러스터 파라미터 그룹 생성 단원을 참조하십시오.

modify-db-cluster-parameter-group CLI 명령을 사용하여 소스 클러스터와 일치하도록 설정을 수정합니다.

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"

응답은 다음과 비슷합니다.

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

modify-db-cluster CLI 명령을 사용하여 새 버전과 새 사용자 지정 DB 클러스터 파라미터 그룹을 사용하도록 클러스터를 수정합니다. 다음 샘플과 같이 --allow-major-version-upgrade 인수도 지정합니다.

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

파라미터 설정을 적용할 수 있도록 reboot-db-instance CLI 명령을 사용하여 클러스터의 라이터 인스턴스를 재부팅합니다.

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