MySQL 5.6 한글메뉴얼

23.8.9.2 C API Prepared Statement 형 변환

Prepared Statement은 클라이언트 측에서 서버 측의 SQL 값에 해당하는 C 언어 변수를 사용하여 클라이언트와 서버간에 데이터를 전송합니다. 클라이언트 측의 C 변수 타입과 서버 측의 대응하는 SQL 치형 사이에 불일치가있는 경우 MySQL은 양방향으로 암시 적 변환을 실행합니다.

MySQL은 서버 측의 SQL 값의 타입 코드를 인식하고 있습니다. MYSQL_BIND 구조의 buffer_type 값은 클라이언트 측의 값을 유지하는 C 변수의 타입 코드를 나타냅니다. 두 코드는 한꺼번에 실행해야 변환이있는 경우에, 그것을 MySQL에 전달합니다. 다음은 몇 가지 예입니다.

int 변수에 MYSQL_TYPE_LONG 를 사용하여 FLOAT 컬럼에 저장되는 정수 값을 서버에 전달하면, MySQL은 그 값을 저장하기 전에 부동 소수점 형식으로 변환합니다.
SQL MEDIUMINT 컬럼 값을 가져올 수 있지만, MYSQL_TYPE_LONGLONG 의 buffer_type 값을 지정하고 대상 버퍼로, 형태 long long int 의 C 변수를 사용했을 경우, MySQL은 long long int (8 바이트 변수)에 저장하기 위해, MEDIUMINT 값 (이것은 8 바이트 미만을 필요로한다)를 변환합니다.
255의 값을 포함하는 숫자 열을 char[4] 문자 배열로 가져 와서 MYSQL_TYPE_STRING 의 buffer_type 값을 지정하면 배열의 결과 값은 4 바이트 문자열 '255\0' 이됩니다.
MySQL은 원래 서버 측 값의 문자열 표현으로 DECIMAL 값을 반환합니다. 따라서 해당 C 형은 char[] 입니다. 예를 들어, 12.345 클라이언트에 '12.345' 으로 반환됩니다. MYSQL_TYPE_NEWDECIMAL 를 지정하고 문자열 버퍼를 MYSQL_BIND 구조에 바인딩하면 mysql_stmt_fetch() 는 변환없이 값을 문자열로 버퍼에 저장합니다. 대신 숫자 변수와 타입 코드를 지정하면 mysql_stmt_fetch() 는 문자열 형식 DECIMAL 값을 숫자 형식으로 변환합니다.
MYSQL_TYPE_BIT 유형 코드는 BIT 값이 문자열 버퍼에 반환됩니다. 따라서 해당 C 형은 char[] 입니다. 값은 클라이언트 측의 해석을 필요로하는 비트 문자열을 나타냅니다. 취급하기 쉬운 형태로 값을 반환하므로 다음 식의 형태를 사용하여 값을 정수로 변환 할 수 있습니다.
```
 SELECT bit_col +0 FROM t
 SELECT CAST (bit_col AS UNSIGNED) FROM t
```
값을 얻으려면 값을 유지하기 위해 충분한 크기의 정수 변수를 바인딩하고 적절한 대응하는 정수 타입 코드를 지정합니다.

컬럼 값 가져 오기에 사용되는 MYSQL_BIND 구조에 변수를 바인딩하기 전에 결과 집합의 각 컬럼의 타입 코드를 확인할 수 있습니다. 이것은 형식 변환을 피하기 위해 사용하는 가장 좋은 변수 유형을 판단 할 때 바람직하다고 생각됩니다. 타입 코드를 얻으려면, mysql_stmt_execute() 에 의해 Prepared Statement을 실행 한 후, mysql_stmt_result_metadata() 를 호출합니다. 메타 데이터는 섹션 23.8.11.23 "mysql_stmt_result_metadata ()" 및 섹션 23.8.5 "C API 데이터 구조" 에서 설명하고있는 바와 같이, 결과 세트의 타입 코드에 대한 액세스를 제공합니다.

서버에서 반환 된 결과 집합의 출력 문자열에 바이너리 데이터가 포함되어 있는지, 비 바이너리 데이터가 포함되어 있는지를 확인하려면 결과 세트 메타 데이터 charsetnr 값이 63인지 여부를 확인 하다합니다 ( 섹션 23.8.5 "C API 데이터 구조" 를 참조하십시오). 이 경우 문자 세트는 binary , 이것은 비 바이너리 데이터가 아닌 바이너리를 나타냅니다. 이로 인해 BINARY 와 CHAR , VARBINARY 과 VARCHAR 및 BLOB 형과 TEXT 형을 구분할 수 있습니다.

MYSQL_FIELD 열 메타 데이터 구조 max_length 멤버를 설정하는 경우 ( mysql_stmt_attr_set() 를 호출하여) 결과 세트의 max_length 값이 이진 표현의 길이가 아니라 결과 값의 긴 문자열 표현의 길이를 나타내는 유의하십시오. 즉, max_length 는 반드시 Prepared Statement에 사용되는 바이너리 프로토콜에 따라 값을 가져 오기 위해 필요한 버퍼의 크기에 대응하고 있지 않습니다. 값을 가져올 변수의 형태에 따라 버퍼 크기를 선택합니다. 예를 들어, 값 -128를 저장하는 TINYINT 컬럼은 4 max_length 값을 가질 수 있습니다. 그러나 TINYINT 값의 이진 표현은 스토리지에 1 바이트만을 필요로하지 않기 때문에 값을 저장하는 signed char 변수를 제공하고 값이 부호임을 나타내는 is_unsigned 를 설정할 수 있습니다.

Prepared Statement에서 참조되는 테이블이나 뷰의 메타 데이터 변경이 감지되고 그것이 다음 실행 때 문이 자동으로 다시 준비됩니다. 자세한 내용은 섹션 8.9.4 "Prepared Statement 및 저장 프로그램 캐시" 를 참조하십시오.