Banco de dados SQL para dados de nuvem

Objetivos

• Provisionar um banco de dados SQL
• Criar o esquema de banco de dados (tabela) e carregar dados
• Implementar um app de contenção pré-construído para Code Engine
• Conectar o serviço de app e de banco de dados (compartilhar credenciais)
• Monitor, Seguro, Backup e Recuperação de bancos de dados em nuvem

Antes de Iniciar

Este tutorial requer:

• IBM Cloud CLI com o plugin Code Engine,
• git para clonar o repositório de código-fonte.

Para evitar a instalação dessas ferramentas, use o Cloud Shell no console IBM Cloud.

Você encontrará instruções para fazer download e instalar essas ferramentas para o seu ambiente operacional no guia Introdução aos tutoriais.

1. Clone o repositório Github para este tutorial e mude em seu diretório. Em um terminal, execute as linhas a seguir:

   git clone https://github.com/IBM-Cloud/cloud-sql-database.git
   cd cloud-sql-database
   

2. Acesse GeoNames e faça o download e extraia o arquivo cities1000.zip Ele contém informações sobre cidades com uma população de mais de 1000. Você vai usá-lo como conjunto de dados.

Provisionar o banco de dados SQL

Comece criando uma instância do serviço IBM Db2 Warehouse SaaS.

1. Visite o console IBM Cloud®. Clique em Catálogo na barra de navegação superior.
2. Clique em Bancos de dados na área de janela esquerda e selecione Db2 Warehouse.
3. Escolha o plano Flex Um e mude o nome do serviço sugerido para sqldatabase (você usará esse nome posteriormente). Escolha um grupo de recursos e um local para a implementação do banco de dados.
4. Clique em Criar. O fornecimento é iniciado.
5. Na Lista de recursos, localize a nova instância em Bancos de dados e aguarde até que ela esteja disponível (às vezes, pode ser necessário atualizar a página). Clique na entrada para o seu serviço do IBM Db2 Warehouse SaaS.
6. Clique em Abrir console para ativar o console do banco de dados.

Criar uma tabela

Você precisa de uma tabela para conter os dados de amostra. Crie-a usando o console.

1. No console de IBM Db2 Warehouse SaaS, clique no ícone do menu superior esquerdo e, em seguida, em Run SQL na barra de navegação.
2. Clique no símbolo + (Adicionar um novo script) ao lado da guia Untitled-1.
3. Clique em Do arquivo e selecione o arquivo cityschema.txt no repositório GitHub que foi clonado anteriormente para o seu diretório local e abra-o.
4. Clique em Executar todos para executar a instrução. Deverá ser mostrada uma mensagem de sucesso.

Carregar dados

Agora que a tabela "cidades" foi criada, você carregará dados nela. Isso pode ser feito de diferentes maneiras, por exemplo, a partir de sua máquina local ou do armazenamento de objetos na nuvem (COS) ou da interface Amazon S3. Para este tutorial, você fará upload de dados de sua máquina. Durante esse processo, você adaptará a estrutura de tabela e o formato de dados para corresponder totalmente ao conteúdo do arquivo.

1. No console para IBM Db2 Warehouse SaaS clique no ícone do menu superior esquerdo, em seguida, Dados na barra de navegação.

2. Como Origem, mantenha a seleção em Meu computador

3. Em Seleção de arquivo, clique em Arrastar um arquivo para cá ou procurar arquivos para localizar e escolher o arquivo cities1000.txt " que você baixou na primeira seção deste guia.

4. Clique em Avançar para obter a visão geral de Destino com uma seleção de Esquema Selecione o esquema BLUADMIN e, em seguida, a tabela CITIES. Clique em Avançar novamente.

   Como a tabela está vazia, ela não faz diferença para anexar ou sobrescrever dados existentes.

5. Agora, customize como os dados do arquivo "cities1000.txt" são interpretados durante o processo de carregamento. Primeiro, desative Cabeçalho na primeira linha porque o arquivo contém apenas dados.

6. Em seguida, digite 0x09 como separador. Isso significa que os valores dentro do arquivo são delimitados por tabulação.

7. Por último, selecione "AAAA-MM-DD" como formato de data. Agora, tudo deve ser semelhante ao que é mostrado nesta captura de tela.

   

8. Clique em Avançar e será oferecido a você para revisar as configurações de carregamento. Concorde e clique em Iniciar carregamento para iniciar o carregamento dos dados na tabela CITIES. O progresso é exibido. Quando os dados forem transferidos por upload, deverá levar somente alguns segundos até que o carregamento seja concluído e algumas estatísticas sejam apresentadas.

9. Clique em Visualizar tabela para procurar os dados. É possível rolar para baixo ou clicar em nomes de coluna para mudar a ordem de classificação.

Verificar dados carregados usando SQL

Os dados foram carregados no banco de dados relacional. Não houve nenhum erro, mas é necessário executar alguns testes rápidos de qualquer maneira. Use o editor de SQL integrado para digitar e executar algumas instruções SQL.

1. Na navegação à esquerda, clique em Run SQL para voltar ao editor SQL. Clique no símbolo + (Incluir novo script) e em Criar novo para criar uma nova guia do editor.

   Em vez do editor de SQL integrado, é possível usar ferramentas SQL baseadas em nuvem e tradicionais em seu desktop ou máquina servidor com o IBM Db2 Warehouse SaaS. As informações de conexão podem ser encontradas no menu Administração na navegação esquerda.

