Objetivos

1. Abra o painel do IBM Cloudant.
2. Criar um banco de dados.
3. Inclua documentos JSON no banco de dados e execute uma consulta.
4. Replique um banco de dados.
5. Monitore tarefas ativas.
6. Monitore com o IBM Cloudant.

Antes de Iniciar

Crie uma instância de serviço no IBM Cloud antes de iniciar este tutorial. É possível seguir as instruções no tutorial de Introdução para criar uma.

Abrindo a sua instância de serviço no painel do IBM Cloudant

Abra sua instância de serviço IBM Cloudant seguindo estas etapas:

1. Acesse o painel da IBM Cloud.

2. Clique em Serviços na lista Recursos.

3. Na seção Serviços, clique na instância Cloudant-o7 que você criou no tutorial Introdução e clique em Ativar Painel. O painel do IBM Cloudant é aberto.

Agora, você pode criar um banco de dados e executar consultas nele.

Criando um banco de dados

Neste exercício, você criará o banco de dados dashboard-demo, que é o banco de dados que você usará neste tutorial.

1. No painel do IBM Cloudant, clique em Criar banco de dados.

   A janela Criar banco de dados é aberta.

2. Insira o nome do banco de dados dashboard-demo.

3. Selecione Não particionado e clique em Criar.

   O banco de dados dashboard-demo é aberto automaticamente.

Agora, é possível criar alguns documentos.

Incluindo documentos no banco de dados

Os documentos que você cria neste exercício incluem os dados que você usa para consultar o banco de dados dashboard-demo em exercícios posteriores.

1. Clique em Criar documento.

   A janela Novo documento é aberta.

2. Copie o texto de amostra a seguir e substitua o texto existente no novo documento. Use o texto de amostra a seguir para o documento 1:

   {
     "firstname": "Sally",
     "lastname": "Brown",
     "age": 16,
     "location": "New York City, NY",
     "_id": "doc1"
   }
   

3. Repita as etapas 1 e 2 para incluir os quatro documentos restantes no banco de dados. Use o texto de amostra a seguir para o documento 2:

   {
     "firstname": "John",
     "lastname": "Brown",
     "age": 21,
     "location": "New York City, NY",
     "_id": "doc2"
   }
   

   Use o texto de amostra a seguir para o documento 3:

   {
     "firstname": "Greg",
     "lastname": "Greene",
     "age": 35,
     "location": "San Diego, CA",
     "_id": "doc3"
   }
   

   Use o texto de amostra a seguir para o documento 4:

   {
     "firstname": "Anna",
     "lastname": "Greene",
     "age": 44,
     "location": "Baton Rouge, LA",
     "_id": "doc4"
   }
   

   Use o texto de amostra a seguir para o documento 5:

   {
     "firstname": "Lois",
     "lastname": "Brown",
     "age": 33,
     "location": "New York City, NY",
     "_id": "doc5"
   }
   

   Você preencheu o dashboard-demo com cinco documentos. É possível ver os documentos na visualização de Tabela na captura de tela a seguir:

   

Replicando um banco de dados

Quando você replica um banco de dados, ele sincroniza o estado de dois bancos de dados: origem e destino. Uma replicação copia todas as mudanças que aconteceram no banco de dados de origem para o banco de dados de destino. Quando um documento for excluído do banco de dados de origem, também será excluído do banco de dados de destino.

Para obter mais informações, consulte Replicação.

1. Clique em Replicação.

2. Clique em Nova replicação.

   A página Configuração da tarefa é aberta.

   Além disso, é possível criar uma replicação na página de bancos de dados, clicando em Replicar na coluna Ações.

3. Insira as informações a seguir para a sua tarefa de replicação. Use as informações a seguir na seção Origem:

   • Tipo - Selecione Banco de dados remoto.
   • Nome - Insira a URL do banco de dados: $SERVICE_URL/query-movies.
   • Autenticação - Deixe como None.

   Use as informações a seguir na seção Destino:

   • Tipo - Selecione Novo banco de dados local.
   • Novo banco de dados - Insira o nome para o novo banco de dados, query-movies.
   • Novas opções do banco de dados - Não selecione a opção Particionado.
   • Autenticação - Selecione Autenticação do IAM.
   • Chave de API do IAM - Insira a apikey das Credenciais de serviço para a sua instância.

   Para obter mais informações, consulte a seção em Localizando suas credenciais de serviço.

   Use as informações a seguir na seção Opções:

   • Tipo de replicação - Deixe como One time.
   • Documento de replicação - Deixe como Custom ID (optional.

   

4. Clique em Iniciar replicação.

   A página Replicação é aberta, na qual é possível ver se sua tarefa de replicação está em execução.

   

5. Consulte o status quando seu job finalizar a mudança para Concluído.

6. Verifique se o banco de dados foi criado na página de bancos de dados.

   

Monitorando tarefas ativas

A página Tarefas ativas exibe uma lista de todas as tarefas em execução. Ao monitorar o desempenho de seu sistema, essa lista pode ajudá-lo a localizar problemas potenciais. É possível ver uma lista de tarefas ativas, que inclui compactação, replicação e indexação. Para obter mais informações, consulte o guia Gerenciando tarefas.

Se a sua instância não tiver nenhuma tarefa ativa, é possível retornar à etapa anterior, excluir o banco de dados query-movies e replicá-lo novamente. Se você abrir a página Tarefas ativas imediatamente, poderá ver a sua replicação.

1. Clique em Tarefas ativas.

   A página Tarefas ativas é aberta.

   

2. Clique na guia associada para ver informações específicas da tarefa.

Monitoramento com o IBM Cloudant

Monitore seu uso com um gráfico que mostra o seu rendimento por leituras, gravações e consultas globais. É possível ver suas operações atuais, solicitações negadas e uso de armazenamento.

A sua instância de serviço não contém dados porque é apenas para fins demonstrativos. No entanto, você pode ver quais informações de monitoramento estão disponíveis seguindo estas etapas:

1. Clique em Monitoramento.

   A página Monitoramento é aberta para a guia Operações atuais. Revise o consumo recente de capacidade de rendimento provisionada consultando as solicitações divididas por leituras, gravações e consultas globais. A linha pontilhada é a capacidade de pico que é permitida para sua instância. A capacidade de pico é baseada no que está configurado para a sua capacidade de rendimento provisionada.

   

2. Clique em Solicitações negadas.

   Revise o número de solicitações negadas de um determinado segundo que são mostradas pelo número de respostas 429: too many requests. As solicitações são negadas quando excedem a capacidade de rendimento provisionada configurada para a instância. O gráfico mostra as solicitações negadas que são divididas por leituras, gravações e consultas globais.

   

3. Clique em Armazenamento.

   Revise periodicamente seu armazenamento, para que você esteja preparado caso o fornecimento de seu plano precise ser mudado.

   

Para obter mais informações, consulte Planos e fornecimentos.