Коды ошибок базы данных

The table below lists some popular errors that can be raised by Tarantool in case of various issues. You can find a complete list of errors in the errcode.h file.

Примечание

The box.error module provides the ability to get the information about the last error raised by Tarantool or raise custom errors manually.

Code	box.error value	Description
ER_NONMASTER	box.error.NONMASTER	(Репликация) Экземпляр сервера не может вносить изменения в данные, если он не является мастером.
ER_ILLEGAL_PARAMS	box.error.ILLEGAL_PARAMS	Недопустимые параметры. Некорректное протокольное сообщение.
ER_MEMORY_ISSUE	box.error.MEMORY_ISSUE	Нехватка оперативной памяти: достижение предела памяти memtx_memory.
ER_WAL_IO	box.error.WAL_IO	Failed to write to disk. May mean: failed to record a change in the write-ahead log.
ER_READONLY	box.error.READONLY	Can’t modify data on a read-only instance.
ER_KEY_PART_COUNT	box.error.KEY_PART_COUNT	Key part count is not the same as index part count.
ER_NO_SUCH_SPACE	box.error.NO_SUCH_SPACE	Указанный спейс отсутствует.
ER_NO_SUCH_INDEX	box.error.NO_SUCH_INDEX	Указанного индекса нет в указанном спейсе.
ER_PROC_LUA	box.error.PROC_LUA	Возникла ошибке в Lua-процедуре.
ER_FIBER_STACK	box.error.FIBER_STACK	При создании нового файбера был достигнут предел рекурсии. Обычно это указывает на то, что хранимая процедура слишком часто рекурсивно вызывает себя.
ER_UPDATE_FIELD	box.error.UPDATE_FIELD	Возникла ошибка во время обновления поля.
ER_TUPLE_FOUND	box.error.TUPLE_FOUND	В уникальном индексе есть повторяющийся ключ.

Обработка ошибок

Ниже представлены несколько процедур для более надежного вызова Lua-функций в случае ошибок, в частности, ошибок базы данных.

Invoke a function using pcall.

Take advantage of Lua’s mechanisms for Error handling and exceptions, particularly pcall. That is, instead of invoking with …
```
box.space.{space-name}:{function-name}()
```
… call the function as follows:
```
if pcall(box.space.{space-name}.{function-name}, box.space.{space-name}) ...
```
For some Tarantool box functions, pcall also returns error details, including a file-name and line-number within Tarantool’s source code. This can be seen by unpacking, for example:
```
status, error = pcall(function() box.schema.space.create('') end)
error:unpack()
```
See the tutorial Sum a JSON field for all tuples to see how pcall can fit in an application.
Examine errors and raise new errors using box.error.

To make a new error and pass it on, the box.error module provides box.error().

To find the last error, the box.error submodule provides box.error.last(). There is also a way to find the text of the last operating-system error for certain functions – errno.strerror([code]).
Запись в журнал.

Записывайте сообщения в журнал с помощью модуля log.

Filter automatically generated messages using the log configuration parameter.

Generally, for Tarantool built-in functions which are designed to return objects: the result is an object, or nil, or a Lua error. For example consider the fio_read.lua program in a cookbook:

#!/usr/bin/env tarantool

local fio = require('fio')
local errno = require('errno')
local f = fio.open('/tmp/xxxx.txt', {'O_RDONLY' })
if not f then
    error("Failed to open file: "..errno.strerror())
end
local data = f:read(4096)
f:close()
print(data)

After a function call that might fail, like fio.open() above, it is common to see syntax like if not f then ... or if f == nil then ..., which check for common failures. But if there had been a syntax error, for example fio.opex instead of fio.open, then there would have been a Lua error and f would not have been changed. If checking for such an obvious error had been a concern, the programmer would probably have used pcall().

Все функции в модулях Tarantool должны работать таким образом, если в руководстве явно не говорится об обратном.

Версия:

Коды ошибок базы данных

Обработка ошибок