Skip to content

Storage

Persistent key-value storage.

3 modules

ModuleDescription
刪除儲存的值從持久化的鍵值儲存中刪除一個值
取得儲存的值從持久化的鍵值儲存中取得一個值
儲存值在持久化的鍵值儲存中儲存一個值

Modules

刪除儲存的值

storage.delete

從持久化的鍵值儲存中刪除一個值

Parameters:

NameTypeRequiredDefaultDescription
namespacestringYesdefault儲存命名空間
keystringYes-儲存命名空間

Output:

FieldTypeDescription
okboolean要刪除的鍵
deletedboolean操作是否成功
keystring操作是否成功

Example: Delete cached value

yaml
namespace: cache
key: api_response

取得儲存的值

storage.get

從持久化的鍵值儲存中取得一個值

Parameters:

NameTypeRequiredDefaultDescription
namespacestringYesdefault儲存命名空間(例如,工作流程名稱或專案)
keystringYes-儲存命名空間(例如,工作流程名稱或專案)
defaultanyNo-要取得的鍵

Output:

FieldTypeDescription
okboolean如果鍵不存在要返回的值
foundboolean操作是否成功
valueany操作是否成功
keystring鍵是否被找到(未過期)

Example: Get last BTC price

yaml
namespace: crypto-alerts
key: btc_last_price
default: 0

Example: Get workflow state

yaml
namespace: my-workflow
key: last_run_status

儲存值

storage.set

在持久化的鍵值儲存中儲存一個值

Parameters:

NameTypeRequiredDefaultDescription
namespacestringYesdefault儲存命名空間(例如,工作流程名稱或專案)
keystringYes-儲存命名空間(例如,工作流程名稱或專案)
valueanyYes-要在其下儲存值的鍵
ttl_secondsnumberNo0Time to live in seconds (optional, 0 = no expiration)

Output:

FieldTypeDescription
okboolean存活時間(秒)(可選,0 = 不過期)
keystring操作是否成功
stored_atnumber操作是否成功
expires_atnumber已儲存的鍵

Example: Store BTC price

yaml
namespace: crypto-alerts
key: btc_last_price
value: 42350.5

Example: Store with expiration

yaml
namespace: cache
key: api_response
value: {"data": "cached"}
ttl_seconds: 3600

Released under the Apache 2.0 License.