Couchbase.NET SDK v2.2.7 w/Developer Preview of Index Management now available!

O Couchbase.NET SDK v2.2.7 com visualização para desenvolvedores do gerenciamento de índices já está disponível!

Hoje estamos lançando a versão 2.2.7 do SDK oficial do Couchbase .NET! Essa versão contém suporte para o gerenciamento de índices e adiciona a API de subdocumentos, que foi lançada como uma prévia para desenvolvedores na versão 2.2.6, bem como uma correção de bugs e melhorias no suporte futuro do .NET Core.

Gerenciamento de índices

Os índices secundários globais (GSIs) são uma parte importante da arquitetura de consulta N1QL no servidor Couchbase, permitindo consultas rápidas e de baixa latência. Você pode colocar índices em elementos JSON, expressões N1QL e usar filtros por meio de uma cláusula WHERE. Para a versão 2.2.7 do SDK do .NET, criamos uma abstração sobre o serviço de indexação do Couchbase Server que facilita muito a criação de índices primários e secundários. Essa abstração estende e amplia a classe BucketManager, que inclui suporte para a criação e o gerenciamento de Buckets do Couchbase.

var configuration = new ClientConfiguration();

using (var cluster = new Cluster(configuration))
{
    using (var bucket = cluster.OpenBucket("beer-sample"))
    {
        var manager = bucket.CreateManager("Administrator", "");
    }
}

var configuração = novo Configuração de cliente();

usando (var agrupamento = novo Aglomerado(configuração))

