CouchConf Israel 2013_Developing with CB I

567 views
497 views

Published on

0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
567
On SlideShare
0
From Embeds
0
Number of Embeds
161
Actions
Shares
0
Downloads
8
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

CouchConf Israel 2013_Developing with CB I

  1. 1. Getting Started withCouchbase App Development Matt Ingenthron Director, Developer Solutions @ingenthr 1
  2. 2. What we’ll talk about• Setup Development Environment• Intro to Document Databases• Intro to Couchbase Operations• Basic Document Modeling• Modeling Examples 2
  3. 3. Basics & Getting started 33
  4. 4. Couchbase is Faster, Scales and Simplifies App Servers Couchbase Server Cluster API Servers 4
  5. 5. Download & Install Couchbase • Downloads at couchbase.com/download• Linux: Ubuntu and Red Hat/CentOS– Packages for most common distributions. • dpkg -i , rpm -i, etc.• Mac– Download a .zip, open, drag to Applications• Windows– Download a setup.exe, double click• Provision via wizard in Web Console– Or provision via REST interface: operations folks to automate provisioning (i.e Chef, puppet, Rightscale rightscript) 5
  6. 6. Setup Smart Client SDK• High performance, official client libraries for Java, .NET, PHP, Ruby, C, Python – Community supported for Clojure, JRuby, Perl, Go, Erlang, Node.js• Head to couchbase.com/develop for SDKs – Client libraries – Getting Started guides – Tutorial with a sample application – A complete API reference 6
  7. 7. Client Setup: Getting Cluster Configuration Cluster Configuration Couchbase Client over REST { … "bucketCapabilities": [ "touch", "sync", "couchapi" ], http://myserver:8091/ "bucketCapabilitiesVer": "sync-1.0", "bucketType": ”couchbase", "name": "default", "nodeLocator": "vbucket", "nodes": [ …. 7
  8. 8. Client Setup: Getting Cluster Configuration Couchbase Client New Node Added to Cluster and Coming Online Couchbase Topology Update 8
  9. 9. Document Database Basics 99
  10. 10. The relational approach to model data Relational databases were not designed with clusters in mind, which is why people have cast around for an alternative. Storing aggregates as fundamental units makes a lot of sense for running on a cluster. http://martinfowler.com/bliki/AggregateOrientedDatabase.html 10
  11. 11. Compared to a Document Database o::1001 { uid: “ji22jd”, customer: “Ann”, line_items: [ { sku: 0321293533, quan: 3, unit_price: 48.0 }, { sku: 0321601912, quan: 1, unit_price: 39.0 }, { sku: 0131495054, quan: 1, unit_price: 51.0 } ], payment: { type: “Amex”, expiry: “04/2001”, last5: 12345 } • Easy to distribute data • Makes sense to application programmers 11
  12. 12. JSON Documents• Map more closely to external API• CRUD Operations, lightweight and implicit schema myDocument = { “fields” : [“with basic types”, 3.14159, true], “like” : “your favorite language.”, “status”: { “apis” : true, “databases” : “document” } }• Stored under a unique identifier key client.set(“mydocumentid”, myDocument); mySavedDocument = client.get(“mydocumentid”); 12
  13. 13. Object to JSON back to ObjectUser Object u::michael.nitschinger@couchbase.co m set()string uid {string firstname “uid”: 123456,string lastname “firstname”: “Michael”,int age “lastname”: “Nitschinger”, “age”: 24,array favorite_colors “favorite_colors”: [“blue”, “black”],string email “email”: “michael.nitschinger@cou…” }User Object u::michael.nitschinger@couchbase.co m get() string uid { string firstname “uid”: 123456, string lastname “firstname”: “Michael”, int age “lastname”: “Nitschinger”, “age”: 24, array favorite_colors “favorite_colors”: [“blue”, “black”], string email “email”: “michael.nitschinger@cou…” } 13
  14. 14. COUCHBASE API OPERATIONS 1414
  15. 15. The Most Common Mental Adjustment• In SQL we tend to want to avoid hitting the database as much as possible: – Costly, tying up connection pools and overloading db servers – Even with caching and indexing tricks, and massive improvements over the years, SQL still gets bogged down by complex joins and huge indexes• In Couchbase, get’s and set’s are so fast they are trivial, and not bottlenecks, this is hard for many people to accept at first 15
  16. 16. Couchbase Basic Operations• get (key) – Retrieve a document• set (key, value) – Store a document, overwrites if exists• add (key, value) – Store a document, error/exception if exists• replace (key, value) – Store a document, error/exception if doesn’t exist• cas (key, value, cas) – Compare and swap, mutate document only if it hasn’t changed while executing this operation 16
  17. 17. Couchbase Basic Operations (cont’d)Atomic Counters are a special structure in Couchbase, theyare executed in order and are Positive Integer Values•set (key, value) – Use set to initialize the counter • cb.set(“my_counter”, 1)•incr (key) – Increase an atomic counter value, default by 1 • cb.incr(“my_counter”) # now it’s 2•decr (key) – Decrease an atomic counter value, default by 1 • cb.decr(“my_counter”) # now it’s 1 17
  18. 18. INCR / DECR• Maintain a numerical counter• Good for shared counters with tons of increments• Example: game scores• Can INCR by any integer• Accessible as a JSON number in views• Well look at maintaining a leaderboard in the next session 18
  19. 19. Simple Example in Ruby# example.rb # user.rbrequire “./user.rb” require “rubygems” require “couchbase”u1 = User.new({ :email => “michael.nitschinger@c…”, class User :name => “Michael Nitschinger”, attr_accessor :name, :email, :title, :twitter :title => “Developer Advocate”, :twitter => “@daschl” def initialize(attr = {})}) attr.each do |name, value| setter = "#{name}=”u1.save next unless respond_to?(setter) send(setter, value) end end def save client = Couchbase.bucket client.set(@email.downcase, self.to_json) end end 19
  20. 20. Add Retrieval# example.rb # user.rbrequire “./user.rb” require “rubygems” require “couchbase”u1 = User.new({ :email => “michael.nitschinger@c…”, class User :name => “Michael Nitschinger”, attr_accessor :name, :email, :title, :twitter :title => “Developer Advocate”, :twitter => “@daschl”}) def initialize(attr = {}) ... endu1.save def save client = Couchbase.bucketu1 = User.find_by_email(“michael.nitschinger@c…”) client.set(@email.downcase, self.to_json)if u1 endputs “User Found!”puts u1.inspect def self.find_by_email(email)else client = Couchbase.bucketputs “User Not Registered!” doc = client.get(email.downcase)end return doc ? User.new(doc) : nil end end 20
  21. 21. Add Instance Variables# example.rb # user.rbrequire “./user.rb” require “rubygems” require “couchbase”u1 = User.find_by_email(“michael.nitschinger@c…”) class Userif u1 attr_accessor :name, :email, :title, :twitteru1.fb_id = “682829292”u1.fb_token = “f02jdjd020d8373730djd02” attr_accessor :fb_id, :fb_tokenu1.saveelse def initialize(attr = {}) ... end# create userend def save ... end def self.find_by_email(email) client = Couchbase.bucket doc = client.get(email.downcase) return doc ? User.new(doc) : nil end end 21
  22. 22. Distributed System Design: Concurrency Controls# actors.rbc = Couchbase.bucketc.set(“mydoc”, { :myvalue => nil } Actor 1 Actor 2doc1, flags, cas = c.get(“mydoc”, :extended => true)doc2, flags, cas = c.get(“mydoc”, Success CAS mismatch! :extended => true)# Couchbase Serverc.set (“mydoc”, { “myvalue”: true }, :cas => cas)# will fail because cas has changedc.set (“mydoc”, { “myvalue”: true }, :cas => cas) 22
  23. 23. Document Modeling 23 23
  24. 24. Basic Document Modeling • Are these separate object in the model layer? Q • Are these objects accessed together?When considering how to model data for a given application: • Think of a logical container for the data • Think of how data groups together 24
  25. 25. Document Design Options • One document that contains all related data – Data is de-normalized – Better performance and scale – Eliminate client-side joins • Separate documents for different object types with cross references – Data duplication is reduced – Objects may not be co-located – Transactions supported only on a document boundary – Most document databases do not support joins 25
  26. 26. Basic Document Design: Document ID / Key selection• Similar to primary keys in relational databases• Documents are sharded based on the document ID• ID based document lookup is extremely fast• ID-Key’s can only appear once in a bucket, unique • Do you have a unique way of referencing objects? Q • Are related objects stored in separate documents?Options• UUIDs, date-based IDs, numeric IDs• Hand-crafted (human readable)• Matching prefixes (for multiple related objects) 26
  27. 27. Example: Entities for a Blog • User profile • • Blog posts BLOG – Contain the posts themselves • Blog comments – Comments from other users • Option 1 - Keep it with Blog Document • Option 2 - Separate it Out 27
  28. 28. Blog Document – Option 1 – Single document {Blog Post Objectstring id “_id”: “daschl_Hello_World”,string author “author”: “daschl”,string type “type”: “post” “title”: “Hello World”,string title “format”: “markdown”,string format “body”: “Hello from [Couchbase](http://couchbase.com).”,string body “html”: “<p>Hello from <a href=“http: …,string htmlarray comments “comments”: [ [“format”: “markdown”, “body”:”Awesome post!”], [“format”: “plain”, “body”:”Like it.” ] ] } 28
  29. 29. Blog Document – Option 2 - Split into Multiple Docs {Blog Post Object “_id”: “daschl_Hello_World”,string id “author”: “daschl”, “type”: “post”string author “title”: “Hello World”,string type “format”: “markdown”,string title “body”: “Hello from [Couchbase](http://couchbase.com).”,string format “html”: “<p>Hello from <a href=“http: …”, “num_comments”: 2string body }string htmlint num_comments { “_id”: “daschl_Hello_World_1”, “format”: “markdown”,Comment Object “body”: “Awesome post!”string format } {string body “_id”: “daschl_Hello_World_2”,int id “format”: “plain”, “body”: “Love It!” } 29
  30. 30. Threaded Comments• You can imagine how to take this to a threaded list List First Reply to List comment comment Blog More CommentsAdvantages• Only fetch the data when you need it • For example, rendering part of a web page • Spread the data and load across the entire cluster 30
  31. 31. Q&A matt@couchbase.com @ingenthrhttp://blog.couchbase.com/matt

×