XADD key ID field value [field value ...]

Redis XADD 用于向 stream 添加消息，如果指定的 stream 不存在，则创建一个 stream，XADD 语法格式：

XADD key ID field value [field value ...]

• key ：队列名称，如果不存在就创建
• ID ：消息 id，我们使用 * 表示由 redis 生成，可以自定义，但是要自己保证递增性。
• field value ： 记录。

一个 entry 是由多条键值对组成的，像一个小的字典。 键值对以用户给定的顺序存储，读取流的命令（如XRANGE 或者 XREAD） 可以保证按照通过 XADD 添加的顺序返回。

XADD 是唯一可以向流添加数据的 Redis 命令， XDEL 和 XTRIM，用于从流中删除数据。

流不好理解，可以简单理解为队列。

*指定流 ID 参数

流条目ID标识流内的给定条目。 如果指定的ID参数是字符*（星号ASCII字符），XADD命令会自动为您生成一个唯一的ID。 但是，也可以指定一个良好格式的ID，以便新的条目以指定的ID准确存储， 虽然仅在极少数情况下有用。

ID是由-隔开的两个数字组成的：

1526919030474-55

两个部分数字都是64位的，当自动生成ID时，第一部分是生成ID的Redis实例的毫秒格式的Unix时间。 第二部分只是一个序列号，以及是用来区分同一毫秒内生成的ID的。

ID保证始终是递增的：如果比较刚插入的条目的ID，它将大于其他任何过去的ID， 因此条目在流中是完全排序的。为了保证这个特性，如果流中当前最大的ID的时间 大于实例的当前本地时间，将会使用前者，并将ID的序列部分递增。例如， 本地始终回调了，或者在故障转移之后新主机具有不同的绝对时间，则可能发生这种情况。

当用户为XADD命令指定显式ID时，最小有效的ID是0-1， 并且用户必须指定一个比当前流中的任何ID都要大的ID，否则命令将失败。 通常使用特定ID仅在您有另一个系统生成唯一ID（例如SQL表）， 并且您确实希望Redis流ID与该另一个系统的ID匹配时才有用。

*上限流

可以使用MAXLEN选项来限制流中的最大元素数量。

与使用XADD添加条目相比较，使用MAXLEN修整会很昂贵： 流由宏节点表示为基数树，以便非常节省内存。改变由几十个元素组成的单个宏节点不是最佳的。 因此可以使用以下特殊形式提供命令：

XADD mystream MAXLEN ~ 1000 * ... entry fields here ...

在选项MAXLEN和实际计数中间的参数~的意思是，用户不是真的需要精确的1000个项目。 它可以多几十个条目，但决不能少于1000个。通过使用这个参数，仅当我们移除整个节点的时候才执行修整。 这使得命令更高效，而且这也是我们通常想要的。

*流的其他信息

更多关于Redis流的信息请参阅 introduction to Redis Streams document.

*返回值

多行字符串, specifically:

该命令返回被添加条目的ID。如果ID参数传的是*，那么ID是自动生成的， 其他情况下，返回用户输入的 ID。

*例子

"1732407547112-0"

"1732407547113-0"

(integer) 2

1) 1) "1732407547112-0"
   2) 1) "name"
      2) "Sara"
      3) "surname"
      4) "OConnor"
2) 1) "1732407547113-0"
   2) 1) "field1"
      2) "value1"
      3) "field2"
      4) "value2"
      5) "field3"
      6) "value3"