Tair (Redis® OSS-Compatible):Luaスクリプトの構文と一般的なエラーの解決策

コマンド

構文

説明

EVAL

EVALスクリプトnumkeys [key [key ...]]] [arg [arg ...]]

パラメーターを含む特定のスクリプトを実行し、出力を返します。

EVALSHA

EVALSHA sha1 numkeys key [key ...] arg [arg ...]

SHA1ダイジェストによってキャッシュされたスクリプトを評価し、スクリプトを実行します。

EVALSHAコマンドを使用するときにスクリプトがTair (Redis OSS互換) にキャッシュされていない場合、Tair (Redis OSS互換) はNOSCRIPTエラーを返します。 EVALまたはscript LOADコマンドを使用してスクリプトをTair (Redis OSS互換) にキャッシュし、再試行します。 詳細については、「NOSCRIPTエラーの処理」をご参照ください。

スクリプトロード

SCRIPTロードスクリプト

指定されたスクリプトをキャッシュし、スクリプトのSHA1ダイジェストを返します。

スクリプトが存在

SCRIPT EXISTSスクリプト [script ...]

対応するSHA1ダイジェストを使用して、スクリプトキャッシュ内の1つ以上のスクリプトの存在に関する情報を返します。 特定のスクリプトが存在する場合、値1が返されます。 そうでなければ、0の値が返される。

SCRIPT KILL

SCRIPT KILL

実行中のLuaスクリプトを終了します。

SCRIPT FLUSH

SCRIPT FLUSH

現在のインスタンスのスクリプトキャッシュからすべてのLuaスクリプトを削除します。

カテゴリ

エラーコード

説明

クラスターアーキテクチャ

-ERR for redisクラスター、eval/evalshaキーの数は負またはゼロにすることはできません \r\n

Luaスクリプトを実行するときにキーを含める必要があります。 プロキシはキーを使用して、Luaスクリプトの転送先のシャードを決定します。

# Example of valid command usage:
EVAL "return redis.call('get', KEYS[1])" 1 fooeval

# Example of invalid command usage:
EVAL "return redis.call('get', 'foo')" 0

-ERR 'xxx' コマンドキーは同じスロットにある必要があります

Luaスクリプトの複数のキーは同じスロットに属している必要があります。

# Example of valid command usage:
EVAL "return redis.call('mget', KEYS[1], KEYS[2])" 2 foo {foo}bar

# Example of invalid command usage:
EVAL "return redis.call('mget', KEYS[1], KEYS[2])" 2 foo foobar

プロキシLua構文チェック

(このチェックを無効にするには、script_check_enableパラメーターを0に設定できます)

-ERR bad luaスクリプトfor redis cluster, neste d redis.ca ll/redis.pcall

ネストされた呼び出しはサポートされません。 ローカル変数を使用してLuaスクリプトを呼び出すことができます。

# Example of valid command usage:
EVAL "local value = redis.call('GET', KEYS[1]); redis.call('SET', KEYS[2], value)" 2 foo bar

# Example of invalid command usage:
EVAL "redis.call('SET', KEYS[1], redis.call('GET', KEYS[2]))" 2 foo bar

-ERR bad luaスクリプトfor redis cluster, first parameter o f redis.ca ll/redis.pcallは単一のリテラル文字列である必要があります

redis.ca llまたはredis.pcall関数でLuaスクリプトを使用する場合、最初に指定するパラメーターは、実行するコマンドを表す文字列リテラルである必要があります。

# Example of valid command usage:
eval "redis.call('GET', KEYS[1])" 1 foo

# Example of invalid command usage:
eval "local cmd = 'GET'; redis.call(cmd, KEYS[1])" 1 foo

-ERR bad luaスクリプトfor redis cluster、スクリプトが使用するすべてのキーはkeys配列 \r\nを使用して渡す必要があります

Luaスクリプトは、redis.ca llまたはredis.pcall関数を使用してコマンドを実行します。 すべてのキーはkeys配列を使用して指定する必要があり、Lua変数で置き換えることはできません。

# Example of valid command usage:
EVAL "return redis.call('mget', KEYS[1], KEYS[2])" 2 foo {foo}bar

