Работа с данными SQL¶

В данном разделе приведены примеры команд для работы с данными в Picodata с помощью команд языка SQL.

Создание таблицы¶

Для создания таблицы в Picodata следует сначала подключиться к интерактивной консоли инстанса.

Пользователям доступны функции для работы как с глобальными, так и шардированными таблицами (в последнем случае реализованы возможности распределенного SQL).

Для примера создадим шаблон списка друзей Свинки Пеппы, котором будет два поля: идентификатор записи и имя друга:

CREATE TABLE friends_of_peppa (
            id INTEGER NOT NULL,
            name TEXT NOT NULL,
            PRIMARY KEY (id))
USING memtx DISTRIBUTED BY (id)
OPTION (TIMEOUT = 3.0);

Помимо двух колонок, в примере указаны:

первичный ключ таблицы (колонка id);
движок хранения данных in-memory (memtx);
тип таблицы (шардированный, distributed by);
ключ шардирования таблицы (колонка id);
таймаут перед возвращением управления пользователю.

Для того чтобы создать такую же, но глобальную таблицу, следует указать соответствующий тип:

CREATE TABLE friends_of_peppa (
            id INTEGER NOT NULL,
            name TEXT NOT NULL,
            PRIMARY KEY (id))
USING memtx DISTRIBUTED GLOBALLY
OPTION (TIMEOUT = 3.0);

Подробнее о типах таблиц см. в глоссарии.

Запись данных в таблицу¶

Запись данных, т.е. вставка строк, в таблицу происходит с помощью команды INSERT в SQL-запросе. В данный момент поддерживается запись только в шардированные таблицы. Можно использовать обычный запрос с прямой передачей значений:

INSERT INTO friends_of_peppa (id, name) VALUES (1, 'Suzy');

Либо параметризированный запрос, но в Lua-режиме (\s l lua):

pico.sql(
    [[INSERT INTO friends_of_peppa (id, name) VALUES (?, ?)]],
    {1, 'Suzy'}
);

См. подробнее о различиях в INSERT-запросах.

Чтение данных из таблицы¶

Для чтения всех данных из таблицы подойдёт команда:

SELECT * FROM friends_of_peppa;

Можно вывести отдельно строку по известному полю:

SELECT * FROM friends_of_peppa WHERE id = 1;

См. подробнее о вариантах чтения данных в SQL.

Удаление данных¶

Удаление строки с известным id:

DELETE FROM friends_of_peppa WHERE id = 1;

В консоли будет выведено количество удаленных строк (в данном случае, это 1).

Приведенный выше пример поможет сделать первые шаги в работе с данными в Picodata. Подробнее о внутренней архитектуре кластера Picodata см. в разделе Жизненный цикл инстанса.

Параметры запуска из командной строки описаны в разделе Аргументы командной строки Picodata.