lua - 如何向 Tarantool 空间添加新字段

Question

我在 Tarantool 中有以下空间模式

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 添加到此空间。我有什么办法可以做到这一点？

Answer 1

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

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

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

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
...

有两种方法可以修复它。

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

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

1. 将新字段定义为可为空

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 .