Neste post pretendo mostrar como fazer o tratamento dos dados inseridos e atualizados no banco de dados. A idéia inicial é que o próprio mysql verifique alguns tipos de dados antes de aceitar a inserção ou alteração dos dados. Isso pode ser útil em empresas onde o DBA(Administrador de banco de dados) não é a mesma pessoa que vai programar o sistema, ou simplesmente quer garantir que todos os dados só entraram no banco se estiverem consistentes. Colocando as verificações diretamente no banco de dados, não dependemos do programa nos enviar dados já validados, não somos reféns do que vem da interface. Para o programador iremos retornar um erro “amigável” dizendo que o dado não foi inserido pois continha erro no campo X ou Y.

Para o exemplo estou disponibilizando para download aqui o script para criação e população de um banco de dados teste (Schema testes_roberson), nos outros posts relacionados a banco de dados também irei utilizar essa base, conforme eu for modificando a base vou atualizando o script de criação e publicando uma notificação de atualização aqui mesmo no blog.

A validação que vou mostrar é bem simples, mas pode dar uma idéia de como criar validações mais completas (pretendo ir colocando aos poucos outras validações mais complexas). Neste exemplo vou mostrar como criar uma Trigger para validar E-mail.

Primeiro faça o download do arquivo .zip onde você encontrará o arquivo testes_roberson.sql e o arquivo leiame.txt(algumas refências sobre o arquivo). Execute o arquivo sql em seu SGBD(Sistema Gerenciador de Banco de Dados), eu uso o MySQL Workbench Tools onde é possível administrar, interagir e modelar bases MySQL, mas pode utilizar qualquer SGBD de sua preferência.

Com o banco, tabelas e dados já criados agora vamos para a análise de possíveis validações que podemos fazer.

Fig. 01 - Modelagem Data Base testes_roberson (schema)

Olhando as tabelas podemos concluir que:

1. Trata-se de um banco simples (para estudos) de um cadastro de clientes.
2. Podemos criar uma rotina para validar CPF, E-mail e talvez ainda o CEP (validar se veio somente numeros e se são 8 caracteres)
3. Podemos criar tabelas de Cidades e Estados para evitar duplicidade de dados.

Nosso objetivo neste post é criar uma trigger para validar e permitir somente e-mails válidos. Segue a baixo código para criação da trigger.

-- Trigger DDL Statements
DELIMITER $$

-- Selecionamos o database desejado e criamos a trigger
-- Usando o BEFORE validamos o dado antes de inserir na tabela e AFTER depois de inserir na tabela
-- INSERT significa que a trigger será disparada quando ocorrer um INSERT na tabela, pode ser usado também o UPDATE e DELETE
USE `testes_roberson`$$CREATE DEFINER=`root`@`localhost` TRIGGER trgValidacaoEmail BEFORE INSERT ON clientes
  FOR EACH ROW BEGIN
    -- Verificamos se o NEW.Email (e-mail que está vindo no INSERT) é válido segundo a expressão regular usado com a função REGEXP
    IF (NOT EXISTS (SELECT NULL FROM Clientes WHERE  NEW.Email REGEXP '^[a-zA-Z0-9]{1}([\._a-zA-Z0-9-]+)(\.[_a-zA-Z0-9-]+)*@[a-z0-9-]+(\.[a-z0-9-]+){1,3}$')) THEN
        -- caso entre no IF disparamos um SELECT com nome de tabela inválido descrevendo o erro que será retornado.
        SELECT 0 FROM `Erro ao inserir dados! E-mail Inválido!` INTO @error;
    -- Fechamos o IF
    END IF;
  -- Fechamos a criação da trigger
  END$$

Com isso a validação já deve estar funcionar. É possível prever uma pequena “gambiarra” (prefiro chamar de ajuste técnico) somente olhando esse script. Quando tentarmos inserir um e-mail inválido ele irá nos retornar o seguinte erro:

Error Code: 1146
Table 'testes_roberson.Erro ao inserir dados! E-mail Inválido!' doesn't exist

Este erro está nos dizendo que a tabela ‘Erro ao inserir dados! E-mail Inválido!’ não existe nessa base de dados. Isso acontece devido ao fato de o nosso querido MySQL não ter nada expecífico para tratamento de erros ou de exceção (Exception). Isso realmente é muito triste, mas pelo menos estamos notificando ao usuário/programador que o dado não foi inserido e que o erro está no e-mail. Se tivermos a possibilidade de conversar com o programador ou programar uma rotina de tratamento de erros na própria linguagem que estiver sendo usada, esse mesmo erro pode ser exibido para o usuário. Para isso basta resgatar esse erro e passar ele por uma função que retire o inicio do erro “Error Code: 1146 – Table ‘testes_roberson.Erro ao inserir dados!” e o final do erro “‘ doesn’t exist”, com isso ficaremos somente com o erro que queremos

Reconheço que o erro retornado não é a melhor coisa do mundo, mas com algumas poucas linhas podemos deixar ele mais limpos, a baixo coloco um script PHP de como poderiamos tratar esse erro e mostrar para o cliente.

//trigger_email.php
// Função para tratamento dos erros
function tratarErrosMysql($numError, $error){
	//identificamos que o erro é no nome da tabela error 1146
	if($numError == '1146'){
		//executamos a decodificação de utf8 para que o erro não apresente problemas com os acentos.
		$error = utf8_decode($error);
		//retiramos o inicio e o fim do erro.
		$error = substr($error, 23 , -15);
		//retornamos o erro que veio do banco
		return $error;
	}else{
		//caso o erro não seja no nome da tabela(retorno de nossa trigger) retornamos o erro do mysql intacto
		return $error;
	}
}
// criamos a conexão com o banco de dados no nosso caso, MySql
$conn = mysqli_connect("localhost", "root", "","testes_roberson");  

//executamos nosso comando sql
$sql = "INSERT INTO Clientes SET Cpf = '05332754906', Nome='Teste', Sobrenome='Teste', Email='isso não é um email válido',sexo='M';"; // query (comando sql)
$result = mysqli_query($conn, $sql);
//verificamos se ouve algum erro
if(mysqli_error($conn)){
	// apresentamos o erro para o cliente;
	echo tratarErrosMysql(mysqli_errno($conn),mysqli_error($conn));
}

Assim teremos o erro tratado, assim teremos uma base de dados bem mais consistente e livre de falhas de verificação na aplicação e erros dos usuários. E não esqueçam de criar uma trigger que valide o dado quando houver uma atualização BEFORE UPDATE.

Em próximos posts pretendo mostrar a validação de CPF usando trigger e stored procedure.

Posts relacionados:

1. Validando dados inseridos no banco MySql – Parte 02
2. Convertendo campos em url amigável pelo Mysql

Postar um comentário