Configuration du client par défaut pour Go - Amazon DynamoDB
Paramètres par défaut du client de kit SDK Go DAXCréation de client

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.

Configuration du client par défaut pour Go

Ce guide présente les options de configuration qui vous permettent d’optimiser les performances, la gestion des connexions et le comportement de journalisation de votre client DAX. En comprenant les paramètres par défaut et en sachant comment les personnaliser, vous pouvez optimiser l’interaction de votre application Go avec DAX.

Paramètres par défaut du client de kit SDK Go DAX

Paramètre Type Description

Region

obligatoire

string

Région AWS À utiliser pour le client DAX (exemple- 'us-east-1'). Il s’agit d’un paramètre obligatoire s’il n’est pas fourni par l’environnement.

HostPorts

obligatoire

[] string

Liste des points de terminaison du cluster DAX auxquels le kit SDK se connecte.

Par exemple :

Non chiffré : dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com

Chiffré : dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com

MaxPendingConnectionsPerHost

Par défaut : 10

number

Nombre de tentatives de connexion simultanées. (Les connexions peuvent être en cours d’établissement simultanément.)

ClusterUpdateThreshold

Par défaut : 125 * time.Millisecond

time.Duration

Durée minimale qui doit s’écouler entre les actualisations du cluster.

ClusterUpdateInterval

Par défaut : 4 * time.Second

time.Duration

Intervalle selon lequel le client actualise automatiquement les informations du cluster DAX.

IdleConnectionsReapDelay

Par défaut : 30 * time.Second

time.Duration

Intervalle selon lequel le client fermera les connexions inactives dans le client DAX.

ClientHealthCheckInterval

Par défaut : 5 * time.Second

time.Duration

Intervalle selon lequel le client effectuera des surveillances de l’état sur les points de terminaison du cluster DAX.

Credentials

default

aws.CredentialsProvider

Les AWS informations d'identification utilisées par le client DAX pour authentifier les demandes adressées au service DAX. Consultez Credentials and Credential Providers.

DialContext

default

func

Fonction personnalisée utilisée par le client DAX pour établir des connexions au cluster DAX.

SkipHostnameVerification

Par défaut : false

bool

Ignore la vérification du nom d’hôte des connexions TLS. Ce paramètre ne concerne que les clusters chiffrés. Lorsqu’il est défini sur True, il désactive la vérification du nom d’hôte. La désactivation de la vérification signifie que vous ne pouvez pas authentifier l’identité du cluster auquel vous vous connectez, ce qui pose des risques de sécurité. Par défaut, la vérification du nom d’hôte est activée.

RouteManagerEnabled

Par défaut : false

bool

Cet indicateur est utilisé pour supprimer les routes confrontées à des erreurs réseau.

RequestTimeout

par défaut : 60 * Time.second

time.Duration

Cela définit le temps maximum pendant lequel le client attend une réponse de DAX.

Priorité : délai d’expiration du contexte (s’il est défini) > RequestTimmeout (s’il est défini) > RequestTimeout de 60 s par défaut.

WriteRetries

Par défaut : 2

number

Nombre de nouvelles tentatives pour des demandes d’écriture qui ont échoué.

ReadRetries

Par défaut : 2

number

Nombre de nouvelles tentatives pour des demandes de lecture qui ont échoué.

RetryDelay

Par défaut : 0

time.Duration

Délai en cas d’erreurs non limitées (en secondes) pour les nouvelles tentatives en cas d’échec d’une demande.

Logger

facultatif

logging.Logger

Logger est une interface permettant de journaliser les entrées dans certaines classifications.

LogLevel

utilitaires par défaut. LogOff

number

Ce niveau de journalisation est défini pour DAX uniquement. Il peut être importé à l'aide de github. com/aws/aws-dax-go-v2/tree/main/dax/utils. 

const (    
 LogOff LogLevelType = 0   
 LogDebug LogLevelType = 1   
 LogDebugWithRequestRetries
 LogLevelType = 2
)
Note

Pour time.Duration, l’unité par défaut est la nanoseconde. Si nous ne spécifions aucune unité pour aucun paramètre, cela sera considéré comme des nanosecondes : daxCfg.ClusterUpdateInterval = 10 signifie 10 nanosecondes. (daxCfg.ClusterUpdateInterval = 10 * time.Millisecond signifie 10 millisecondes).

Création de client

Pour créer un client DAX :

  • Créez une configuration DAX, puis créez un client DAX à l’aide de la configuration DAX. Vous pouvez ainsi remplacer une configuration DAX si nécessaire.

    import (
"github.com/aws/aws-dax-go-v2/dax/utils"
"github.com/aws/aws-dax-go-v2/dax"
)

// Non - Encrypted : 'dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com'.
// Encrypted : daxs://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com'.

config := dax.DefaultConfig()
config.HostPorts = []string{endpoint}
config.Region = region
config.LogLevel = utils.LogDebug
daxClient, err := dax.New(config)