~drizzle-trunk/drizzle/development

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
/* - mode: c; c-basic-offset: 2; indent-tabs-mode: nil; -*-
 *  vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
 *
 *  Copyright 2011 Daniel Nichter
 *
 *  This program is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#pragma once

/**
 * @file
 *   event.h
 *
 * @brief
 *   Defines the event_t struct that encapsulates an event.
 *
 * @details
 *   An event (i.e. a query) has the attributes defined in the event_t struct.
 *   The values come from various members of the Session class.  This is
 *   a necessary redundancy for two reasons.  First, access to this data via
 *   the Session class is not uniform; it requires various calls and
 *   calculations.  Look at QueryLog::afterStatement() to see this.  Second,
 *   because the QueryLog object controls the logger classes, i.e.
 *   QueryLoggerFile and others in the futre, event creation and filtering
 *   is done in one place (QueryLog::afterStatement()) and then acceptable
 *   events are passed to the logger classes so that all they have to do is log.
 *
 *   Since this is just a collection of variables, making this a class
 *   with accessor functions is overkill.
 */
struct event_t {
  // GMT timestamps (2002-01-31T10:00:01.123456)
  std::string ts;

  // integers
  uint32_t session_id;
  uint32_t query_id;
  uint32_t rows_examined;
  uint32_t rows_sent;
  uint32_t tmp_tables;
  uint32_t warnings;

  // times (42.123456)
  double execution_time;
  double lock_time;
  double session_time;

  // bools ("true" or "false")
  const char *error;

  // strings, not quoted or escaped
  const char *schema;

  // query, not quoted or escaped
  const char *query;
};