Couchbase Mobile Part 2: Couchbase Lite Views (Indexes!)

Este blog foi publicado originalmente no site do blog pessoal de Roi Katz. Por favor clique aqui para encontrar a postagem original.

No Parte 1 Criamos nosso aplicativo pequeno, porém interessante, e até o replicamos em outro Couchbase Lite.

Mas e agora? Queremos usá-lo de fato!

Então, como usamos um banco de dados? Bem, pelo menos para "obter" os dados, você tem algumas opções:

Obter por chave primária
Obter por um índice (ou "selecioná-lo" onde x)

Até agora, em nosso aplicativo de exemplo simples, só podíamos usar a "chave primária" para acessar nossos dados e recuperá-los.

Mas essa não é a única maneira de obter dados do Couchbase Lite.

Nesta parte, aprenderemos os conceitos básicos da indexação do Couchbase Lite. Também conhecido como Views.

Nas exibições, executamos nossas consultas.

Portanto, precisamos:

Criar visualização
Executar consultas na exibição
Obter os resultados

Criaremos nosso caso de uso - de como usar "exibições" no Couchbase Lite.

Inicie um novo projeto WPF.

Adicionar o pacote Nuget Couchbase.Lite

Copie esse XAML

   
     
       
         
         
       
       
         
         
       
       
       <button></button>  
       <button></button>  
       <button></button>  
       
       
         
          
       
       
       <button></button>

<botão></botão>

O que se traduz em

A GUI é gerada a partir do XAML acima

Depois de obter a interface de usuário básica, que você poderá explorar mais tarde (nada de mais aqui, na verdade), vamos ao código propriamente dito.

Depois de iniciarmos tudo e inicializarmos o banco de dados, vamos definir nossas exibições.

Nesse caso, defini uma visualização, apenas para mostrar como configurar as coisas.

     private void GenerateViews()  
     {  
       var docsByCity = _database.GetView("docs_by_city");  
       docsByCity.SetMap((doc, emit) =&gt;  
       {  
         if (doc.ContainsKey("City"))  
         {  
           emit(doc["City"], doc);  
         }  
       }, "1");  
     }

privado vazio Gerar visualizações()

{

var docsByCity = _database.Obter visualização("docs_by_city");

docsByCity.SetMap((doc, emitir) =>

{

se (doc.Contém a chave("Cidade"))

{

emitir(doc["Cidade"], doc);

}

}, "1");

}

O que você pode ver aqui é que, depois de recuperar um nome do _database, posso definir um mapa sobre ele.

No exemplo acima, criei uma exibição chamada "docs_by_city", atribuí um delegado, verifiquei se alguma chave ("City") existia e, em seguida, a emiti para o índice. Simples assim.

Acabamos de criar nosso índice que, para cada documento, contém uma propriedade chamada City (Cidade) - ele emite o documento inteiro, mas você pode optar por emitir o que quiser, dependendo dos requisitos do aplicativo.

Ele pode ser ajustado para melhor desempenho e menor tamanho de índice.

Além disso, você pode colocar como chave qualquer string que desejar ou compor seu índice a partir de várias propriedades para atender a necessidades especiais.

Nunca é bom armazenar o documento inteiro no índice, pois isso basicamente cria uma cópia do documento dentro do índice. Tente manter seu índice o menor possível. No entanto, se você precisar de algum tipo de índice que tenha o documento inteiro como resultado, por uma questão de desempenho, é melhor manter o documento no índice em vez de acessar a propriedade result.Document - para evitar algumas viagens de ida e volta ao banco de dados.

O número "1" aqui é a versão do índice. Durante o desenvolvimento, se você alterar a função de mapa, também precisará incrementar esse número (caso não tenha excluído todo o banco de dados) para reconstruir o índice.

Há duas consultas especiais.

Obter a contagem de todos os documentos. (com _database.DocumentCount)
Obter todos os documentos. (com _database.CreateAllDocumentsQuery())

Depois de definirmos nossa visualização (*index), podemos começar a escrever o código e usá-lo.

O uso é bastante simples, com apenas 5 etapas.
Obter a visualização
Criar uma consulta na exibição
Defina seus critérios no índice
Execute-o
Leia

No código, isso parece ainda mais simples:

      private void GetByCityClick(object sender, RoutedEventArgs e)  
     {  
       var docsByCity = _database.GetView("docs_by_city");  
       var query = docsByCity.CreateQuery();  

       query.StartKey = City;  
       query.EndKey = City;  

       var queryResults = query.Run();  
       MessageBox.Show(string.Format("{0} documents has been retrieved for that query", queryResults.Count));

       if (queryResults.Count == 0) return;  

       var documents = queryResults.Select(result =&gt; JsonConvert.SerializeObject(result.Value, Formatting.Indented)).ToArray();  
       var commaSeperaterdDocs = "[" + string.Join(",", documents) + "]";  

       DocumentText = commaSeperaterdDocs;  
     }

