Paramètres du groupe de paramètres de cluster de bases de données pour Babelfish - Amazon Aurora

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Paramètres du groupe de paramètres de cluster de bases de données pour Babelfish

Lorsque vous créez un cluster de bases de données Aurora PostgreSQL et choisissez Turn on Babelfish (Activer Babelfish), un groupe de paramètres de cluster de bases de données est créé automatiquement pour vous si vous choisissez Create new (Créer un nouveau). Ce groupe de paramètres de cluster de bases de données est basé sur le groupe de paramètres de cluster de bases de données Aurora PostgreSQL pour la version d’Aurora PostgreSQL choisie pour l’installation, par exemple Aurora PostgreSQL version 14. Il est nommé en utilisant le modèle général suivant :

custom-aurora-postgresql14-babelfish-compat-3

Vous pouvez modifier les paramètres suivants pendant le processus de création du cluster, mais certains d’entre eux ne peuvent pas être modifiés une fois qu’ils sont stockés dans le groupe de paramètres personnalisés. Choisissez donc soigneusement :

  • Base de données unique ou plusieurs bases de données

  • Paramètres régionaux de classement par défaut

  • Nom du classement

  • Groupe de paramètres de base de données

Pour utiliser un cluster de bases de données Aurora PostgreSQL version 13 ou un groupe de paramètres ultérieur, modifiez le groupe et définissez le paramètre babelfish_status sur on. Spécifiez toutes les options Babelfish avant de créer votre cluster Aurora PostgreSQL. Pour en savoir plus, consultez Groupes de paramètres pour Amazon Aurora.

Les paramètres suivants contrôlent les préférences Babelfish. Sauf indication contraire dans la description, les paramètres sont modifiables. La valeur par défaut est incluse dans la description. Pour voir les valeurs autorisées pour n’importe quel paramètre, procédez comme suit :

Note

Lorsque vous associez un nouveau groupe de paramètres de base de données à une instance de base de données, les paramètres statiques et dynamiques modifiés sont appliqués uniquement après que l’instance de base de données est redémarrée. Toutefois, si vous modifiez des paramètres dynamiques dans le groupe de paramètres de base de données après l’avoir associé à l’instance de base de données, ces modifications sont appliquées immédiatement sans redémarrage.

  1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l’adresse https://console.aws.amazon.com/rds/.

  2. Choisissez Parameter groups (Groupes de paramètres) dans le menu de navigation.

  3. Choisissez le groupe de paramètres du cluster de bases de données default.aurora-postgresql14 dans la liste.

  4. Saisissez le nom d’un paramètre dans le champ de recherche. Par exemple, saisissez babelfishpg_tsql.default_locale dans le champ de recherche pour afficher ce paramètre ainsi que sa valeur par défaut et ses valeurs autorisées.

    Note

    Les bases de données globales Babelfish pour Aurora PostgreSQL ne fonctionnent dans les régions secondaires que si les paramètres suivants sont activés dans ces régions.

Paramètre Description Type d’application Modifiable

babelfishpg_tsql.apg_enable_correlated_scalar_transform

Permet au planificateur de transformer une sous-requête scalaire corrélée dans Babelfish. (Par défaut : on) (Autorisé : on, off)

dynamic

true

babelfishpg_tsql.apg_enable_subquery_cache

Active l’utilisation du cache pour les sous-requêtes scalaires corrélées dans Babelfish. (Par défaut : on) (Autorisé : on, off)

dynamic

true

babelfishpg_tds.tds_default_numeric_scale

Définit l’échelle par défaut du type numérique à envoyer dans les métadonnées de la colonne TDS si le moteur n’en spécifie pas. (Par défaut : 8) (Autorisée : 0 à 38)

dynamic

true

babelfishpg_tds.tds_default_numeric_precision

Entier qui définit la précision par défaut du type numérique à envoyer dans les métadonnées de la colonne TDS si le moteur n’en spécifie pas. (Par défaut : 38) (Autorisée : 1 à 38)

dynamic

true

babelfishpg_tds.tds_default_packet_size

Entier qui définit la taille par défaut des paquets pour la connexion des clients SQL Server. (Par défaut : 4 096) (Autorisée : 512 à 32 767)

dynamic

true

babelfishpg_tds.tds_default_protocol_version

