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 문을 실행하는 경우에도 필요합니다. 저장 프로 시저의 결과는 이러한 특성이 있습니다.

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

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

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

앞서 전략의 하나의 가능한 구현을 보여줍니다. 루프의 마지막 부분은 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);