O Couchbase Server oferece v\u00e1rios servi\u00e7os para armazenar, recuperar, consultar e analisar seus dados. Cada servi\u00e7o exp\u00f5e uma API p\u00fablica como API REST ou por meio do protocolo bin\u00e1rio Memcached estendido de n\u00edvel inferior. Com a autentica\u00e7\u00e3o adequada e as portas abertas, qualquer aplicativo pode usar essas APIs, mas elas t\u00eam um custo, uma complexidade e a falta de seguran\u00e7a de tipo na maioria das vezes. Sejamos francos, a maioria dos desenvolvedores de aplicativos n\u00e3o est\u00e1 preocupada em analisar uma resposta REST ou desempacotar pacotes do Memcached; eles querem criar suas solu\u00e7\u00f5es de forma r\u00e1pida e eficiente para resolver suas necessidades comerciais exclusivas. Eles querem uma biblioteca que lide com gerenciamento de recursos, fragmenta\u00e7\u00e3o, gerenciamento de altera\u00e7\u00f5es na topologia do cluster etc., que \u00e9 a fun\u00e7\u00e3o do SDK do Couchbase.<\/p>\n
O SDK 1.0 estava alinhado com o Couchbase Server 1.x e suportava principalmente a leitura\/grava\u00e7\u00e3o de pares de chave\/valor em um formato bin\u00e1rio e JSON usando o protocolo Memcached e as visualiza\u00e7\u00f5es. Os SDKs foram desenvolvidos independentemente uns dos outros e n\u00e3o tinham uma interface de API consistente. Em alguns casos, as diferen\u00e7as de empacotamento do Memcached tornavam os dados n\u00e3o compartilh\u00e1veis entre os SDKs.<\/p>\n
O SDK 2.0 oferecia suporte a novos recursos do Couchbase Server \u00e0 medida que ele evolu\u00eda: N1QL, a linguagem semelhante ao SQL para consultar documentos JSON armazenados no Couchbase Server, autentica\u00e7\u00e3o aprimorada usando RBAC (Role Based Access Control, controle de acesso baseado em fun\u00e7\u00e3o), suporte aprimorado a JSON, an\u00e1lise, FTS (Full Text Search, pesquisa de texto completo) e outras ferramentas para interagir com seus dados. Na vers\u00e3o 2.X, alinhamos as interfaces e as tornamos consistentes, em sua maior parte, em todos os SDKs usando uma RFC para garantir a ades\u00e3o \u00e0s interfaces definidas e inclu\u00edmos um componente Common Flags para garantir que os dados pudessem ser gravados e lidos em qualquer SDK. No lado negativo, a interface do IBucket ficou inchada e dif\u00edcil de usar, pois v\u00e1rias APIs foram amontoadas nela.<\/p>\n
O SDK 3.0 est\u00e1 alinhado com os novos recursos do Couchbase Server que se estendem da interface tradicional do Bucket: suporte para Escopos e Cole\u00e7\u00f5es que estar\u00e3o dispon\u00edveis como um Visualiza\u00e7\u00e3o para desenvolvedores no Couchbase Server 6.5<\/strong> e como GA no Couchbase Server 7.0<\/strong>. Al\u00e9m disso, ele consolida e refina as interfaces formalmente inchadas e baseadas em sobrecarga em uma interface menor e mais concisa, mantendo e melhorando a conformidade entre os SDKs.<\/p>\n Todos os SDKs assinam o Controle de vers\u00e3o sem\u00e2ntico 2.0.0<\/a> Especifica\u00e7\u00e3o (SemVer) em que, para um determinado n\u00famero de vers\u00e3o MAIOR.MENOR.PATCH<\/em> \u00e9 incrementado quando:<\/p>\n Al\u00e9m disso, para pr\u00e9-lan\u00e7amentos e metadados de compila\u00e7\u00e3o, adicionamos extens\u00f5es \u00e0 especifica\u00e7\u00e3o SemVer, conforme permitido por ela. Por exemplo, nossas primeiras vers\u00f5es do SDK 3.0 usam a designa\u00e7\u00e3o \"alfa\" mais um incremento para a vers\u00e3o alfa. Por exemplo, nossas primeiras visualiza\u00e7\u00f5es do SDK 3.0 usaram a seguinte vers\u00e3o compat\u00edvel com o SemVer: \"3.0.0-alpha1\". O pr\u00f3ximo pr\u00e9-lan\u00e7amento, ap\u00f3s as vers\u00f5es alfa, ser\u00e1 \"3.0.0-beta1\" e, finalmente, uma vers\u00e3o GA totalmente compat\u00edvel ser\u00e1 \"3.0.0\". Em geral, espere mudan\u00e7as significativas entre as vers\u00f5es \"alfa\", que n\u00e3o devem ocorrer (mas, em alguns casos, podem ser necess\u00e1rias) quando a vers\u00e3o \"beta\" for lan\u00e7ada.<\/p>\n Observe que h\u00e1 uma pequena discrep\u00e2ncia entre as vers\u00f5es do servidor, pois o Couchbase Server oferecer\u00e1 pr\u00e9-lan\u00e7amentos como \"developer previews\" ou \"dp\" e, em seguida, \"beta\" e, finalmente, GA.<\/p>\n Nas vers\u00f5es do Couchbase Servers anteriores \u00e0 6.5, os Buckets eram usados como uma entidade l\u00f3gica, nomeada pelo usu\u00e1rio, que agrupava itens, permitindo que fossem acessados, indexados, replicados e controlados por acesso.<\/p>\n Esse era realmente o \u00fanico meio de obter multitenancy usando o Couchbase Server e vinha com algumas limita\u00e7\u00f5es: Os pr\u00f3prios buckets s\u00e3o bastante intensivos em recursos e um cluster s\u00f3 pode gerenciar com efici\u00eancia um n\u00famero finito de buckets. Para arquiteturas de microsservi\u00e7o modernas ou qualquer arquitetura em que o multilocat\u00e1rio fosse necess\u00e1rio, isso criava alguns desafios ao atender a uma grande quantidade de locat\u00e1rios. Isso \u00e9 resolvido no Couchbase Server 6.5+ por Escopos e Cole\u00e7\u00f5es.<\/p>\n Um escopo no Couchbase 6.5+ representa uma unidade de multiloca\u00e7\u00e3o e permite que os nomes de cole\u00e7\u00f5es sejam reutilizados; qualquer escopo pode conter exatamente um nome de cole\u00e7\u00e3o exclusivo. Um escopo \u00e9 simplesmente um grupo de cole\u00e7\u00f5es. Cada Bucket cont\u00e9m um Escopo padr\u00e3o com o nome \"_default\"<\/em> e um identificador de escopo 0 (zero) que cont\u00e9m uma cole\u00e7\u00e3o padr\u00e3o chamada \"_default<\/em>\" e seu respectivo identificador de 0 (zero). Obviamente, para cada escopo espec\u00edfico, podem ser criadas v\u00e1rias cole\u00e7\u00f5es.<\/p>\n Isso tem o efeito de mover as opera\u00e7\u00f5es de chave\/valor que estavam no contexto do Bucket para SDK1.0 e SDK2.0 para o contexto da Cole\u00e7\u00e3o para SDK3.0. Ao mesmo tempo, as opera\u00e7\u00f5es entre buckets, como FTS, Analytics e N1QL, agora s\u00e3o feitas no n\u00edvel do cluster.<\/p>\n O primeiro pacote de despejo do Couchbase .NET SDK 3.0 foi o Couchbase Alfa 2<\/a> (O Alpha 1 continha um bug que tornou necess\u00e1rio o lan\u00e7amento e o aumento da vers\u00e3o). Alfa 3<\/a> foi lan\u00e7ado em 26 de abril - planejamos lan\u00e7ar v\u00e1rios outros! O foco em um pr\u00e9-lan\u00e7amento \u00e9 fornecer os bits para programar opera\u00e7\u00f5es de chave\/valor e consultas N1QL no Couchbase Server. Ele cont\u00e9m as conhecidas estruturas l\u00f3gicas Cluster e Bucket, bem como as novas estruturas Scope e Collections. Observe que, embora os escopos e as cole\u00e7\u00f5es fa\u00e7am parte do Couchbase 6.5, que n\u00e3o ser\u00e1 lan\u00e7ado at\u00e9 o final deste ano ou no ano que vem, o SDK 3.0 tamb\u00e9m oferece suporte ao Couchbase 5.0 e superior usando o escopo e a cole\u00e7\u00e3o padr\u00e3o explicados anteriormente.<\/p>\n Assim como no SDK 2.0, os objetos Cluster e Bucket est\u00e3o de volta no SDK 3.0, cada um representando suas equival\u00eancias de servidor. A conex\u00e3o a um cluster e a abertura de um bucket s\u00e3o feitas de maneira semelhante \u00e0 do SDK2.0:<\/p>\n Semelhante ao SDK2.0, os objetos Cluster e Bucket s\u00e3o objetos de longa dura\u00e7\u00e3o, cuja vida \u00fatil geralmente vai da inicializa\u00e7\u00e3o do aplicativo at\u00e9 o seu encerramento.<\/p>\n Todas as opera\u00e7\u00f5es de chave\/valor agora existem no n\u00edvel das cole\u00e7\u00f5es, que sempre ser\u00e3o membros de exatamente um escopo. Aqui est\u00e3o alguns exemplos de acesso a uma cole\u00e7\u00e3o e, em seguida, de leitura e grava\u00e7\u00e3o de dados na cole\u00e7\u00e3o.<\/p>\n Observe que estamos usando o Couchbase Server 6.0 e, portanto, n\u00e3o temos suporte para Scope ou Collection (eles n\u00e3o estar\u00e3o dispon\u00edveis at\u00e9 o Server 6.5); no entanto, podemos usar o Scope e a Collection \"padr\u00e3o\" como se tiv\u00e9ssemos suporte para Scope e Collections. Observe que isso foi adicionado como um recurso de atualiza\u00e7\u00e3o para migrar para a vers\u00e3o mais recente do servidor. O escopo e a cole\u00e7\u00e3o \"padr\u00e3o\" sempre estar\u00e3o dispon\u00edveis; \u00e9 semelhante ao funcionamento de um bucket nos SDKs anteriores \u00e0 vers\u00e3o 3.0.<\/p>\n Observe que, ap\u00f3s buscar um documento, o GetResult deve ser descartado para liberar recursos, caso contr\u00e1rio, os buffers internos ser\u00e3o \"vazados\"; essa \u00e9 uma altera\u00e7\u00e3o do SDK 1.0 e 2.0.<\/p>\n Esse \u00e9 o futuro do Couchbase: a capacidade de dividir um Bucket em v\u00e1rios escopos l\u00f3gicos (multiloca\u00e7\u00e3o) e cole\u00e7\u00f5es de documentos distintos. Isso substitui a exig\u00eancia das primeiras vers\u00f5es do servidor Couchbase de adicionar um campo especial de \"tipo\" que designava uma esp\u00e9cie de agrupamento de documentos por nome, que poderia ser consultado independentemente em um Bucket. Acredito que voc\u00ea descobrir\u00e1 que esse \u00e9 um modelo de programa\u00e7\u00e3o muito mais intuitivo e que permitir\u00e1 avan\u00e7os futuros dos recursos do servidor no futuro.<\/p>\n O N1QL, assim como o Analytics e o FTS, \u00e9 considerado de escopo \"global\", pois uma consulta pode fazer refer\u00eancia a v\u00e1rios Buckets. Inicialmente, no SDK 2.0, as consultas N1QL tinham escopo para o Bucket e, posteriormente, foram adicionadas ao Cluster. No SDK 3.0, atualmente, voc\u00ea s\u00f3 pode consultar a partir do objeto Cluster.<\/p>\n De modo geral, todos os servi\u00e7os (Query, FTS e Analytics) t\u00eam uma API p\u00fablica muito semelhante \u00e0 do SDK 2.0; no entanto, para fins de consist\u00eancia, o campo obrigat\u00f3rio (a instru\u00e7\u00e3o SQL para N1QL) foi adicionado como um par\u00e2metro no lado esquerdo e os par\u00e2metros opcionais agora est\u00e3o consolidados em um bloco ou estrutura de \"op\u00e7\u00f5es\" no lado direito. Voc\u00ea perceber\u00e1 que isso continua em todo o SDK e melhora muito a consist\u00eancia da API.<\/p>\n Assim como em todas as vers\u00f5es do SDK do Couchbase .NET, oferecemos a op\u00e7\u00e3o de downloads<\/a> do pacote NuGet e tamb\u00e9m ser\u00e1 publicado no NuGet<\/a>.<\/p>\n Por fim, um agradecimento especial a Brant Burnett, da Centeredge Software, por contribuir enormemente para o lan\u00e7amento!<\/p>","protected":false},"excerpt":{"rendered":" What\u2019s in an SDK? Couchbase Server offers multiple services for storing, retrieving, querying and analyzing your data. Each service exposes a public API either as REST API or via lower level, extended, Memcached binary protocol. With the proper Authentication and […]<\/p>","protected":false},"author":21,"featured_media":7110,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[1811,10127,2201],"tags":[2364,1261],"ppma_author":[8970],"class_list":["post-6901","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dotnet","category-c-sharp","category-tools-sdks","tag-collections","tag-json"],"acf":[],"yoast_head":"\nComo fazemos a vers\u00e3o?<\/h3>\n
\n
Escopos e cole\u00e7\u00f5es no Couchbase Server 6.5+<\/h3>\n
S\u00e9rie alfa do .NET SDK 3.0<\/h2>\n
Cluster e buckets no SDK 3.0<\/h3>\n
\/Configurar e abrir um objeto de cluster\r\nvar cluster = new Cluster(new Configuration().\r\n WithServers(\"couchbase:\/\/localhost\").\r\n WithBucket(\"default\").\r\n WithCredentials(\"Administrator\", \"password\"));\r\n\r\n\/\/abrir um bucket chamado \"default\"\r\nvar bucket = await Cluster.Bucket(\"default\");<\/pre>\n
Usando o escopo e as cole\u00e7\u00f5es padr\u00e3o no Couchbase Server 6.0<\/h3>\n
\/\/abrir a cole\u00e7\u00e3o\/escopo padr\u00e3o\r\nvar collection = await bucket.GetDefaultCollection();\r\n\r\n\/\/adicionar um novo documento\r\nawait collection.Insert(key, new {name = \"mike\"});\r\n\r\n\/\/recuperar o documento\r\nusing (var result = await collection.Get(key)) {\r\n var content = result.ContentAs();\r\n Console.WriteLine(content.name);\r\n}<\/pre>\nUso do escopo nomeado e das cole\u00e7\u00f5es no Couchbase Server 6.5+<\/h3>\n
\/Abrir um escopo e, em seguida, uma cole\u00e7\u00e3o\r\nvar scope = await bucket.Scope(\"ACME\");\r\nvar collection = await scope.Collection(\"tools\");\r\n\r\n\/\/adicionar um novo documentawait\r\ncollection.Insert(key, new Tool(Name = \"Hammer\", Type=\"Ball peen\"});\r\n\r\n\/\/recuperar o documento\r\nusing (var result = await collection.Get(key)) {\r\n var content = result.ContentAs();\r\n Console.WriteLine(content.Name);\r\n}<\/pre>\nUso do cluster para consultas N1QL<\/h3>\n
\/\/executar uma consulta no cluster\r\nvar statement = \"SELECT * FROM `default` WHERE type=$name;\";\r\nvar result = await cluster.Query(statement,\r\n parameters =>{parameters.Add(\"name\", \"person\");});\r\n\r\n\/\/enumerar as linhas retornadas\r\nforeach(var row in result){\r\n Console.WriteLine(row.name);\r\n}\r\n\r\n\/\/liberar os buffers internos\r\nresult.Dispose();<\/pre>\nObtendo as vers\u00f5es alfa do SDK do Couchbase .NET 3.0<\/h3>\n