Configuration du client par défaut pour Node.js - Amazon DynamoDB

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 Node.js

Lors de la configuration du client DAX JavaScript SDK, vous pouvez personnaliser divers paramètres pour optimiser les performances, la gestion des connexions et la résilience aux erreurs. Le tableau suivant décrit les paramètres de configuration par défaut qui contrôlent la manière dont votre client interagit avec le cluster DAX, notamment les valeurs de délai d’expiration, les mécanismes de nouvelle tentative, la gestion des informations d’identification et les options de surveillance de l’état de santé. Pour plus d'informations, consultez Dynamo DBClient Operations.

Paramètres par défaut du kit SDK JS DAX
Paramètre Type Description

region

facultatif

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 la variable d’environnement.

endpoint

obligatoire

string

Point de terminaison du cluster auquel le kit SDK se connecte.

Exemples :

Non crypté — .region.amazonaws.com dax-cluster-name

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

requestTimeout

Par défaut : 6 000 ms

number

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

writeRetries

Par défaut : 1

number

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

readRetries

Par défaut : 1

number

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

maxRetries

Par défaut : 1

number

Nombre maximal de nouvelles tentatives en cas d’échec des demandes.

S' readRetries/writeRetries ils sont définis, la configuration définie dans ReadRetries et WriteRetries a priorité sur MaxRetries.

connectTimeout

Par défaut : 10 000 ms

number

Délai (en millisecondes) pour établir une connexion à l’un des nœuds du cluster.

maxConcurrentConnections

Par défaut : 100

number

Limite le nombre total de connexions simultanées qu’une instance client peut créer par nœud dans un cluster DAX.

maxRetryDelay

Par défaut : 7 000 ms

number

Lorsque le serveur DAX indique qu’une récupération est nécessaire en définissant l’indicateur waitForRecoveryBeforeRetrying sur true, le client fait une pause avant de réessayer. Pendant ces périodes de récupération, le paramètre maxRetryDelay détermine le temps d’attente maximal entre les tentatives. Cette configuration spécifique à la récupération s’applique uniquement lorsque le serveur DAX est en mode récupération. Pour tous les autres scénarios, le comportement des nouvelles tentatives suit l’un des deux modèles suivants : soit un délai exponentiel basé sur le nombre de tentatives (régi par les paramètres writeRetries, readRetries ou maxRetries), soit une nouvelle tentative immédiate en fonction du type d’exception.

credentials

facultatif

AwsCredentialIdentity | AwsCredentialIdentityProvider

Les AWS informations d'identification à utiliser pour authentifier les demandes. Cela peut être fourni sous forme de AwsCredentialIdentity ou de AwsCredentialIdentityProvider. Si ces paramètres ne sont pas fournis, le kit SDK AWS utilisera automatiquement la chaîne du fournisseur d’informations d’identification par défaut. Exemple : `{ accessKeyId: 'AKIA... ' , secretAccessKey : ' ... ', SessionToken :'... '} `* @default Utilise la chaîne de fournisseurs d'informations d'identification AWS par défaut.

healthCheckInterval

Par défaut : 5 000 ms

number

Intervalle (en millisecondes) entre les surveillances de l’état du cluster. Un intervalle inférieur permet d’effectuer des surveillances plus fréquentes.

healthCheckTimeout

Par défaut : 1 000 ms

number

Délai (en millisecondes) nécessaire à l’exécution de la surveillance de l’état.

skipHostnameVerification

Par défaut : false

boolean

Ignore la vérification du nom d’hôte des connexions TLS. Cela n’a aucun impact sur les clusters non chiffrés. Par défaut, la vérification du nom d’hôte est effectuée. Si vous définissez ce paramètre sur True, la vérification sera ignorée. Assurez-vous de bien comprendre les conséquences de sa désactivation, à savoir l’impossibilité d’authentifier le cluster auquel vous vous connectez.

unhealthyConsecutiveErrorCount

Par défaut : 5

number

Définit le nombre d’erreurs consécutives nécessaires pour signaler un nœud défectueux pendant l’intervalle de surveillance de l’état.

clusterUpdateInterval

Par défaut : 4 000 ms

number

Renvoie l’intervalle entre les interrogations des membres du cluster pour les modifications d’appartenance.

clusterUpdateThreshold

Par défaut : 125

number

Renvoie le seuil en dessous duquel le cluster ne sera pas interrogé pour les modifications d’appartenance.

credentailProvider

facultatif | null par défaut

AwsCredentialIdentityProvider

Fournisseur défini par l'utilisateur pour les AWS informations d'identification utilisées pour authentifier les demandes adressées au DAX.
Configuration de pagination pour DaxDocument
Nom Type Détail

client

DaxDocument

Instance de DaxDocument type.

pageSize

number

Détermine le nombre d’éléments par page.

startingToken

Facultatif

any

LastEvaluatedKey La réponse précédente peut être utilisée pour les demandes suivantes.

Pour plus d’informations sur l’utilisation de la pagination, consultez TryDax.js.