Babelfish の DB クラスターパラメータグループ設定 - Amazon Aurora

Babelfish の DB クラスターパラメータグループ設定

Aurora PostgreSQL DB クラスターを作成し、[Babelfish をオンにする] を選択した場合、[新規作成] を作成すると、DB クラスターパラメータグループが自動的に作成されます。この DB クラスターパラメータグループは、インストール用に選択された Aurora PostgreSQL DB バージョンの Aurora PostgreSQL DB クラスターパラメータグループ (例えば、Aurora PostgreSQL DB バージョン 14) に基づいています。これは、次の一般的なパターンを使用して命名されています。

custom-aurora-postgresql14-babelfish-compat-3

クラスター作成プロセス中に次の設定を変更できますが、カスタムパラメータグループに保存するとこれらの一部は変更できないため、慎重に選択してください。

  • 単一データベースまたは複数のデータベース

  • デフォルトの照合ロケール

  • 照合順序名

  • DB パラメータグループ

既存の Aurora PostgreSQL DB クラスターバージョン 13 以降のパラメータグループを使用するには、グループを編集して babelfish_status パラメータを on に設定します。Aurora PostgreSQL クラスターを作成する前に、Babelfish オプションを指定してください。詳細についてはAmazon Aurora のパラメータグループを参照してください。

次のパラメータは、Babelfish のプリファレンスを制御します。説明に特に明記されていない限り、パラメータは変更可能です。デフォルト値は説明に含まれています。任意のパラメータの許容値を表示するには、次の手順を実行します。

注記

新しい DB パラメータグループを DB インスタンスに関連付ける場合、変更された静的パラメータと動的パラメータは、DB インスタンスが再起動された後にのみ適用されます。ただし、DB インスタンスに関連付けた後に DB パラメータグループの動的パラメータを変更すると、これらの変更は再起動せずに直ちに適用されます。

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインから [パラメータグループ] を選択します。

  3. リストから、default.aurora-postgresql14 DB クラスターのパラメータグループを選択します。

  4. 検索フィールドにパラメータの名前を入力します。例えば、検索フィールドに babelfishpg_tsql.default_locale を入力して、このパラメータとそのデフォルト値、および許容される設定を表示します。

    注記

    Babelfish for Aurora PostgreSQL グローバルデータベースは、次のパラメータが有効になっている場合にのみ, セカンダリリージョンで機能します。

パラメータ 説明 適用タイプ 変更可能

babelfishpg_tsql.apg_enable_correlated_scalar_transform

プランナーが Babelfish で相関スカラーサブクエリを変換できるようにします。(デフォルト: on) (許容値: on、off)

dynamic

babelfishpg_tsql.apg_enable_subquery_cache

Babelfish で相関スカラーサブクエリのキャッシュの使用を有効にします。(デフォルト: on) (許容値: on、off)

dynamic

babelfishpg_tds.tds_default_numeric_scale

エンジンがスケールを指定していない場合、TDS 列メタデータで送信される数値型のデフォルトスケールを設定します。(デフォルト: 8) (許容値: 0 ~ 38)

dynamic

babelfishpg_tds.tds_default_numeric_precision

エンジンが精度を指定していない場合、TDS 列のメタデータで送信される数値型のデフォルト精度を設定する整数。(デフォルト: 38) (許容値: 1 ~ 38)

dynamic

babelfishpg_tds.tds_default_packet_size

SQL Server クライアントを接続するためのデフォルトのパケットサイズを設定する整数。(デフォルト: 4096) (許容値: 512 ~ 32767)

dynamic

babelfishpg_tds.tds_default_protocol_version

クライアントを接続するためのデフォルトの TDS プロトコルバージョンを設定する整数。(デフォルト: DEFAULT) (tdsv7.0、 tdsv7.1、 tdsv7.1.1、 tdsv7.2、 tdsv7.3a、 tdsv7.3b、 tdsv7.4、DEFAULT)

dynamic

babelfishpg_tds.default_server_name

Babelfish サーバーのデフォルト名を識別する文字列。(デフォルト: Microsoft SQL Server) (許容値: null)

dynamic

babelfishpg_tds.tds_debug_log_level

TDS のロギングレベルを設定します。0 はロギングをオフにする整数。(デフォルト: 1) (許容値: 0、1、2、3)

dynamic

babelfishpg_tds.listen_addresses

TDS をリッスンするためのホスト名、IP アドレス、またはアドレスを設定する整数。Babelfish DB クラスターの作成後にこのパラメータを変更することはできません。(デフォルト: *) (許容値: null)

false

babelfishpg_tds.port

SQL Server 構文でのリクエストに使用する TCP ポートを設定する整数。(デフォルト: 1433) (許容値: 1 ~ 65535)

static

babelfishpg_tds.tds_ssl_encrypt

TDS リスナーポートを通過するデータの暗号化をオン (0) またはオフ (1) にするブール値。SSL を使用したクライアント接続の詳細については、Babelfish SSL 設定とクライアント接続 を参照してください。(デフォルト: 00) (許容値: 0、1)

dynamic

babelfishpg_tds.tds_ssl_max_protocol_version

TDS セッションに使用する最高の SSL/TLS プロトコルバージョンを指定する文字列。(デフォルト: 'TLSv1.2') (許容値: 'TLSv1'、'TLSv1.1'、'TLSv1.2')

dynamic

babelfishpg_tds.tds_ssl_min_protocol_version

TDS セッションに使用する最低の SSL/TLS プロトコルバージョンを指定する文字列。(デフォルト: Aurora PostgreSQL バージョン 16 の「TLSv1.2」、Aurora PostgreSQL バージョン 16 より古いバージョンの「TLSv1」) (許容可能:「TLSv1」、「TLSv1.1」、「TLSv1.2」)

