Uma Breve Introdução ao MongoDB

1. Eduardo Nicola F. Zagari

2. Sumário <ul><li>MongoDB </li></ul><ul><ul><li>Característica </li></ul></ul><ul><ul><li>Instalação </li></ul></ul><ul><ul><li>Mapeamento SQL  MongoDB </li></ul></ul><ul><ul><li>Conexão com Banco via shell </li></ul></ul><ul><ul><li>Schema Dinâmico </li></ul></ul><ul><ul><li>Inserção de dados </li></ul></ul><ul><ul><li>Interando sobre a coleção </li></ul></ul><ul><ul><li>Sintaxe </li></ul></ul>

3. Sumário <ul><li>MongoDB Ruby Driver </li></ul><ul><ul><li>Instalação </li></ul></ul><ul><ul><li>Conexão com banco </li></ul></ul><ul><ul><li>Listagem de bases e coleções </li></ul></ul><ul><ul><li>Criação/acesso de coleções </li></ul></ul><ul><ul><li>Inserção de documentos </li></ul></ul><ul><ul><li>Atualização de documentos </li></ul></ul><ul><ul><li>Busca </li></ul></ul><ul><ul><li>Índices </li></ul></ul>

4. Sumário <ul><li>Mongoid </li></ul><ul><ul><li>Instalação </li></ul></ul><ul><ul><li>Documentos </li></ul></ul><ul><ul><li>Persistência </li></ul></ul><ul><ul><li>Querying </li></ul></ul><ul><ul><li>Relations </li></ul></ul>

5. Características <ul><li>Armazenamento Orientado a Documentos </li></ul><ul><li>Suporte full-index </li></ul><ul><li>Replicação e Alta disponibilidade </li></ul><ul><li>Auto sharding </li></ul><ul><li>Querying </li></ul><ul><li>Atualizações rápidas in-place </li></ul><ul><li>Map/Reduce </li></ul><ul><li>GridFS </li></ul>

6. Instalando MongoDB <ul><li>Download </li></ul><ul><li>Crie o diretório de dados </li></ul>$ curl http://downloads.mongodb.org/osx/mongodb-osx-i386-x.y.z.tgz > mongo.tgz $ tar xzf mongo.tgz $ sudo mkdir –p /data/db $ sudo chmod 777 /data/db

7. Instalação MongoDB <ul><li>Inicie o servidor e se conecte a ele </li></ul><ul><li>Em uma shell </li></ul><ul><li>Em outra shell </li></ul>$ ./mongodb-XXXXXXX /bin/mongod <ul><li>$ ./mongodb-XXXXXXX /bin/mongo </li></ul><ul><li>db.foo.save( { a : 1 } ) </li></ul><ul><li>{ "_id" : ObjectId("4e46f2141373c8f77f7ee954"), "a" : 1 } </li></ul>

8. Mapeamento SQL  MongoDB

9. Conexão com Banco via shell <ul><li>Inicie a shell do MongoDB </li></ul><ul><li>Para trocar de base, tecle </li></ul>$ /Applications/mongodb-osx-x86_64-1.8.2/bin/mongo MongoDB shell version: 1.8.2 connecting to: test > use mydb switched to db mydb > show dbs admin (empty) local (empty) test 0.203125GB

10. Schema Dinâmico (Schema Free) <ul><li>MongoDB possui databases, collections e índices </li></ul><ul><li>Collections contêm documentos BSON </li></ul><ul><li>Documentos BSON possuem campos </li></ul><ul><ul><li>Sem pré-definição </li></ul></ul><ul><ul><li>Sem schemas </li></ul></ul><ul><ul><li>Não há a noção de “ALTER table” </li></ul></ul><ul><ul><li>Na prática, é comum uma coleção possuir estrutura de documentos homogênea, no entanto, isto não é um requisito </li></ul></ul>

11. Inserção de Dados > j = { name : "mongo" }; {"name" : "mongo"} > t = { x : 3 }; { "x" : 3 } > db.things.save(j); > db.things.save(t); > db.things.find(); { "_id" : ObjectId(" 4e47fae21373c8f77f7ee955 "), "name" : "mongo" } { "_id" : ObjectId(" 4e47faeb1373c8f77f7ee956 "), "x" : 3 } <ul><li>Sem pré-definição do collection </li></ul><ul><li>Lazy initialization </li></ul><ul><li>Docs com camps distintos </li></ul><ul><li>Atribuição do campo “_id </li></ul>

12. Inserção de mais dados > for (var i = 1; i <= 20; i++) db.things.save({x : 4, j : i}); > db.things.find() { "_id" : ObjectId("4e47fae21373c8f77f7ee955"), "name" : "mongo" } { "_id" : ObjectId("4e47faeb1373c8f77f7ee956"), "x" : 3 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee957"), "x" : 4, "j" : 1 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee958"), "x" : 4, "j" : 2 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee959"), "x" : 4, "j" : 3 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee95a"), "x" : 4, "j" : 4 } … { "_id" : ObjectId("4e47fcb41373c8f77f7ee963"), "x" : 4, "j" : 13 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee964"), "x" : 4, "j" : 14 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee965"), "x" : 4, "j" : 15 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee966"), "x" : 4, "j" : 16 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee967"), "x" : 4, "j" : 17 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee968"), "x" : 4, "j" : 18 } has more

