Aurora MySQL 네이티브 함수로 Lambda 함수 호출 - Amazon Aurora

Aurora MySQL 네이티브 함수로 Lambda 함수 호출

참고

Aurora MySQL 버전 2 또는 Aurora MySQL 3.01 이상을 사용하는 경우 lambda_synclambda_async 네이티브 함수를 호출할 수 있습니다. Aurora MySQL 버전에 대한 자세한 내용은 Amazon Aurora MySQL에 대한 데이터베이스 엔진 업데이트 단원을 참조하십시오.

네이티브 함수 lambda_synclambda_async를 호출하여 Aurora MySQL DB 클러스터에서 AWS Lambda 함수를 호출할 수 있습니다. 이 방식은 Aurora MySQL에서 실행 중인 데이터베이스를 다른 AWS 서비스와 통합하려는 경우에 유용합니다. 예를 들어 데이터베이스의 특정 테이블에 행이 삽입될 때마다 Amazon Simple Notification Service(Amazon SNS)를 사용하여 알림을 보낼 수 있습니다.

Lambda 함수를 호출하기 위해 네이티브 함수로 작업

lambda_synclambda_async 함수는 내장된 네이티브 함수이며 동기적 또는 비동기적으로 Lambda 함수를 호출합니다. 다른 작업으로 넘어가기 전에 Lambda 함수의 결과를 알아야 하는 경우, 동기식 함수 lambda_sync를 사용합니다. 다른 작업으로 넘어가기 전에 Lambda함수의 결과를 알 필요가 없는 경우, 비동기식 함수 lambda_async를 사용합니다.

Aurora MySQL 버전 3에서의 역할 부여

Aurora MySQL 버전 3에서는 네이티브 함수를 호출하는 사용자에게는 AWS_LAMBDA_ACCESS 역할이 부여되어야 합니다. 사용자에게 이 역할을 부여하려면 관리자 사용자로 DB 인스턴스에 연결하고 다음 명령문을 실행합니다.

GRANT AWS_LAMBDA_ACCESS TO user@domain-or-ip-address

다음 명령문을 실행하여 이 역할을 호출할 수 있습니다.

REVOKE AWS_LAMBDA_ACCESS FROM user@domain-or-ip-address
작은 정보

Aurora MySQL 버전 3에서 역할을 사용하는 경우 SET ROLE role_name 또는 SET ROLE ALL 문을 사용하여 해당 역할을 활성화할 수도 있습니다. MySQL 8.0 역할 시스템에 익숙하지 않을 경우 역할 기반 권한 모델에서 자세한 내용을 확인할 수 있습니다. 자세한 내용은 MySQL 참조 설명서의 역할 사용을 참조하세요.

이는 현재 활성 세션에만 적용됩니다. 다시 연결할 때 권한을 부여하려면 SET ROLE 문을 다시 실행해야 합니다. 자세한 내용은 MySQL 참조 매뉴얼의 SET ROLE 문을 참조하세요.

activate_all_roles_on_login DB 클러스터 파라미터로 사용자가 DB 인스턴스에 연결할 때 모든 역할을 자동으로 활성화할 수 있습니다. 이 파라미터를 설정하면 역할을 활성화하는 데 SET ROLE 문을 명시적으로 직접 호출할 필요가 없습니다. 자세한 내용은 MySQL Reference Manual(MySQL 참조 매뉴얼)의 activate_all_roles_on_login을 참조하세요.

하지만 다른 사용자가 저장 프로시저를 직접 호출한 경우에는 저장 프로시저를 시작할 때 명시적으로 SET ROLE ALL을 직접 호출하여 역할을 활성화해야 합니다.

Lambda 함수를 간접적으로 호출하려고 할 때 다음과 같은 오류가 발생하면 SET ROLE 문을 실행합니다.

SQL Error [1227] [42000]: Access denied; you need (at least one of) the Invoke Lambda privilege(s) for this operation

Aurora MySQL 버전 2에서의 권한 부여

Aurora MySQL 버전 2에서 네이티브 함수를 호출하는 사용자에게는 INVOKE LAMBDA 권한이 부여되어야 합니다. 사용자에게 이 권한을 부여하려면 관리자 사용자로 DB 인스턴스에 연결하고 다음 명령문을 실행합니다.

GRANT INVOKE LAMBDA ON *.* TO user@domain-or-ip-address

