Os teste estão localizados em mysql-test/t/*.test

Um caso de teste consiste de instruções terminadas em ; e é similar a entrada do cliente de linha de comando mysql. Uma instrução por padrão é uma consulta a ser enviada ao servidor MySQL, a menos que ele seja reconhecido como um comando insterno (ex. sleep).

Todas as consultas que produzem resultados¯ex., SELECT, SHOW, EXPLAIN, etc., devem ser precedidas com @/path/to/result/file. O arquivo deve conter os resultados esperados. Um modo fácil de gerar o arquivo resultante é executar mysqltest -r < t/test-case-name.test do diretório mysql-test, e então editar o arquivo resultante gerado e, se necessário, ajustá-los a saída esperada. Neste caso, tenha cuidado de não adicionar ou deletar quaisquer caracteres invisíveis - tenha certeza de apenas alterar o texto e/ou adicionar linhas deletadas. Se você tiver que inserir uma linha, esteja certo que os campos são separados com tabulação e que há uma tabulação no final. Você pode querer utilizar od -c para ter certeza que seu editor de texto não bagunçõu nada durante a edição. Nós, é claro, esperamos que você nunca tenha que editar a saída de mysqltest -r já que você só deverá fazê-lo quando encontra um bug.

Para estar consistente com a nossa configuração, você deve colocar seus arquivos de resultados no diretório mysql-test/r e o nomeie como test_name.result. Se o teste produzir mais de um resultado, você deve usar test_name.a.result, test_name.b.result, etc.

Se uma instrução retornar um erro, você eve espacificar na linha anterior a instrução com --error error-number. O número do erro pode ser uma lista de números de erros possíveis separados com ','.

Se você estiver escrevendo em teste de replicação, você deve coloca source include/master-slave.inc; na primeira linha do arquivo. Para trocar entre master e slave, utilize connection master; e connection slave;. se você precisar fazer alguma coisa em uma conexão alternativa, você pode fazer connection master1; para o master e connection slave1; para o slave.

Se você precisar fazer alguma coisa em um loop, você pode usar algo assim:

let $1=1000;
while ($1)
{
# do your queries here
dec $1;
}

Para 'dormir' entre consultas, use o comando sleep. Ele suporta frações de um segundo, assim você pode fazer sleep 1.3;, por exemplo, para dormir 1.3 segundos.

Para executar o slave com opções adicionais para o seu caso de teste, coloque-os na formato de linha de comando mysql-test/t/test_name-slave.opt. Para o master, coloque-os em mysql-test/t/test_name-master.opt.

Se você tiver uma questão sobre o pacote de testes, ou tiver um caso de teste para contribuir, envie um e-mail para lista de email ``internals'' do MySQL. Veja mais informações sobre isto na Seção 1.7.1.1, “As Listas de Discussão do MySQL”. Como a lista não aceita anexos, você deve utilizar o ftp para enviar os arquivos relevantes: ftp://support.mysql.com/pub/mysql/Incoming/

Não envie um relatório de bug antes de ter feito tudo possível para encontrar o que esta errado! Quando o fizer, por favor, utilize o script mysqlbug assim podemoster informações sobre o seu sistema e a versão do MySQL. Veja mais informações sobre isto na Seção 1.7.1.3, “Como relatar erros ou problemas”.

Esteja certo de inluir a saída de mysql-test-run, assim como o conteúdoi de todos os arquivos .reject no diretório mysql-test/r.

Se um pacote de teste falhar, verifique se o teste também falha quando executado sozinho:

cd mysql-test
mysql-test-run --local test-name

Se falhar, você deve configurar o MySQL com --with-debug e executar mysql-test-run com a opção --debug. Se into também falhar envie o arquivo de rastreamento var/tmp/master.trace para ftp://support.mysql.com/pub/mysql/secret assim nós podemos examiná-los. Por favor, se lembre de também incluir uma descrição completa do seu sistema, a versão do binário do mysqld e como você o compilou.

Tente também executar mysql-test-run com a opção --force para ver se há qualquer outro teste que tenha falhado.

Se você próprio compilou o MySQL, verifique nosso manual sobre como compilar o MySQL na sua platforma ou, de preferência, use um dos binários que nós compilamos para você no http://www.mysql.com/downloads/. Todos os seus binários padrões devem passar no pacote de teste!

Se você obter um erro, como Result length mismatch ou Result content mismatch, significa que a saída do teste não é igual a saída esperada. Este pode ser um bug no MySQL ou que o seu versão do mysqld produz resultados um pouco diferentes sobre certas circuntâncias.

Resultado de testes que falharam são colocados em um arquivo com o mesmo nome base que o arquivo de resultado com a extensão .reject. Se o seu caso de teste está falhando, você deve fazer um diff nos dois arquivos. Se você não puder ver como els são diferentes, examine ambos com od -c e també verifique os seus tamanhos.

Se um teste falhar totalmente, você deve verificar os arquivos de log no diretório mysql-test/var/log para avisos sobre o que deu errado.

Se você tiver compilado o MySQL com depuração você pode tentar depurá-lo executando mysql-test-run com a opções --gdb e/ou --debug. Veja mais informações sobre isto na Seção E.1.2, “Criando Arquivos Trace (Rastreamento)”.

Se você não tiver compilado o MySQL com depuração você deve, provavelmente, fazê-lo. Apenas especifique a opção --with-debug no configure! Veja mais informações sobre isto na Seção 2.3, “Instalando uma distribuição com fontes do MySQL”.