File: quick-start.ru.rst

package info (click to toggle)
tarantool 2.6.0-1.2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 85,396 kB
  • sloc: ansic: 513,775; cpp: 69,493; sh: 25,650; python: 19,190; perl: 14,973; makefile: 4,176; yacc: 1,329; sql: 1,074; pascal: 620; ruby: 190; awk: 18; lisp: 7
file content (97 lines) | stat: -rw-r--r-- 3,185 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
Краткое руководство
===================

Подключение к серверу
---------------------

Создаем подключение к серверу::

    >>> import tarantool
    >>> server = tarantool.connect("localhost", 33013)


Создаем объект доступа к пространству
-------------------------------------

Экземпляр :class:`~tarantool.space.Space` - это именованный объект для доступа
к пространству ключей.

Создаем объект ``demo``, который будет использоваться для доступа к пространству ``0``::

    >>> demo = server.space(0)

Все последующие операции с пространством ``0`` выполняются при помощи методов объекта ``demo``.


Работа с данными
----------------

Select
^^^^^^

Извлечь одну запись с id ``'AAAA'`` из пространства ``demo``
по первичному ключу (нулевой индекс)::

    >>> demo.select('AAAA')

Извлечь несколько записей используя первичный индекс::

    >>> demo.select(['AAAA', 'BBBB', 'CCCC'])
    [('AAAA', 'Alpha'), ('BBBB', 'Bravo'), ('CCCC', 'Charlie')]


Insert
^^^^^^

Вставить кортеж ``('DDDD', 'Delta')`` в пространство ``demo``::

    >>> demo.insert(('DDDD', 'Delta'))

Первый элемент является первичным ключом для данного кортежа.


Update
^^^^^^

Обновить запись с id ``'DDDD'``, поместив значение ``'Denver'`` 
в поле ``1``::

    >>> demo.update('DDDD', [(1, '=', 'Denver')])
    [('DDDD', 'Denver')]

Для поиска записи :meth:`~tarantool.space.Space.update` всгеда использует
первичный индекс.
Номера полей начинаются с нуля.
Таким образом, поле ``0`` - это первый элемент кортежа. 


Delete
^^^^^^

Удалить одиночную запись с идентификатором ``'DDDD'``::

    >>> demo.delete('DDDD')
    [('DDDD', 'Denver')]

Для поиска записи :meth:`~tarantool.space.Space.delete` всгеда использует 
первичный индекс.


Вызов хранимых функций
----------------------

Для вызова хранимых функций можно использовать метод 
:meth:`Connection.call() <tarantool.connection.Connection.call()>`::

    >>> server.call("box.select_range", (0, 0, 2, 'AAAA'))
    [('AAAA', 'Alpha'), ('BBBB', 'Bravo')]

Тоже самое можно получить при помощи метода
:meth:`Space.call() <tarantool.space.Space.call()>`::

    >>> demo.call("box.select_range", (0, 0, 2, 'AAAA'))
    [('AAAA', 'Alpha'), ('BBBB', 'Bravo')]

Метод :meth:`Space.call() <tarantool.space.Space.call()>` - это просто
псевдоним для
:meth:`Connection.call() <tarantool.connection.Connection.call()>`