測試位於 mysql-test/t/*.test

測試案例包括終止聲明，測試案例類似於mysql命令行客戶端的輸入。 預設的聲明是一個被發送到MySQL伺服器的查詢，除非這個聲明被識別為內部命令（如 sleep）。

所有產生結果的查詢，例如SELECT, SHOW, EXPLAIN等，必須在 @/path/to/result/file之前。那個檔案必須包含期望的結果。生成結果檔案的一個簡單辦法是在mysql-test目錄運行mysqltest -r < t/test-case-name.test ，然後編輯生成的結果檔案，如果需要，可將它們調整到想要的輸出端。在那種情況下，要小心避免新增或刪除任何不可見的字元，確保只改變文本和（或）刪除行。如果插入一行，要確保插入的區域被一個硬標識隔開，且在行尾有一個硬標識。您可能會想要使用od -c來確保您的文本編輯器在編輯 步驟中沒有搞亂任何東西。當您發現一個問題而不得不編輯mysqltest -r的輸出時，我們真希望您不要編輯它。

為和我們的設置一致，您應該把您的結果檔案放在mysql-test/r 目錄，並取名為test_name.result。如果測試產生不止一個結果，您應該使用諸如 test_name.a.result，test_name.b.result等這樣的名字。

如果聲明返回一個錯誤，您可以在聲明的前一行使用--error error-number來詳細說明它。錯誤號可能是由「,」分開的可能錯誤號的列資料表。

如果您正編寫一個重複的測試案例，您應該在測試檔案的第一行寫：source include/master-slave.inc;。用connection master; 和 connection slave;來切換主案例和從案例。如果您需要對一個替換的連接做點什麼，對於主連接，用connection master1;，對於從連接，用connection slave1;。

如果需要在一個循環裡做點什麼，可以用些這樣的內容：

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

在查詢之間休眠，使用sleep命令。此命令支援幾分之幾秒，所以，例如您想要休眠1.3秒，您可以使用sleep 1.3; 命令。

對您的測試案例要運行帶附加選項的從案例，以命令行方式把它們放在mysql-test/t/test_name-slave.opt。對於主案例，把它們放在mysql-test/t/test_name-master.opt。

如果對測試套件有問題，和想要獻出一個測試案例，發送郵件訊息到MySQL 內部插件 郵件列資料表。請參閱1.7.1.1節，「MySQL郵件列資料表」。 雖然這個列資料表不接受附件，您可以把相關檔案通過ftp上傳到：ftp://ftp.mysql.com/pub/mysql/upload/

在盡可能多地找到出錯之時的錯誤之前，不要發送問題報告。搜尋之時，請使用mysqlbug指令比便我們能獲取您的系統和MySQL版本訊息，參閱1.7.1.3節 ，「如何報告問題或問題」。

確保包含了mysql-test-run的輸出，以及  mysql-test/r目錄下所有.reject檔案的內容。

如果測試套件裡的測試未通過，用如下命令檢查一下看它自己運行時是否通過測試：

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

如果未能通過，您應該用 --with-debug 配置MySQL並使用--debug選項來運行mysql-test-run。如果這樣也未能通過，請把追蹤檔案var/tmp/master.trace 上傳到 ftp://ftp.mysql.com/pub/mysql/upload/ 以便我們能檢查它。請記得也要包含您系統的完整描述，mysqld 二進制檔案的版本，以及您是如何編譯它的。

也試著帶--force選項運行一下mysql-test-run ，看是否還有別的測試未通過。

如果您是自己編譯的MySQL，查看我們的手冊看看如何在您的平台上編譯MySQL，最好用一個在http://dev.mysql.com/downloads/上我們已經為您編譯好的二進製版本。我們所有標準的二進製版本都能通過測試套件的測試！

如果錯誤是Result length mismatch 或 Result content mismatch ，這意味測試的輸出於期望的輸出不匹配，這可能是在MySQL或您的mysqld 版本裡的問題在某些環境下產生稍有不同的結果。

未通過的測試結果放在和結果檔案同主名但延伸名為.reject的檔案裡。如果測試案例未通過，您應該對兩個檔案做diff操作。如果您不能發現它們是如何不同，用od -c 命令檢查它們，也檢查一下檔案長度。

如果測試完全未通過，您應該檢查mysql-test/var/log目錄下的日誌檔案以獲得有關錯誤的一些提示。

如果您是為調試而編譯MySQL，試一下帶--gdb和（或）--debug參數運行mysql-test-run 。請參閱E.1.2節，「建立跟蹤檔案」。

如果您沒有為調試而編譯MySQL，這應該是您可能去做的。只要帶－-with-debug參數運行configure。 請參閱2.8節，「使用原始碼分發版安裝MySQL 」。

my_bool maybe_null

如果xxx() 能返回NULL，xxx_init()應maybe_null 為 1 。如果任一參量被說明了 maybe_null值，其 預設值是1 。

unsigned int decimals

小數位數。預設值是傳到主函數的參量裡小數的最大位數。（例如，如果函數傳遞 1.34, 1.345, 和1.3, 那麼預設值為，因為1.345 有3位小數。

unsigned int max_length

結果的最大長度。max_length 的預設值因函數的結果類型而異。對字串函數，預設值是最長參量的長度。對整型函數，預設是21位。對實型函數，預設是13再加上initid->decimals指示的小數位數。（對數字函數，長度包含正負號或者小數點符）。

如果想返回團值，您可以把max_length 設為從65KB到16MB。這個內存不會被分配，但是如果有臨時數據需要儲存，這個設置了的值被用來決定使用哪種 列的類型。

char *ptr

函數可以用作本身目的的指針。比如，函數可以用initid->ptr 來在分配了的內存內部通訊。 xxx_init() 應該分配內存，並指派給這個指針：

initid->ptr = allocated_memory;

在 xxx() 和 xxx_deinit()中，借用 initid->ptr 來使用或分配內存。

xxx_reset()

當MySQL在一個新組中發現第一行時使用這個函數。它對這個組重置任何內部總和變數，然後使用給定的UDF_ARGS參量作為內部總和值的第一個值。如下說明 xxx_reset() 函數：

char *xxx_reset(UDF_INIT *initid, UDF_ARGS *args,
                char *is_null, char *error);

 在MySQL5.1版中UDF接口不需要或不使用xxx_reset()函數，而是使用xxx_clear()函數作為替代。但是如果您想讓UDF也能在老版本的伺服器上運行，您也可以定義 xxx_reset() 和 xxx_clear() 函數。（如果您使用了這兩個函數，xxx_reset()函數在很多情況下可以通過使用函數來內部實現，即使用xxx_clear()函數重置所有變數，然後新增UDF_ARGS參量作為組的第一個值。）

xxx_clear()

當MySQL需要重置總和結果時使用此函數。對每一個新組，在開始之時使用它，但是它也可以被使用來為一個沒有匹配行在其中的查詢重置值。如下說明xxx_clear()：

char *xxx_clear(UDF_INIT *initid, char *is_null, char *error);

在使用xxx_clear()之前is_null 被設置指向 CHAR(0) 。

如果發生錯誤，您可以儲存一個值在 error參量指向的變數中。error指向一單字節變數，而不是一個字串緩衝區。

xxx_clear() 是MySQL 5.1必須的。

xxx_add()

為同組除了第一行之外，所有的行使用這個函數。您應該用它在UDF_ARGS參量中向內部總和變數加值。.

char *xxx_add(UDF_INIT *initid, UDF_ARGS *args,
              char *is_null, char *error);

unsigned int arg_count

參量個數。如果您需要您的函數帶著某個數目的參量被使用，在初始化函數檢查這個值，例如：

if (args->arg_count != 2)
{
    strcpy(message,"XXX() requires two arguments");
    return 1;
}

enum Item_result *arg_type

一個指針，對每個參量指向包含類型的一個數列。可能的類型值是STRING_RESULT, INT_RESULT 和 REAL_RESULT。

要確信一個參量是給定類型的，並且如果不是的話就返回一個錯誤，請檢查初始化函數中的arg_type數列。比如：

if (args->arg_type[0] != STRING_RESULT ||
    args->arg_type[1] != INT_RESULT)
{
    strcpy(message,"XXX() requires a string and an integer");
    return 1;
}

要求您函數的參量是某一類型的另一方法是，使用初始化函數設置arg_type元素為您想要的類型。對所有對xxx()的使用而言，這會導致MySQL強制參量為這些類型。比如，要指定投兩個參量強製成字串和整數，在xxx_init()中分別：

args->arg_type[0] = STRING_RESULT;
args->arg_type[1] = INT_RESULT;

char **args

args->args 與初始化函數做有關傳到您函數的參量的一般情況做通訊。對於常參量i，args->args[i] 指向參量值。（看下面的說明瞭解如何妥善地訪問這個值）。對非－常參量，args->args[i] 為 0。一個常參量為僅使用參量的資料表達式，如 3 或 4*7-2 或 SIN(3.14)。一個非常 參量是一個行與行不同的資料表達式，如，列名或帶非－常參量使用的函數。

對主函數的每次使用，args->args 包含為每個當前處理的行傳遞的實際參量。

如下使用參量i的函數：

unsigned long *lengths

對初始化函數，lengths數列資料表示對每個參量的最大字串長度。您不要改變它。對主函數的每次使用，lengths包含了對當前處理行傳遞的任何字串 參量的實際長度。對於INT_RESULT 或 REAL_RESULT類型的參量，lengths 仍包含參量的最大長度（對初始化函數）。

metaphon() 返回字串參量的一個變音位(metaphon)字串，這有點像一個探測法（soundex）字串，但是它英語更協調。

myfunc_double()返回在其參量中所有字元的ASCII值的和，除以其 參量長度之和。

myfunc_int()返回其參量長度之和。

sequence([const int]) 返回一個序列，從給定數開始，若沒有給定數則從1開始。

lookup() 返回對應主機名的IP數。

reverse_lookup() 返回對應一個IP數的主機名。函數可以帶'xxx.xxx.xxx.xxx'形式的一個單字串 參量使用，要麼帶4個數字使用。