Avgidea Function で実行するファンクション内 (kvs API document) から Avgidea KVS にアクセスし、キーと値(JSON形式)のペアを一つの単位として、データ操作(*1)が行えます。アプリケーションや機能別に領域(Store)を分けることで、用途別にデータを管理することができます。
stores = kvs.stores()
adpy.log(stores)
ファンクション
stores : ストア一覧の取得。
戻り値
resp : ストア一覧を含む配列
store = 'kvs1'
v = {
'p1': 'aaa',
'p2': 1.1,
'p3': 2,
'p4': True
}
kvs.create(key="key1", value=v, store=store)
ファンクション
create : JSON オブジェクトの格納。key がすでに存在する場合、エラーが返る
パラメータ
key : エントリのキー
value : エントリの値(*2)
store : エントリの格納先のストア(デフォルト値 default)
戻り値
resp : CREATE のステータスとメッセージ
store = 'kvs1'
v = {
'p1': 'aaa',
'p2': 1.1,
'p3': 2,
'p4': True
}
kvs.put(key="key1", value=v, store=store)
ファンクション
put : JSON オブジェクトの格納。key がすでに存在する場合、値を上書きする
パラメータ
key : エントリのキー
value : エントリの値
store : エントリの格納先のストア(デフォルト値 default)
戻り値
resp : PUT のステータスとメッセージ
store = 'kvs1'
v = kvs.get(key="key1", store=store)
ファンクション
get : key に紐づいた値を取得
パラメータ
key : エントリのキー
store : エントリの格納先のストア(デフォルト値 default)
戻り値
value : エントリの値
store = 'kvs1'
kvs.delete(key="key1", store=store)
ファンクション
delete : key に紐づいた値を削除
パラメータ
key : エントリのキー
store : エントリの格納先のストア(デフォルト値 default)
戻り値
resp : DELETE のステータスとメッセージ
store = 'kvs1'
kvs.keys(filter="key",store=store)
ファンクション
keys
パラメータ
filter : キーのフィルタリング(オプション)
store : エントリの格納先のストア(デフォルト値 default)
戻り値
resp : キーの一覧を含む配列
Note :
*1 KVS の CRUD 実行毎に、クォータとして KVS request が消費されます。
*2 値に含まれる float 型で、1.0 や 2.0 などの整数として表せる浮動小数点数は、自動的に int 型に変換・格納されます。