如何向 Tarantool 添加新字段 space

Question

我在 Tarantool 中有以下 space 模式

box.schema.space.create('customer')

format = {
    {name = 'id', type = 'string'},
    {name = 'last_name', type = 'string'},
}

box.space.customer:format(format)
box.space.customer:create_index('id', {parts = {{field = 'id', is_nullable = false}}})
box.space.customer:replace({'1', 'Ivanov'})

我想将新字段 first_name 添加到此 space。我有什么办法可以做到这一点？

Answer 1

在回答问题之前，我们应该讨论一个 format 方法。

format - 这是一个 space 选项，允许您通过名称从元组中获取值。实际上元组是一个值的“列表”，任何字段都可以通过字段号访问。

下一步是什么？例如。你有一个简单的模式。

box.schema.space.create('customer')
box.space.customer:format(format)
box.space.customer:create_index('id', {parts = {{field = 'id', is_nullable = false}}})
box.space.customer:replace({'1', 'Ivanov'})

让我们定义具有第三个字段的新格式 - first_name。

new_format = {
    {name = 'id', type = 'string'},
    {name = 'last_name', type = 'string'},
    {name = 'first_name', type = 'string'},
}

box.space.customer:format(new_format) -- error: our tuple have only two fields

tarantool> box.space.customer:format(new_format)
- --
- error: Tuple field 3 required by space format is missing
...

有两种修复方法。

使用默认值将新字段添加到元组的末尾。

box.space.customer:update({'1'}, {{'=', 3, 'Ivan'}})
box.space.customer:format(new_format) -- OK

将新字段定义为可为空

new_format = {
    {name = 'id', type = 'string'},
    {name = 'last_name', type = 'string'},
    {name = 'first_name', type = 'string', is_nullable = true},
}

box.space.customer:format(new_format) -- OK: absence of the third value is acceptable

您可以选择上述变体之一。

我刚刚添加了一些注释：

您不能通过缺席字段添加一些值（例如，您有第一个和第二个值，您应该在添加第四个之前添加第三个）

tarantool> box.tuple.new({'1', 'Ivanov'}):update({{'=', 4, 'value'}})
- --
- error: Field 4 was not found in the tuple

...

tarantool> box.tuple.new({'1', 'Ivanov'}):update({{'=', 3, box.NULL}, {'=', 4, 'value'}})
- --
- ['1', 'Ivanov', null, 'value']

...

如果您有很多数据，用默认值填充字段可能会是一个相当长的操作。应用迁移时请小心。

详细了解 format 方法 in the documentation。

如何向 Tarantool 添加新字段 space

How to add new field to Tarantool space

lua

nosql

tarantool