Rupy2012 ArangoDB Workshop Part1

ArangoDB & Ashikawa
Workshop

Frank Celler & Lucas Dohmen, triAGENS, Cologne
RuPy 2012, Brno
2012-11-16

www.arangodb.org (c) f.celler@triagens.de
Donnerstag, 15. November 12

Agenda
Brief Introduction to ArangoDB

Installing ArangoDB

CRUD Operations for Documents

ArangoDB Query Language

Using the Ruby Driver Ashikawa

Build a small Ruby example


multi-model NoSQL database and application
server

Basically, it's a document store...

...but also supports key / value access

... and provides functionality to store and analyse
document relations, making it a graph database,
too


arangod: the server, written in C++

arangosh: JavaScript shell

arangoimp: Import for JSON / CSV

Ashikawa: Ruby driver


Mac OS X

brew install arangodb installs stable 1.0.4
brew install --devel arangodb installs development 1.1.beta2
If this is your ﬁrst install, automatically load on login with:
mkdir -p ~/Library/LaunchAgents
cp /usr/local/Cellar/arangodb/1.0.4/homebrew.mxcl.arangodb.plist ~/Library/LaunchAgents/
launchctl load -w ~/Library/LaunchAgents/homebrew.mxcl.arangodb.plist

If this is an upgrade and you already have the homebrew.mxcl.arangodb.plist loaded:
launchctl unload -w ~/Library/LaunchAgents/homebrew.mxcl.arangodb.plist
cp /usr/local/Cellar/arangodb/1.0.4/homebrew.mxcl.arangodb.plist ~/Library/LaunchAgents/
launchctl load -w ~/Library/LaunchAgents/homebrew.mxcl.arangodb.plist

To start the ArangoDB server manually, run:
/usr/local/sbin/arangod

To start the ArangoDB shell, run:
arangosh


Download a Package
Use http://www.arangodb.org/download to download a package for

Centos

Debian

Ubuntu

SuSE

Mint

Mac OS X


From the Source
~> git clone -b 1.0 https://github.com/triAGENS/ArangoDB
Cloning into 'ArangoDB'...

~> ./build.sh
....
########################################################
arangod
########################################################

bin/arangod:
$Revision: READLINE 0x0402.hex $
$Revision: V8 3.9.4 $
$Revision: BASICS 1.0.4 (c) triAGENS GmbH $
$Revision: BOOST 1.48.0 $
$Revision: BASICS-C 1.0.4 (c) triAGENS GmbH $
$Revision: NCURSES ncurses $
$Revision: REST 1.0.4 (c) triAGENS GmbH $
$Revision: OPENSSL OpenSSL 0.9.8r 8 Feb 2011 $
$Revision: LIBEV 4.11 $

see http://www.arangodb.org/manuals/current/Compiling.html for details


