Capítulo 27. Extender MySQL

27.1. El interior de MySQL

• Los tests se encuentran en mysql-test/t/*.test

• Un caso de test consiste en comandos terminados por ; y es similar a la entrada del cliente de línea de comandos mysql . Un comando por defecto es una consulta que se envía a MySQL server, a no ser que se reconozca como comando interno (p.e. sleep).

• Todas las consultas que producen resultados--por ejemplo, SELECT, SHOW, EXPLAIN, etc., debe precederse con @/path/to/result/file. El fichero debe contener los resultados esperados. Una forma fácil de generar el fichero de resultados es ejecutar mysqltest -r <t/test-case-name.test del directorio mysql-test, y editar los ficheros resultantes, si es necesario, para ajustarlos a la salida esperada. En ese caso, sea muy cuidadoso de no añadir o borrar carácteres invisibles -- asegúrese de cambiar sólo el texto y/o borrar líneas. Si tiene que insertar una línea, aségurese que los campos estén separados por un tabulador, y que hay un tabulador al final. Si quiere puede usar od -c para asegurarse que su editor de texto no ha desbaratado nada durante la edición. Esperamos que nunca tenga que editar la salida de mysqltest -r ya que sólo tiene que hacerlo al encontrar un bug.

• Para ser consistente con nuestra inicialización, debe poner sus ficheros resultantes en el directorio mysql-test/r y llamarlos test_name.result. Si el test produce más de un resultado, debe usar test_name.a.result, test_name.b.result, etc.

• Si un comando retorna un error, debe especificarlo con --error error-number en la línea anterior al comando. El número de error puede ser una lista de números de error posibles separados por ','.

• Si está escribiendo un caso de test de replicación, debe poner en la primera línea del fichero de test, source include/master-slave.inc;. Para cambiar entre maestro y esclavo, use connection master; y connection slave;. Si necesita hacer algo en una conexión alternativa, puede hacer connection master1; para el maestro, y connection slave1; para el esclavo.

• Si necesita hacer algo en un bucle, puede usar algo como esto:

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

• Para dormir entre consultas, use el comando sleep. Soporta fracciones de segundo, así que puede usar sleep 1.3;, por ejemplo, para dormir 1.3 segundos.

• Para ejecutar el esclavo con opciones adicionales para sus casos de test, póngalos en el formato de línea de comandos en mysql-test/t/test_name-slave.opt. Para el maestro, póngalas en mysql-test/t/test_name-master.opt.

• Si tiene una pregunta sobre la suite de test, o tiene un caso de test al que contribuir, envíe un email a la lista de correo MySQL internals . Consulte Sección 1.6.1.1, “Las listas de correo de MySQL”. Como esta lista no acepta adjuntos, debe subir por ftp todos los ficheros relevantes a: ftp://ftp.mysql.com/pub/mysql/upload/

• No envíe un reporte de bug antes que haya encontrado todo lo posible sobre qué ha ido mal! Cuando lo haga, por favor use el script mysqlbug para que podamos obtener información sobre el sistema y la versión MySQL. Consulte Sección 1.6.1.3, “Cómo informar de bugs y problemas”.

• Asegúrese de incluir la salida de mysql-test-run, así como los contenidos de todos los ficheros .reject en el directorio mysql-test/r .

• Si falla un test en la suite, chequee si el test también falla al ejecutarlo en solitario:

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

  Si esto falla, debe configurar MySQL con --with-debug y ejecutar mysql-test-run con la opción --debug . Si también falla envíe el fichero de traza var/tmp/master.trace a ftp://ftp.mysql.com/pub/mysql/upload/ para que podamos examinarlo. Por favor recuerde de incluir una descripción completa de su sistema, la versión del binario mysqld y cómo lo compiló.

• También intente ejecutar mysql-test-run con la opción --force para ver si hay algún otro test que falla.

• Si ha compilado MySQL usted mismo, chequee nuestro manual para ver cómo compilar MySQL en su plataforma, o preferiblemente, usar uno de los binarios que hemos compilado en http://dev.mysql.com/downloads/. Todos nuestros binarios estándard deben pasar la suite de tests!

• Si obtiene un error como Result length mismatch o Result content mismatch significa que la salida del test no coincide exactamente con la salida esperada. Este puede ser un bug en MySQL o que su versión de mysqld produce resultados ligeramente distintos bajo algunas circunstancias.

  Los resultados de tests fallidos se ponen en un fichero con el mismo nombre base que el fichero de resultados con la extensión .reject . Si su caso de test falla, debe hacer un diff entre los dos ficheros. Si no puede ver en qué se distinguen, exemine ambos con od -c y compruebe los tamaños.

• Si un test falla completamente, debe chequear los ficheros de logs en el directorio mysql-test/var/log para ayudas sobre qué ha fallado.

• Si ha compilado MySQL con depuración puede intentar depurarlo ejecutando mysql-test-run con las opciones --gdb y/o --debug . Consulte Sección D.1.2, “Crear ficheros de traza”.

  Si no ha compilado MySQL para depuración debería hacerlo. Especifique la opción --with-debug en configure. Consulte Sección 2.8, “Instalación de MySQL usando una distribución de código fuente”.