Entier qui définit une version de protocole TDS par défaut pour la connexion des clients. (Par défaut : DEFAULT) (Autorisée : TDSv7.0, TDSv7.1, TDSv7.1.1, TDSv7.2, TDSv7.3A, TDSv7.3B, TDSv7.4, DEFAULT)

dynamic

true

babelfishpg_tds.default_server_name

Chaîne qui identifie le nom par défaut du serveur Babelfish. (Par défaut : Microsoft SQL Server) (Autorisée : null)

dynamic

true

babelfishpg_tds.tds_debug_log_level

Entier qui définit le niveau de journalisation dans TDS ; 0 désactive la journalisation. (Par défaut : 1) (Autorisée : 0, 1, 2, 3)

dynamic

true

babelfishpg_tds.listen_addresses

Chaîne qui définit le nom d’hôte ou les adresses IP sur lesquelles écouter TDS. Ce paramètre ne peut pas être modifié une fois que le cluster de bases de données Babelfish a été créé. (Par défaut : * ) (Autorisée : null)

false

babelfishpg_tds.port

Entier qui spécifie le port TCP utilisé pour les requêtes dans la syntaxe SQL Server. (Par défaut : 1 433) (Autorisée : 1 à 65 535)

statique

true

babelfishpg_tds.tds_ssl_encrypt

Booléen qui active (0) ou désactive (1) le chiffrement des données traversant le port d’écoute TDS. Pour obtenir des informations détaillées sur l’utilisation de SSL pour les connexions client, consultez Paramètres SSL Babelfish et connexions client. (Par défaut : 0) (Autorisée : 0, 1)

dynamic

true

babelfishpg_tds.tds_ssl_max_protocol_version

Chaîne qui spécifie la version la plus élevée du protocole SSL/TLS à utiliser pour la session TDS. (Par défaut : « TLSv1.2 ») (Autorisée : « TLSv1 », « TLSv1.1 », « TLSv1.2 »)

dynamic

true

babelfishpg_tds.tds_ssl_min_protocol_version

Chaîne qui spécifie la version minimale du protocole SSL/TLS à utiliser pour la session TDS. (Par défaut : ’TLSv1.2’ à partir d’Aurora PostgreSQL version 16, ’TLSv1’ pour les versions antérieures à Aurora PostgreSQL version 16) (Autorisé : ’TLSv1’, ’TLSv1.1’, ’TLSv1.2’)

dynamic

true

babelfishpg_tds.unix_socket_directories

Chaîne qui identifie le répertoire des sockets Unix du serveur TDS. Ce paramètre ne peut pas être modifié une fois que le cluster de bases de données Babelfish a été créé. (Par défaut : /tmp) (Autorisée : null)

false

babelfishpg_tds.unix_socket_group

Chaîne qui identifie le groupe de sockets Unix du serveur TDS. Ce paramètre ne peut pas être modifié une fois que le cluster de bases de données Babelfish a été créé. (Par défaut : rdsdb) (Autorisée : null)

false

babelfishpg_tsql.default_locale

Chaîne qui spécifie les paramètres régionaux par défaut utilisés pour les classements Babelfish. Les paramètres régionaux par défaut se limitent aux paramètres régionaux ; ils n’incluent aucun qualificatif.

Définissez ce paramètre au moment de l’approvisionnement d’un cluster de bases de données Babelfish. Une fois le cluster de bases de données approvisionné, les modifications apportées à ce paramètre sont ignorées. (Par défaut : en_US) (Autorisée : voir tables)

statique

true

babelfishpg_tsql.migration_mode

Liste non modifiable qui spécifie la prise en charge des bases de données utilisateur uniques ou multiples. Définissez ce paramètre au moment de l’approvisionnement d’un cluster de bases de données Babelfish. Une fois le cluster de bases de données approvisionné, vous ne pouvez pas modifier la valeur de ce paramètre. (Par défaut : multi-db à partir d’Aurora PostgreSQL version 16, single-db pour les versions antérieures à Aurora PostgreSQL version 16) (Autorisé : single-db, multi-db, null)

statique

true

babelfishpg_tsql.server_collation_name

Chaîne qui spécifie le nom du classement utilisé pour les actions au niveau du serveur. Définissez ce paramètre au moment de l’approvisionnement d’un cluster de bases de données Babelfish. Une fois le cluster de bases de données approvisionné, ne modifiez pas la valeur de ce paramètre. (Par défaut : bbf_unicode_general_ci_as) (Autorisée : voir tables)

