데브러너 (DevRunner)

27.3.7 Using the JavaScript SQL API

27.3.7.1 Simple Statements
27.3.7.2 Prepared Statements
27.3.7.3 Working with Data and Metadata

이 섹션에서는 API를 사용하여 단순 SQL 문과 준비된 문 양쪽 모두에서 SQL 문을 실행하고, 그 결과를 얻고 처리하는 방법에 대해 설명합니다. JavaScript에서의 SQL 실행은 저장 프로시저에서만 가능하며, 저장 함수에서는 사용할 수 없습니다.

SQL API는 두 종류의 문을 지원합니다. 단순 SQL 문( Section 27.3.7.1, “Simple Statements” 참조)과 준비된 문( Section 27.3.7.2, “Prepared Statements” 참조)입니다. 준비된 문은 바인드 파라미터를 지원하지만, 단순 문은 지원하지 않습니다.

특정 세션에서 저장 프로시저를 실행하기 위해 동시에 열려 있을 수 있는 단순 문의 최대 개수는 1024개입니다. 이 값은 고정되어 있으며, 사용자가 설정을 변경할 수 없습니다. 이 숫자보다 많은 단순 문을 동시에 실행하려고 하면 오류가 발생합니다. JavaScript에서 실행되는 준비된 문은 max_prepared_stmt_count에 의해 결정되는 전역 제한에 포함됩니다. 자세한 내용은 해당 변수에 대한 설명을 참조하십시오.

SQL 문에 의해 반환되는 결과 집합은 메모리에 버퍼링됩니다. 단순 문의 경우 (전체) 결과 집합의 크기는 1MB로 제한됩니다. 준비된 문의 경우, 개별 행 하나가 최대 1MB까지 사용할 수 있습니다. 어느 경우든 이 제한을 초과하면 오류가 발생합니다.

문 유형에 관계없이 결과를 소비하기 위한 두 가지 메커니즘을 사용할 수 있습니다. 결과 집합은 JavaScript 내부에서 처리할 수 있거나, 클라이언트로 직접 전달될 수 있습니다. 더 많은 정보는 Result Sets를 참조하십시오.

또한 임시 테이블, 세션 변수, 트랜잭션 상태와 같은 세션 데이터에도 접근할 수 있습니다. 저장 프로시저 밖에서 선언된 세션 변수는 저장 프로시저 내부에서 접근할 수 있습니다. 임시 테이블에 대해서도 마찬가지입니다. 추가로, 저장 프로시저 밖에서 시작된 트랜잭션은 그 저장 프로시저 내부에서 커밋할 수 있습니다.

지원되지 않는 데이터 타입을 포함하는 결과 집합을 생성하는 문은 지원되지 않는 타입 오류를 발생시킵니다. 예를 들어, DESCRIBE, EXPLAIN, 또는 ANALYZE TABLE을 포함하는 문은 다음과 같이 이 제한의 영향을 받습니다:

1mysql> CALL jssp_simple("DESCRIBE t1");
2ERROR 6113 (HY000): JavaScript> Unsupported type BLOB/TEXT for 'Type'
3mysql> SHOW WARNINGS;
4+-------+------+---------------------------------------------------+
5| Level | Code | Message                                           |
6+-------+------+---------------------------------------------------+
7| Error | 6113 | JavaScript> Unsupported type BLOB/TEXT for 'Type' |
8+-------+------+---------------------------------------------------+
91 row in set (0.00 sec)

저장 프로시저 내부의 SQL 문에서 JavaScript 로컬 변수를 설정하는 것은 지원되지 않습니다.

이 API는 또한 하나의 저장 프로시저가 다른 저장 프로시저를 호출할 때와 같이, 다중 결과 집합도 지원합니다. 다중 문 쿼리는 지원되지 않으며, 구문 오류를 발생시킵니다.

이 섹션의 예제들 중 일부는 MySQL website에서 제공되는 world 예제 데이터베이스를 기반으로 합니다. 다운로드 파일에서 데이터베이스를 설치하는 방법에 대한 도움말은 Section 6.5.1.5, “Executing SQL Statements from a Text File”을 참조하십시오.