13. O Comando “it” (iterador) … { "_id" : ObjectId("4e47fcb41373c8f77f7ee967"), "x" : 4, "j" : 17 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee968"), "x" : 4, "j" : 18 } has more > it { "_id" : ObjectId("4e47fcb41373c8f77f7ee969"), "x" : 4, "j" : 19 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee96a"), "x" : 4, "j" : 20 }

14. Acessando dados a partir de uma Query (objeto “cursor”) > var cur = db.things.find() > while (cur.hasNext()) printjson(cur.next()); { "_id" : ObjectId("4e47fae21373c8f77f7ee955"), "name" : "mongo" } { "_id" : ObjectId("4e47faeb1373c8f77f7ee956"), "x" : 3 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee957"), "x" : 4, "j" : 1 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee958"), "x" : 4, "j" : 2 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee959"), "x" : 4, "j" : 3 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee95a"), "x" : 4, "j" : 4 } … { "_id" : ObjectId("4e47fcb41373c8f77f7ee965"), "x" : 4, "j" : 15 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee966"), "x" : 4, "j" : 16 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee967"), "x" : 4, "j" : 17 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee968"), "x" : 4, "j" : 18 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee969"), "x" : 4, "j" : 19 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee96a"), "x" : 4, "j" : 20 }

15. forEach() ao invés de while() > db.things.find().forEach(printjson); { "_id" : ObjectId("4e47fae21373c8f77f7ee955"), "name" : "mongo" } { "_id" : ObjectId("4e47faeb1373c8f77f7ee956"), "x" : 3 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee957"), "x" : 4, "j" : 1 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee958"), "x" : 4, "j" : 2 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee959"), "x" : 4, "j" : 3 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee95a"), "x" : 4, "j" : 4 } … { "_id" : ObjectId("4e47fcb41373c8f77f7ee965"), "x" : 4, "j" : 15 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee966"), "x" : 4, "j" : 16 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee967"), "x" : 4, "j" : 17 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee968"), "x" : 4, "j" : 18 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee969"), "x" : 4, "j" : 19 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee96a"), "x" : 4, "j" : 20 }

16. Tratando cursor no estilo array <ul><li>Nota: documentos até o mais alto acessado(quinto documento, no nosso caso) são todos carregados em RAM ao mesmo tempo </li></ul><ul><ul><li>Não apropriado para grandes coleções </li></ul></ul>> var cur = db.things.find(); > printjson(cur[4]); { "_id" : ObjectId("4e47fcb41373c8f77f7ee959"), "x" : 4, "j" : 3 }

17. Convertendo cursor em array <ul><li>Nota: cursores não são fotografias “ instantâneas ” </li></ul><ul><li>Operações feitas na coleção por usuários distintos concorrentemente podem ou não serem retornadas pelo cursor </li></ul><ul><li>Deve-se usar bloqueios para consultas instantâneas </li></ul>> var arr = db.things.find().toArray(); > arr[5]; { "_id" : ObjectId("4e47fcb41373c8f77f7ee95a"), "x" : 4, "j" : 4 }

18. Especificando retorno de Queries <ul><li>Query documents: </li></ul><ul><li>{a:A, b:B, …} significa “WHERE a==A AND b=BB AND …” </li></ul>> db.things.find( {name:"mongo"} ).forEach(printjson); { "_id" : ObjectId("4e47fae21373c8f77f7ee955"), "name" : "mongo" }

19. Especificando retorno de Queries > db.things.find( {x:4} ).forEach(printjson); { "_id" : ObjectId("4e47fcb41373c8f77f7ee957"), "x" : 4, "j" : 1 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee958"), "x" : 4, "j" : 2 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee959"), "x" : 4, "j" : 3 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee95a"), "x" : 4, "j" : 4 } … { "_id" : ObjectId("4e47fcb41373c8f77f7ee965"), "x" : 4, "j" : 15 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee966"), "x" : 4, "j" : 16 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee967"), "x" : 4, "j" : 17 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee968"), "x" : 4, "j" : 18 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee969"), "x" : 4, "j" : 19 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee96a"), "x" : 4, "j" : 20 }

20. Especificando retorno de Queries > db.things.find( {x:4} , {j:true} ).forEach(printjson); { "_id" : ObjectId("4e47fcb41373c8f77f7ee957"), "j" : 1 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee958"), "j" : 2 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee959"), "j" : 3 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee95a"), "j" : 4 } … { "_id" : ObjectId("4e47fcb41373c8f77f7ee965"), "j" : 15 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee966"), "j" : 16 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee967"), "j" : 17 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee968"), "j" : 18 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee969"), "j" : 19 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee96a"), "j" : 20 } Partial Documents

