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

В таблице ниже перечислены некоторые распространенные ошибки, которые могут возникать в Tarantool при различных проблемах. Полный список ошибок доступен в файле errcode.h.

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

1. Вызов функции с помощью pcall.

   Используйте механизмы Lua для обработки ошибок и исключений, в частности pcall. То есть, вместо вызова ...

    
   box.space.{space-name}:{function-name}()

   ... вызывайте функцию следующим образом:

    
   if pcall(box.space.{space-name}.{function-name}, box.space.{space-name}) ...

   Для некоторых функций box в Tarantool pcall также возвращает детали ошибки, включая имя файла и номер строки в исходном коде Tarantool. Это можно увидеть, распаковав результат, например:

    
   status, error = pcall(function() box.schema.space.create('') end)error:unpack()

   См. руководство Суммирование JSON-поля для всех кортежей, чтобы узнать, как pcall можно использовать в приложении.

2. Анализ ошибок и вызов новых ошибок с помощью box.error.

   Для создания новой ошибки и её передачи модуль box.error предоставляет box.error().

   Для получения последней ошибки подмодуль box.error предоставляет box.error.last(). Также существует способ получить текст последней ошибки операционной системы для определённых функций — errno.strerror([code]).

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

Фильтрация автоматически генерируемых сообщений выполняется с помощью конфигурационного параметра log.

Как правило, для встроенных функций Tarantool, предназначенных для возврата объектов: результатом является объект, nil или ошибка Lua. Например, рассмотрим программу fio_read.lua из руководства:

 
#!/usr/bin/env tarantoollocal 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())endlocal data = f:read(4096)f:close()print(data)

После вызова функции, который может завершиться неудачей, как в случае с fio.open() выше, часто встречается конструкция вида if not f then ... или if f == nil then ..., проверяющая типичные ошибки. Но если бы была допущена синтаксическая ошибка, например fio.opex вместо fio.open, то возникла бы ошибка Lua, и значение f не изменилось бы. Если бы проверка таких очевидных ошибок имела значение, программист, вероятно, использовал бы pcall().

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