Node.js 的預設用戶端組態 - Amazon DynamoDB

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Node.js 的預設用戶端組態

設定 DAX JavaScript SDK 用戶端時,您可以自訂各種參數,以最佳化效能、連線處理和錯誤恢復能力。下表概述控制用戶端與 DAX 叢集互動方式的預設組態設定,包括逾時值、重試機制、憑證管理和運作狀態監控選項。如需詳細資訊,請參閱 DynamoDBClient 操作

DAX JS SDK 用戶端預設值
參數 類型 說明

region

選擇性

string

AWS 區域 用於 DAX 用戶端的 (範例 - 'us-east-1')。如果未透過環境變數提供,則此為必要參數。

endpoint

必要

string

軟體開發套件所連線叢集的端點。

範例:

未加密:dax-cluster-name.region.amazonaws.com

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

requestTimeout

預設 6000 毫秒

number

這用於定義用戶端等待 DAX 回應的時間上限。

writeRetries

預設 1

number

寫入請求失敗時的重試次數。

readRetries

預設 1

number

讀取請求失敗時的重試次數。

maxRetries

預設 1

number

請求失敗時的重試次數上限。

如果已設定 readRetries/writeRetries,則 readRetries 和 writeRetries 中設定的組態會優先於 maxRetries。

connectTimeout

預設 10000 毫秒

number

建立任何叢集節點連線的逾時值 (以毫秒為單位)。

maxConcurrentConnections

預設 100

number

限制用戶端執行個體可在 DAX 叢集中為每個節點建立的並行連線總數。

maxRetryDelay

預設 7000 毫秒

number

DAX 伺服器將 waitForRecoveryBeforeRetrying 旗標設定為 true 表示需要復原時,用戶端會先暫停然後再重試。在這些復原期間,maxRetryDelay 參數會決定重試之間的最長等待時間。此復原專屬組態僅適用於處於復原模式的 DAX 伺服器。對於所有其他情境,重試行為會遵循兩種模式之一:根據重試計數的指數延遲 (由 writeRetriesreadRetries、或 maxRetries 參數控管),或根據例外狀況類型立即重試。

credentials

選擇性

AwsCredentialIdentity | AwsCredentialIdentityProvider

用於驗證請求的 AWS 登入資料。這能夠以 AwsCredentialIdentity 或 AwsCredentialIdentityProvider 的形式提供。如果未提供, AWS 軟體開發套件會自動使用預設憑證供應者鏈結。範例:`{ accessKeyId: 'AKIA...', secretAccessKey: '...', sessionToken: '...' }` * @default 使用預設 AWS 憑證供應者鏈結。

healthCheckInterval

預設 5000 毫秒

number

叢集運作狀態檢查之間的間隔 (以毫秒為單位)。間隔時間越短,檢查頻率就更高。

healthCheckTimeout

預設 1000 毫秒

number

完成運作狀態檢查的逾時 (以毫秒為單位)。

skipHostnameVerification

預設 false

boolean

略過 TLS 連線的主機名稱驗證。這不會影響未加密叢集。預設為執行主機名稱驗證,將此設定為 True 會略過驗證。請務必了解將其關閉的意涵,也就是無法驗證您連線的叢集。

unhealthyConsecutiveErrorCount

預設 5

number

設定在運作狀態檢查間隔內向節點發出運作狀態不佳訊號所需的連續錯誤次數。

clusterUpdateInterval

預設 4000 毫秒

number

傳回輪詢叢集成員以進行成員資格變更之間的間隔。

clusterUpdateThreshold

預設 125

number

傳回低於閾值的叢集不會接受輪詢進行成員資格變更。

credentailProvider

選用 | 預設 null

AwsCredentialIdentityProvider

用於驗證 DAX 請求之 AWS 登入資料的使用者定義提供者。

DaxDocument 的分頁組態
名稱 類型 詳細資訊

client

DaxDocument

DaxDocument 類型的執行個體。

pageSize

number

決定每頁的項目數。

startingToken

選用

any

先前回應的 LastEvaluatedKey 可用於後續請求。

如需了解分頁的使用方式,請參閱 TryDax.js