21. findOne( ) – Syntactic Sugar <ul><li>Documentos podem ser obtidos </li></ul><ul><ul><li>invocando-se next() sobre um cursor </li></ul></ul><ul><ul><li>Tratando o cursor como um array </li></ul></ul><ul><ul><li>Convertendo cursor em array etc </li></ul></ul><ul><ul><li>findOne() : Açúcar Sintático </li></ul></ul>> printjson(db.things. findOne({j:4}) ); { "_id" : ObjectId("4e47fcb41373c8f77f7ee95a"), "x" : 4, "j" : 4 }

22. limit( ): limitando o retorno > db.things.find(). limit(3) ; { "_id" : ObjectId("4e47fae21373c8f77f7ee955"), "name" : "mongo" } { "_id" : ObjectId("4e47faeb1373c8f77f7ee956"), "x" : 3 } { "_id" : ObjectId("4e47fcb41373c8f77f7ee957"), "x" : 4, "j" : 1 }

23. Sintaxe

24. Sintaxe

25. Sintaxe

26. Sintaxe

27. Sintaxe

28. MongoDB Ruby Driver <ul><li>Escrito em Ruby </li></ul><ul><li>Com uma extensão em C para velocidade </li></ul><ul><li>Otimizado à simplicidade </li></ul><ul><li>Pode ser usado sozinho, além servir de base para várias bibliotecas de mapeamento de objetos </li></ul>

29. Instalação <ul><li>Para garantir a última versão do rubygems </li></ul><ul><li>Para instalar a gem do mongo </li></ul><ul><li>Para otimização de performance, instala-se também a gem bson_ext </li></ul>$ gem update --system $ gem install mongo $ gem install bson_ext

30. Iniciando… <ul><li>Usando a gem </li></ul><ul><li>Criando uma conexão </li></ul>require 'rubygems' # not necessary for Ruby 1.9 require 'mongo' db = Mongo::Connection.new.db("mydb") db = Mongo::Connection.new("localhost").db("mydb") db = Mongo::Connection.new("localhost", 27017).db("mydb”)

31. Iniciando… <ul><li>Listando todas as bases </li></ul><ul><li>Removendo uma base </li></ul>connection = Mongo::Connection.new # (optional host/port args) connection.database_names.each { |name| puts name } connection.database_info.each { |info| puts info.inspect} connection.drop_database('database_name’)