Arango Shell
~> /usr/local/sbin/arangod &
~> /usr/local/bin/arangosh
_
__ _ _ __ __ _ _ __ __ _ ___ ___| |__
/ _` | '__/ _` | '_ / _` |/ _ / __| '_
| (_| | | | (_| | | | | (_| | (_) __ | | |
__,_|_| __,_|_| |_|__, |___/|___/_| |_|
|___/

Welcome to arangosh 1.0.4. Copyright (c) 2012 triAGENS GmbH.
Using Google V8 3.9.24 JavaScript engine.
Using READLINE 0x0402.hex.

Connected to Arango DB 127.0.0.1:8529 Version 1.0.4

------------------------------------- Help -------------------------------------
Predefined objects:
arango: ArangoConnection
db: ArangoDatabase
edges: ArangoEdges
Example:
> db._collections(); list all collections
> db.<coll_name>.all().toArray(); list all documents
> id = db.<coll_name>.save({ ... }); save a document
> db.<coll_name>.remove(<_id>); delete a document
> db.<coll_name>.document(<_id>); get a document
> help show help pages
> exit


First Steps
Create a collection (similar to a table)

arangosh> db._create("cars");
[ArangoCollection 2769319, "cars" (status loaded)]
arangosh> db.cars.toArray();
[ ]

Create a document in that collection

arangosh> db._create("cars");
[ArangoCollection 2769319, "cars" (status loaded)]
arangosh> db.cars.toArray();
[ ]

arangosh> db.cars.save({ manufacturer: "skoda", model: "superb", year: 2010 });
{ error : false, _id : "2769319/4407719", _rev : 4407719 }
arangosh> db.cars.document("2769319/4407719");
{ year : 2010, manufacturer : "skoda", model : "superb", _id : "2769319/4407719", _rev : 4407719 }


Web Interface
start at http://localhost:8529/


Create Read Update Delete

Create: octavia = db.cars.save({ model: “octavia“ });

Read: db.cars.document(octavia._id);

Update: db.cars.replace(octavia, { model: “fabia“ });

Delete: db.cars.remove(octavia._id);


List & Sub-Objects

arangosh> r = db.cars.save({ model: "yeti",
address: { city: "Cologne", street: "Trankgasse" },
drivers: [ "fceller", "lucas" ]});

arangosh> car = db.cars.document(r);
{
model : "yeti",
address : {
city : "Cologne",
street : "Trankgasse"
},
drivers : [
"fceller",
"lucas"
],
_id : "2769319/6504871",
_rev : 6504871
}


Import Data

~> curl "http:/ /www.arangodb.org/rupy2012/airports.csv" > airports.csv
~> head -2 airports.csv
"id","ident","type","name","latitude_deg","longitude_deg","elevation_ft","continent",...
6523,"00A","heliport","Total Rf Heliport",40.07080078125,-74.9336013793945,11,"NA",....

~> curl "http://www.arangodb.org/rupy2012/names_10000.json" > names_10000.json
~> head -2 names_10000.json
{"name":{"ﬁrst":"Caren","last":"Ferm"},"gender":"female","birthday":"1971-07-22","contact":{"address":{"street":"3
Wyoming Cir","zip":"08053","city":"Marlton","state":"NJ"},"email":["caren.ferm@nosql-matters.org","ferm@nosql-
matters.org","caren@nosql-matters.org"],"region":"856","phone":["856-5374929"]},"likes":
["boxing"],"memberSince":"2008-11-07"}
{"name":{"ﬁrst":"Jack","last":"Irias"},"gender":"male","birthday":"1967-02-20","contact":{"address":{"street":"7
Santa fe Way","zip":"19885","city":"Wilmington","state":"DE"},"email":["jack.irias@nosql-matters.org","irias@nosql-
matters.org","jack@nosql-matters.org"],"region":"302","phone":[]},"likes":
["snowboarding"],"memberSince":"2009-04-27"}


Import Data

~> /usr/local/bin/arangoimp --type json --collection users --create-collection true names_10000.json
----------------------------------------
collection : users
create : yes
reusing ids : no
file : names_10000.json
type : json
quote : "
separator : ,
connect timeout : 5
request timeout : 300
----------------------------------------
Starting JSON import...

created : 10000
errors : 0
total : 10000


Import Data

~> /usr/local/bin/arangoimp --type csv --collection airports --create-collection true airports.csv
----------------------------------------
collection : airports
create : yes
reusing ids : no
file : airports.csv
type : csv
quote : "
separator : ,
connect timeout : 5
request timeout : 300
----------------------------------------
Starting CSV import...

created : 43991
errors : 0
total : 43992


Query Data
Grep 5 users and return their names and ids
FOR u IN users
LIMIT 5
RETURN u

arangosh> a = db._createStatement(
{ query: "for u in users limit 5 return u" }).execute()
[object ArangoQueryCursor]

arangosh> a.next()
{ _id : "6570407/264716711", _rev : 264716711, gender : "male", birthday :
"1964-01-09", memberSince : "2008-09-18", name : { last : "Geving", first :
"Millard" }, contact : { region : "409", phone : ["409-0605391"], address : { zip :
"75941", city : "Diboll", state : "TX", street : "18 Woodlawn Loop" }, email :
["millard.geving@nosql-matters.org", "geving@nosql-matters.org", "millard@nosql-
matters.org"] }, likes : ["shopping", "skiing"] }


Query Data
Find out how many users live in each city

FOR u IN users
COLLECT city = u.contact.address.city INTO g
LIMIT 0,20
RETURN { "city" : city, "users" : length(g) }


Query Data
Find the 5 regions in state CA with the most inhabitants

FOR u IN users
FILTER u.contact.address.state == "CA"
COLLECT region = u.contact.region INTO group
SORT LENGTH(group) DESC
LIMIT 0, 5
RETURN { "region" : region, "count" : LENGTH(group) }


Query Data
Find the other top 5 hobbies of male users that also like running

FOR likes IN (
FOR u IN users
FILTER u.gender == "male" && "running" IN u.likes
FOR value IN u.likes
FILTER value != "running"
RETURN value
)
COLLECT what = likes INTO group
SORT LENGTH(group) DESC
LIMIT 0, 5
RETURN { "what" : what, "count" : LENGTH(group) }


Query Data
Find the 10 nearest larger airports around Cologne

FOR a IN NEAR(airports, 50.67, 6.9, 200, "distance")
FILTER a.type == "large_airport"
SORT a.distance ASC
LIMIT 0, 10
RETURN { "name" : a.name,
"code" : a.iata_code,
"country" : a.iso_country,
"city" : a.municipality,
"distance" : CONCAT(TO_STRING(CEIL(a.distance/1000)), ' km') }


Indexes
Create a Geo–Index

arangosh> db.airports.ensureGeoIndex('latitude_deg', 'longitude_deg');
{
id : "716390823/3631628711",
type : "geo2",
constraint : false,
fields : [
"latitude_deg",
"longitude_deg"
],
isNewlyCreated : true,
error : false,
code : 201
}


Thank You!

Stay in Touch:

Fork me on github

Google Group: ArangoDB

Twitter: @fceller & @arangodb

www.arangodb.org


Rupy2012 ArangoDB Workshop Part1

More Related Content

What's hot

Similar to Rupy2012 ArangoDB Workshop Part1

More from ArangoDB Database

Recently uploaded

Rupy2012 ArangoDB Workshop Part1