# Example of invalid command usage:
EVAL "return redis.call('mget', KEYS[1], '{foo}bar')" 1 foo                      # This command is invalid because the '{foo}bar' key must be specified by using the KEYS array. 
EVAL "local i = 2 return redis.call('mget', KEYS[1], KEYS[i])" 2 foo {foo}bar    # This command is invalid because the index of keys consists of variables, which is not allowed for an instance in proxy mode. Instances in direct connection mode are not subject to this limit. 
EVAL "return redis.call('mget', KEYS[1], ARGV[1])" 1 foo {foo}bar                # This command is invalid because ARGV[1] cannot be specified as a key. 

-ERR bad luaスクリプトfor redis cluster、スクリプトが使用するすべてのキーはkeys配列を使用して渡される必要があります。include destination、KEYSは式に含まれません

ZUNIONSTOREおよびZINTERSTOREコマンドの宛先パラメーターは、KEYS配列を使用して指定する必要があります。

-redisクラスターのERR bad luaスクリプト、ZUNIONSTORE/ZINTERSTORE numkeysパラメーターは、式ではなく単一の数値である必要があります

ZUNIONSTOREコマンドとZINTERSTOREコマンドのnumkeysパラメーターは定数ではありません。

-redisクラスターのERR不良luaスクリプト、ZUNIONSTORE/ZINTERSTORE numkeys値が整数または範囲外ではありません

ZUNIONSTOREコマンドとZINTERSTOREコマンドのnumkeysパラメーターは数値ではありません。

-ERR bad luaスクリプトfor redis cluster, ZUNIONSTORE/ZINTERSTOREスクリプトが使用するすべてのキーはkeys配列を使用して渡される必要があります

ZUNIONSTOREおよびZINTERSTOREコマンドのすべてのキーは、keys配列を使用して指定する必要があります。

-redisクラスターのERR不良luaスクリプト、XREAD/XREADGROUPスクリプトが使用するすべてのキーは、keys配列を使用して渡される必要があります

XREADおよびXREADGROUPコマンドのすべてのキーは、keys配列を使用して指定する必要があります。

-ERR bad luaスクリプトfor redis cluster、スクリプトが使用するすべてのキーはkeys配列を使用して渡される必要があり、KEYSは式に含まれない必要があります。sort command store keyが要件を満たしていません

SORTコマンドのキーは、keys配列を使用して指定する必要があります。

読み取り /書き込み権限

-ERR Writeコマンドは読み取り専用スクリプトからは許可されません

EVAL_ROコマンドを使用して送信されるLuaスクリプトには、書き込みコマンドは含まれません。

-ERR bad writeコマンドが書き込み権限なし

読み取り専用アカウントから送信されるLuaスクリプトには、書き込みコマンドを含めることはできません。

サポートされていないコマンド

-ERRスクリプトデバッグがサポートされていません

SCRIPT DEBUGコマンドはプロキシモードではサポートされていません。

-ERR bad luaスクリプトfor redis cluster, redis.ca ll/pcall unkown redisコマンドxxx

Luaスクリプトには、プロキシモードではサポートされないコマンドが含まれます。 詳細については、「クラスターインスタンスおよび読み書き分離インスタンスでサポートされているコマンドの制限」をご参照ください。

Lua構文

• -ERRの悪いluaスクリプトredisクラスター、redis.ca ll/pcall expect '('

• -ERR bad luaスクリプトfor redis cluster, redis.ca ll/redis.pcall定義が完了していない, expect ')'

Lua構文エラー: redis.ca ll関数の後に (および) の完全なセットが続く必要があります。

-redisクラスターのERR不良luaスクリプト、ZUNIONSTORE/ZINTERSTOREには少なくとも1つの入力キーが必要です

ZUNIONSTOREコマンドとZINTERSTOREコマンドのnumkeysパラメーターは0より大きくなければなりません。

-redisクラスターのERR不良luaスクリプト、ZUNIONSTORE/ZINTERSTOREキーカウント <numkeys

ZUNIONSTOREコマンドとZINTERSTOREコマンドのキーの数がnumkeys値よりも少ない。

-redisクラスターのERR不良luaスクリプト、xread/xreadgroupコマンド構文エラー

XREADまたはXREADGROUPコマンドの構文が正しくありません。 パラメータの数を確認してください。

-redisクラスターのERR不良luaスクリプト、xread/xreadgroupコマンド構文エラー、ストリームを指定する必要があります

streamsパラメーターは、XREADコマンドとXREADGROUPコマンドで必要です。

-redisクラスターのERR不良luaスクリプト、ソートコマンド構文エラー

SORTコマンドの構文が正しくありません。