privado vazio GetByCityClick(objeto remetente, RoutedEventArgs e)

{

var docsByCity = _database.Obter visualização("docs_by_city");

var consulta = docsByCity.Criar Consulta();

consulta.StartKey = Cidade;

consulta.EndKey = Cidade;

var resultados da consulta = consulta.Executar();

Caixa de mensagem.Mostrar(string.Formato("{0} documentos foram recuperados para essa consulta", resultados da consulta.Contagem));

se (resultados da consulta.Contagem == 0) retorno;

var documentos = resultados da consulta.Selecione(resultado => JsonConvert.SerializeObject(resultado.Valor, Formatação.Recuado)).ToArray();

var commaSeperaterdDocs = "[" + string.Aderir(",", documentos) + "]";

DocumentText = commaSeperaterdDocs;

}

Quero a "Cidade" exata, por isso escrevi na chave inicial e final o mesmo valor.

Executo a consulta e verifico se há algum resultado.

Em seguida, eu "embelezo" o resultado (para cada valor) e o retorno como uma matriz JSON.

Preste atenção que não estou usando result.Document, mas result.Value, pois o uso de result.Document não usará o índice e consultará o banco de dados para cada resultado.

Portanto, para melhorar o desempenho, use result.key, result.value ou result.DocumentId.

Agora é só adicionar essa parte para gerar alguns dados...

   private void InsertSomeDataClick(object sender, RoutedEventArgs e)  
     {  
       var result = MessageBox.Show("Press Yes to insert some data (10 docs)!", "Confirm", MessageBoxButton.YesNo);  
       if (result == MessageBoxResult.Yes)  
       {  
         var count = _database.DocumentCount;  
         string[] cities = { "London", "New York", "Tel Aviv" };  
         var rnd = new Random();  
         for (int i = 0; i &lt; 10; i++)  
         {  
           var id = "document" + (i + count);  
           var cityIndex = rnd.Next(0, 3);  
   
           var properties = new Dictionary&lt;string, string&gt;();  
           properties.Add("name", "Roi Katz");  
           properties.Add("City", cities[cityIndex]);  
             
           var doc = JsonConvert.SerializeObject(properties);  
           InsertDocument(id, doc);  
         }   
         MessageBox.Show("10 Records inserted");  
       }  
     }

privado vazio InsertSomeDataClick(objeto remetente, RoutedEventArgs e)

{

var resultado = Caixa de mensagem.Mostrar("Pressione Yes para inserir alguns dados (10 documentos)!", "Confirmar", MessageBoxButton.SimNão);

se (resultado == Resultado do MessageBox.Sim)

{

var contagem = _database.DocumentCount;

string[] cidades = { "Londres", "Nova York", "Tel Aviv" };

var rnd = novo Aleatório();

para (int i = 0; i < 10; i++)

{

var id = "document" (documento) + (i + contagem);

var índice da cidade = rnd.Próximo(0, 3);

var propriedades = novo Dicionário<string, string>();

propriedades.Adicionar("name" (nome), "Roi Katz");

propriedades.Adicionar("Cidade", cidades[índice da cidade]);

var doc = JsonConvert.SerializeObject(propriedades);

InserirDocumento(id, doc);

}

Caixa de mensagem.Mostrar("10 registros inseridos");

}

E estamos prontos para ir!

É assim que fazemos uma visualização simples!

É claro que teremos mais informações sobre as visualizações do Couchbase lite, mas isso é apenas o começo.

É claro que precisamos criar as propriedades adequadas, portanto, para obter o projeto completo, consulte meu GitHub página.

Roi Katz, arquiteto de soluções, Couchbase

Um comentário

kpal abril 18, 2018 em 4:07 am

O que é _database aqui? Estou tentando implementar as coisas acima em meu aplicativo nodeJs com o servidor couchbase e, uma vez, coloquei o nome do bucket no lugar de _database, mas não consegui fazer nada certo.

Acesse para responder

Deixar uma resposta Cancelar resposta

Você precisa fazer o login para publicar um comentário.

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

Couchbase Mobile Parte 2: visualizações do Couchbase Lite (índices!)

Autor

Postado por Roi Katz, arquiteto de soluções, Couchbase

Um comentário

Deixar uma resposta Cancelar resposta