1Краткое руководство
2===================
3
4Подключение к серверу
5---------------------
6
7Создаем подключение к серверу::
8
9    >>> import tarantool
10    >>> server = tarantool.connect("localhost", 33013)
11
12
13Создаем объект доступа к пространству
14-------------------------------------
15
16Экземпляр :class:`~tarantool.space.Space` - это именованный объект для доступа
17к пространству ключей.
18
19Создаем объект ``demo``, который будет использоваться для доступа к пространству ``0``::
20
21    >>> demo = server.space(0)
22
23Все последующие операции с пространством ``0`` выполняются при помощи методов объекта ``demo``.
24
25
26Работа с данными
27----------------
28
29Select
30^^^^^^
31
32Извлечь одну запись с id ``'AAAA'`` из пространства ``demo``
33по первичному ключу (нулевой индекс)::
34
35    >>> demo.select('AAAA')
36
37Извлечь несколько записей используя первичный индекс::
38
39    >>> demo.select(['AAAA', 'BBBB', 'CCCC'])
40    [('AAAA', 'Alpha'), ('BBBB', 'Bravo'), ('CCCC', 'Charlie')]
41
42
43Insert
44^^^^^^
45
46Вставить кортеж ``('DDDD', 'Delta')`` в пространство ``demo``::
47
48    >>> demo.insert(('DDDD', 'Delta'))
49
50Первый элемент является первичным ключом для данного кортежа.
51
52
53Update
54^^^^^^
55
56Обновить запись с id ``'DDDD'``, поместив значение ``'Denver'``
57в поле ``1``::
58
59    >>> demo.update('DDDD', [(1, '=', 'Denver')])
60    [('DDDD', 'Denver')]
61
62Для поиска записи :meth:`~tarantool.space.Space.update` всгеда использует
63первичный индекс.
64Номера полей начинаются с нуля.
65Таким образом, поле ``0`` - это первый элемент кортежа.
66
67
68Delete
69^^^^^^
70
71Удалить одиночную запись с идентификатором ``'DDDD'``::
72
73    >>> demo.delete('DDDD')
74    [('DDDD', 'Denver')]
75
76Для поиска записи :meth:`~tarantool.space.Space.delete` всгеда использует
77первичный индекс.
78
79
80Вызов хранимых функций
81----------------------
82
83Для вызова хранимых функций можно использовать метод
84:meth:`Connection.call() <tarantool.connection.Connection.call()>`::
85
86    >>> server.call("box.select_range", (0, 0, 2, 'AAAA'))
87    [('AAAA', 'Alpha'), ('BBBB', 'Bravo')]
88
89Тоже самое можно получить при помощи метода
90:meth:`Space.call() <tarantool.space.Space.call()>`::
91
92    >>> demo.call("box.select_range", (0, 0, 2, 'AAAA'))
93    [('AAAA', 'Alpha'), ('BBBB', 'Bravo')]
94
95Метод :meth:`Space.call() <tarantool.space.Space.call()>` - это просто
96псевдоним для
97:meth:`Connection.call() <tarantool.connection.Connection.call()>`
98