2. No tipo de editor ou copie na consulta a seguir:

   select count(*) from cities;
   

   Selecione o texto da consulta, então, em dropdown ao lado de Run All, escolha Run selecionada. Na seção de resultados, deve ser mostrado o mesmo número de linhas informado pelo processo de carregamento.

3. No "Editor de SQL", insira a instrução a seguir em uma nova linha:

   select countrycode, count(name) from cities
   group by countrycode
   order by 2 desc;
   

   Marque o texto da instrução acima e clique no botão Executar selecionado. Somente essa instrução é executada, retornando algumas estatísticas por país na seção de resultados.

4. Por fim, execute a seguinte instrução similarmente para recuperar detalhes sobre San Francisco na Califórnia:

   select * from cities
   where name='San Francisco'
   and countrycode='US';
   

Implementar o código do aplicativo

Mude de volta para o terminal. Agora você vai implantar o código do aplicativo, usando uma imagem de contêiner pré-construído. Você pode modificar o código do aplicativo e construir a imagem do contêiner por conta própria. Veja as instruções no repositório GitHub para obter detalhes.

1. Se você não estiver conectado, use ibmcloud login ou ibmcloud login --sso para fazer login interativamente. Configure a região e o grupo de recursos para onde o banco de dados foi provisionado. Substitua RESOURCE_GROUP e REGION adequadamente.

   ibmcloud target -g RESOURCE_GROUP -r REGION
   

2. Crie um projeto novo Code Engine denominado sqldatabase:

   ibmcloud ce project create --name sqldatabase
   

   Selecione o novo projeto como o ativo:

   ibmcloud ce project select --name sqldatabase
   

3. Em seguida, implemente o aplicativo, nomeando-o como worldcities.

   ibmcloud ce app create --name worldcities --image icr.io/solution-tutorials/tutorial-cloud-sql-database:latest --min-scale 1
   

4. Por último, crie uma ligação de serviço entre o banco de dados existente IBM Db2 Warehouse SaaS e o app:

   ibmcloud ce application bind --name worldcities --service-instance sqldatabase
   

   Uma vez que a ligação é criada, uma nova revisão do app é iniciada.

5. Agora você pode verificar os detalhes do aplicativo para saber o status e recuperar o URL:

   ibmcloud ce app get --name worldcities
   

   Na saída, procure a linha que começa com URL. O URL mostrado deve ter um padrão como https://worldcities.unique-subdomain.region.codeengine.appdomain.cloud. Clique no link para acessar o app. Outra opção para recuperar detalhes do aplicativo é visitar o console Code Engine.

Segurança, Backup & Recuperação, Monitoramento

O IBM Db2 Warehouse SaaS é um serviço gerenciado. A IBM cuida de proteger o ambiente, os backups diários e o monitoramento do sistema. Quando você estiver usando um dos planos corporativos existem várias opções para gerenciar o acesso e para configurar a criptografia avançada de dados.

Além das opções de administração tradicionais, o serviço IBM Db2 Warehouse SaaS também oferece uma API REST para monitoramento, gerenciamento de usuários, utilitários, carregamento, acesso de armazenamento e mais.

Testar o app

O app para exibir informações de cidade com base no conjunto de dados carregado é reduzido para um mínimo. Ele oferece um formulário de pesquisa para especificar um nome de cidade - os nomes fazem distinção entre maiúsculas e minúsculas - e algumas cidades pré-configuradas. Eles são convertidos em /search?name=cityname (formulário de procura) ou /city/cityname (cidades especificadas diretamente). Ambas as solicitações são entregues por meio das mesmas linhas de código em segundo plano. O endereço cityname é passado como valor para uma instrução SQL preparada usando um marcador de parâmetro por motivos de segurança. As linhas são buscadas do banco de dados e passadas para um modelo HTML para renderização.

Limpeza

Para limpar os recursos usados pelo tutorial, siga estas etapas:

1. Visite o IBM Cloud® Lista de Recursos.
2. Na seção Code Engine localize o projeto sqldatabase. Clique nos três pontinhos e selecione Excluir para excluir o projeto e seu app.
3. Localize o banco de dados sqldatabase sob Bancos de Dados. Novamente, clique nos três pontinhos e selecione Excluir para excluir o banco de dados.

Dependendo do recurso, ele não é excluído imediatamente, mas retido (por padrão por 7 dias). É possível recuperar o recurso excluindo-o permanentemente ou restaurando-o dentro do período de retenção. Consulte este documento sobre como usar a recuperação de recurso.

Expandir o tutorial

Deseja ampliar esse app? Aqui estão algumas ideias:

1. Ofereça uma procura de caracteres curinga nos nomes alternativos.
2. Procure cidades de um país específico e somente dentro de um determinado valor de população.
3. Mude o layout da página, substituindo os estilos CSS e ampliando os modelos.
4. Permitir a criação de novas informações sobre a cidade com base em formulários ou permitir atualizações de dados existentes, por exemplo, população.

Conteúdo relacionado

• Documentação: Descrição da API para o driver ibm_db Python
• Db2 Data Management Console
• Db2 on Cloud