View a markdown version of this page

Configurazione client predefinita per Node.js - Amazon DynamoDB

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione client predefinita per Node.js

Durante la configurazione del client DAX JavaScript SDK, è possibile personalizzare vari parametri per ottimizzare le prestazioni, la gestione delle connessioni e la resilienza agli errori. La tabella seguente descrive le impostazioni di configurazione predefinite che controllano il modo in cui il client interagisce con il cluster DAX, inclusi i valori di timeout, i meccanismi di ripetizione dei tentativi, la gestione delle credenziali e le opzioni di monitoraggio dello stato. Per ulteriori informazioni, consulta DynamoDBClient Operations.

Impostazioni predefinite del client SDK DAX per JS
Parametro Tipo Description

region

facoltativo

string

Regione AWS Da utilizzare per il client DAX (esempio: 'us-east-1'). Questo è un parametro obbligatorio se non viene fornito tramite la variabile di ambiente.

endpoint

obbligatorio

string

L’endpoint del Cluster a cui si connette l’SDK.

Esempi:

Non-encrypted — dax-cluster-name.region.amazonaws.com

Crittografato: daxs://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com

requestTimeout

valore predefinito 6000 ms

number

Definisce il tempo massimo di attesa da parte del client per ricevere una risposta da DAX.

writeRetries

valore predefinito 1

number

Il numero di ripetizioni di tentativi per le richieste di scrittura che hanno esito negativo.

readRetries

valore predefinito 1

number

Il numero di ripetizioni di tentativi per le richieste di lettura che hanno esito negativo.

maxRetries

valore predefinito 1

number

Il numero massimo di ripetizioni di tentativi in caso di richieste che hanno esito negativo.

Se readRetries/writeRetries sono impostati, la configurazione impostata in ReadRetries e WriteRetries ha la priorità su MaxRetries.

connectTimeout

valore predefinito 10000 ms

number

Il timeout (in millisecondi) per stabilire una connessione a uno qualsiasi dei nodi del cluster.

maxConcurrentConnections

valore predefinito 100

number

Limita il numero totale di connessioni simultanee che un’istanza client può creare per nodo in un cluster DAX.

maxRetryDelay

valore predefinito 7000 ms

number

Quando il server DAX indica che è necessario il ripristino impostando il flag waitForRecoveryBeforeRetrying su true, il client si interrompe prima della ripetizione del tentativo. Durante questi periodi di recupero, il parametro maxRetryDelay determina il tempo massimo di attesa tra le ripetizioni di tentativi. Questa configurazione specifica per il recupero si applica solo quando il server DAX è in modalità di recupero. In tutti gli altri scenari, il comportamento delle ripetizioni di tentativi segue uno dei due modelli seguenti: un ritardo esponenziale basato sul numero di ripetizioni di tentativi (regolato da parametri writeRetries, readRetries o maxRetries) o una ripetizione di tentativo immediata a seconda del tipo di eccezione.

credentials

facoltativo

AwsCredentialIdentity | AwsCredentialIdentityProvider

Le credenziali da utilizzare per l'autenticazione delle richieste. AWS Può essere fornito come o come AwsCredentialIdentity . AwsCredentialIdentityProvider Se non fornite, l’SDK AWS utilizzerà automaticamente la catena di provider di credenziali predefinita. Esempio: `{accessKeyId: 'AKIA... ', segretoAccessKey:' ... ', sessionToken:'... '} `* @default Utilizza la catena di provider di AWS credenziali predefinita.

healthCheckInterval

valore predefinito 5000 ms

number

L’intervallo (in millisecondi) tra i controlli di integrità del cluster. Un intervallo più basso verrà controllato più frequentemente.

healthCheckTimeout

valore predefinito 1000 ms

number

Il timeout (in millisecondi) per il completamento del controllo dell’integrità.

skipHostnameVerification

valore predefinito false

boolean

Salta la verifica del nome host delle connessioni TLS. Non ha alcun impatto sui cluster non crittografati. L’impostazione predefinita prevede la verifica del nome host; impostandola su True, la verifica verrà saltata. Assicurati di comprendere le implicazioni della disattivazione, ovvero l’impossibilità di autenticare il cluster a cui ti stai connettendo.

unhealthyConsecutiveErrorCount

valore predefinito 5

number

Imposta il numero di errori consecutivi necessari per segnalare un nodo non integro entro l’intervallo di controllo dell’integrità.

clusterUpdateInterval

valore predefinito 4000 ms

number

Restituisce l’intervallo tra polling di membri del cluster per le modifiche ai membri del cluster.

clusterUpdateThreshold

valore predefinito 125

number

Restituisce la soglia al di sotto della quale sul cluster non verranno eseguite query per le modifiche ai membri.

credentailProvider

opzionale | valore predefinito null

AwsCredentialIdentityProvider

Provider definito dall'utente per AWS le credenziali utilizzate per autenticare le richieste al DAX.

Configurazione dell'impaginazione per DaxDocument
Nome Tipo Dettaglio

client

DaxDocument

Istanza di DaxDocument tipo.

pageSize

numero

Determina il numero di elementi per pagina.

startingToken

Facoltativo

any

LastEvaluatedKey della risposta precedente può essere utilizzata per le richieste successive.

Per l’utilizzo dell’impaginazione, consulta TryDax.js.