728x90

MySQL CREATE FUNCTION Statement for Loadable Functions 알아보기

MySQL을 사용하다 보면 내장 함수 외에 직접 만든 함수를 사용하고 싶을 때가 있습니다. 이런 경우 MySQL은 Loadable Function (로더블 함수)를 지원합니다. 이 글에서는 Loadable Function이 무엇인지, 어떻게 작성하고 MySQL에 등록하는지, 그리고 버전 별 차이점을 설명합니다.

Loadable Function이란?

Loadable Function은 MySQL 서버의 공유 라이브러리로 작성한 C 언어 기반 사용자 정의 함수(UDF)입니다. 즉, SQL 내장 함수처럼 호출할 수 있지만, 사용자가 직접 작성한 C 코드로 동작합니다.

예를 들어, 복잡한 수학 계산, 문자열 처리, 커스텀 암호화 로직 등을 빠르게 처리할 때 유용합니다. MySQL 서버의 퍼포먼스를 최대한 활용할 수 있지만, 보안과 안정성 관리가 중요합니다.

CREATE FUNCTION 문법

Loadable Function을 등록하려면 CREATE FUNCTION 구문을 사용합니다. 일반적인 문법은 다음과 같습니다:

CREATE FUNCTION 함수명 RETURNS 반환타입
SONAME '라이브러리파일.so';

함수명: SQL에서 사용할 함수 이름
RETURNS: 반환 데이터 타입 (e.g. STRING, INTEGER, REAL)
SONAME: 서버에 위치한 공유 라이브러리 파일 이름

예제

CREATE FUNCTION my_add RETURNS INTEGER
SONAME 'my_functions.so';

이 명령어는 my_functions.so라는 공유 라이브러리에서 my_add 함수를 로드하여 SQL 내에서 사용할 수 있게 합니다.

주의사항 및 버전 차이

MySQL의 Loadable Function은 다음 사항을 반드시 주의해야 합니다:

공유 라이브러리 빌드
- 반드시 MySQL UDF API를 사용하여 C로 컴파일해야 합니다.
- 운영체제 아키텍처, MySQL 서버 버전과 호환되어야 합니다.
파일 경로
- MySQL은 plugin_dir 디렉토리에서 라이브러리를 찾습니다.
- 이 경로는 SHOW VARIABLES LIKE 'plugin_dir';로 확인할 수 있습니다.
보안
- Loadable Function은 서버 권한으로 실행되므로 보안 위험이 존재합니다.
- MySQL 8.0.29부터는 CREATE FUNCTION ... SONAME 사용이 기본적으로 비활성화되어 있습니다 (변수 mysql_udf_metadata로 제어).
삭제 방법
- 함수 삭제는 간단합니다:
```
DROP FUNCTION 함수명;
```

MySQL 8.x 이후의 변화

MySQL 8.0.29 이후 버전에서는 보안 강화를 위해 Loadable Function 기능 사용이 제한되었습니다. 기본적으로 서버 설정에서 별도 활성화하지 않으면 사용이 불가능합니다. 이는 운영 환경에서의 보안 사고 방지를 위한 조치입니다.

CREATE FUNCTION ... SONAME 활성화를 위해서는 mysql.udf_registration 권한 필요
mysql_udf_metadata 시스템 변수 조정 필요

따라서 최신 MySQL 버전을 사용할 경우, Loadable Function보다는 Stored Function이나 Plugin API 활용을 먼저 고려하는 것이 권장됩니다.

마무리 및 실전 팁

Loadable Function은 MySQL 기능을 확장하는 강력한 도구이지만, 보안과 유지보수를 위해 신중하게 사용해야 합니다.

실전 팁:

되도록 최신 버전에서는 Plugin API나 내장 함수로 대체 가능한지 검토하세요.
개발-운영 환경이 동일한 라이브러리 아키텍처를 유지하세요.
서버 업데이트 시 라이브러리 재빌드를 준비하세요.

공식 문서 링크

MySQL CREATE FUNCTION (Loadable Functions) 공식 문서