{"id":13147,"date":"2022-04-26T20:13:45","date_gmt":"2022-04-27T03:13:45","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=13147"},"modified":"2025-06-13T23:04:15","modified_gmt":"2025-06-14T06:04:15","slug":"build-a-python-microservice-with-couchbase-part-3","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/build-a-python-microservice-with-couchbase-part-3\/","title":{"rendered":"Crie um microsservi\u00e7o Python com o Couchbase - Parte 3"},"content":{"rendered":"

Recapitula\u00e7\u00e3o<\/span><\/h2>\n

Nas duas parcelas anteriores de esta s\u00e9rie<\/a>Na se\u00e7\u00e3o \"A arquitetura de microsservi\u00e7os\", discutimos os motivadores por tr\u00e1s da cria\u00e7\u00e3o de microsservi\u00e7os. Tamb\u00e9m analisamos por que o Couchbase \u00e9 o reposit\u00f3rio de dados perfeito para ser usado com essa arquitetura. Tamb\u00e9m analisamos tr\u00eas variantes de um exemplo de microsservi\u00e7o de perfil de usu\u00e1rio. Duas foram escritas em Python e uma foi escrita em Node.js para compara\u00e7\u00e3o. Nesta \u00faltima parte da s\u00e9rie, discutiremos um m\u00e9todo para gerar dados de teste para o esquema de microsservi\u00e7o. <\/span><\/p>\n

Por que usar dados de teste?<\/span><\/h2>\n

Testes rigorosos s\u00e3o essenciais para o lan\u00e7amento de um software est\u00e1vel. Muitos elementos fazem parte de uma boa estrat\u00e9gia de teste. Na \u00faltima d\u00e9cada, o termo \"DevOps\" \u00e9 frequentemente usado para fazer refer\u00eancia tanto aos conjuntos de ferramentas usados no desenvolvimento e teste de software quanto \u00e0 cultura, aos processos e aos procedimentos que devem ser implementados para obter um desenvolvimento r\u00e1pido e \u00e1gil. Independentemente da terminologia, h\u00e1 um ponto em comum: automa\u00e7\u00e3o e orquestra\u00e7\u00e3o. Esses dois aspectos podem facilmente constituir sua pr\u00f3pria s\u00e9rie de blog, portanto, n\u00e3o nos deteremos muito neles, exceto para dizer que a gera\u00e7\u00e3o de dados de teste \u00e9 um aspecto essencial do DevOps e do desenvolvimento e teste \u00e1geis de software.<\/span><\/p>\n

Pessoalmente, ca\u00ed na armadilha de n\u00e3o ter um bom conjunto de dados de desenvolvimento. Por conveni\u00eancia, criei manualmente alguns dados que se encaixavam no esquema desejado para que eu pudesse fazer testes de unidade no c\u00f3digo. Mas, no dia seguinte, percebi que o c\u00f3digo que funcionava bem com meu pequeno conjunto de dados n\u00e3o funcionava muito bem quando era executado em um banco de dados de teste com milhares de registros e dados mais realistas.<\/span><\/p>\n

Gera\u00e7\u00e3o de dados JSON para testar o microsservi\u00e7o Python<\/span><\/h2>\n

H\u00e1 muitas maneiras de colocar os dados de teste em um banco de dados de teste ou de desenvolvimento. Um m\u00e9todo \u00e9 copiar e higienizar os dados de produ\u00e7\u00e3o, se poss\u00edvel. Pode n\u00e3o ser vi\u00e1vel ter c\u00f3pias completas da produ\u00e7\u00e3o para v\u00e1rios ambientes de desenvolvimento e teste, dependendo dos recursos dispon\u00edveis. As plataformas de banco de dados devem ser dimensionadas adequadamente e deve-se tomar cuidado para remover dados confidenciais por motivos de conformidade e seguran\u00e7a. C\u00f3pias completas de produ\u00e7\u00e3o devem ser um requisito para ambientes de teste de regress\u00e3o e pr\u00e9-produ\u00e7\u00e3o. A gera\u00e7\u00e3o de dados sint\u00e9ticos e aleat\u00f3rios com um conjunto m\u00ednimo de dados para teste e desenvolvimento de unidades geralmente \u00e9 adequada.<\/span><\/p>\n

Com um banco de dados relacional, pode ser um desafio criar uma inst\u00e2ncia de banco de dados com um subconjunto de tabelas porque os modelos relacionais normalmente exigem que todas as estruturas de dados estejam presentes. No entanto, com o formato de documento JSON do Couchbase, isso \u00e9 muito mais f\u00e1cil de fazer. Observando a amostra do microsservi\u00e7o, o esquema foi criado em torno dos escopos e cole\u00e7\u00f5es do Couchbase. Eles poderiam facilmente fazer parte de um esquema maior com mais cole\u00e7\u00f5es e escopos. Mas tudo o que precisamos s\u00e3o as cole\u00e7\u00f5es para acessar chaves, perfis de usu\u00e1rios e imagens de usu\u00e1rios, pois isso \u00e9 tudo o que o nosso exemplo de servi\u00e7o precisa acessar para funcionar.<\/span><\/p>\n

Na segunda parte da s\u00e9rie do blog, usamos o JMeter para fazer testes de desempenho. Para realizar testes de desempenho, o banco de dados deve ter pelo menos milhares de registros para fornecer ao JMeter um conjunto de dados razo\u00e1vel para a gera\u00e7\u00e3o de testes. O microsservi\u00e7o simplesmente obt\u00e9m elementos de perfil e os retorna por meio da API REST. O pressuposto \u00e9 que outros componentes do aplicativo consumam os dados e executem a l\u00f3gica comercial usando os resultados.<\/span><\/p>\n

Revisando as tr\u00eas cole\u00e7\u00f5es de perfis, veja a seguir um exemplo de um documento na cole\u00e7\u00e3o <\/span>dados_do_usu\u00e1rio<\/span> cole\u00e7\u00e3o. O servi\u00e7o n\u00e3o imp\u00f5e se o campo de imagem tem uma ID que faz refer\u00eancia a um registro de imagem. O servi\u00e7o apenas retorna os dados do perfil ou os dados da imagem. O pressuposto \u00e9 que o que quer que o consuma no sentido ascendente lidar\u00e1 com essa l\u00f3gica.<\/span><\/p>\n

{\r\n\u00a0\u00a0\"record_id\": 1,\r\n\u00a0\u00a0\"name\": \"Michael Jones\",\r\n\u00a0\u00a0\"nickname\": \"mjones\",\r\n\u00a0\u00a0\"picture\": \"\",\r\n\u00a0\u00a0\"user_id\": \"michaeljones2104\",\r\n\u00a0\u00a0\"email\": \"michael.jones@example.com\",\r\n\u00a0\u00a0\"email_verified\": \"True\",\r\n\u00a0\u00a0\"first_name\": \"Michael\",\r\n\u00a0\u00a0\"last_name\": \"Jones\",\r\n\u00a0\u00a0\"address\": \"0208 River Parkway\",\r\n\u00a0\u00a0\"city\": \"Strongdol\",\r\n\u00a0\u00a0\"state\": \"IL\",\r\n\u00a0\u00a0\"zip_code\": \"29954\",\r\n\u00a0\u00a0\"phone\": \"363-555-9036\",\r\n\u00a0\u00a0\"date_of_birth\": \"10\/27\/1958\"\r\n}<\/pre>\n
A cole\u00e7\u00e3o user_images \u00e9 simples, com um ID de registro (que pode ser referenciado por um perfil de usu\u00e1rio), um campo de tipo de imagem para que v\u00e1rios codecs de imagem possam ser suportados e a pr\u00f3pria imagem codificada em Base64. Conforme observado na primeira postagem da s\u00e9rie, o Couchbase oferece suporte a documentos bin\u00e1rios, mas usamos o JSON por sua portabilidade e extensibilidade no aplicativo de amostra. Isso implica em um custo adicional de largura de banda de rede para obter os dados e os ciclos do processador para fazer a decodifica\u00e7\u00e3o.<\/p>\n
{\r\n\u00a0\u00a0\"record_id\": 1,\r\n\u00a0\u00a0\"type\": \"jpeg\",\r\n\u00a0\u00a0\"image\": \"AAAAD\u2026\"\r\n}<\/pre>\n
O b\u00e1sico <\/span>service_auth<\/span><\/em> cont\u00e9m o token de autentica\u00e7\u00e3o, mas pode ser facilmente ampliada para incluir outros campos de autentica\u00e7\u00e3o.<\/span><\/p>\n
{\r\n\u00a0\u00a0\"record_id\": 1,\r\n\u00a0\u00a0\"token\": \"6j6nW3KD0ZXodBv1\"\r\n}<\/pre>\n
Gera\u00e7\u00e3o de dados JSON de amostra aleat\u00f3ria<\/span><\/h3>\n
Escrevi um utilit\u00e1rio chamado <\/span>cb_perf<\/span> para gerar dados aleat\u00f3rios e inseri-los no Couchbase. O utilit\u00e1rio tamb\u00e9m faz alguns testes de desempenho para avaliar os recursos do Python em uma plataforma. Ferramentas como o YCSB usam um esquema irrealista, pois o \u00fanico objetivo \u00e9 avaliar o desempenho bruto. Eu queria ter a capacidade de pegar um JSON arbitr\u00e1rio e inseri-lo com dados sint\u00e9ticos aleat\u00f3rios.<\/span><\/p>\n
Para testar o microsservi\u00e7o de amostra, adicionei o esquema a <\/span>cb_perf<\/span> para que eu pudesse gerar conjuntos de dados de teste em qualquer cluster do Couchbase. Os <\/span>cb_perf<\/span> O utilit\u00e1rio JSON usa um arquivo de defini\u00e7\u00e3o de esquema JSON. Para cada cole\u00e7\u00e3o, voc\u00ea define a estrutura de dados JSON.\u00a0<\/span><\/p>\n
Voc\u00ea pode especificar express\u00f5es Jinja2 com vari\u00e1veis que mapeiam os tipos de dados do randomizador para cada valor JSON. Dessa forma, cada registro ser\u00e1 diferente. Voc\u00ea tamb\u00e9m pode definir quais \u00edndices criar. Nesse caso, criamos um \u00edndice prim\u00e1rio e \u00edndices secund\u00e1rios em alguns campos.\u00a0<\/span><\/p>\n
Ela especifica que <\/span>id_registro<\/span><\/em> \u00e9 um campo de ID e que a contagem geral de registros solicitada n\u00e3o deve ser substitu\u00edda (para que possamos criar quantos registros quisermos).<\/span><\/p>\n
{\r\n\"name\": \"user_data\",\r\n\"schema\": {\r\n\u00a0\u00a0\"record_id\": \"record_id\",\r\n\u00a0\u00a0\"name\": \"{{ rand_first }} {{ rand_last }}\",\r\n\u00a0\u00a0\"nickname\": \"{{ rand_nickname }}\",\r\n\u00a0\u00a0\"picture\": \"\",\r\n\u00a0\u00a0\"user_id\": \"{{ rand_username }}\",\r\n\u00a0\u00a0\"email\": \"{{ rand_email }}\",\r\n\u00a0\u00a0\"email_verified\": \"{{ rand_bool }}\",\r\n\u00a0\u00a0\"first_name\": \"{{ rand_first }}\",\r\n\u00a0\u00a0\"last_name\": \"{{ rand_last }}\",\r\n\u00a0\u00a0\"address\": \"{{ rand_address }}\",\r\n\u00a0\u00a0\"city\": \"{{ rand_city }}\",\r\n\u00a0\u00a0\"state\": \"{{ rand_state }}\",\r\n\u00a0\u00a0\"zip_code\": \"{{ rand_zip_code }}\",\r\n\u00a0\u00a0\"phone\": \"{{ rand_phone }}\",\r\n\u00a0\u00a0\"date_of_birth\": \"{{ rand_dob_1 }}\"\r\n\u00a0\u00a0},\r\n\"idkey\": \"record_id\",\r\n\"primary_index\": true,\r\n\"override_count\": false,\r\n\"indexes\": [\r\n\u00a0\u00a0\"record_id\",\r\n\u00a0\u00a0\"nickname\",\r\n\u00a0\u00a0\"user_id\"\r\n\u00a0\u00a0]\r\n},<\/pre>\n
Aproveitamos o cb_perf<\/em> para a cole\u00e7\u00e3o de imagens para criar uma imagem JPEG aleat\u00f3ria (ele cria um mapa aleat\u00f3rio de valores RGB para criar uma imagem de cores aleat\u00f3rias). Definimos o seguinte:<\/p>\n