MySQL 5.6 한글메뉴얼

23.8.17 여러 명령문 실행 C API 지원

기본적으로 mysql_query() 와 mysql_real_query() 는 그 문 문자열 인수를 수행해야하는 하나의 문으로 해석하고 사용자는 문이 결과 세트 (행 세트, SELECT 의 경우)을 생성하거나 또는 영향을받는 행 카운트 ( INSERT , UPDATE 등의 경우)를 생성할지에 따라 결과를 처리합니다.

MySQL 5.6은 세미콜론 ( " ; ") 문자로 구분 된 여러 개의 명령문을 포함하는 문자열의 실행도 지원합니다. 이 기능은 mysql_real_connect() 에 의해 서버에 연결할 때 또는 mysql_set_server_option() 를 호출하여 연결 후 중 하나에 지정되는 특별한 옵션에 의해 활성화됩니다.

여러 문 문자열을 실행하면 여러 결과 집합 또는 행 수 표시를 생성 할 수 있습니다. 이러한 결과의 처리에는 단일 명령문의 경우와 다른 접근 방식이 필요합니다. 첫 번째 문에서 결과를 처리 한 후 더 이상의 결과가 존재하는지 여부를 확인하고있는 경우이를 순서대로 처리해야합니다. 여러 결과의 처리를 지원하기 위해 C API는 mysql_more_results() 함수와 mysql_next_result() 함수가 포함되어 있습니다. 이 함수는 그 이상의 결과가있는 한 반복하는 루프의 마지막에 사용합니다. 결과를 이렇게 처리 할 수없는 서버에 연결이 끊어 질 수 있습니다.

여러 결과 처리는 저장 프로 시저에 대해 CALL 문을 실행하는 경우에도 필요합니다. 저장 프로 시저의 결과는 이러한 특성이 있습니다.

프로 시저의 문은 결과 집합을 생성 할 수 있습니다 (예를 들어, 그것이 SELECT 문을 실행하는 경우 등). 이러한 결과 세트는 프로 시저를 실행하고, 그들이 생성 된 순서로 반환됩니다.

일반적으로 호출자가 프로 시저에서 반환 된 결과 세트 수를 알 수 없습니다. 프로 시저의 실행은 호출마다 실행 경로가 다른 루프와 조건문에 따라 다를 수 있습니다. 따라서 여러 결과를 얻을 수 있도록 준비하고 있어야합니다.
시저의 최종 결과는 결과 세트를 포함하지 않는 상태 결과입니다. 이 상태는 시저가 성공했는지 오류가 발생했는지를 나타냅니다.

여러 문 및 결과 기능은 mysql_query() 또는 mysql_real_query() 와 함께 만 사용할 수 있습니다. 그들은 준비된 명령문 인터페이스와 함께 사용할 수 없습니다. 준비된 문 핸들은 단일 문을 포함하는 문자열만을 사용하도록 정의됩니다. 섹션 23.8.8 "C API 준비된 문" 을 참조하십시오.

다중 문 실행 및 결과 처리를 활성화하려면 다음 옵션을 사용할 수 있습니다.

