run-sql-bench.pl

run-sql-bench.pl è uno script Perl per l'esecuzione automatica di sql-bench (sql-bench si trova nel codice sorgente di MariaDB.)

run-sql-bench.pl si trova nel progetto mariadb-tools su Launchpad. Una volta scaricata una copia di mariadb-tools, lo script e le sue directory di configurazione si trovano nella directory sql-bench. Ai fini di questo articolo, la directory in cui si trova mariadb-tools verrà chiamata ${BASE_DIR}.

Lo script run-sql-bench.pl si trova in '${BASE_DIR}/sql-bench/run-sql-bench.pl'.

Un esempio degli script di configurazione usati per le diverse esecuzioni si trova nelle varie sottodirectory di ${BASE_DIR}/sql-bench/.

Ecco come eseguire lo script run-sql-bench.pl:

1. Creare un branch di un albero di MariaDB o MySQL
2. Opzionalmente, si eseguano delle modifiche nella branch e si esegua un commit
3. Si modifichi run-sql-bench.pl valorizzando le opzioni interne, soprattutto la variabile "my $path ".
4. Si crei un file ${BASE_DIR}/sql-bench/conf/host.cnf. Il modo più semplice è duplicate uno dei file host.cnf di esempio:

   cp -avi ${BASE_DIR}/sql-bench/conf/pitbull.cnf ${BASE_DIR}/sql-bench/conf/${HOSTNAME}.cnf
   

   Il file va poi personalizzato.
5. Si credi i file ${HOSTNAME}.cnf sotto la directory ${BASE_DIR}/sql-bench/basic, ${BASE_DIR}/sql-bench/debug, ${BASE_DIR}/sql-bench/debug-full oppure ${BASE_DIR}/sql-bench/O2, a seconda di quali test automatizzati si desidera eseguire. Si usi i file di esempio come base e li si personalizzi.
6. Si esegua lo script run-sql-bench.pl:

   cd ${BASE_DIR}/sql-bench/; ./run-sql-bench.pl --repository=[/path/to/bzr/repository] --sql-bench-options=[additional sql-bench-options] --debug=[yes|no]
   

   • --repository è l'albero di MariaDB da usare e compilare, inoltre lo script cercherà qui sql-bench.
   • --sql-bench-options è usato soprattutto per il test e il debug, quando si desidera avere tempi di esecuzione brevi. Per esempio specificando --small-test o --small-table.
   • E' possibile separare le diverse opzioni di sql-bench con degli spazi, in questo modo:

     --sql-bench-options="--small-test --small-table"
     

I risultati

I risultati vengono registrati al percorso specificato nella variabile $sql_bench_results , nel file ${BASE_DIR}/sql-bench/conf/hostname.cnf sul proprio host. Sono organizzati in sottodirectory con il seguente schema schema:

sql-bench-results-dir/${HOSTNAME}/YYYY-MM-DD

Piani futuri

• Rilevamento e segnalazione dei crash e dei bug.
• Dovrebbe esserci la possibilità di specificare il nome di un test per ogni file (run-all-tests --suffix='_xxxx')