Основы CouchDB

CouchDB - документо-ориентированная СУБД, в которой удобно хранить разную информацию с изменяющимся количеством параметров. Например сущность товары могут иметь бесконечное количество параметров. Создавать в РСУБД миллионы таблиц или одну огромную не вариант. В couchdb хранятся документы, т.е. простые записи. В записи может быть сколько угодно разных параметров. А для унификации записей обычно создают параметр type который заменяет имя таблицы в РСУБД.




Установка:
debian

sudo apt-get install couchdb

from source

wget http://erlang.org/download/otp_src_R12B-5.tar.gz
tar -xvzf otp_src_R12B-5.tar.gz
cd otp_src_R12B-5
./configure
sudo make && make install

wget http://download.filehat.com/apache/incubator/couchdb/0.8.1-incubating/apache-couchdb-0.8.1-incubating.tar.gz
tar -xvzf apache-couchdb-0.8.1-incubating.tar.gz
cd apache-couchdb-0.8.1-incubating
./configure
sudo make && make install

MacOS, Android, iOS
http://www.couchbase.com/downloads
CouchDB можно установить на смартфон, причем он может работать как автономно, так и в режиме репликации когда появляется связь с основной базой.

Futon:

Futon это веб интерфейс для управления CouchDB, что то типа phpmyadmin. После запуска CouchDB появится доступ к Futon по http://127.0.0.1:5984/. Для того что бы увидеть инструменты Futon нужно перейти на http://127.0.0.1:5984/_utils/

Couchdb Futon

Все манипуляции с базой происходят через http при помощи REST интерфейса. Поэтому можно пользоваться как браузером, так и curl или например модулем url в python. Futon использует для запросов плагин на jQuery. Посмотреть его можно здесь: http://127.0.0.1:5984/_utils/script/jquery.couch.js

Пользователи:
По умолчанию к CouchDB открыт доступ всем, но его можно ограничить нажав на "Welcome to Admin Party! Everyone is admin. Fix this" в нижнем правом углу.

Создание документа:
Вначале создадим базу(тоже кстати документ), нажимаем "Create Database..." и вводим название, дальше нажимаем "New document" и заводим значения

CouchDB создание документа

Для сохранения нажимаем "Save document". Как видно можно вводить русские названия параметров. Поле _id формируется автоматически при создании. Поле _rev формируется автоматически при каждом изменении, первая цифра означает количество изменений. _rev используется для внутренних служб системы при репликации.

 Создание документа с помощью cURL:
Данные в CouchDB обрабатываются в формате JSON. Создадим документ giant.json

{
    "manufacture": "Giant",
    "model":  "REVEL 2",
    "цвет": "синий",
    "цена": 16000,
    "type": "bike"
}

Для вставки этого документа введем в консоле

curl -X POST http://127.0.0.1:5984/test/ -d @giant.json -H "Content-Type: application/json"

В базе появится документ типа

{"ok":true,"id":"08601f0b9d3574a116ee390bf0000f44","rev":"1-67d8f0ad3100d85952dbb17ba68b08eb"}

Принятые правила в REST
POST – создать новую запись
GET – получить значения
PUT – обновить записи
DELETE – удалить

Выбрать все записи
В CouchDB есть view которые по определенным условиям фильтруют данные. Выбор всех данных это стандартная view _all_docs.

curl -X GET http://127.0.0.1:5984/mycouchshop/_all_docs

Получим

{"total_rows":2,"offset":0,"rows":[
{"id":"08601f0b9d3574a116ee390bf0000f44","key":"08601f0b9d3574a116ee390bf0000f44","value":{"rev":"1-67d8f0ad3100d85952dbb17ba68b08eb"}},
{"id":"2f6904cbb5d279fbdbb9e9eef40015ec","key":"2f6904cbb5d279fbdbb9e9eef40015ec","value":{"rev":"3-6d0577a0a515178f0cd939b5caa19572"}}
]}

Создание представлений

Представления работают по принципу map/reduce
map - это выбор и фильтрация документов
reduce - это последующая обработка данных

Простая map функция

function (doc) {  
        if (doc.type === "bike" && doc.manufacture) {  
            emit(doc.manufacture, doc);  
        }  
    }  

Функции создаются в правом верхнем углу в Temporary View

Сохраним view по нажатию "Save As..."

Вызовем из консоли

curl -X GET http://127.0.0.1:5984/test/_design/product/_view/bike

результат

{"total_rows":1,"offset":0,"rows":[
{"id":"08601f0b9d3574a116ee390bf0000f44","key":"Giant","value":{"_id":"08601f0b9d3574a116ee390bf0000f44","_rev":"1-67d8f0ad3100d85952dbb17ba68b08eb","manufacture":"Giant","model":"REVEL 2","\u0446\u0432\u0435\u0442":"\u0441\u0438\u043d\u0438\u0439","\u0446\u0435\u043d\u0430":"16000","type":"bike"}}
]}

Reduce функции
Map функция

function (doc) {  
        if (doc.type === "bike" && doc.цена) {  
            emit(doc._id, doc.цена);  
        }  
    }  

Получим

{"total_rows":2,"offset":0,"rows":[
{"id":"08601f0b9d3574a116ee390bf0000f44","key":"08601f0b9d3574a116ee390bf0000f44","value":12000},
{"id":"08601f0b9d3574a116ee390bf0001130","key":"08601f0b9d3574a116ee390bf0001130","value":16000}
]}

Reduce функция

function(keys, prices) {  
    return sum(prices);  
}

Получаем сумму

{"rows":[
{"key":null,"value":28000}
]}

В заключение можно сказать что NoSQL в виде CouchDB мне показался очень простым и удобным механизмом.

Для дополнительного чтения:
http://net.tutsplus.com/tutorials/getting-started-with-couchdb/