statique

true

babelfishpg_tsql.version

Chaîne qui définit la sortie de la variable @@VERSION. Ne modifiez pas cette valeur pour les clusters de bases de données Aurora PostgreSQL. (Par défaut : null) (Autorisée : default)

dynamic

true

rds.babelfish_status

Chaîne qui définit l’état de la fonctionnalité Babelfish. Lorsque ce paramètre est défini sur datatypesonly, Babelfish est désactivé, mais les types de données SQL Server sont toujours disponibles. (Par défaut : off) (Autorisée : on, off, datatypesonly)

statique

true

unix_socket_permissions

Entier qui définit les autorisations des sockets Unix du serveur TDS. Ce paramètre ne peut pas être modifié une fois que le cluster de bases de données Babelfish a été créé. (Par défaut : 0700) (Autorisée : 0 à 511)

false

Paramètres SSL Babelfish et connexions client

Pour exiger que les connexions à votre cluster de bases de données Babelfish pour Aurora PostgreSQL utilisent SSL/TLS, appliquez le paramètre rds.force_ssl.

  • Pour que les connexions utilisent SSL/TLS, définissez la valeur du paramètre rds.force_ssl sur 1 (activé).

  • Pour que les connexions n’utilisent plus SSL/TLS, définissez la valeur du paramètre rds.force_ssl sur 0 (désactivé).

La valeur par défaut de ce paramètre dépend de la version d’Aurora PostgreSQL :

  • Pour Aurora PostgreSQL 17 et les versions ultérieures : la valeur par défaut est 1 (activé).

  • Pour Aurora PostgreSQL 16 et les versions antérieures : la valeur par défaut est 0 (désactivé).

Note

Lorsque vous effectuez une mise à niveau de version majeure d’Aurora PostgreSQL 16 ou version antérieure vers la version 17 ou une version ultérieure, la valeur par défaut du paramètre passe de 0 (désactivé) à 1 (activé). Ce changement peut entraîner des défaillances de connectivité pour les applications qui ne sont pas configurées pour le protocole SSL. Pour revenir au comportement par défaut précédent, définissez ce paramètre sur 0 (désactivé).

Pour des informations spécifiques au pilote, consultez Connexion à un cluster de bases de données Babelfish.

Lorsqu’un client se connecte au port TDS (1433 par défaut), Babelfish compare le paramètre SSL (Secure Sockets Layer) envoyé lors de l’établissement de la liaison client avec le paramètre Babelfish SSL (tds_ssl_encrypt). Babelfish détermine alors si une connexion est autorisée. Si une connexion est autorisée, le comportement de chiffrement est appliqué ou non, en fonction de vos paramètres et de la prise en charge du chiffrement offerte par le client.

Le tableau suivant montre comment Babelfish se comporte pour chaque combinaison.

Paramètre SSL du client Paramètre SSL de Babelfish rds.force_ssl Connexion autorisée ? Valeur renvoyée au client

ENCRYPT_ON

N’importe quel compte

N’importe quel compte

Autorisée, la connexion est intégralement chiffrée

ENCRYPT_ON

ENCRYPT_OFF

tds_ssl_encrypt=1

N’importe quel compte

Autorisée, la connexion est intégralement chiffrée

ENCRYPT_REQ

ENCRYPT_OFF

tds_ssl_encrypt=0

rds.force_ssl=0

Autorisée, le paquet de connexion est chiffré

ENCRYPT_OFF

ENCRYPT_OFF

tds_ssl_encrypt=0

rds.force_ssl=1

Non, connexion fermée

ENCRYPT_OFF

ENCRYPT_NOT_SUP

tds_ssl_encrypt=0

rds.force_ssl=0

Oui

ENCRYPT_NOT_SUP

ENCRYPT_NOT_SUP

tds_ssl_encrypt=1

N’importe quel compte

Non, connexion fermée

ENCRYPT_REQ

ENCRYPT_NOT_SUP

tds_ssl_encrypt=0

rds.force_ssl=1

Non, connexion fermée

ENCRYPT_NOT_SUP

ENCRYPT_CLIENT_CERT

N’importe quel compte

N’importe quel compte

Non, connexion fermée

Non pris en charge