{

usando (var balde = agrupamento.OpenBucket("amostra de cerveja"))

{

var gerente = balde.Gerenciador de criação("Administrador", "");

}

O BucketManager é criado abrindo um objeto Bucket em uma instância do Cluster e passando a configuração correta para o seu ambiente.

Criação e eliminação de índices primários

Você pode criar índices primários nomeados e não nomeados chamando o método CreatePrimaryIndex e CreateNamedPrimaryIndex depois de ter a instância do BucketManager:

 //create an unamed primary index on the bucket
 var result = manager.CreatePrimaryIndex(false);

 //create a named primary index called "myprimaryindex" on the bucket
 var result = manager.CreateNamedPrimaryIndex("myprimaryindex", false);

//criar um índice primário não nomeado no bucket

var resultado = gerente.CreatePrimaryIndex(falso);

//criar um índice primário nomeado chamado "myprimaryindex" no bucket

var resultado = gerente.CreateNamedPrimaryIndex("myprimaryindex", falso);

Observe que você está sempre trabalhando com o contexto do bucket que abriu. Portanto, esses índices serão criados no bucket "beer-sample" que abrimos anteriormente. Além disso, observe que esses dois métodos usam um campo booleano chamado "defer"; na verdade, como você verá, todos os métodos de criação contêm um parâmetro "defer". Se "defer" for verdadeiro, o índice será criado, mas não será construído até que o método BuildDeferredIndexes seja chamado. Mais informações sobre os índices diferidos mais adiante!

Eliminar um índice primário nomeado ou não nomeado é praticamente o mesmo que criar um índice, com exceção dos nomes dos métodos:

//drop the primary index for the bucket
var result = manager.DropPrimaryIndex();

//drop a named primary index on the bucket
var result = manager.DropNamedPrimaryIndex("myprimaryindex");

//drop o índice primário para o bucket

var resultado = gerente.DropPrimaryIndex();

//drop um índice primário nomeado no bucket

var resultado = gerente.DropNamedPrimaryIndex("myprimaryindex");

Observe que, se o índice não existir, result.Success será falso.

Criação e eliminação de índices secundários

A criação e o descarte de índices secundários são semelhantes aos índices primários, exceto pelo fato de que você também pode indexar em um ou mais campos.

//create a secondary index called "myindex" on the "id" and "name" fields.
var result = manager.CreateIndex("myindex", true, "id", "name");

//drop the index called "myindex"
var result = manager.DropIndex("myindex");

//criar um índice secundário chamado "myindex" nos campos "id" e "name".

var resultado = gerente.Criar índice("myindex", verdadeiro, "id", "name" (nome));

//drop o índice chamado "myindex"

var resultado = gerente.Índice de gotas("myindex");

Observe que, nesse caso, estou passando "true" para que a criação do índice seja adiada. Além disso, se o índice já existir ou se ele não existir e você tentar removê-lo, result.Success será falso.

Atualizações na API do subdocumento

Esta versão também contém alterações internas na API SubDocument lançada como Developer Preview na versão 2.2.6. Foram adicionados dois grandes aprimoramentos relacionados ao desempenho:

Se uma única mutação ou operação de pesquisa for executada, o SDK usará uma única operação, em vez de uma operação múltipla que economiza alguns bytes na conexão.
A desserialização do corpo da resposta é adiada até que você chame o Content

Além dessas alterações, outro novo recurso foi incluído na versão por meio de uma contribuição do comunidade: Navegação de expressão lambda para caminhos de subdocumentos. Esse recurso permite que você use a sintaxe familiar com suporte ao intellisense e à segurança de tipos que você aprecia no linq, em vez de apenas passar caminhos de string.

Supondo um documento que se pareça com:

{
  "name": "21st Amendment Brewery Cafe",
  "city": "San Francisco",
  "state": "California",
  "code": "94107",
  "country": "United States",
  "phone": "1-415-369-0900",
  "website": "http://www.21st-amendment.com/",
  "type": "brewery",
  "updated": "2010-10-24 13:54:07",
  "description": "The 21st Amendment Brewery offers a variety of award winning house made brews and American grilled cuisine in a comfortable loft like setting. Join us before and after Giants baseball games in our outdoor beer garden. A great location for functions and parties in our semi-private Brewers Loft. See you soon at the 21A!",
  "address": [
    "563 Second Street"
  ],
  "geo": {
    "accuracy": "ROOFTOP",
    "lat": 37.7825,
    "lon": -122.393
  }
}

{

"name" (nome): "Café da Cervejaria 21ª Emenda",

"cidade": "São Francisco",

"estado": "Califórnia",

"código": "94107",

"país": "Estados Unidos",

"telefone": "1-415-369-0900",

"website": "http://www.21st-amendment.com/",

"tipo": "cervejaria",

"atualizado": "2010-10-24 13:54:07",

"description" (descrição): "A 21st Amendment Brewery oferece uma variedade de cervejas artesanais premiadas e cozinha americana grelhada em um ambiente confortável como um loft. Junte-se a nós antes e depois dos jogos de beisebol do Giants em nossa cervejaria ao ar livre. Um ótimo local para eventos e festas em nosso Brewers Loft semiprivado. Vejo você em breve no 21A!",

"endereço": [

"563 Second Street"

"geo": {

"precisão": "ROOFTOP",

"lat": 37.7825,

"longo": -122.393

}

Em seguida, você recupera o valor no caminho "geo.accuracy" da seguinte forma:

var key = "21st_amendment_brewery_cafe";
var lookup = bucket.LookupIn(key).
    Get(x =&gt; x.Geo.Accuracy).
    Execute();

var value = lookup.Content(x=&gt;x.Geo.Accuracy);
Assert.AreEqual("ROOFTOP", value);

var chave = "21st_amendment_brewery_cafe";

var pesquisa = balde.Pesquisa(chave).

Obter(x => x.Geo.Precisão).

Executar();

var valor = pesquisa.Conteúdo(x=>x.Geo.Precisão);

Afirmar.AreEqual("ROOFTOP", valor);

É claro que você poderia encadear vários "Gets" para recuperar cada elemento individual do documento.

Notas de versão da v2.2.7

Bug

[NCBC-1099] - Adicionar atributo DataContract às classes Error, Warning e Metrics

Melhoria

[NCBC-1103] - Suporte para operações assíncronas em subdocumentos
[NCBC-994] - Atualizar o ambiente de desenvolvimento e os projetos para o VS2015
[NCBC-1089] - Aguardar todos os caminhos de código não bem-sucedidos
[NCBC-1095] - Não tentar novamente com NodeUnavailableException

Novo recurso

[NCBC-1067] - Estender o BucketManager para oferecer suporte ao gerenciamento de índices
[NCBC-1093] - Incluir suporte para a API de subdocumentos - Comandos únicos da Parte 2 DP2

Como obter a versão 2.2.7

Faça o download dos binários aqui.
O pacote NuGet pode ser encontrado aqui.
O repositório do Github é aqui.

Jeff Morris, engenheiro de software sênior, Couchbase

Platform

Self-Managed

Services

Capabilities

Why Couchbase?

Migrate to Capella

By Use Case

By Industry

By Application Need

Popular Docs

By Developer Role

Quickstart

Resource Center

About

Partnerships

Our Services

Partners: Register a Deal

Ready to register a deal with Couchbase?

Marriott

Todas as publicações

O Couchbase.NET SDK v2.2.7 com visualização para desenvolvedores do gerenciamento de índices já está disponível!

O Couchbase.NET SDK v2.2.7 com visualização para desenvolvedores do gerenciamento de índices já está disponível!

Gerenciamento de índices

Criação e eliminação de índices primários

Criação e eliminação de índices secundários

Atualizações na API do subdocumento

Expressões Lambda para navegação no caminho do subdocumento

Notas de versão da v2.2.7

Bug

Melhoria

Novo recurso

Como obter a versão 2.2.7

Autor

Postado por Jeff Morris, engenheiro de software sênior, Couchbase

Deixar uma resposta Cancelar resposta