{"id":2327,"date":"2016-07-12T13:18:54","date_gmt":"2016-07-12T13:18:53","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=2327"},"modified":"2025-10-09T07:25:56","modified_gmt":"2025-10-09T14:25:56","slug":"sub-document-api-in-couchbase-server-4-5-with-the-net-sdk-revisted","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/sub-document-api-in-couchbase-server-4-5-with-the-net-sdk-revisted\/","title":{"rendered":"API de subdocumento no Couchbase Server 4.5 com o SDK do .NET (revisitado)"},"content":{"rendered":"
\n
\n

Esta postagem do blog \u00e9 baseada em um post anterior do blog de Jeff Morris<\/a> que cobriu a API de subdocumentos enquanto ela ainda estava na vers\u00e3o pr\u00e9via para desenvolvedores. Houve algumas altera\u00e7\u00f5es na API desde esse lan\u00e7amento.<\/em><\/p>\n<\/div>\n

\n

Com Servidor Couchbase 4.5<\/a> e o .NET SDK 2.3.x<\/a>Agora voc\u00ea pode usar o Subdocumento<\/em> em seu aplicativo .NET.<\/p>\n<\/div>\n

\n

Nas vers\u00f5es anteriores do Couchbase, todas as muta\u00e7\u00f5es de documentos eram at\u00f4micas e envolviam o documento inteiro. Se voc\u00ea quiser alterar apenas um \u00fanico campo e depois fazer uma atualiza\u00e7\u00e3o, todo o documento no servidor Couchbase ser\u00e1 copiado pela nova revis\u00e3o. O problema \u00e9 que, se o documento for grande ou a rede for lenta (ou ambos), muitos recursos ser\u00e3o desperdi\u00e7ados com o envio de dados que n\u00e3o foram modificados. Uma solu\u00e7\u00e3o melhor e de melhor desempenho seria enviar apenas a parte do documento ou o valor que sofreu muta\u00e7\u00e3o. Essencialmente, \u00e9 isso que voc\u00ea obt\u00e9m com a API de subdocumento; quando voc\u00ea atualiza um elemento ou exclui um elemento de um documento, somente o caminho do fragmento a ser alterado \u00e9 enviado pela rede e somente essa parte do documento \u00e9 modificada.<\/p>\n<\/div>\n

\n
\"Subdocument\"<\/div>\n<\/div>\n
\n

H\u00e1 v\u00e1rias opera\u00e7\u00f5es diferentes que s\u00e3o suportadas pela API, desde muta\u00e7\u00f5es em elementos individuais aninhados (tamb\u00e9m conhecidos como sub<\/em>documentos) para modifica\u00e7\u00f5es em matrizes e dicion\u00e1rios. As opera\u00e7\u00f5es de contador tamb\u00e9m s\u00e3o suportadas, assim como as opera\u00e7\u00f5es de recupera\u00e7\u00e3o de fragmentos JSON incorporados.<\/p>\n<\/div>\n

\n

A API \u00e9 exposta por meio de um fluente<\/em> que permite anexar v\u00e1rias opera\u00e7\u00f5es e execut\u00e1-las atomicamente no documento. H\u00e1 dois \"construtores\" diferentes: um construtor para opera\u00e7\u00f5es de muta\u00e7\u00e3o e um construtor para leituras ou \"pesquisas\" (que tamb\u00e9m pode verificar se um elemento existe em um determinado caminho).<\/p>\n<\/div>\n<\/div>\n

\n

Pr\u00e9-requisito: Couchbase Server 4.5<\/h3>\n
\n

Para seguir os exemplos abaixo, voc\u00ea precisar\u00e1 fazer o download e instalar Servidor Couchbase 4.5<\/a>. Se voc\u00ea nunca instalou o Couchbase Server antes, assista ao meu v\u00eddeo sobre Como instalar o Couchbase Server no Windows<\/a>. \u00c9 muito f\u00e1cil, independentemente do sistema operacional que estiver usando.<\/p>\n<\/div>\n<\/div>\n

\n

Vis\u00e3o geral da API do subdocumento<\/h2>\n
\n
\n

Os exemplos a seguir usar\u00e3o um documento com um ID de \"puppy\" e come\u00e7ar\u00e3o com a seguinte apar\u00eancia:<\/p>\n<\/div>\n

\n
\n
  {\r\n  \"type\": \"dog\",\r\n  \"breed\": \"Pitbull\/Chihuahua\",\r\n  \"name\": \"Puppy\",\r\n  \"toys\": [\r\n    \"squeaker\",\r\n    \"ball\",\r\n    \"shoe\"\r\n  ],\r\n  \"owner\": {\r\n    \"type\": \"servant\",\r\n    \"name\": \"Don Knotts\",\r\n    \"age\": 63\r\n  },\r\n  \"attributes\": {\r\n    \"fleas\": true,\r\n    \"color\": \"white\",\r\n    \"eyeColor\": \"brown\",\r\n    \"age\": 5,\r\n    \"dirty\": true,\r\n    \"sex\": \"female\"\r\n  }\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Todos os Os exemplos est\u00e3o dispon\u00edveis no Github<\/a> para que voc\u00ea possa clonar o projeto e brincar com a API.<\/p>\n<\/div>\n
\n
MutateInBuilder e LookupInBuilder<\/h3>\n
\n
A API de subdocumentos oferece dois novos tipos que utilizam um padr\u00e3o de construtor por meio de uma interface fluente para encadear v\u00e1rias opera\u00e7\u00f5es em um documento. Ambos os objetos s\u00e3o criados chamando Muta\u00e7\u00e3o<\/code> ou Pesquisa<\/code> em um CouchbaseBucket<\/code> e passando a chave do documento com o qual voc\u00ea est\u00e1 trabalhando:<\/p>\n<\/div>\n
\n
\n
\/\/Initialize the cluster helper with the default settings - i.e. localhost\r\nClusterHelper.Initialize();\r\nvar bucket = ClusterHelper.GetBucket(\"default\");\r\n\r\n\/\/create a mutation builder for the document \"thekey\"\r\nvar mutate = bucket.MutateIn(\"thekey\");\r\n\r\n\/\/create a lookup builder for the document \"thekey2\"\r\nvar lookup = bucket.LookupIn(\"thekey2\");\r\n\r\nClusterHelper.Close();<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Depois de ter o objeto construtor, voc\u00ea pode encadear v\u00e1rias opera\u00e7\u00f5es para executar no documento, por exemplo:<\/p>\n<\/div>\n
\n
\n
var builder = bucket.LookupIn(id).\r\n    Get(\"type\").\r\n    Get(\"name\").\r\n    Get(\"owner\").\r\n    Exists(\"notfound\");<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Em seguida, voc\u00ea pode enviar todas as opera\u00e7\u00f5es para o servidor em um \u00fanico lote:<\/p>\n<\/div>\n
\n
\n
var fragment = builder.Execute();<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Voc\u00ea pode verificar o resultado de uma opera\u00e7\u00e3o usando OpStatus e um caminho. Neste exemplo, estou usando o caminho \"tipo\"<\/code>:<\/p>\n<\/div>\n
\n
\n
if (fragment.OpStatus(\"type\") == ResponseStatus.Success)\r\n{\r\n    string format = \"Path='{0}' Value='{1}'\";\r\n    Console.WriteLine(format, \"type\", fragment.Content(\"type\"));\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Estes s\u00e3o alguns dos m\u00e9todos e campos que voc\u00ea encontrar\u00e1 no IDoc DocumentFragment<\/code> interface.<\/p>\n<\/div>\n\n\n\n\n\n\n\n\n\n
\n
Nome<\/p>\n<\/td>\n
\n
Descri\u00e7\u00e3o<\/p>\n<\/td>\n<\/tr>\n
\n
Conte\u00fado(...)<\/p>\n<\/td>\n
\n
Obt\u00e9m o conte\u00fado de um determinado caminho ou \u00edndice.<\/p>\n<\/td>\n<\/tr>\n
\n
Existe(...)<\/p>\n<\/td>\n
\n
Retorna true se houver um resultado para um determinado caminho ou \u00edndice.<\/p>\n<\/td>\n<\/tr>\n
\n
Count()<\/p>\n<\/td>\n
\n
O n\u00famero de opera\u00e7\u00f5es atuais mantidas pelo construtor.<\/p>\n<\/td>\n<\/tr>\n
\n
OpStatus(...)<\/p>\n<\/td>\n
\n
O Status da resposta<\/code> de uma opera\u00e7\u00e3o em um determinado \u00edndice ou caminho.<\/p>\n<\/td>\n<\/tr>\n
\n
Status<\/p>\n<\/td>\n
\n
O Status da resposta<\/code> para toda a opera\u00e7\u00e3o m\u00faltipla.<\/p>\n<\/td>\n<\/tr>\n
\n
Sucesso<\/p>\n<\/td>\n
\n
Verdadeiro se toda a opera\u00e7\u00e3o m\u00faltipla for bem-sucedida.<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n
Al\u00e9m dessas propriedades ou m\u00e9todos, h\u00e1 todas as outras propriedades herdadas de Resultado da opera\u00e7\u00e3o<\/code> (que \u00e9 a resposta padr\u00e3o de uma opera\u00e7\u00e3o de chave\/valor): Upsert, Remove, Replace e assim por diante.<\/p>\n<\/div>\n<\/div>\n
\n
Tratamento de erros<\/h3>\n
\n
Ao enviar v\u00e1rios muta\u00e7\u00f5es<\/em>Se um deles falhar, toda a solicita\u00e7\u00e3o de v\u00e1rias opera\u00e7\u00f5es falhar\u00e1. Isso permite uma sem\u00e2ntica transacional do tipo \"tudo ou nada\" ao realizar muta\u00e7\u00f5es em um \u00fanico documento.<\/p>\n<\/div>\n
\n
Ao enviar v\u00e1rios pesquisas<\/em>Se o servidor tentar retornar tantos itens quantos forem solicitados, algumas opera\u00e7\u00f5es poder\u00e3o ser bem-sucedidas e outras poder\u00e3o falhar.<\/p>\n<\/div>\n
\n
If the operation(s) failed, then the`Status` property will contain a top-level error response such as SubDocMultiPathFailure<\/code>. Essa \u00e9 uma indica\u00e7\u00e3o de que voc\u00ea deve se aprofundar nos resultados da opera\u00e7\u00e3o para obter o erro espec\u00edfico. Voc\u00ea pode fazer isso por meio de itera\u00e7\u00e3o: chamando a fun\u00e7\u00e3o Status da opera\u00e7\u00e3o<\/code> e passando o \u00edndice ou o caminho:<\/p>\n<\/div>\n
\n
\n
var builder = bucket.LookupIn(id).\r\n    Get(\"type\").\r\n    Get(\"somepaththatdoesntexist\").\r\n    Get(\"owner\");\r\n\r\nvar fragment = builder.Execute();\r\nConsole.WriteLine(\"Generic error: {0}{1}Specific Error: {2}\",\r\n    fragment.Status, Environment.NewLine, fragment.OpStatus(1));\r\n\r\nConsole.WriteLine(\"Generic error: {0}{1}Specific Error: {2}\",\r\n   fragment.Status, Environment.NewLine, fragment.OpStatus(\"somepaththatdoesntexist\"));<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Nesse caso, como o caminho \"somepaththatdoesntexist\" n\u00e3o existia no documento, o erro espec\u00edfico retornado foi SubDocPathNotFound<\/code>. H\u00e1 muitas combina\u00e7\u00f5es diferentes de erros, dependendo do tipo de construtor e da condi\u00e7\u00e3o do erro.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
Exemplos de LookupInBuilder<\/h2>\n
\n
\n
O LookUpInBuilder<\/code> suporta duas opera\u00e7\u00f5es: buscar um valor por caminho e verificar a exist\u00eancia de um valor em um determinado caminho.<\/p>\n<\/div>\n
\n
Obter:<\/h3>\n
\n
Vamos procurar o propriet\u00e1rio<\/code> fragmento. Se eu passar \"owner\" como par\u00e2metro de caminho para esse m\u00e9todo...<\/p>\n<\/div>\n
\n
\n
public static void GetExample(IBucket bucket, string path, string id)\r\n{\r\n    var builder = bucket.LookupIn(id).\r\n        Get(path).\r\n        Execute();\r\n\r\n    var fragment = builder.Content(path);\r\n    Console.WriteLine(fragment);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
...a sa\u00edda para o console seria:<\/p>\n<\/div>\n
\n
\n
{\r\n    \"type\": \"servant\",\r\n    \"name\": \"Don Knotts\",\r\n    \"age\": 63\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
Existir:<\/h3>\n
\n
Tamb\u00e9m podemos verificar se um caminho existe. Se eu passar \"owner\" como o caminho para esse m\u00e9todo...<\/p>\n<\/div>\n
\n
\n
public static void ExistsExample(IBucket bucket, string path, string id)\r\n{\r\n    var builder = bucket.LookupIn(id).\r\n        Exists(path).\r\n        Execute();\r\n\r\n    var found = builder.Content(path);\r\n    Console.WriteLine(found);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
...o resultado \u00e9 verdadeiro<\/code>porque o caminho propriet\u00e1rio<\/code> existe de fato no documento.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
MutateInBuilder<\/h2>\n
\n
\n
O MutateInBuilder oferece v\u00e1rios m\u00e9todos de suporte a muta\u00e7\u00f5es em valores escalares, dicion\u00e1rios e matrizes, al\u00e9m de suporte a opera\u00e7\u00f5es de contador at\u00f4mico.<\/p>\n<\/div>\n
\n
Inserir:<\/h3>\n
\n
Insert adiciona um valor a um dicion\u00e1rio e, opcionalmente, permite que o elemento que o cont\u00e9m (o pr\u00f3prio dicion\u00e1rio) seja adicionado.<\/p>\n<\/div>\n
\n
\n
public static void InsertExample(IBucket bucket, string id, string path, string value)\r\n{\r\n    var fragment = bucket.MutateIn(id).\r\n        Insert(path, value, true).  \/\/ false is the default\r\n        Execute();\r\n\r\n    var status = fragment.OpStatus(path);\r\n    Console.WriteLine(status);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Se eu chamasse o m\u00e9todo acima dessa forma:<\/p>\n<\/div>\n
\n
\n
InsertExample(bucket, id,\"attributes.hairLength\", \"short\");<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Ent\u00e3o, o dicion\u00e1rio de atributos do documento ter\u00e1 a seguinte apar\u00eancia:<\/p>\n<\/div>\n
\n
\n
...\r\n\"attributes\":\r\n{\r\n    \"fleas\": true,\r\n    \"color\": \"white\",\r\n    \"eyeColor\": \"brown\",\r\n    \"age\": 5,\r\n    \"dirty\": true,\r\n    \"sex\": \"female\",\r\n    \"hairLength\": \"short\"\r\n}\r\n...<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Observe que o Inserir<\/code> tem um par\u00e2metro booleano opcional chamado createParents<\/code>. \u00c9 falso por padr\u00e3o. Se for verdadeiro, a API do subdocumento criar\u00e1 o caminho necess\u00e1rio para que o campo exista. Se for falso, a API do subdocumento s\u00f3 criar\u00e1 o campo se os pais do campo j\u00e1 existirem. No exemplo acima, o campo atributos<\/code> j\u00e1 existia.<\/p>\n<\/div>\n
\n
No pr\u00f3ximo exemplo, usarei um caminho com um campo pai (um novo atributo<\/code>) que ainda n\u00e3o exista.<\/p>\n<\/div>\n
\n
\n
InsertExample(bucket, id, \"anewattribute.withakey\", \"somevalue\");<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Isso criar\u00e1 o novo atributo chamado um novo atributo<\/code> no documento e adicione uma \u00fanica chave chamada withakey<\/code> com um valor de algum valor<\/code>.<\/p>\n<\/div>\n
\n
\n
...\r\n\"anewattribute\":\r\n{\r\n    \"withakey\": \"somevalue\"\r\n}\r\n...<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Agora, se passarmos falso<\/code> para createParents<\/code> e o atributo pai n\u00e3o existisse, a muta\u00e7\u00e3o m\u00faltipla falharia com um status de resposta de n\u00edvel superior de SubDocMultiPathFailure<\/code> e o erro espec\u00edfico seria SubDocPathNotFound<\/code>.<\/p>\n<\/div>\n<\/div>\n
\n
Upsert<\/h3>\n
\n
Upsert adiciona ou substitui uma entrada existente no dicion\u00e1rio. O uso \u00e9 exatamente o mesmo que Inserir<\/code> com exce\u00e7\u00e3o do nome do m\u00e9todo que \u00e9 Upsert<\/code>.<\/p>\n<\/div>\n<\/div>\n
\n
Remover<\/h3>\n
\n
Remover<\/code> remover\u00e1 um elemento em um determinado caminho.<\/p>\n<\/div>\n
\n
\n
public static void RemoveExample(IBucket bucket, string id, string path)\r\n{\r\n    var fragment = bucket.MutateIn(id).\r\n        Remove(path).\r\n        Execute();\r\n\r\n    var status = fragment.OpStatus(path);\r\n    Console.WriteLine(status);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Quando chamo esse m\u00e9todo:<\/p>\n<\/div>\n
\n
\n
RemoveExample(bucket, id, \"owner.name\");<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Veja como o documento ficar\u00e1 depois:<\/p>\n<\/div>\n
\n
\n
...\r\n\"owner\":\r\n{\r\n    \"type\": \"servant\",\r\n    \"age\": 63\r\n},\r\n...<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
Substituir<\/h3>\n
\n
Replace trocar\u00e1 o valor do elemento em um determinado caminho, falhando se o caminho n\u00e3o existir:<\/p>\n<\/div>\n
\n
\n
public static void ReplaceExample(IBucket bucket, string id, string path, object value)\r\n{\r\n    var fragment = bucket.MutateIn(id).\r\n        Replace(path, value).\r\n        Execute();\r\n\r\n    var status = fragment.OpStatus(path);\r\n    Console.WriteLine(status);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Depois que eu chamar esse m\u00e9todo:<\/p>\n<\/div>\n
\n
\n
ReplaceExample(bucket, id, \"owner\", new { CatLover=true, CatName=\"celia\"});<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
O documento agora ter\u00e1 um valor diferente para \"propriet\u00e1rio\":<\/p>\n<\/div>\n
\n
\n
...\r\n\"owner\":\r\n{\r\n    \"catLover\": true,\r\n    \"catName\": \"celia\"\r\n},\r\n...<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
ArrayAppend<\/h3>\n
\n
O ArrayAppend adiciona um valor ao final de uma matriz, adicionando opcionalmente o elemento pai (o pr\u00f3prio elemento da matriz) se ele n\u00e3o existir.<\/p>\n<\/div>\n
\n
\n
public static void ArrayAppendExample(IBucket bucket, string id, string path, object value)\r\n{\r\n    var fragment = bucket.MutateIn(id).\r\n        ArrayAppend(path, value, false).\r\n        Execute();\r\n\r\n    var status = fragment.OpStatus(path);\r\n    Console.WriteLine(status);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Depois desse m\u00e9todo com o caminho \"toys\"...<\/p>\n<\/div>\n
\n
\n
ArrayAppendExample(bucket, id, \"toys\", \"slipper\");<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
...o brinquedos<\/code> no documento ter\u00e1 o valor \"slipper\" no \u00faltimo ordinal:<\/p>\n<\/div>\n
\n
\n
...\r\n\"toys\":\r\n[\r\n    \"squeaker\",\r\n    \"ball\",\r\n    \"shoe\",\r\n    \"slipper\"\r\n],\r\n...<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
ArrayPrepender<\/h3>\n
\n
O ArrayPrepend funciona da mesma forma que o ArrayAppend, exceto pelo fato de que ele adiciona um valor \u00e0 vari\u00e1vel frente<\/em> de uma matriz.<\/p>\n<\/div>\n
\n
\n
public static void ArrayAppendExample(IBucket bucket, string id, string path, object value)\r\n{\r\n    var fragment = bucket.MutateIn(id).\r\n        ArrayAppend(path, value, false).\r\n        Execute();\r\n\r\n    var status = fragment.OpStatus(path);\r\n    Console.WriteLine(status);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Chamando esse m\u00e9todo com o caminho \"toys\"...<\/p>\n<\/div>\n
\n
\n
ArrayAppendExample(bucket, id, \"toys\", \"slipper\");<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
O brinquedos<\/code> agora tem o valor \"slipper\" em sua matriz primeiro<\/em> ordinal:<\/p>\n<\/div>\n
\n
\n
...\r\n\"toys\":\r\n[\r\n    \"slipper\",\r\n    \"squeaker\",\r\n    \"ball\",\r\n    \"shoe\"\r\n],\r\n...<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
ArrayInsert<\/h3>\n
\n
O ArrayPrepend coloca um valor no in\u00edcio, o ArrayAppend o coloca no final. Para completar, voc\u00ea pode usar o ArrayInsert para colocar um valor em algum ponto intermedi\u00e1rio (em um determinado \u00edndice).<\/p>\n<\/div>\n
\n
\n
public static void ArrayInsertExample(IBucket bucket, string id, string path, object value)\r\n{\r\n    var fragment = bucket.MutateIn(id).\r\n        ArrayInsert(path, value).\r\n        Execute();\r\n\r\n    var status = fragment.OpStatus(path);\r\n    Console.WriteLine(status);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
E, em seguida, chamar esse m\u00e9todo com \"toys[2]\"...<\/p>\n<\/div>\n
\n
\n
ArrayInsertExample(bucket, id, \"toys[2]\", \"slipper\");<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
O brinquedos<\/code> A matriz agora tem o valor \"slipper\" em seu terceiro ordinal (\u00edndice 2):<\/p>\n<\/div>\n
\n
\n
\"toys\":\r\n[\r\n    \"squeaker\",\r\n    \"ball\",\r\n    \"slipper\",\r\n    \"shoe\"\r\n ],<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
ArrayAddUnique<\/h3>\n
\n
O ArrayAddUnique insere um valor em uma matriz, mas falhar\u00e1 se esse valor j\u00e1 existir (ou seja, o valor deve ser exclusivo dentro da matriz).<\/p>\n<\/div>\n
\n
\n
public static void ArrayAddUniqueExample(IBucket bucket, string id, string path, object value)\r\n{\r\n    var fragment = bucket.MutateIn(id).\r\n        ArrayAddUnique(path, value).\r\n        Execute();\r\n\r\n    var status = fragment.OpStatus(path);\r\n    Console.WriteLine(status);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Quando eu chamo isso de \"sapato\"...<\/p>\n<\/div>\n
\n
\n
ArrayAddUniqueExample(bucket, id, \"toys\", \"shoe\");<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
...uma vez que o valor \"shoe\" j\u00e1 existe no documento original brinquedos<\/code> isso falhar\u00e1 com o status SubDocPathExists<\/code>.<\/p>\n<\/div>\n
\n
Observe que esse m\u00e9todo s\u00f3 permite a inser\u00e7\u00e3o de primitivos JSON: cadeias de caracteres, n\u00fameros e valores especiais para verdadeiro, falso ou nulo. N\u00e3o h\u00e1 como comparar a exclusividade sem descer em cada objeto JSON e comparar os elementos item por item.<\/em><\/p>\n<\/div>\n<\/div>\n
\n
Balc\u00e3o<\/h3>\n
\n
Adiciona o delta especificado (altera\u00e7\u00e3o) a um valor existente, criando o elemento se ele n\u00e3o existir. O valor e o delta ser\u00e3o padronizados como 0. Se o delta for negativo, o valor do elemento ser\u00e1 diminu\u00eddo pelo delta fornecido.<\/p>\n<\/div>\n
\n
Criarei um m\u00e9todo que usa Balc\u00e3o<\/code>:<\/p>\n<\/div>\n
\n
\n
public static void CounterExample(IBucket bucket, string id, string path, long delta)\r\n{\r\n    var fragment = bucket.MutateIn(id).\r\n        Counter(path, delta).\r\n        Execute();\r\n\r\n    var status = fragment.OpStatus(path);\r\n    Console.WriteLine(status);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Em seguida, chamarei o m\u00e9todo duas vezes usando um 1 positivo e um 1 negativo como \"deltas\":<\/p>\n<\/div>\n
\n
\n
CounterExample(bucket, id, \"likes\", 1);\r\nCounterExample(bucket, id, \"likes\", -1);<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Ap\u00f3s a primeira chamada, como o elemento n\u00e3o existe, ele ser\u00e1 criado e, em seguida, definido como um (1). O documento agora ter\u00e1 a seguinte apar\u00eancia:<\/p>\n<\/div>\n
\n
\n
...\r\n    ],\r\n    \"likes\": 1\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
A segunda chamada passa um n\u00famero negativo (-1), portanto, o contador para gostos<\/code> ser\u00e1 decrementado para zero (0). O documento JSON agora ter\u00e1 a seguinte apar\u00eancia:<\/p>\n<\/div>\n
\n
\n
...\r\n    ],\r\n    \"likes\": 0\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
Conclus\u00e3o<\/h2>\n
\n
\n
Desde a publica\u00e7\u00e3o no blog da visualiza\u00e7\u00e3o do desenvolvedor, o SDK do Couchbase .NET foi atualizado para a vers\u00e3o 2.3.2 (at\u00e9 o momento desta publica\u00e7\u00e3o no blog). Voc\u00ea pode conferir o trabalho que foi feito na se\u00e7\u00e3o Notas de vers\u00e3o da vers\u00e3o 2.3.2<\/a>.<\/p>\n<\/div>\n
\n
Como obter a vers\u00e3o 2.3.x<\/h3>\n
\n