概覽
Key-Value Store是一種穩健的資料儲存解決方案，可讓您管理大量資料點清單（例如數百（或數百萬）個錢包地址）以及鍵值集。透過 Key-Value Store，您可以按需更新清單和鍵值集，並隨時透過 REST API 進行管理與使用，或直接在您的 Streams 篩選器中無縫操作。
為什麼要使用鍵值儲存系統？
當您處理大量資料時，高效的儲存與快速的檢索至關重要。鍵值儲存庫能與 Streams 無縫整合，讓您能輕鬆地根據即時串流資料與歷史資料，對清單和鍵值集合進行評估，管理清單與集合，並以高效率逐區塊追蹤資料點。
此解決方案對於需要即時追蹤、更新及評估大型資料集的使用情境特別有用，例如：
- 希望追蹤龐大且動態變化的錢包地址清單活動的錢包與投資組合應用程式
- 追蹤與查閱代幣持有量
- 用於追蹤隨時間變化的數值並針對其變化發出警示的應用程式
鍵值儲存系統的特色
- 可擴展的資料管理——輕鬆管理、存取及評估大量資料清單，例如數百萬個地址或其他資料點。
- 即時更新— 隨時更新您的資料，並立即存取。
- API 存取— 透過 REST API 操作您的清單和鍵值集。
- Streams 整合— 在 Streams 篩選器中無縫使用鍵值儲存庫，以強化資料處理能力。
- 高效能——鍵值儲存系統具備超快的存取時間，可高效地進行資料查詢與更新。
使用案例範例
- 錢包地址管理：管理錢包地址清單，以便與串流資料進行比對。
- 歷史資料追蹤：追蹤各項指標隨時間變化的數值。
- 資料分析：針對大型資料集計算變動量及其他統計指標。
透過運用鍵值儲存庫，您可以強化並自訂 Streams，從而根據您的需求，建立更精緻、高效且反應靈敏的串流資料集。
清單與集合：選擇合適的資料類型
| 清單 | 集合 | |
|---|---|---|
| 儲存的內容 | 單一鍵值下的一組命名字串項目集合 | 一個鍵值對 |
| 最適合 | 會員資格檢查（例如：「這個地址是否在我關注清單中？」） | 儲存與檢索個別資料點 |
| 範例 | 一個名為 已監控的錢包 包含數千個錢包地址 | 一個名為 lastProcessedBlock 附有數值 19271294 |
| 流函式 | qnContainsListItems, qnUpsertList, qnAddListItem | qnGetSet, qnAddSet, qnBulkSets |
當您需要根據串流資料來管理及評估一組動態項目（例如：錢包地址、代幣合約、帳戶 ID）時，請使用清單。當您需要儲存及擷取可能隨時間變動的個別資料點（例如：追蹤累計總和、儲存最後處理的區塊編號、在區塊之間快取計算出的值）時，請使用集合。
功能可用性與費用
所有 Quicknode 方案的用戶均可使用鍵值儲存服務。如需更多詳細資訊，請參閱定價頁面。
存取
透過Quicknode 開發者入口網站中的 Streams 存取鍵值儲存庫，並透過鍵值儲存庫 REST API 進行存取。
將鍵值儲存庫與 Streams 篩選器搭配使用
鍵值儲存庫中的項目會區分大小寫。在處理區塊鏈地址時，這一點尤其重要，因為必須完全按照鏈上顯示的樣式輸入。
您可以在 Streams 過濾器中無縫存取及管理鍵值儲存庫。您可以建立新的清單和鍵值集、在清單中新增或移除項目、更新鍵值集，並將鍵值儲存庫的資料與串流式區塊鏈資料進行比對。
在鍵值儲存系統中，「集合」指的是單一的鍵值對。「清單」則是與單一鍵相關聯、由字串項目組成的命名集合。
使用 清單 當您想將多個值與一個鍵關聯時，例如，您可以透過將大量錢包地址新增為 項目 加入一個名為 地址.
使用鍵值 集合 當您想儲存資料點以便日後輕鬆檢索和更新時，例如，您可以計算區塊內的平均汽油價格，並將該數值與鍵一併儲存 gasPrice，然後在下一段程式碼中讀取該值以計算變化量。
在您的 Streams 過濾器中可用的鍵值儲存功能
清單
qnLib.qnUpsertList: 在鍵值儲存庫中建立或更新一個新清單。qnLib.qnAddListItem: 將一項資料新增至鍵值儲存庫中的特定清單。qnLib.qnRemoveListItem: 從鍵值儲存庫中的特定清單中移除一項項目。qnLib.qnContainsListItems: 批次查詢，用於檢查多個項目是否屬於鍵值儲存庫中的特定清單。將所有查詢整合為盡可能少的呼叫次數，以減少往返次數並提升效能。qnLib.qnDeleteList: 刪除鍵值儲存庫中的特定清單。
清單的篩選程式碼範例
若要查看一個完整且可運作的範例，用以展示所有清單操作（qnUpsertList, qnAddListItem, qnRemoveListItem, qnContainsListItems, qnDeleteList)，請參閱 流過濾器文件.
集合
qnLib.qnAddSet: 在鍵值儲存庫中建立一個鍵值對。qnLib.qnBulkSets: 在鍵值儲存庫中批次建立及移除鍵值對。qnLib.qnDeleteSet: 從鍵值儲存庫中刪除一組鍵值對。qnLib.qnGetSet: 從鍵值儲存庫中擷取特定鍵的值。qnLib.qnListAllSets: 列出鍵值儲存庫中所有集合的鍵。
鍵值儲存集的篩選程式碼範例
若要查看一個完整且可運作的範例，用以展示所有集合運算（qnAddSet, qnGetSet, qnListAllSets, qnBulkSets, qnDeleteSet)，請參閱 流過濾器文件.
對「Key-Value Store」有任何意見或建議嗎？歡迎告訴我們。