Files
doc-exports/docs/dcs/umn/dcs-pd-200813003.html
Chen, Junjie 2b90aa9fff DCS UMN 20240313 version
Reviewed-by: Mützel, Andrea <andrea.muetzel@t-systems.com>
Co-authored-by: Chen, Junjie <chenjunjie@huawei.com>
Co-committed-by: Chen, Junjie <chenjunjie@huawei.com>
2024-04-10 14:46:00 +00:00

140 lines
12 KiB
HTML

<a name="dcs-pd-200813003"></a><a name="dcs-pd-200813003"></a>
<h1 class="topictitle1">Command Restrictions</h1>
<div id="body1600245575467"><p id="dcs-pd-200813003__p18341248161510">Some Redis commands are supported by Redis Cluster DCS instances for multi-key operations in the same slot. For details, see <a href="#dcs-pd-200813003__table7589193113396">Table 1</a>.</p>
<p id="dcs-pd-200813003__p451610566582">Some commands support multiple keys but do not support cross-slot access. For details, see <a href="#dcs-pd-200813003__table152098710112">Table 2</a>.</p>
<div class="tablenoborder"><a name="dcs-pd-200813003__table7589193113396"></a><a name="table7589193113396"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-pd-200813003__table7589193113396" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Redis commands restricted in Redis Cluster DCS instances</caption><thead align="left"><tr id="dcs-pd-200813003__row17608931153912"><th align="left" class="cellrowborder" valign="top" width="28.17%" id="mcps1.3.3.2.3.1.1"><p id="dcs-pd-200813003__p861118318394">Category</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="71.83%" id="mcps1.3.3.2.3.1.2"><p id="dcs-pd-200813003__p8613631123915">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dcs-pd-200813003__row19615103153914"><td class="cellrowborder" colspan="2" valign="top" headers="mcps1.3.3.2.3.1.1 mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p106175313396"><strong id="dcs-pd-200813003__b175611651145711">Set</strong></p>
</td>
</tr>
<tr id="dcs-pd-200813003__row17106110145518"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p19106150185520">SINTER</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p3106100135510">Returns the members of the set resulting from the intersection of all the given sets.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row73718155114"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p114032111112">SINTERSTORE</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p9142182113117">Equal to <strong id="dcs-pd-200813003__b16908203473415">SINTER</strong>, but instead of returning the result set, it is stored in <em id="dcs-pd-200813003__i59081134163417">destination</em>.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row171510522410"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p1948711618517">SUNION</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p1491146259">Returns the members of the set resulting from the union of all the given sets.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row12312808552"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p1431280205512">SUNIONSTORE</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p103125020559">Equal to <strong id="dcs-pd-200813003__b05631538153420">SUNION</strong>, but instead of returning the result set, it is stored in <em id="dcs-pd-200813003__i45632386344">destination</em>.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row2380115517419"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p10822802518">SDIFF</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p68251301752">Returns the members of the set resulting from the difference between the first set and all the successive sets.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row116991015517"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p1169915035516">SDIFFSTORE</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p369980185510">Equal to <strong id="dcs-pd-200813003__b11702943153410">SDIFF</strong>, but instead of returning the result set, it is stored in <em id="dcs-pd-200813003__i197026437341">destination</em>.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row141351113558"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p1013613113559">SMOVE</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p1913611145515">Moves <strong id="dcs-pd-200813003__b113262686175625">member</strong> from the set at <strong id="dcs-pd-200813003__b105961067775625">source</strong> to the set at <em id="dcs-pd-200813003__i63494771875625">destination</em>.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row9622143120393"><td class="cellrowborder" colspan="2" valign="top" headers="mcps1.3.3.2.3.1.1 mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p156255312391"><strong id="dcs-pd-200813003__b10857124910574">Sorted Set</strong></p>
</td>
</tr>
<tr id="dcs-pd-200813003__row69805945518"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p1798069175510">ZUNIONSTORE</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p898017916552">Computes the union of <em id="dcs-pd-200813003__i2022934743418">numkeys</em> sorted sets given by the specified keys.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row0148510195511"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p1714817109555">ZINTERSTORE</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p514891019556">Computes the intersection of <em id="dcs-pd-200813003__i773554810349">numkeys</em> sorted sets given by the specified keys.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row562993110397"><td class="cellrowborder" colspan="2" valign="top" headers="mcps1.3.3.2.3.1.1 mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p163019319397"><strong id="dcs-pd-200813003__b86751046195717">HyperLogLog</strong></p>
</td>
</tr>
<tr id="dcs-pd-200813003__row53222122556"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p103221712195513">PFCOUNT</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p832261217556">Returns the approximated cardinality computed by the HyperLogLog data structure stored at the specified variable.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row13494131216558"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p9494312185518">PFMERGE</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p10494012175517">Merges multiple HyperLogLog values into a unique value.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row56371731203918"><td class="cellrowborder" colspan="2" valign="top" headers="mcps1.3.3.2.3.1.1 mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p14638531113917"><strong id="dcs-pd-200813003__b825815381589">Keys</strong></p>
</td>
</tr>
<tr id="dcs-pd-200813003__row546318184557"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p1646551816552">RENAME</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p174484012185">Renames <em id="dcs-pd-200813003__i38809700175625">key</em> to <em id="dcs-pd-200813003__i57147008175625">newkey</em>.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row15638318135519"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p463891815516">RENAMENX</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p76381518115516">Renames <em id="dcs-pd-200813003__i112288548975625">key</em> to <em id="dcs-pd-200813003__i46446324975625">newkey</em> if <em id="dcs-pd-200813003__i100067509875625">newkey</em> does not yet exist.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row582015183557"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p12822161814557">BITOP</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p5822518125516">Performs a bitwise operation between multiple keys (containing string values) and stores the result in the destination key.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row152120198553"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p221141914551">RPOPLPUSH</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p1921171914557">Returns and removes the last element (tail) of the list stored at source, and pushes the element at the first element (head) of the list stored at <em id="dcs-pd-200813003__i148931142075625">destination</em>.</p>
</td>
</tr>
<tr id="dcs-pd-200813003__row15642731143912"><td class="cellrowborder" colspan="2" valign="top" headers="mcps1.3.3.2.3.1.1 mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p12644153110392"><strong id="dcs-pd-200813003__b20151174214314">String</strong></p>
</td>
</tr>
<tr id="dcs-pd-200813003__row09952219550"><td class="cellrowborder" valign="top" width="28.17%" headers="mcps1.3.3.2.3.1.1 "><p id="dcs-pd-200813003__p7995152113554">MSETNX</p>
</td>
<td class="cellrowborder" valign="top" width="71.83%" headers="mcps1.3.3.2.3.1.2 "><p id="dcs-pd-200813003__p13995152115516">Merges multiple HyperLogLog values into a unique value.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="note" id="dcs-pd-200813003__note210215792015"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dcs-pd-200813003__p43221008215">While running commands that take a long time to run, such as <strong id="dcs-pd-200813003__b47844483675625">FLUSHALL</strong>, DCS instances may not respond to other commands and may change to the faulty state. After the command finishes executing, the instance will return to normal.</p>
</div></div>
<div class="tablenoborder"><a name="dcs-pd-200813003__table152098710112"></a><a name="table152098710112"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-pd-200813003__table152098710112" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Multi-key commands of Proxy Cluster instances</caption><thead align="left"><tr id="dcs-pd-200813003__en-us_topic_0269770665_row17275124052719"><th align="left" class="cellrowborder" valign="top" width="29.53%" id="mcps1.3.5.2.3.1.1"><p id="dcs-pd-200813003__en-us_topic_0269770665_p15275134015278">Category</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="70.47%" id="mcps1.3.5.2.3.1.2"><p id="dcs-pd-200813003__en-us_topic_0269770665_p52751140162714">Command</p>
</th>
</tr>
</thead>
<tbody><tr id="dcs-pd-200813003__en-us_topic_0269770665_row182751240102711"><td class="cellrowborder" valign="top" width="29.53%" headers="mcps1.3.5.2.3.1.1 "><p id="dcs-pd-200813003__en-us_topic_0269770665_p827594032713">Multi-key commands that support cross-slot access</p>
</td>
<td class="cellrowborder" valign="top" width="70.47%" headers="mcps1.3.5.2.3.1.2 "><p id="dcs-pd-200813003__en-us_topic_0269770665_p62751340122711">DEL, MGET, MSET, EXISTS, SUNION, SINTER, SDIFF, SUNIONSTORE, SINTERSTORE, SDIFFSTORE, ZUNIONSTORE, ZINTERSTORE</p>
</td>
</tr>
<tr id="dcs-pd-200813003__en-us_topic_0269770665_row1227514019276"><td class="cellrowborder" valign="top" width="29.53%" headers="mcps1.3.5.2.3.1.1 "><p id="dcs-pd-200813003__en-us_topic_0269770665_p172758407278">Multi-key commands that do not support cross-slot access</p>
</td>
<td class="cellrowborder" valign="top" width="70.47%" headers="mcps1.3.5.2.3.1.2 "><p id="dcs-pd-200813003__en-us_topic_0269770665_p162756405277">SMOVE, SORT, BITOP, MSETNX, RENAME, RENAMENX, BLPOP, BRPOP, RPOPLPUSH, BRPOPLPUSH, PFMERGE, PFCOUNT, BLMOVE, COPY, GEOSEARCHSTORE, LMOVE, ZRANGESTORE</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dcs-pd-200312003.html">Command Compatibility</a></div>
</div>
</div>