Percona Toolkit UDFs

Three Percona Toolkit UDFs that provide faster checksums are provided:

• fnv_udf
• fnv1a_udf
• murmur_udf

Version Specific Information

• 5.5.8-20.0: Began distributing fnv_udf, fnv1a_udf, and murmur_udf.

Other Information

• Author / Origin: Baron Schwartz

Installation

Use of the Percona Software Repositories simplifies the installation of Percona Toolkit. Once the repository has been set up on your system, Percona Toolkit can be installed by executing:

$ yum install percona-toolkit

This will place the Percona Toolkit UDFs onto your system. However, they will not yet be installed into the MySQL server. To install one of the UDF``s into the server, execute one of the following commands, depending on which UDF you want to install:

$ mysql -e "CREATE FUNCTION fnv_64 RETURNS INTEGER SONAME ``fnv_udf.so``"
$ mysql -e "CREATE FUNCTION fnv1a_64 RETURNS INTEGER SONAME ``fnv1a_udf.so``"
$ mysql -e "CREATE FUNCTION murmur_hash RETURNS INTEGER SONAME ``murmur_udf.so``"

Executing each of these commands will install its respective UDF into the server.

Troubleshooting

If you get the error:

ERROR 1126 (HY000): Can't open shared library 'fnv_udf.so' (errno: 22 fnv_udf.so: cannot open shared object file: No such file or directory)

Then you may need to copy the .so file to another location in your system. Try both /lib and /usr/lib. Look at your environment’s $LD_LIBRARY_PATH variable for clues. If none is set, and neither /lib nor /usr/lib works, you may need to set LD_LIBRARY_PATH to /lib or /usr/lib.

Other Reading

• Percona Toolkit documentation