Сервис хранения
================

Используется для хранения и обработки данных.

Публичные методы
-----------------

get_metric
^^^^^^^^^^^

Метод, предназначенный для передачи метрик данной роли в систему сбора метрик.

*Возвращаемое значение:* Набор метрик в формате *JSON*.

prep_sql
^^^^^^^^^

Метод, предназначенный для генерации и кеширования *prepared statement* запроса.

*Параметры:*

* ``query`` -- SQL-код запроса.

execute_sql
^^^^^^^^^^^^

Метод, предназначенный для запуска SQL-запроса на инстансе.

*Параметры:*

* ``query`` -- SQL-код запроса;
* ``params`` -- биндинг-параметры запроса.

*Возвращаемое значение:*

* Для select-запроса:
  
  * *набор данных, nil* -- при успешном выполнении;
  * *false,error* -- при ошибке выполнения;

* Для остальных запросов:

  * *true, nil* -- при успешном выполнении;
  * *false,error* -- при ошибке выполнения.

set_schema_ddl
^^^^^^^^^^^^^^^

Метод, предназначенный для обновления ddl-схемы на данном *storage*. Данные берутся из конфига кластера.

*Возвращаемое значение:*

* *true, nil* -- при успешном выполнении;

* *false,error* -- при ошибке выполнения.


Приватные методы
-----------------

insert_tuples
^^^^^^^^^^^^^^

Метод, предназначенный для вставки туплов.

*Параметры:*

* ``tuples`` -- cписок пар ``space_name``/``by_space`` для вставки в спейсы.

*Возвращаемое значение:*

* *true, nil* -- при успешном выполнении;

* *false,error* -- при ошибке выполнения.


storage_drop_all
^^^^^^^^^^^^^^^^^

Метод, предназначенный для дропа всех спейсов.

*Возвращаемое значение:*

* *true* -- при успешном выполнении;

* *false,error* -- при ошибке выполнения.

storage_space_len
^^^^^^^^^^^^^^^^^^

Метод, предназначенный для расчета количества строк в спейсе.

*Параметры:*

* ``space_name`` -- имя спейса, для которого требуется вычислить количество строк.

*Возвращаемое значение:* Количество строк в спейсе.

get_storage_ddl
^^^^^^^^^^^^^^^^

Метод, предназначенный для получения схемы данных данного *storage*.

*Возвращаемое значение:* ddl-схема текущего *storage*.