dynamic

babelfishpg_tds.unix_socket_directories

TDS サーバーの Unix ソケットディレクトリを識別する文字列。Babelfish DB クラスターの作成後にこのパラメータを変更することはできません。(デフォルト: /tmp) (許容値: null)

false

babelfishpg_tds.unix_socket_group

TDS サーバーの Unix ソケットグループを識別する文字列。Babelfish DB クラスターの作成後にこのパラメータを変更することはできません。(デフォルト: rdsdb) (許容値: null)

false

babelfishpg_tsql. default_locale

Babelfish 照合に使用されるデフォルトのロケールを指定する文字列。デフォルトのロケールはロケールで、修飾子は含まれません。

Babelfish DB クラスターをプロビジョニングするときに、このパラメータを設定します。DB クラスターのプロビジョニング後、このパラメータへの変更は無視されます。(デフォルト: en_US) (許容値: tables を参照)

static

babelfishpg_tsql.migration_mode

単一または複数のユーザーデータベースのサポートを指定する変更不可能なリスト。Babelfish DB クラスターをプロビジョニングするときに、このパラメータを設定します。DB クラスターのプロビジョニング後は、このパラメータの値を変更できません。(デフォルト: Aurora PostgreSQL バージョン 16 の multi-db、Aurora PostgreSQL バージョン 16 以前のバージョンでは single-db) (許容値: single-db、multi-db、null)

static

babelfishpg_tsql.server_collation_name

サーバーレベルのアクションに使用される照合の名前を指定する文字列。Babelfish DB クラスターをプロビジョニングするときに、このパラメータを設定します。DB クラスターのプロビジョニング後は、このパラメータの値を変更しないでください。(デフォルト: bbf_unicode_general_ci_as) (許容値: tables を参照)

static

babelfishpg_tsql.version

@@VERSION 変数の出力を設定する文字列。Aurora PostgreSQL DB クラスターのこの値は変更しないでください。(デフォルト: null) (許容値: デフォルト)

dynamic

rds.babelfish_status

Babelfish 機能の状態を設定する文字列。このパラメータが datatypesonly に設定されている場合、Babelfish はオフになりますが、SQL Server のデータ型は引き続き使用できます。(デフォルト: off) (許容値: on、off、datatypesonly)

static

unix_socket_permissions

TDS サーバーの Unix ソケットパーミッションを設定する整数。Babelfish DB クラスターの作成後にこのパラメータを変更することはできません。(デフォルト: 0700) (許容値: 0 ~ 511)

false

Babelfish SSL 設定とクライアント接続

Babelfish for Aurora PostgreSQL DB クラスターへの SSL/TLS 接続を必須にするには、rds.force_ssl パラメータを使用します。

  • SSL/TLS 接続を必須にするには、rds.force_ssl パラメータ値を 1 (オン) に設定します。

  • 必須の SSL/TLS 接続をオフにするには、rds.force_ssl パラメータ値を 0 (オフ) に設定します。

このパラメータのデフォルト値は、Aurora PostgreSQL のバージョンによって異なります。

  • Aurora PostgreSQL バージョン 17 以降では、デフォルト値は 1 (オン) です。

  • Aurora PostgreSQL バージョン 16 以前では、デフォルト値は 0 (オフ) です。

注記

Aurora PostgreSQL バージョン 16 またはそれ以前のバージョンからバージョン 17 以降にメジャーバージョンアップグレードを実行すると、パラメータのデフォルト値は 0 (オフ) から 1 (オン) に変わります。この変更により、SSL 用に設定されていないアプリケーションで接続障害が発生する可能性があります。このパラメータを 0 (オフ) に設定することで、以前のデフォルトの動作に戻すことができます。

ドライバー固有の詳細については、BabelfishDB クラスターへの接続 を参照してください。

クライアントが TDS ポート (デフォルト 1433) に接続するとき、Babelfish はクライアントハンドシェイク中に送信された Secure Sockets Layer (SSL) 設定を Babelfish SSL パラメータ設定 (tds_ssl_encrypt) と比較します。その後 Babelfish は接続が許可されているかどうかを判断します。接続が許可されている場合、パラメータ設定およびクライアントが提供する暗号化のサポートに応じて、暗号化動作が強制されるかどうかが決まります。

次の表は、各組み合わせで Babelfish がどのように動作するかを示します。

クライアント SSL の設定 Babelfish SSL 設定 rds.force_ssl 接続は許可されていますか? クライアントに返された値

ENCRYPT_ON

いずれか

すべて

許可されている場合、接続全体が暗号化されます

ENCRYPT_ON

ENCRYPT_OFF

tds_ssl_encrypt=1

いずれか

許可されている場合、接続全体が暗号化されます

ENCRYPT_REQ

ENCRYPT_OFF

tds_ssl_encrypt=0

rds.force_ssl=0

許可されている場合、ログインパケットは暗号化されます

ENCRYPT_OFF

ENCRYPT_OFF

tds_ssl_encrypt=0

rds.force_ssl=1

いいえ、接続は閉じました

ENCRYPT_OFF

ENCRYPT_NOT_SUP

tds_ssl_encrypt=0

rds.force_ssl=0

はい

ENCRYPT_NOT_SUP

ENCRYPT_NOT_SUP

tds_ssl_encrypt=1

いずれか

いいえ、接続は閉じました

ENCRYPT_REQ

ENCRYPT_NOT_SUP

tds_ssl_encrypt=0

rds.force_ssl=1

いいえ、接続は閉じました

ENCRYPT_NOT_SUP

ENCRYPT_CLIENT_CERT

いずれか

すべて

いいえ、接続は閉じました

サポートされていません