Lua：Redisユーザー向けガイド

URL短縮サービスを構築しているとします。 URLが届くたびに、それを保存して、後でURLにアクセスするために使用できる一意の番号を返します。

Luaスクリプトを使用して、INCRを使用してRedisから一意のIDを取得します 一意のIDでキー設定されたハッシュにURLをすぐに保存します：

local link_id = redis.call("INCR", KEYS[1])
redis.call("HSET", KEYS[2], link_id, ARGV[1])
return link_id

call()を使用して、ここで初めてRedisにアクセスします function。call() の引数は、Redisに送信するコマンドです。最初にINCR <key> 次に、HSET <key> <field> <value> 。これらの2つのコマンドは順番に実行されます。このスクリプトの実行中、Redisは他に何も実行せず、非常に高速に実行されます。

2つのLuaテーブルKEYSにアクセスしています およびARGV 。テーブルは連想配列であり、データを構造化するためのLuaの唯一のメカニズムです。私たちの目的では、これらは最も使いやすい言語の配列に相当すると考えることができますが、この言語に不慣れな人々をつまずかせるこれら2つのLua-ismに注意してください。

• テーブルは1ベースです。つまり、インデックス作成は1から始まります。したがって、mytableの最初の要素は mytable[1]です 、2番目はmytable[2] 、など。

• テーブルはnil値を保持できません。操作によって[ 1, nil, 3, 4 ]のテーブルが生成される場合 、結果は代わりに[ 1 ]になります —テーブルは切り捨てられます 最初のnil値で。

このスクリプトを呼び出すときは、KEYSの値も渡す必要があります。 およびARGV テーブル。生のRedisプロトコルでは、コマンドは次のようになります。

EVAL $incrset.lua 2 links:counter links:url https://malcolmgladwellbookgenerator.com/

EVALを呼び出す場合 、スクリプトの後に2を提供します KEYSの数として アクセスされるので、KEYSをリストします 、最後にARGVの値を提供します 。

通常、Redis Luaスクリプトを使用してアプリをビルドする場合、Redisclientライブラリがキーの数の指定を処理します。上記のコードブロックは完全を期すために示されていますが、コマンドラインでこれを行う簡単な方法は次のとおりです。

redis-cli --eval incrset.lua links:counter links:urls , https://malcolmgladwellbookgenerator.com/

--evalを使用する場合 上記のように、コンマはKEYS[]を区切ります ARGV[]から アイテム。

わかりやすくするために、今回もKEYSを使用した元のスクリプトを示します。 およびARGV 拡張：

local link_id = redis.call("INCR", "links:counter")
redis.call("HSET", "links:urls", link_id, "https://malcolmgladwellbookgenerator.com")
return link_id

Redis用のLuaスクリプトを作成する場合、アクセスされるすべてのキーには、KEYSのみがアクセスする必要があります。 テーブル。 ARGV テーブルはパラメータの受け渡しに使用されます—ここでは保存したいURLの値です。

条件付きロジック：increxとhincrex

上記の例では、URL短縮サービスのリンクを保存していますが、URLにアクセスした回数も追跡する必要があります。そのために、Redisのハッシュにカウンターを保持します。ユーザーがリンク識別子を持ってきたら、それが存在するかどうかを確認し、存在する場合はそのカウンターをインクリメントします。

if redis.call("HEXISTS", KEYS[1], ARGV[1]) == 1 then
  return redis.call("HINCRBY", KEYS[1], ARGV[1], 1)
else
  return nil
end

誰かがショートリンクをクリックするたびに、このスクリプトを実行して、リンクが再び共有されたことを追跡します。 EVALを使用してスクリプトを呼び出します links:visitsを渡します 単一のキーと、前のスクリプトから単一の引数として返されたリンク識別子。

スクリプトはハッシュなしでほぼ​​同じように見えます。標準のRedisキーが存在する場合にのみインクリメントするスクリプトは次のとおりです。

if redis.call("EXISTS",KEYS[1]) == 1 then
  return redis.call("INCR",KEYS[1])
else
  return nil
end

SCRIPTLOADとEVALSHA

RedisがLuaスクリプトを実行しているときは、他には何も実行されないことに注意してください。最良のスクリプトは、必要最小限のロジックで、既存の小さなアトミックデータ操作のRedisボキャブラリーを拡張するだけです。 Luaスクリプトのバグにより、Redisサーバーが完全にロックされる可能性があります。短くしてデバッグしやすいようにするのが最善です。

通常は非常に短いですが、実行するたびに完全なLuaスクリプトを指定する必要はありません。実際のアプリケーションでは、代わりに、アプリケーションの起動時（またはデプロイ時）に各LuaスクリプトをRedisに登録し、後で一意のSHA-1識別子でスクリプトを呼び出します。

redis-cli SCRIPT LOAD "return 'hello world'"
# "5332031c6b470dc5a0dd9b4bf2030dea6d65de91"

redis-cli EVALSHA 5332031c6b470dc5a0dd9b4bf2030dea6d65de91 0
# "hello world"

SCRIPT LOADへの明示的な呼び出し EVALの場合、ライブアプリケーションでは通常不要です。 渡されるスクリプトを暗黙的にロードします。アプリケーションはEVALSHAを試みることができます 楽観的にEVALにフォールバックします スクリプトが見つからない場合のみ。

Rubyプログラマーの方は、ShopifyのWolverineをご覧ください。これにより、RubyアプリのLuaスクリプトの読み込みと保存が簡単になります。 PHPプログラマーの場合、Predisは、通常のRedisコマンドであるかのように呼び出されるLuascriptの追加をサポートしています。これらのツールやその他のツールを使用してLuaとのやり取りを標準化する場合は、お知らせください。他に何があるかを知りたいと思います。

if redis.call("EXISTS", KEYS[1]) == 1 then
  local payload = redis.call("GET", KEYS[1])
  return cjson.decode(payload)[ARGV[1]]
else
  return nil
end

redis-cli set apple '{ "color": "red", "type": "fruit" }'
# OK

redis-cli --eval json-get.lua apple , type
# "fruit"

if redis.call("EXISTS", KEYS[1]) == 1 then
  local payload = redis.call("GET", KEYS[1])
  return cmsgpack.unpack(payload)[ARGV[1]]
else
  return nil
end

local indiana_pi = 3.2
return indiana_pi

local indiana_pi = 3.2
redis.call("SET", "pi", indiana_pi)
return redis.call("GET", "pi")