다음 명령문을 실행하여 이 권한을 호출할 수 있습니다.

REVOKE INVOKE LAMBDA ON *.* FROM user@domain-or-ip-address

lambda_sync 함수의 구문

lambda_sync 호출 유형으로 RequestResponse 함수를 동기식으로 호출합니다. 함수가 JSON 페이로드에서 Lambda 호출 결과를 반환합니다. 함수에는 다음과 같은 구문이 있습니다.

lambda_sync ( lambda_function_ARN, JSON_payload )

lambda_sync 함수의 파라미터

lambda_sync 함수에는 다음과 같은 파라미터가 있습니다.

lambda_function_ARN

호출할 Lambda 함수의 Amazon 리소스 이름(ARN)입니다.

JSON_payload

JSON 형식으로 호출된 Lambda 함수의 페이로드입니다.

참고

Aurora MySQL 버전 3은 MySQL 8.0의 JSON 구문 분석 함수를 지원합니다. 그러나 Aurora MySQL 버전 2에는 이러한 함수가 포함되어 있지 않습니다. Lambda 함수가 숫자 또는 문자열과 같은 원자 값을 반환할 때 JSON 구문 분석이 필요하지 않습니다.

lambda_sync 함수의 예

lambda_sync를 기반으로 하는 다음 쿼리는 함수 ARN을 사용하여 Lambda 함수 BasicTestLambda를 동기식으로 호출합니다. 함수에 대한 페이로드는 {"operation": "ping"}입니다.

SELECT lambda_sync( 'arn:aws:lambda:us-east-1:123456789012:function:BasicTestLambda', '{"operation": "ping"}');

lambda_async 함수의 구문

lambda_async 호출 유형으로 Event 함수를 비동기식으로 호출합니다. 함수가 JSON 페이로드에서 Lambda 호출 결과를 반환합니다. 함수에는 다음과 같은 구문이 있습니다.

lambda_async ( lambda_function_ARN, JSON_payload )

lambda_async 함수의 파라미터

lambda_async 함수에는 다음과 같은 파라미터가 있습니다.

lambda_function_ARN

호출할 Lambda 함수의 Amazon 리소스 이름(ARN)입니다.

JSON_payload

JSON 형식으로 호출된 Lambda 함수의 페이로드입니다.

참고

Aurora MySQL 버전 3은 MySQL 8.0의 JSON 구문 분석 함수를 지원합니다. 그러나 Aurora MySQL 버전 2에는 이러한 함수가 포함되어 있지 않습니다. Lambda 함수가 숫자 또는 문자열과 같은 원자 값을 반환할 때 JSON 구문 분석이 필요하지 않습니다.

lambda_async 함수의 예

lambda_async를 기반으로 하는 다음 쿼리는 함수 ARN을 사용하여 Lambda 함수 BasicTestLambda를 비동기식으로 호출합니다. 함수에 대한 페이로드는 {"operation": "ping"}입니다.

SELECT lambda_async( 'arn:aws:lambda:us-east-1:123456789012:function:BasicTestLambda', '{"operation": "ping"}');

트리거 내에서 Lambda 함수 호출

트리거를 사용하여 데이터 수정 문에서 Lambda을 호출할 수 있습니다. 다음 예제에서는 lambda_async 기본 함수를 사용하고 결과를 변수에 저장합니다.

mysql>SET @result=0; mysql>DELIMITER // mysql>CREATE TRIGGER myFirstTrigger AFTER INSERT ON Test_trigger FOR EACH ROW BEGIN SELECT lambda_async( 'arn:aws:lambda:us-east-1:123456789012:function:BasicTestLambda', '{"operation": "ping"}') INTO @result; END; // mysql>DELIMITER ;
참고

트리거는 SQL 문당 한 번이 아니라 수정된 행당 한 번 실행되며 한 번에 한 행씩 실행됩니다. 트리거가 실행되면 프로세스는 동기식입니다. 트리거가 완료될 때만 데이터 수정 문이 반환합니다.

쓰기 트래픽이 높은 테이블의 트리거에서 AWS Lambda 함수를 호출할 때는 주의해야 합니다. INSERT, UPDATEDELETE 트리거는 행별로 활성화됩니다. INSERT, UPDATE 또는 DELETE 트리거가 있는 테이블에서 쓰기가 많은 워크로드는 AWS Lambda 함수에 다량의 호출을 야기합니다.