32. Iniciando <ul><li>Listagem de coleções </li></ul><ul><li>Acessando uma coleção </li></ul><ul><li>Que é um alias para o método [ ] </li></ul>db.collection_names.each { |name| puts name } coll = db.collection("topicos") coll = db[”topicos"]

33. Inserção de documentos { "name" : "MongoDB", "type" : "database", "faculdade" : "Fecomp" "count" : 1, "info" : { x : 203, y : 102 } } doc = {"name" => "MongoDB", "type" => "database", "count" => 1, "faculdade" => "FECOMP", "info" => {"x" => 203, "y" => 102} } coll.insert(doc)

34. Atualização de documentos <ul><li>Reescrevendo o documento </li></ul><ul><li>Usando um operador atômico para mudar um valor único </li></ul><ul><li>asaa </li></ul>coll.update({"_id" => doc[:_id]}, {"$set" => {"name" => "MongoDB Ruby"}}) doc["name"] = "MongoDB Ruby" coll.update({"_id" => doc[:_id]}, doc)

35. Busca <ul><li>Encontrando o primeiro documento </li></ul><ul><li>asaa </li></ul>=> {"_id"=>BSON::ObjectId('4e78d41bed686f02d1000001'), "name"=>"MongoDB", "faculdade" : "Fecomp”, "info"=>{"x"=>203, "y"=>102}, "count"=>1, "type"=>"database”} my_doc = coll.find_one() puts my_doc.inspect

36. Adicionando mais documentos <ul><li>Contando documentos </li></ul>{ "i" : value } 100.times { |i| coll.insert("i" => i) } puts coll.count()

37. Busca <ul><li>Usando um Cursor para obter todos os documentos </li></ul><ul><li>asaa </li></ul>coll.find().each { |row| puts row.inspect }

38. Busca com Queries <ul><li>Obtendo um único documento com queries </li></ul><ul><li>Obtendo um conjunto de documentos </li></ul><ul><li>asaa </li></ul>coll.find("i" => 71).each { |row| puts row.inspect } coll.find("i" => {"$gt" => 50}).each { |row| puts row.inspect } coll.find("i" => {"$gt" => 20, "$lte" => 30}).each { |row| puts row.inspect }

39. Busca com Queries <ul><li>Queries com Expressões Regulares </li></ul><ul><li>Dinamicamente </li></ul><ul><li>asaa </li></ul>coll.find("name" => /^M/).each { |row| puts row.inspect } search_string = params['search'] #Constructor Syntax coll.find({"name" => Regexp.new(search_string)}) # Literal syntax coll.find({"name" => /#{search_string}/})

40. Índices <ul><li>Criando índices </li></ul><ul><li>Explicit ”descending" </li></ul><ul><li>asaa </li></ul>coll.create_index("i") coll.create_index([["i", Mongo::DESCENDING]])

41. Índices <ul><li>Criando índice geo-espacial </li></ul><ul><li>Query com limites </li></ul><ul><li>Obtendo a lista de índices de uma coleção </li></ul>people.create_index([["loc", Mongo::GEO2D]]) people.find({"loc" => {"$near" => [50, 50]}}, {:limit => 20}).each do |p| puts p.inspect end coll.index_information()

42. Mongoid <ul><li>Object-Document-Mapper (ODM) para MongoDB </li></ul><ul><li>Escrito em Ruby </li></ul><ul><li>Provém uma API familiar aos desenvolvedores Ruby acostumados com Active Record, enquanto alavanca o poder da ausência de schema do MongoDB </li></ul>

43. Instalação <ul><li>Para instalar a gem do mongoid </li></ul><ul><li>Arquivo de configuração mongoid.yml </li></ul><ul><li>Por programação </li></ul>$ gem install mongoid host: localhost database: mydb Mongoid.load!("path/to/your/mongoid.yml") Mongoid.configure do |config| config.master = Mongo::Connection.new.db(”mydb") end

44. Documentos <ul><li>Objetos devem incluir Mongoid::Document a fim de serem persistidos </li></ul><ul><li>Armazenamento </li></ul>class Person include Mongoid::Document end class Person include Mongoid::Document store_in :citizens end

45. Campos <ul><li>Outros tipos: Array, BigDecimal, Boolean, Date, DateTime, Float, Hash, Integer, Range, Symbol e Time </li></ul>class Person include Mongoid::Document store_in :citizens field :first_name, type: String field :middle_name, type: String field :last_name, type: String end

46. Campos: get e set <ul><li>Obtém o valor do campo first_name </li></ul><ul><li>Atribui o valor para o campo first_name </li></ul>person.first_name person[:first_name] person.read_attribute(:first_name) person.first_name = ”José" person[:first_name] = ”José" person.write_attribute(:first_name, ”José")

47. Campos: get e set para vários campos <ul><li>Obtém os valores dos campos em um hash </li></ul><ul><li>Atribui os valores de campos em um documento </li></ul>person.attributes Person.new(first_name: "Jean-Baptiste", middle_name: "Emmanuel") person.attributes = { first_name: "Jean-Baptiste", middle_name: "Emmanuel" } person.write_attributes( first_name: "Jean-Baptiste", middle_name: "Emmanuel" )

48. Defaults class Person include Mongoid::Document field :blood_alcohol_level, type: Float, default: 0.40 field :last_drink, type: Time, default: -> { 10.minutes.ago } end

49. Serialização de Campos customizados class Profile include Mongoid::Document field :location, type: Point end class Point include Mongoid::Fields::Serializable def deserialize(object) [ object["x"], object["y"] ] end def serialize(object) { "x" => object[0], "y" => object[1] } end end

50. Campos Dinâmicos <ul><li>Suporte a Campos dinâmicos </li></ul><ul><ul><li>Permite get, set e persistência de atributos mesmo que um campo não tenha sido definido para ele </li></ul></ul><ul><ul><li>Não usar getters e setters </li></ul></ul><ul><ul><li>Usar os métodos acessores: </li></ul></ul>person[:gender] person.read_attribute(:gender) person[:gender] = "Male" person.write_attribute(:gender, "Male")

51. Acesso: Protected class User include Mongoid::Document field :first_name, type: String field :password, type: String attr_protected :password end # Ajusta atributos em uma pessoa de forma apropriada Person.new(first_name: "Corbin") person.attributes = { first_name: "Corbin" } person.write_attributes(first_name: "Corbin") # Tenta ajudar os valores, levantando um erro Person.new(first_name: "Corbin", password: "password") person.attributes = { first_name: "Corbin", password: "password" } person.write_attributes(first_name: "Corbin", password: "password")

52. Acesso: Accessible class User include Mongoid::Document field :first_name, type: String field :password, type: String attr_accessible :first_name end # Ajusta atributos em uma pessoa de forma apropriada Person.new(first_name: "Corbin") person.attributes = { first_name: "Corbin" } person.write_attributes(first_name: "Corbin") # Tenta ajudar os valores, levantando um erro Person.new(first_name: "Corbin", password: "password") person.attributes = { first_name: "Corbin", password: "password" } person.write_attributes(first_name: "Corbin", password: "password")

53. Acesso: Overriding Person.new(first_name: "Corbin") do |person| person.password = "password" end

54. Dirty Tracking person = Person.first person.name = "Alan Garner” # Checa para ver se o documento foi alterado person.changed? #=> true # Obtém um array dos nomes dos campos alterados person.changed #=> [ :name ] # Obtém um hash do antigo e do novo valor para cada campo person.changes #=> { "name" => [ "Alan Parsons", "Alan Garner" ] } # Checa se um campo específico foi alterado person.name_changed? #=> true # Obtém as mudanças para um campo específico person.name_change #=> [ "Alan Parsons", "Alan Garner" ] # Obtém o valor anterior de um campo person.name_was #=> "Alan Parsons" class Person include Mongoid::Document field :name, type: String end

55. Limpando mudanças person = Person.first person.name = "Alan Garner" # Reinicializa o nome alterado de volta ao original person.reset_name! person.name #=> "Alan Parsons"

56. Vendo as mudanças anteriores person = Person.first person.name = "Alan Garner" person.save #=> Clears out current changes. # Vê mudanças anteriores person.previous_changes #=> { "name" => [ "Alan Parsons", "Alan Garner" ] }

57. Herança class Canvas include Mongoid::Document field :name, type: String embeds_many :shapes end class Browser < Canvas field :version, type: Integer scope :recent, where(:version.gt => 3) end class Firefox < Browser end

58. Herança class Shape include Mongoid::Document field :x, type: Integer field :y, type: Integer embedded_in :canvas end class Circle < Shape field :radius, type: Float end class Rectangle < Shape field :width, type: Float field :height, type: Float end

59. Persistência <ul><li>Model.create </li></ul><ul><li>Model.create! </li></ul><ul><li>Model#save </li></ul><ul><li>Model#save! </li></ul><ul><li>Model#update_attributes </li></ul><ul><li>Model#update_attributes! </li></ul><ul><li>Model#update_attribute </li></ul><ul><li>Model#delete </li></ul><ul><li>Model#destroy </li></ul><ul><li>Model.delete_all </li></ul><ul><li>Model.destroy_all </li></ul>

60. Model.create # Insere um novo poeta na base. Person.create(first_name: "Heinrich", last_name: "Heine") # Isto também pode ser feito usando um bloco Person.create(first_name: "Heinrich") do |doc| doc.last_name = "Heine" end collections[”citizens"].insert({ "_id" : ..., "first_name" : "Heinrich", "last_name" : "Heine” })

61. Model.create! # Insere um novo poeta na base, levantando um erro # se a validação falhar. Person.create!(first_name: "Heinrich", last_name: "Heine") # Isto também pode ser feito usando um bloco Person.create!(first_name: "Heinrich") do |doc| doc.last_name = "Heine" end collections[”citizens"].insert({ "_id" : ..., "first_name" : "Heinrich", "last_name" : "Heine” })

62. Model#save # Insere um novo poeta na base. person = Person.new(first_name: "Heinrich", last_name: "Heine") person.save # Grava sem executar as validações person.save(validate: false) # Grava os campos modificados de um documento existente person.first_name = "Christian Johan" person.save # Comando de inserção de um novo documento collections[”sitizens"].insert({ "_id" : ..., "first_name" : "Heinrich", "last_name" : "Heine” }) # Comando de atualização do doc modificado collections["people"].update({ { "_id" : ... }, { "$set" : { "first_name" : "Christian Johan” } } })

63. Model#save! # Insere um novo poeta na base. person = Person.new(first_name: "Heinrich", last_name: "Heine") person.save! # Grava os campos modificados de um documento existente person.first_name = "Christian Johan" person.save! # Comando de inserção de um novo documento collections[”sitizens"].insert({ "_id" : ..., "first_name" : "Heinrich", "last_name" : "Heine” }) # Comando de atualização do doc modificado collections["people"].update({ { "_id" : ... }, { "$set" : { "first_name" : "Christian Johan” } } })

64. Model#update_attributes # Update the provided attributes. person.update_attributes(first_name: "Jean", last_name: "Zorg") # Comando de atualização do doc modificado collections[”citizens"].update({ "_id" : ..., "first_name" : ”Jean", "last_name" : ”Zorg” })

65. Model#update_attributes! # Update the provided attributes. person.update_attributes!(first_name: "Jean", last_name: "Zorg") # Comando de atualização do doc modificado collections[”citizens"].update({ "_id" : ..., "first_name" : ”Jean", "last_name" : ”Zorg” })

66. Model#update_attribute # Update the provided attributes. person.update_attribute(first_name: "Jean") # Comando de atualização do doc modificado collections[”citizens"].update({ "_id" : ..., "first_name" : ”Jean” })

67. Model#delete person.delete collections[”citizens"].remove("_id" : ... )

68. Model#destroy person.destroy collections[”citizens"].remove("_id" : ... )

69. Model#delete_all # Apaga todos os documentos da coleção Person.delete_all # Apaga todos os documentos da coleção que satisfaçam a condição Person.delete_all(conditions: { first_name: "Heinrich" }) # Comando para apagar todos collections[”citizens"].remove # Comando para apagar docs que satisfaçam condição collections[”citizens"].remove("first_name" : "Heinrich")

70. Model#destroy_all # Apaga todos os documentos da coleção Person.destroy_all # Apaga todos os documentos da coleção que satisfaçam a condição Person.destroy_all(conditions: { first_name: "Heinrich" }) # Comando para apagar todos collections[”citizens"].remove # Comando para apagar docs que satisfaçam condição collections[”citizens"].remove("first_name" : "Heinrich")

71. Atomicidade na Persistênicia <ul><li>Embora Mongoid realize operações atômicas por trás da cena por default, há casos em que se deseja fazê-lo explicitamente sem persistir outros campos </li></ul><ul><ul><li>Model#add_to_set </li></ul></ul><ul><ul><li>Model#inc </li></ul></ul><ul><ul><li>Model#pull_all </li></ul></ul><ul><ul><li>Model#push </li></ul></ul>

72. Model#add_to_set person.add_to_set(:aliases, "Bond") collections[”citizens"].update( { "_id" : ... }, { "$addToSet" : { "aliases" : "Bond" } } )

73. Model#inc person.inc(:age, 1) collections[”citizens"].update( { "_id" : ... }, { "$inc" : { "age" : 1 } } )

74. Model#pull_all person.pull_all(:aliases, [ "Bond", "James" ]) collections[”citizens"].update( { "_id" : ... }, { "$pullAll" : { "aliases" : [ "Bond", "James" ] } } )

75. Model#push person.push(:aliases, "007") collections[”citizens"].update( { "_id" : ... }, { "$push" : { "aliases" : "007" } } )

76. Querying <ul><li>Mongoid queries são em Criteria, um wrapper de queries dinâmicas do MongoDB, que é encadeável e de avaliação “tardia”, por só acessar a base quando necessário. </li></ul>

77. Criteria – métodos de query <ul><li>Model.all_in </li></ul><ul><li>Model.also_in </li></ul><ul><li>Criteria#and </li></ul><ul><li>Model.any_in </li></ul><ul><li>Model.any_of </li></ul><ul><li>Model.asc </li></ul><ul><li>Model.desc </li></ul><ul><li>Criteria#distinct </li></ul><ul><li>Model.excludes </li></ul><ul><li>Model.includes </li></ul><ul><li>Model.limit </li></ul><ul><li>Model.near </li></ul><ul><li>Model.not_in </li></ul><ul><li>Model.only </li></ul><ul><li>Model.order_by </li></ul><ul><li>Model.skip </li></ul><ul><li>Model.where </li></ul><ul><li>Model.without </li></ul>

78. Model.all_in | Criteria#all_in # Traz todas as pessoas que tem Bond e 007 como aliases Person.all_in(aliases: [ "Bond", "007" ]) { "aliases" : { "$all" : [ "Bond", "007" ] }}

79. Model.also_in | Criteria#also_in # Traz pessoas com aliases igual a Bond ou 007 Person.also_in(aliases: [ "Bond", "007" ]) Person.any_in(aliases: [ "Bond" ]).also_in(aliases: [ "007" ]) { "aliases" : { "$in" : [ "Bond", "007" ] }}

80. Criteria#and # Traz todas as pessoas com last_name Jordan e first_name iniciando com d Person.where(last_name: "Jordan").and(first_name: /^d/i) { "last_name" : "Jordan", "first_name" : /^d/i }

81. Model.any_in | Criteria#any_in # Traz todas as pessoas com Bond e/ou 007 como aliases Person.any_in(aliases: [ "Bond", "007" ]) Person. any_in(aliases: [ "Bond", "007", "James" ]). any_in(aliases: [ "Bond", "007" ]) { "aliases" : { "$in" : [ "Bond", "007" ] }}

82. Model.any_of | Criteria#any_of # Traz todas as pessoas com last_name Penn ou Teller Person.any_of({ last_name: "Penn" }, { last_name: "Teller" }) { "last_name" : { "$or" : [ { "last_name" : "Penn" }, { "last_name" : "Teller" } ] } }

83. Model.asc | Criteria#asc # Retorna pessoas ordenadas por first_name e last_name em ordem alfabética crescente Person.asc(:first_name, :last_name) Person.ascending(:first_name, :last_name) { "sort" : {[ [ "first_name", Mongo::ASCENDING ], [ "last_name", Mongo::ASCENDING ] ]} }

84. Model.where | Criteria#where # Traz todas as pessocas com first_name Emmanuel Person.where(first_name: "Emmanuel") # Traz todas as pessoas com first_name Emmanuel usando Javascript. Person.where("this.first_name == 'Emmanuel'") # Traz todas as pessoas de Berlin, onde address é “embutido” Person.where("addresses.city" => "Berlin") { "first_name" : "Emmanuel" } { "$where" : "this.first_name == 'Emmanuel'" } { "addresses.city" : "Berlin" }

85. Model.where | Criteria#where # Exemplo de queries usando símbolo h4s para realizar critérios mais complexos Person.where(:title.all => ["Sir"]) Person.where(:age.exists => true) Person.where(:age.gt => 18) Person.where(:age.gte => 18) Person.where(:title.in => ["Sir", "Madam"]) Person.where(:age.lt => 55) Person.where(:age.lte => 55) Person.where(:title.ne => "Mr") Person.where(:title.nin => ["Esquire"]) Person.where(:aliases.size => 2) Person.where(:location.near => [ 22.50, -21.33 ]) Person.where(:location.within => { "$center" => [ [ 50, -40 ], 1 ] })

86. Criteria + Modificação <ul><li>Pode-se usar Mongoid criteria para se criar um seletor e usá-lo para se modificar documentos no banco </li></ul>

87. Criação # Cria uma pessoa com title Sir e first_name Lancelot e a persiste Person.where(title: "Sir", first_name: "Lancelot").create Person.where(title: "Sir").create(first_name: "Lancelot") # Constrói uma pessoa com title Sir e first_name Lancelot, sem salvá-la Person.where(title: "Sir", first_name: "Lancelot").build Person.where(title: "Sir").build(first_name: "Lancelot")

88. Atualização # Atualiza todas as pessoas que têm last_name Oldman com um novo first_name Person.where(last_name: "Oldman").update_all( first_name: "Pappa Gary" )

89. Remoção # Apaga todos os cavaleiros de Sir Arthur da base Person.where(title: "Sir").and(king: "Arthur").delete_all Person.where(title: "Sir", king: "Arthur").destroy_all

90. Finders <ul><li>Métodos Finders não são encadeáveis </li></ul><ul><li>Retornam arrays de documentos ou um documento único (com exceções) </li></ul><ul><li>Métodos: </li></ul><ul><ul><li>Model.all </li></ul></ul><ul><ul><li>Model.count </li></ul></ul><ul><ul><li>Model.exists? </li></ul></ul><ul><ul><li>Model.find </li></ul></ul><ul><ul><li>Model.find_or_create_by </li></ul></ul><ul><ul><li>Model.find_or_initialize_by </li></ul></ul><ul><ul><li>Model.first </li></ul></ul><ul><ul><li>Model.last </li></ul></ul>

91. Model.all # Encontra todas as pessoas pelas condições e opções compatíveis com MongoDB Person.all Person.all(conditions: { first_name: /^dur/i, "addresses.city" => "Berlin" }) Person.all(conditions: { title: "Sir" }, limit: 5) Person.all(sort: [[ :first_name, :asc ]])

92. Model.count # Obtém o montante de documentos que satisfazem a(s) condição(ões) Person.count Person.count(conditions: { title: "Sir" })

93. Model.exists? # Existe algum documento na base que satisfaça a(s) condição(ões)? Person.exists? Person.exists?(conditions: { title: "Sir" })

94. Model.find | Criteria#find #Permite encontrar um vários documentos pelo id Person.find(id) Person.find("4baa56f1230048567300485c") Person.where(last_name: "Black").find(id) Person.find([id_one, id_two]) Person.find(["4baa56f1230048567300485c","4baa56f1230048567300485d"]) Person.where(last_name: "Black").find([ id_one, id_two ])

95. Model.find_or_create_by # Encontra um documento que satisfaça a condição ou cria um novo, se não houver nada persistido Person.find_or_create_by(first_name: "Syd", last_name: "Vicious")

96. Model.find_or_initialize_by # Encontra um documento que satisfaça a condição ou inicializa um novo, se não houver nada persistido Person.find_or_initialize_by(first_name: "Syd", last_name: "Vicious")

97. Model.first # Encontra o primeiro documento da base que satisfaça a condição. Retorna um documento ou nil, se nada for encontrado. Pode-se definir a ordenação, a fim de se ditar qual documento deve ser retornado. Person.first(conditions: { first_name: "Syd" }) Person.first(sort: [[ :first_name, :asc ]])

98. Model.last # Encontra o último documento da base que satisfaça a condição. Retorna um documento ou nil, se nada for encontrado. Pode-se definir a ordenação, a fim de se ditar qual documento deve ser retornado. Person.last(conditions: { first_name: "Syd" }) Person.last(sort: [[ :first_name, :asc ]])

99. Escopos <ul><li>Mongoid permite definir escopos dentro dos modelos, a fim de se filtrar resultados de busca </li></ul><ul><li>São definidos no nível da Classe </li></ul><ul><li>São encadeáveis </li></ul>

100. Named Scopes class Person include Mongoid::Document field :occupation, type : String field :age, type : Integer scope :rock_n_rolla, where ( occupation : "Rockstar") scope :washed_up, where (:age. gt => 30) scope :over, ->( limit ) { where (:age .gt => limit ) } end # Encontra todos os roqueiros Person.rock_n_rolla # Econtra os roqueiros que já deviam ter parado Person.washed_up.rock_n_rolla # Encontra o Tremendão Person.rock_n_rolla.over(60) scope :current, where(:start_date.lte => Date.today) scope :current, -> { where(:start_date.lte => Date.today) }

101. Métodos de Classe # Encontra todos os roqueiros Person.rock_n_rolla # Econtra os roqueiros que já deviam ter parado Person.washed_up.rock_n_rolla # Encontra o Tremendão Person.rock_n_rolla.over(60) class Person include Mongoid::Document field :occupation, type : String field :age, type : Integer class << self def rock_n_rolla where ( occupation : "Rockstar") end def washed_up where (:age. gt => 30) end def over ( limit ) where (:age. gt => limit ) end end end

102. Métodos de Classe e Named Scopes Person.rock_n_rolla Person.washed_up.rock_n_rolla Person.rock_n_rolla.over(60) class Person include Mongoid::Document field :occupation, type : String field :age, type : Integer scope :washed_up, where (:age. gt => 30) scope :over, ->( limit ) { where (:age .gt => limit ) } class self. rock_n_rolla where ( occupation : "Rockstar") end end

103. Default Scopes # Econtra os roqueiros que já deviam ter parado Person.washed_up # Se quiser encontrar os mais velhos que não são roqueiros Person.unscoped.washed_up class Person include Mongoid::Document field :occupation, type : String field :age, type : Integer default_scope where ( occupation : "Rockstar") scope :washed_up, where (:age. gt => 30) end

104. Relacionamentos <ul><li>Associações entre modelos no domínio e no banco. </li></ul><ul><li>Podem ser “embutidas” ou “referenciadas </li></ul><ul><li>Embedded: </li></ul><ul><ul><li>1…N: “embeds_many” e “embedded_in” </li></ul></ul><ul><ul><li>1…1: “embeds_one” e “embedded_in” </li></ul></ul><ul><li>Referenced: </li></ul><ul><ul><li>1…N: “has_many” e “belongs_to” </li></ul></ul><ul><ul><li>1…1: “has_one” e “belongs_to” </li></ul></ul><ul><ul><li>N…N: “has_and_belongs_to_many” e “has_and_belongs_to_many” </li></ul></ul>

105. Callbacks <ul><li>after_initialize </li></ul><ul><li>before_validation </li></ul><ul><li>after_validation </li></ul><ul><li>before_create </li></ul><ul><li>around_create </li></ul><ul><li>after_create </li></ul><ul><li>before_update </li></ul><ul><li>around_update </li></ul><ul><li>after_update </li></ul><ul><li>before_save </li></ul><ul><li>around_save </li></ul><ul><li>after_save </li></ul><ul><li>before_destroy </li></ul><ul><li>around_destroy </li></ul><ul><li>after_destroy </li></ul>

106. Callbacks class Article include Mongoid::Document field :name, type: String set_callback(:save, :before) do |document| document.generate_slug end protected def generate_slug self.slug = name.to_permalink end end class Article include Mongoid::Document field :name, type: String field :body, type: String field :slug, type: String before_create :generate_slug protected def generate_slug self.slug = name.to_permalink end end

107. Observers <ul><li>Implementa o comportamento fora da classe </li></ul><ul><li>Instanciação </li></ul>class ArticleObserver < Mongoid::Observer def after_save(article) Notifications.article("admin@do.com", "New article", article).deliver end end require 'article_observer' require 'audit_observer' Mongoid.observers = ArticleObserver, AuditObserver Mongoid.instantiate_observers config.mongoid.observers = :article_observer, :audit_observer Config/application.rb

108. Mapeamento class AuditObserver < Mongoid::Observer observe :account, :balance def after_update(record) AuditTrail.new(record, "UPDATED") end end

109. Validations <ul><li>validates_acceptance_of </li></ul><ul><li>validates_associated </li></ul><ul><li>validates_confirmation_of </li></ul><ul><li>validates_exclusion_of </li></ul><ul><li>validates_format_of </li></ul><ul><li>validates_inclusion_of </li></ul><ul><li>validates_length_of </li></ul><ul><li>validates_numericality_of </li></ul><ul><li>validates_presence_of </li></ul><ul><li>validates_uniqueness_of </li></ul>

110. Fontes <ul><li>MongoDB: Features, Quickstart and Tutorial( http://www.mongdb.com ) </li></ul><ul><li>MongoDB Ruby Driver Tutorial ( http://api.mongodb.org/ruby/current/file.TUTORIAL.html ) </li></ul><ul><li>Mongoid (http://mongoid.org/) </li></ul>

Uma Breve Introdução ao MongoDB

Esté a ler uma amostra.

Confira estes a seguir

Uma Breve Introdução ao MongoDB

Mais Conteúdo rRelacionado

Quem viu também gostou (20)

Semelhante a Uma Breve Introdução ao MongoDB (20)

Mais de Eduardo Nicola F. Zagari (11)

Mais recentes (20)