mysql_real_connect() 함수에는 두 가지 옵션 값이 관련 flags 인수가 있습니다.
- CLIENT_MULTI_RESULTS 통해 클라이언트 프로그램은 여러 결과를 처리 할 수 있습니다. 결과 세트를 생성하는 저장 프로 시저에 대해 CALL 문을 실행하는 경우이 옵션을 활성화해야합니다. 그렇지 않으면 그러한 프로시 저는 오류 Error 1312 (0A000): PROCEDURE proc_name can't return a result set in the given context 를 생성합니다. MySQL 5.6에서는 CLIENT_MULTI_RESULTS 은 기본적으로 활성화되어 있습니다.
- CLIENT_MULTI_STATEMENTS 하여 mysql_query() 및 mysql_real_query() 는 세미콜론으로 구분 된 여러 개의 문이 포함 된 명령문 문자열을 실행할 수 있습니다. 이 옵션은 CLIENT_MULTI_RESULTS 도 암묵적으로 사용되기 때문에 mysql_real_connect() 에 CLIENT_MULTI_STATEMENTS 의 flags 인수는 CLIENT_MULTI_STATEMENTS | CLIENT_MULTI_RESULTS 인수와 동등합니다. 즉, CLIENT_MULTI_STATEMENTS 는 여러 명령문 실행과 모든 여러 결과 처리를 활성화하는 데 충분하다.
서버에 연결이 된 후 mysql_set_server_option() 함수를 사용하여 그것을 MYSQL_OPTION_MULTI_STATEMENTS_ON 또는 MYSQL_OPTION_MULTI_STATEMENTS_OFF 인수에 전달하여 여러 명령문 실행을 활성화하거나 비활성화 할 수 있습니다. 이 함수는 다중 문 실행을 사용하면 여러 문 문자열 "간단한"결과의 처리도 사용할 수 있습니다. 거기에서는 각 문이 하나의 결과를 생성하지만, 결과 세트를 생성하는 저장 프로 시저의 처리를 허용하려면 충분하지 않습니다.

다음과 같이 여러 문 처리의 권장 전략의 개요를 나타냅니다.

CLIENT_MULTI_STATEMENTS 를 mysql_real_connect() 에 전달하여 여러 문 실행 및 여러 결과의 처리를 완전히 활성화합니다.
mysql_query() 또는 mysql_real_query() 를 호출 그것이 성공한 것을 확인한 뒤 명령문 결과를 처리하는 루프에 들어갑니다.
루프 반복마다 현재의 명령문 결과를 처리하고 결과 세트 또는 영향을받은 행 수를 가져옵니다. 오류가 발생하면 루프를 종료합니다.
루프의 끝에서 mysql_next_result() 를 호출하여 다른 결과가 존재하는지 여부를 확인하고 그 경우는 취득을 시작합니다. 그 이상의 결과가 없어지면 루프를 종료합니다.

앞서 전략의 하나의 가능한 구현을 보여줍니다. 루프의 마지막 부분은 mysql_next_result() 가 0이 아닌 반환하는지 간단한 테스트로 단순화 할 수 있습니다. 표시된 코드는 그 이상의 결과가없는 것과 에러를 구분하고이를 통해 후자의 발생에 메시지를 출력 할 수 있습니다.

/* connect to server with the CLIENT_MULTI_STATEMENTS option */
if (mysql_real_connect (mysql, host_name, user_name, password,
    db_name, port_num, socket_name, CLIENT_MULTI_STATEMENTS) == NULL)
{
  printf("mysql_real_connect() failed\n");
  mysql_close(mysql);
  exit(1);
}

/* execute multiple statements */
status = mysql_query(mysql,
                     "DROP TABLE IF EXISTS test_table;\
                      CREATE TABLE test_table(id INT);\
                      INSERT INTO test_table VALUES(10);\
                      UPDATE test_table SET id=20 WHERE id=10;\
                      SELECT * FROM test_table;\
                      DROP TABLE test_table");
if (status)
{
  printf("Could not execute statement(s)");
  mysql_close(mysql);
  exit(0);
}

/* process each statement result */
do {
  /* did current statement return data? */
  result = mysql_store_result(mysql);
  if (result)
  {
    /* yes; process rows and free the result set */
    process_result_set(mysql, result);
    mysql_free_result(result);
  }
  else          /* no result set or error */
  {
    if (mysql_field_count(mysql) == 0)
    {
      printf("%lld rows affected\n",
            mysql_affected_rows(mysql));
    }
    else  /* some error occurred */
    {
      printf("Could not retrieve result set\n");
      break;
    }
  }
  /* more results? -1 = no, >0 = error, 0 = yes (keep looping) */
  if ((status = mysql_next_result(mysql)) > 0)
    printf("Could not execute statement\n");
} while (status == 0);

mysql_close(mysql);