RussianLDP Рейтинг@Mail.ru
WebMoney: 
WMZ Z294115950220 
WMR R409981405661 
WME E134003968233 
Visa 
4274 3200 2453 6495 

Глава 2. NDB API

Резюме

Эта глава содержит информацию о API NDB, который используется, чтобы написать приложения, работающие с данными в NDB.

2.1. Начало работы с NDB API

Эта секция обсуждает приготовления, необходимые для написания и компилирования приложения API NDB.

2.1.1. Компилирование и компоновка программ NDB API

Резюме

Эта секция предоставляет информацию о компилировании и компоновке приложения NDB API, включая требования и варианты компоновщика и компилятора.

2.1.1.1. Общие требования

Чтобы использовать API NDB с MySQL, вы должны иметь библиотеку клиента libndbclient и ее связанные заголовочные файлы, они устанавливаются вместе с обычными библиотеками клиента MySQL и заголовками. Они автоматически устанавливаются, когда вы собираете MySQL с опцией -DWITH_NDBCLUSTER=ON или используете двоичный пакет, который поддерживает NDB.

Это руководство предназначено для использования с MySQL NDB Cluster 7.2 и выше.

2.1.1.2. Параметры компилятора

Заголовочные файлы. Чтобы собрать исходные файлы, которые используют API NDB, необходимо гарантировать, что необходимые заголовочные файлы могут быть найдены. Заголовочные файлы, определенные для NDB и MGM API, устанавливаются в следующих подкаталогах MySQL include:

  • include/mysql/storage/ndb/ndbapi

  • include/mysql/storage/ndb/mgmapi

Флаги компилятора. MySQL-определенные необходимые флаги компилятора могут быть определены, используя утилиту mysql_config, которая является частью установки MySQL:

$ mysql_config --cflags -I/usr/local/mysql/include/mysql -Wreturn-type \
               -Wtrigraphs -W -Wformat -Wsign-compare \
               -Wunused-mcpu=pentium4 -march=pentium4

Это устанавливает путь включения для заголовочных файлов MySQL, но не для определенных для API NDB. Опция --include в mysql_config возвращает общий путь включения:

shell> mysql_config --include
-I/usr/local/mysql/include/mysql

Необходимо добавить пути подкаталога явно, чтобы добавление всего необходимого собрало флаги к переменной оболочки CXXFLAGS, которая должна выглядеть примерно так:

CFLAGS="$CFLAGS "`mysql_config --cflags`
CFLAGS="$CFLAGS "`mysql_config --include`/storage/ndb
CFLAGS="$CFLAGS "`mysql_config --include`/storage/ndb/ndbapi
CFLAGS="$CFLAGS "`mysql_config --include`/storage/ndb/mgmapi

Если вы не намереваетесь использовать функции управления NDB Cluster, последняя строка в предыдущем примере может быть опущена. Однако, если вы интересуетесь только функциями управления и не хотите получить доступ к данным NDB Cluster кроме как из MySQL, тогда можно опустить строку, ссылающуюся на каталог ndbapi.

2.1.1.3. Опции компоновки

Приложения NDB API должны быть скомпонованы с библиотеками клиента MySQL и NDB. Библиотеки NDB также требует некоторых функций от библиотеки mystrings, таким образом, это должно быть также учтено.

Необходимые флаги компоновщика для библиотеки клиента MySQL возвращены mysql_config --libs. Для многопоточных приложений необходимо использовать --libs_r:

$ mysql_config --libs_r -L/usr/local/mysql-5.1/lib/mysql -lmysqlclient_r \
               -lz -lpthread -lcrypt -lnsl -lm -lpthread \
               -L/usr/lib -lssl -lcrypto

Теперь необходимо только добавить -lndbclient в LD_FLAGS:

LDFLAGS="$LDFLAGS "`mysql_config --libs_r`
LDFLAGS="$LDFLAGS -lndbclient"

2.1.1.4. Применение Autotools

Это часто быстрее и более просто использовать автоинструменты GNU, чем написать ваши собственные make-файлы. В этой секции мы обеспечиваем макрос autoconf WITH_MYSQL, который может использоваться, чтобы добавить --with-mysql к файлу конфигурации, и это автоматически устанавливает правильный компилятор и флаги компоновщика для данной установки MySQL.

Все примеры в этой главе включают общий файл mysql.m4 с определением WITH_MYSQL. Типичный полный пример состоит из фактического исходного файла и следующих файлов помощника:

  • acinclude

  • configure.in

  • Makefile.m4

automake также требует, чтобы вы обеспечили файлы README, NEWS, AUTHORS и ChangeLog, однако, их можно оставить пустыми.

Чтобы создать все необходимые файлы, скомандуйте:

aclocal
autoconf
automake -a -c
configure --with-mysql=/mysql/prefix/path

Обычно это должно быть сделано только однажды, после чего make приспосабливает любые изменения файла.

Пример 1-1: acinclude.m4.

m4_include([../mysql.m4])

Пример 1-2: configure.in.

AC_INIT(example, 1.0)
AM_INIT_AUTOMAKE(example, 1.0)
WITH_MYSQL()
AC_OUTPUT(Makefile)

Пример 1-3: Makefile.am.

bin_PROGRAMS = example
example_SOURCES = example.cc

Пример 1-4: WITH_MYSQL для включения в acinclude.m4.

dnl
dnl configure.in helper macros
dnl

AC_DEFUN([WITH_MYSQL], [
  AC_MSG_CHECKING(for mysql_config executable)
  AC_ARG_WITH(mysql, [--with-mysql=PATH path to mysql_config binary or mysql prefix dir], [
    if test -x $withval -a -f $withval then
       MYSQL_CONFIG=$withval
    elif test -x $withval/bin/mysql_config -a -f $withval/bin/mysql_config then
      MYSQL_CONFIG=$withval/bin/mysql_config
    fi
  ], [
    if test -x /usr/local/mysql/bin/mysql_config -a -f /usr/local/mysql/bin/mysql_config then
       MYSQL_CONFIG=/usr/local/mysql/bin/mysql_config
    elif test -x /usr/bin/mysql_config -a -f /usr/bin/mysql_config then
      MYSQL_CONFIG=/usr/bin/mysql_config
    fi
  ])
  if test "x$MYSQL_CONFIG" = "x" then
     AC_MSG_RESULT(not found)
     exit 3
  else
    AC_PROG_CC
    AC_PROG_CXX
    # add regular MySQL C flags
    ADDFLAGS=`$MYSQL_CONFIG --cflags`
    # add NDB API specific C flags
    IBASE=`$MYSQL_CONFIG --include`
    ADDFLAGS="$ADDFLAGS $IBASE/storage/ndb"
    ADDFLAGS="$ADDFLAGS $IBASE/storage/ndb/ndbapi"
    ADDFLAGS="$ADDFLAGS $IBASE/storage/ndb/mgmapi"
    CFLAGS="$CFLAGS $ADDFLAGS"
    CXXFLAGS="$CXXFLAGS $ADDFLAGS"
    LDFLAGS="$LDFLAGS "`$MYSQL_CONFIG --libs_r`" -lndbclient -lmystrings -lmysys"
    LDFLAGS="$LDFLAGS "`$MYSQL_CONFIG --libs_r`" -lndbclient -lmystrings"
    AC_MSG_RESULT($MYSQL_CONFIG)
  fi
])

2.1.2. Соединение с кластером

Резюме

Эта секция показывает подключение к NDB Cluster.

2.1.2.1. Включаемые файлы

Приложения NDB API требуют один или больше включаемых файлов:

  • Приложения, получающие доступ к данным NDB Cluster через NDB API, должны включать файл NdbApi.hpp.

  • Приложения, использующие клиентский MySQL API, а также API NDB, должны также включать mysql.h (в дополнение к NdbApi.hpp).

  • Для приложений, которые используют функции управления NDB Cluster из MGM API нужен файл mgmapi.h.

2.1.2.2. Инициализация и парковка API

Перед использованием API NDB это должно сначала быть инициализировано вызовом функции ndb_init().

Как только применение API NDB завершено, можно вызвать ndb_end(0), чтобы выполнить любую необходимую очистку. Следует иметь в виду что, прежде чем вы вызовете эту функцию, все объекты Ndb_cluster_connection, созданные в вашем приложении NDB API, должны быть очищены или разрушены, иначе потоки, созданные, когда вызывался метод connect() объекта Ndb_cluster_connection, не выходят правильно, что вызывает ошибки после завершения программы. Когда Ndb_cluster_connection создается статически, вы не должны вызвать ndb_end() в том же самом объеме, как объект связи. Когда объект связи создается динамично, можно разрушить его использованием delete() перед вызовом ndb_end().

Каждая из функций ndb_init() и ndb_end() определяется в файле storage/ndb/include/ndb_init.h.

Должно быть возможно использовать fork() в NDB API, но необходимо сделать так до запроса ndb_init() или my_init(), чтобы не разделять такие ресурсы, как файлы и связи между процессами.

2.1.2.3. Установление связи

Чтобы установить связь с сервером, необходимо создать экземпляр Ndb_cluster_connection, чей конструктор берет в качестве его аргумента строку подключения. Если никакая строка подключения не задана, предполагается localhost.

Связь кластера на самом деле не начинается до вызова метода Ndb_cluster_connection::connect(). Когда вызвано без любых аргументов, попытка подключения повторена неопределенно долго, однажды в секунду, до успеха. Никакое сообщение не сделано, пока связь не будет установлена.

По умолчанию узел API соединяется с ближайшим узлом данных. Это обычно узел данных на той же самой машине как самый близкий вследствие того, что транспортировка общей памяти может использоваться вместо медленного TCP/IP. Это может привести к плохому распределению нагрузки в некоторых случаях, таким образом, возможно провести в жизнь циклическую схему связи узла, вызывая метод set_optimized_node_selection() с 0 как его аргумент до запроса connect().

connect() начинает связь только с узлом управления NDB Cluster. Чтобы позволить связи с узлами данных, надо использовать wait_until_ready() после connect(), wait_until_ready() ждет заданное число секунд для связи с узлом данных, который будет установлен.

В следующем примере инициализация и связь обработаны в двух функциях example_init() и example_end(), которые включены в последующие примеры посредством включения файла example_connection.h.

Пример 2-1: Пример связи.

#include <stdio.h>
#include <stdlib.h>
#include <NdbApi.hpp>
#include <mysql.h>
#include <mgmapi.h>

Ndb_cluster_connection* connect_to_cluster();
void disconnect_from_cluster(Ndb_cluster_connection *c);
Ndb_cluster_connection* connect_to_cluster()
{
  Ndb_cluster_connection* c;
  if (ndb_init()) exit(EXIT_FAILURE);
  c= new Ndb_cluster_connection();
  if (c->connect(4, 5, 1))
  {
     fprintf(stderr, "Unable to connect to cluster within 30 seconds.\n\n");
     exit(EXIT_FAILURE);
  }
  if (c->wait_until_ready(30, 0) < 0)
  {
     fprintf(stderr, "Cluster was not ready within 30 seconds.\n\n");
     exit(EXIT_FAILURE);
  }
  return c;
}

void disconnect_from_cluster(Ndb_cluster_connection *c)
{
  delete c;
  ndb_end(2);
}

int main(int argc, char* argv[])
{
  Ndb_cluster_connection *ndb_connection= connect_to_cluster();
  printf("Connection Established.\n\n");
  disconnect_from_cluster(ndb_connection);
  return EXIT_SUCCESS;
}

2.1.3. Отображение имен объектов базы данных MySQL и типов к NDB

Резюме

Следующие две секции обсуждают обозначение и другие соглашения, сопровождаемые API NDB относительно объектов базы данных MySQL, а также обработку типов данных MySQL в приложениях API NDB.

2.1.3.1. Имена объектов базы данных MySQL в API NDB

Эта секция обсуждает отображение объектов базы данных MySQL к API NDB.

Базы данных и схемы. Базы данных и схемы не представляются объектами как таковыми в API NDB. Вместо этого они смоделированы как признаки объектов Table и Index. Значение признака database одного из этих объектов всегда то же самое, как название базы данных MySQL, которой принадлежат таблица или индекс. Значение признака Table или Index объекта всегда 'def' (для default).

Таблицы. Имена таблиц MySQL непосредственно отображены к именам таблиц NDB без модификации. Имена таблиц, начинающиеся с 'NDB$', резервируются для внутреннего пользования, как таблица SYSTAB_0 в базе данных sys.

Индексы. Есть два типа индексов NDB:

  • Hash indexes уникальны, но не сортированы.

  • B-tree indexes сортированы, но разрешают двойные значения.

Названия уникальных индексов и первичных ключей обработаны следующим образом:

  • Для MySQL индекс UNIQUE, создаются хэш-индекс и B-tree. Индекс B-tree использует название MySQL индекса, название хэш-индекса произведено, приложив '$unique' к имени индекса.

  • Для первичного ключа MySQL создается только индекс B-tree. Этому индексу дают имя PRIMARY. Нет никакого дополнительного хэша, однако, уникальность первичного ключа гарантируется, заставляя MySQL включить внутренний первичный ключ таблицы NDB.

Имена столбцов и значения. Имена столбцов NDB совпадают со своими названиями в MySQL.

2.1.3.2. Обработка NDB API типов данных MySQL

Эта секция предоставляет информацию о пути, которым типы данных MySQL представляются в столбцах таблицы NDBCLUSTER и как к этим значениям можно получить доступ в приложениях NDB API.

Типы числовых данных. Типы данных MySQL TINYINT, SMALLINT, INT и BIGINT отображаются к типам NDB, имеющим те же самые имена и требования хранения, как их коллеги из MySQL.

Типы данных MySQL FLOAT и DOUBLE отображаются к типам NDB, имеющим те же самые имена и требования хранения.

Типы символьных данных. Пространство памяти для столбцов MySQL CHAR определяется максимальным количеством знаков и набором символов колонки. Для большинства (но не всех) наборов символов, каждый символ берет один байт. Используя utf8, каждый символ требует трех байт, utfmb4 требует до четырех байт на символ. Можно сосчитать максимальное количество байт, необходимых на символ в данном наборе символов, проверив колонку Maxlen в выводе SHOW CHARACTER SET.

Значение столбца NDB VARCHAR отображает MySQL VARCHAR, за исключением того, что первые два байта NDB VARCHAR резервируются для длины последовательности. Сервисная функция, как показано здесь, может сделать значение VARCHAR готовым к употреблению в приложении NDB API:

void make_ndb_varchar(char *buffer, char *str)
{
  int len = strlen(str);
  int hlen = (len > 255) ? 2 : 1;
  buffer[0] = len & 0xff;
  if (len > 255) buffer[1] = (len / 256);
  strcpy(buffer+hlen, str);
}

Можно использовать эту функцию как показано здесь:

char myVal[128+1];   // Size of myVal (+1 for length)
...
make_ndb_varchar(myVal, "NDB is way cool!!");
myOperation->setValue("myVal", myVal);

См. раздел 2.5.11 для полного примера программы, который пишет и читает значения VARCHAR и VARBINARY в и мз таблицы, используя API NDB.

Требования хранения MySQL для столбцов VARCHAR или VARBINARY зависят от того, сохранена ли колонка в памяти или на диске:

  • Для колонок в памяти NDB поддерживает колонки переменной ширины с 4-байтовым выравниванием. Это означает что (например), последовательность 'abcde', сохраненная в столбце VARCHAR(50), используя набор символов latin1, занимает 12 байтов: в этом случае 2-байтовые 5 символов это 10, округленные к следующему кратному 4 значению, дают 12.

  • Для дисковых столбцов данных VARCHAR и VARBINARY сохранены как столбцы фиксированной ширины. Это означает, что каждый из этих типов требует того же самого объема хранения, как CHAR того же самого размера.

Каждая строка в столбце NDB Cluster BLOB или TEXT составлена из двух отдельных частей. Одна из них имеет фиксированный размер (256 байтов) и на самом деле сохранена в оригинальной таблице. Другая состоит из любых данных сверх 256 байтов, которые сохранили в скрытой таблице. Строки в ней всегда 2000 байт длиной. Это означает, что запись size байт TEXT или BLOB требует:

  • 256 байт, если size <= 256.

  • 256+2000* ((size-256)\2000)+1) байт иначе.

Временные типы данных. Хранение временных типов в API NDB зависит от того, используются ли старые типы MySQL без долей секунды или новые типы с поддержкой доли секунды. Поддержка долей секунды была введена в MySQL 5.6, а также версиях NDB Cluster на основе его, то есть NDB 7.3 и NDB 7.4. Эти версии используют новые временные типы по умолчанию, но могут использовать старые, запуская mysqld с опцией --create-old-temporals=ON. NDB 7.5 и позже, то есть, версии NDB Cluster на основе MySQL 5.7 и позже, могут прочитать и написать данные, используя старые временные типы, но не могут составить таблицы, которые используют старые типы. Посмотрите Fractional Seconds in Time Values.

Поскольку поддержка старых временных типов будет удалена в будущем выпуске, вы поощряетесь мигрировать любые таблицы, используя старые временные типы для новых версий этих типов. Можно сделать это, выполнив ALTER TABLE на любой таблице, использующей старые типы, или посредством поддержки и восстановления любых таких таблиц.

Вы видите, использует ли данная таблица старые или новые временные типы, проверяя вывод ndb_desc, поставляемой с NDB Cluster. Считайте таблицу, созданную в базе данных test, используя следующую команду, при запуске mysqld без опции --create-old-temporals:

CREATE TABLE t1 (c1 DATETIME, c2 DATE, c3 TIME, c4 TIMESTAMP,
                 c5 YEAR) ENGINE=NDB;

Соответствующая часть (блок Attributes) вывода ndb_desc:

shell> ndb_desc -dtest t1
...
-- Attributes --
c1 Datetime2(0) NULL AT=FIXED ST=MEMORY
c2 Date NULL AT=FIXED ST=MEMORY
c3 Time2(0) NULL AT=FIXED ST=MEMORY
c4 Timestamp2(0) NOT NULL AT=FIXED ST=MEMORY DEFAULT 0
c5 Year NULL AT=FIXED ST=MEMORY

Названия новых временных типов MySQL имеют суффикс с 2 (например, Datetime2). Предположите, что мы перезапускаем mysqld с --create-old-temporals=ON и затем составьте таблицу t2, также в базе данных test:

CREATE TABLE t2 (c1 DATETIME, c2 DATE, c3 TIME,
                 c4 TIMESTAMP, c5 YEAR) ENGINE=NDB;

Вывод от выполнения ndb_desc на этой таблице включает блок Attributes:

shell> ndb_desc -dtest t2
...
-- Attributes --
c1 Datetime NULL AT=FIXED ST=MEMORY
c2 Date NULL AT=FIXED ST=MEMORY
c3 Time NULL AT=FIXED ST=MEMORY
c4 Timestamp NOT NULL AT=FIXED ST=MEMORY DEFAULT 0
c5 Year NULL AT=FIXED ST=MEMORY

Затронутые типы MySQL: TIME, DATETIME и TIMESTAMP. Новые версии этих типов отражены в API NDB как Time2, Datetime2, and Timestamp2, соответственно, каждый поддерживает доли секунды максимум с 6 цифрами точности. Новые варианты используют кодирование с обратным порядком байтов целочисленных значений, которые обрабатываются, чтобы определить компоненты каждого временного типа.

Для части доли секунды каждого из этих типов точность затрагивает число необходимых байтов, как показано в следующей таблице:

Таблица 2.1. Точность новых временных типов NDB API

Точность Надо байтДиапазон
00Нет
110-9
210-99
320-999
420-9999
530-99999
630-999999

Дробная часть для каждого из новых временных типов сохранена в формате с обратным порядком байтов, то есть, с самым старшим байтом в начале.

Двоичные расположения старых и новых версий этих типов описаны в следующих нескольких параграфах.

Time: Старая версия типа сохранена как 24-bit signed int в формате с прямым порядком байтов (младший байт первый. Байт 0 (биты 0-7) соответствует часам, байт 2 (биты 8-15) минутам и байт 2 (биты 16-23) секундам, согласно этой формуле:

value = 10000 * hour + 100 * minute + second

Бит 23 служит знаковым битом, если этот бит установлен, временное значение считают отрицательным.

Time2: Новый тип TIME добавлен в NDB 7.3 и 7.4 (MySQL 5.6) и сохранен как 3-байтовый обратный порядок байтов и от 0 до 3 байт для дробной части. Целая часть закодирована как показано в следующей таблице:

Таблица 2.2. Кодирование Time2

БитыСмысл Диапазон
23Знаковый бит0-1
22Интервал0-1
22-13Час1-1023
12-7Минута0-63
6-0Секунда0-63

Любые дробные байты в дополнение к этому обработаны, как описано ранее.

Date: Представление для типа MySQL DATE не изменено через версии NDB и использует 3-байтовое целое число без знака, сохраненное с прямым порядком байтов. Кодирование показано здесь:

Таблица 2.3. Кодирование Date

БитыСмысл Диапазон
23-9Год0-32767
8-5Месяц0-15
4-0День0-31

Datetime: Старая версия типа MySQL DATETIME представляется 64-битным unsigned значением, сохраненным в порядке байтов хоста с использованием следующей формулы:

value = second + minute * 102 + hour * 104
        + day * 106 + month * 108
        + year * 1010

DateTime2: Новый тип DATETIME закодирован как 5-байтовый обратный порядок байтов с дополнительной дробной частью от 0 до 3 байт, дробная часть обрабатывается как описано ранее. Старшие 5 байт закодированы как показано здесь:

Таблица 2.4. Кодирование DateTime2

БитыСмысл Диапазон
23Знаковый бит0-1
22Интервал0-1
22-13Час1-1023
12-7Минута0-63
6-0Секунда0-63

Биты YearMonth закодированы как Year = YearMonth / 13 и Month = YearMonth % 13.

Timestamp: Старая версия этого типа использует 32-битное unsigned значение секунд с начала эпохи Unix, сохраненное в порядке байтов хоста.

Timestamp2: Это версия TIMESTAMP в NDB 7.3 и 7.4 (MySQL 5.6) использует 4 байта с обратным порядком байтов для integer (unsigned). Дополнительная 3-байтовая дробная часть закодирована как показано ранее в этой секции.

Дополнительная информация. Больше информации и примеров как выражены в API NDB типы данных можно найти в ndb/src/common/util/NdbSqlUtil.cpp. См. также раздел 2.5.13, который обеспечивает пример простого применения API NDB, которое использует тип данных Timestamp2.

2.2. Иерархия классов NDB API

Эта секция предоставляет иерархический список всех классов, интерфейсов и структур, выставленных API NDB.

2.3. Классы, интерфейсы и структуры NDB API

Эта секция предоставляет подробный список всех классов, интерфейсов и структур, определенных в NDB API.

Каждый листинг включает следующую информацию:

  • Описание и цель класса, интерфейса или структуры.

  • Указатели, когда это применимо, к родительским и дочерним классам.

  • Подробные списки всех публичных членов, включая описания всех параметров методов и типов значений.

Класс, интерфейс и описания структуры обеспечиваются в алфавитном порядке. Для иерархического листинга посмотрите раздел 2.2.

2.3.1. Структура AutoGrowSpecification

Резюме

Эта секция описывает структуру AutoGrowSpecification.

Родительский класс. NdbDictionary .

Описание. AutoGrowSpecification это структура данных, определенная в классе NdbDictionary и применяется в качестве параметра или возвращаемого значения некоторых методов классов Tablespace и LogfileGroup, см. разделы 2.3.38 и 2.3.13.

Методы. AutoGrowSpecification имеет следующие методы:

Таблица 2.5. NdbDictionary::AutoGrowSpecification

Имя Описание
min_free ???
max_size ???
file_size ???
filename_pattern ???

2.3.2. Класс Column

Резюме

Этот класс представляет колонку в таблице NDB Cluster.

Родительский класс. NdbDictionary

Дочерние классы. Нет

Описание. Каждый экземпляр Column символизуется его типом, который определяется многими спецификаторами типа:

  • Встроенный тип

  • Длина массива или максимальная длина

  • Точность и масштаб ( в настоящее время не применяется)

  • Набор символов (применим только к столбецм, используя строковые типы данных

  • Размеры частей (применим только к столбцам BLOB)

Эти типы в целом соответствуют типам данных MySQL и их вариантам. Форматы данных те же самые, как в MySQL. API NDB не оказывает поддержки для создания таких форматов, однако, они проверяются ядром NDB.

Методы. В следующей таблице перечислены публичные методы этого класса и цели использования каждого метода:

Таблица 2.6.

Метод Описание
Column() Конструктор класса, есть также конструктор копии
~Column() Деструктор класса
equal() Сравнивает объекты Column
getArrayType() Получает тип массива колонки
getCharset() Используемый набор символов последовательности (текста) столбца (неприменим к столбецм, не хранящим данные о символах)
getColumnNo() Получает номер столбца
getDefaultValue() Возвращает значение по умолчанию столбца
getInlineSize() Получает действующий размер BLOB (неприменим к другим типам столбца)
getLength() Получает длину столбца
getName() Получает название столбца
getNullable() Проверяет, может ли столбец быть установлен в NULL
getPartitionKey() Проверяет, является ли столбец частью ключа разделения таблицы
getPartSize() Получает размер части BLOB (неприменим к другим типам столбца)
getPrecision() Получает точность колонки (используемый только для десятичных типов)
getPrimaryKey() Проверяет, является ли столбец частью первичного ключа таблицы
getScale() Получает масштаб колонки (используемый только для десятичных типов)
getSize() Получает размер элемента
getSizeInBytesForRecord() Получает пространство, требуемое для колонки NdbRecord , согласно типу колонки (добавлен в NDB 7.3.10 и NDB 7.4.7)
getStripeSize() Получает размер полосы колонки BLOB (неприменим к другим типам столбца)
getStorageType() Получает тип хранения этой колонки
getType() Получает тип колонки (значение Type )
setArrayType() Устанавливает ArrayType столбца
setCharset() Устанавливает набор символов, используемый колонкой, содержащей данные о символах (неприменим к нетекстовым столбецам)
setDefaultValue() Устанавливает значение столбца по умолчанию
setInlineSize() Устанавливает действующий размер для столбца BLOB (неприменим к столбцам не-BLOB)
setLength() Устанавливает длину колонки
setName() Определяет имя колонки
setNullable() Переключает возможность задания столбцу значения null
setPartitionKey() Определяет, является ли столбец частью ключа разделения таблицы
setPartSize() Устанавливает размер части для столбца BLOB (неприменим к не-BLOB)
setPrecision() Устанавливает точность колонки (используемый только для десятичных типов)
setPrimaryKey() Определяет, является ли столбец частью первичного ключа
setScale() Устанавливает масштаб колонки (используемый только для десятичных типов)
setStorageType() Устанавливает тип хранения этого столбца
setStripeSize() Устанавливает размер полосы для BLOB (неприменим к не-BLOB)
setType() Устанавливает Type столбца

Для подробных описаний и примеров использования для каждого из этих методов см. раздел 2.3.2.4.

Столбцы, созданные этим классом, невидимы для MySQL Server. Это означает, что к ним не могут получить доступ клиенты MySQL, и что они не могут копироваться. По этим причинам часто предпочтительно избежать работать с ними.

В NDB API имена столбцов обработаны чувствительным к регистру способом. Это отличается от MySQL C API. Чтобы уменьшить возможность для ошибки, рекомендуется, чтобы вы последовательно называли все колонки, используя верхний регистр или строчные буквы.

Типы. Это публичные типы класса Column:

Таблица 2.7.

Тип Описание
ArrayType Определяет формат внутренней памяти колонки
StorageType Определяет, сохранен ли столбец в памяти или на диске
Type Тип данных колонки. У столбцов NDB есть те же самые типы данных, как в MySQL

2.3.2.1. Column::ArrayType

Резюме

Этот тип описывает внутренний формат признака Column.

Описание. Формат хранения признака может быть фиксированным или переменным.

Возможные значения. Возможные значения показывают с описаниями в следующей таблице:

Таблица 2.8.

Имя Описание
ArrayTypeFixed сохраненный как постоянное число байтов
ArrayTypeShortVar сохраненный как переменное число байтов, дополнительно 1 байт
ArrayTypeMediumVar сохраненный как переменное число байтов, дополнительно 2 байта

Фиксированный формат хранения быстрее, но также обычно требует большего количества пространства, чем переменный формат. По умолчанию ArrayTypeShortVar для типов Var* и ArrayTypeFixed для остальных. Этого обычно хватает.

2.3.2.2. Column::StorageType

Резюме

Этот тип описывает тип хранения, используемый объектом Column.

Описание. Тип хранения, используемый для данной колонки, может быть в памяти или на диске. Колонки, сохраненные на диске, означают, что меньше RAM требуется в целом, но такие колонки не могут быть внесены в индекс и потенциально намного медленнее по доступу. Умолчание StorageTypeMemory.

Возможные значения.

Таблица 2.9.

Имя Описание
StorageTypeMemory Сохраните колонку в памяти
StorageTypeDisk Сохраните колонку на диске

2.3.2.3. Column::Type

Резюме

Type используется, чтобы описать тип данных объекта Column .

Описание. Типы данных для объектов Column походят на типы данных, используемые MySQL. Типы Tinyint, Tinyintunsigned, Smallint, Smallunsigned, Mediumint, Mediumunsigned, Int, Unsigned, Bigint, Bigunsigned, Float и Double (то есть, типы с Tinyint до Double в порядке, перечисленном в таблице Enumeration Values) могут использоваться в множествах.

Возможные значения.

Таблица 2.10.

Имя Описание
Undefined Не определено
Tinyint 1-byte signed integer
Tinyunsigned 1-byte unsigned integer
Smallint 2-byte signed integer
Smallunsigned 2-byte unsigned integer
Mediumint 3-byte signed integer
Mediumunsigned 3-byte unsigned integer
Int 4-byte signed integer
Unsigned 4-byte unsigned integer
Bigint 8-byte signed integer
Bigunsigned 8-byte signed integer
Float 4-byte float
Double 8-byte float
Olddecimal Signed decimal используется до MySQL 5.0
Olddecimalunsigned Unsigned decimal используется до MySQL 5.0
Decimal Signed decimal используется в MySQL 5.0 и позже
Decimalunsigned Unsigned decimal используется в MySQL 5.0 и позже
Char Множество фиксированной длины из 1-байтовых символов, максимальная длина 255 символов
Varchar Множество переменной длины из 1-байтовых символов, максимальная длина 255 символов
Binary Множество фиксированной длины из 1-байтовых двоичных символов, максимальная длина 255 символов
Varbinary Множество переменной длины из 1-байтовых двоичных символов, максимальная длина 255 символов
Datetime 8-байтовое значение даты и времени с точностью 1 секунда (устарело)
Date 4-байтовое значение даты, с точностью 1 день
Blob Blob, см. раздел 2.3.18
Text Текстовый вариант blob
Bit Битовое значение, длина определяет число битов
Longvarchar 2-байтный Varchar
Longvarbinary 2-байтный Varbinary
Time Время без даты (устарел)
Year 1-байтовое значение года в диапазоне 1901-2155 (то же самое, как в MySQL)
Timestamp Unix time (устарел)
Time2 Время без даты с долями секунды. Добавлен в NDB 7.3.1.
Datetime2 8-байтовое значение даты и времени с долями секунды. Добавлен в NDB 7.3.1.
Timestamp2 Unix time с долями секунды. Добавлен в NDB 7.3.1.

Начиная с NDB 7.3.1, NDB API обеспечивает доступ к типам времени с микросекундами, добавленными в MySQL 5.6 ( TIME, DATETIME и TIMESTAMP) как Time2, Datetime2 и Timestamp2. Time, Datetime и Timestamp устарели с той же самой версии. Используйте setPrecision(), чтобы установить до 6 дробных цифр (по умолчанию 0). Форматы данных как в MySQL и должны использовать правильную длину в байтах. С тех пор, как NDB может сравнить любое из этих значений как двоичные строки, это не выполняет проверок на фактических данные.

Не путайте Column::Type с Object::Type.

2.3.2.4. Методы Column

Резюме

Эта секция документирует публичные методы класса Column.

Оператор присваивания (=) перегружен для этого класса, так, чтобы он всегда выполнил глубокую копию.

Как с другими объектами базы данных, создание объекта Column и изменения признака существующих столбцов, сделанных, используя API NDB, невидимы из MySQL. Например, если вы изменяете тип данных с использованием колонки Column::setType(), MySQL расценит тип колонки, как являющейся неизменным. Единственное исключение к этому правилу относительно столбцов: можно поменять имя существующего столбца с использованием Column::setName().

Также помните, что API NDB обращается с именами столбцов чувствительным к регистру способом.

2.3.2.4.1. Column Constructor

Описание. Можно создать новый Column или скопировать существующий, используя конструктор класса.

Column, созданный с использованием API NDB, невидим сервером MySQL.

API NDB обращается с именами столбцов чувствительным к регистру способом. Например, если вы создадите колонку, названную myColumn, вы не будете в состоянии получить доступ к ней позже, используя имя Mycolumn. Можно уменьшить возможность для ошибки, назвав все колонки последовательно, используя только какой-то один регистр.

Сигнатура. Можно создать любой новый экземпляр класс Column или скопировать существующий объект Column:

  • Конструктор для нового Column:

    Column
    (
      const char* name = ""
    )
    
  • Конструктор копии:

    Column
    (
      const Column& column
    )
    

Параметры. Создавая новый экземпляр Column, конструктор берет отдельный аргумент, который является названием новой колонки, которая будет создана. Конструктор копии также берет один параметр, в этом случае, это ссылка на копируемый экземпляр Column.

Возвращаемое значение. Объект Column .

Деструктор. Деструктор класса Column не берет аргументов.

2.3.2.4.2. Column::equal()

Описание. Этот метод используется, чтобы сравнить Column с другим, чтобы определить, одинаковы ли два объекта Column.

Сигнатура.

bool equal
(
  const Column& column
) const

Параметры. equal() берет единственный параметр, ссылку на экземпляр Column.

Возвращаемое значение. true, если сравниваемые колонки равны, иначе false.

2.3.2.4.3. Column::getArrayType()

Описание. Этот метод получает тип массива колонки.

Сигнатура.

ArrayType getArrayType
(
  void
) const

Параметры. Нет.

Возвращаемое значение. ArrayType, см. раздел 2.3.2.1.

2.3.2.4.4. Column::getCharset()

Описание. Это вернет набор символов столбца.

Этот метод применим только к столбецм, чей Type Char, Varchar или Text.

NDB APIобращается с именами столбцов чувствительным к регистру способом, myColumn и Mycolumn это разные столбцы.

Сигнатура.

CHARSET_INFO* getCharset
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Указатель на структуру CHARSET_INFO, определяющую набор символов и сопоставление. Это совпадает со структурой MySQL MY_CHARSET_INFO, см. mysql_get_character_set_info() в MySQL Manual.

2.3.2.4.5. Column::getColumnNo()

Описание. Этот метод получает порядковый номер колонки в рамках ее таблицы или индекса. Если столбец часть индекса (такой как тогда, когда возвращено getColumn()), это отображено к его положению в том индексе, а не в таблице, содержащей индекс.

Сигнатура.

int getColumnNo
(
void
) const

Параметры. Нет.

Возвращаемое значение. Номер столбца как integer.

2.3.2.4.6. Column::getDefaultValue()

Описание. Получает данные о значении столбца по умолчанию.

Чтобы определить, есть ли у таблицы какие-либо колонки со значениями по умолчанию, надо использовать Table::hasDefaultValues().

Сигнатура.

const void* getDefaultValue
(
  unsigned int* len = 0
) const

Параметры. len содержит длину значения по умолчанию или 0, если столбец может быть null или не имеет никакого значения по умолчанию.

Возвращаемое значение. Данные о значении по умолчанию.

2.3.2.4.7. Column::getInlineSize()

Описание. Этот метод получает действующий размер BLOB то есть, число начальных байтов, чтобы сохранить в признаке blob таблицы. Эта часть обычно находится в оперативной памяти и может быть внесена в индекс.

Этот метод применим только к столбцам BLOB.

Сигнатура.

int getInlineSize
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Действующий размер колонки BLOB как integer.

2.3.2.4.8. Column::getLength()

Описание. Этот метод получает длину колонки. Это длина массива для колонки или максимальная длина для множества переменной длины.

Сигнатура.

int getLength
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Максимальная длина массива колонки как integer.

2.3.2.4.9. Column::getName()

Описание. Этот метод возвращает название колонки, для которой его вызывают.

Сигнатура.

const char* getName
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Название колонки.

2.3.2.4.10. Column::getNullable()

Описание. Этот метод используется, чтобы определить, может ли столбец быть установлен в NULL.

Сигнатура.

bool getNullable
(
  void
) const

Параметры. Нет.

Возвращаемое значение. true, если столбец может быть установлен в NULL, иначе false.

2.3.2.4.11. Column::getPartitionKey()

Описание. Этот метод используется, чтобы проверить, является ли столбец частью ключа разделения таблицы.

Ключ разделения это ряд признаков, используемых, чтобы распределить кортежи на узлы данных. Этот ключ это хеш-функция, определенная для NDB.

Примером, где это было бы полезно, является применение отслеживания ресурсов, включающее многократные склады и регионы, где могло бы быть хорошо использовать ID склада и id округа как ключ разделения. Это поместило бы все данные для определенного района и склада в том же самом узле хранения. В местном масштабе к каждому фрагменту полный первичный ключ будет все еще использоваться с алгоритмом хеширования в таком случае.

Для получения дополнительной информации о разделении, схемы выделения разделов и разделении ключей в MySQL см. Partitioning в MySQL Manual.

Единственный тип определенного пользователями разделения, которое поддерживается для использования с NDB, это ключевое разделение, включая линейное ключевое разделение.

Сигнатура.

bool getPartitionKey
(
  void
) const

Параметры. Нет.

Возвращаемое значение. true, если столбец часть ключа разделения для таблицы, иначе false.

2.3.2.4.12. Column::getPartSize()

Описание. Этот метод используется, чтобы получить размер части BLOB то есть, число байтов, которые сохранены в каждом кортеже таблицы blob.

Этот метод применим только к столбцам BLOB.

Сигнатура.

int getPartSize
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Размер части колонки как integer. В случае Tinyblob это значение 0 (то есть, только действующие байты сохранены).

2.3.2.4.13. Column::getPrecision()

Описание. Этот метод получает точность колонки.

Этот метод применим только к десятичным столбецам.

Сигнатура.

int getPrecision
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Точность колонки как integer. Точность определяется как количество значащих цифр, для получения дополнительной информации посмотрите обсуждение типа данных DECIMAL в Numeric Data Types.

2.3.2.4.14. Column::getPrimaryKey()

Описание. Этот метод используется, чтобы определить, является ли столбец частью первичного ключа таблицы.

Сигнатура.

bool getPrimaryKey
(
void
) const

Параметры. Нет.

Возвращаемое значение. true, если столбец часть первичного ключа таблицы, которой этот столбец принадлежит, иначе false.

2.3.2.4.15. Column::getScale()

Описание. Этот метод вернет масштаб для десятичного значения столбца.

Этот метод применим только к десятичным столбцам.

Сигнатура.

int getScale
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Масштаб десятичной колонки как integer. Масштаб десятичной колонки представляет количество цифр, которые могут быть сохранены после десятичной точки. Для этого значения возможно быть 0. См. описание типа данных DECIMAL в Numeric Data Types.

2.3.2.4.16. Column::getSize()

Описание. Эта функция используется, чтобы получить размер колонки.

Сигнатура.

int getSize
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Размер колонки в байтах (integer).

2.3.2.4.17. Column::getSizeInBytesForRecord()

Описание. Получает пространство, требуемое для данной колонки NdbRecord , в зависимости от типа колонки следующим образом:

  • Для BLOB это значение совпадает с sizeof(NdbRecord*), который составляет 4 или 8 байтов (размер указателя зависит от платформы).

  • Для столбцов всех других типов это совпадает со значением, возвращенным getSize().

Этот метод был добавлен в NDB 7.3.10 и NDB 7.4.7.

Сигнатура.

int getSizeInBytesForRecord
(
  void
) const

Параметры. Нет.

Возвращаемое значение. integer.

2.3.2.4.18. Column::getStorageType()

Описание. Этот метод получает тип хранения колонки.

Сигнатура.

StorageType getStorageType
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Значение StorageType , см. раздел 2.3.2.2.

2.3.2.4.19. Column::getStripeSize()

Описание. Этот метод получает размер полосы BLOB то есть, количество последовательных частей, чтобы сохранить в каждом узле кластера.

Сигнатура.

int getStripeSize
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Размер полосы колонки как integer.

2.3.2.4.20. Column::getType()

Описание. Этот метод получает тип данных колонки.

Сигнатура.

Type getType
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Type (тип данных) колонки. Для списка возможных значений посмотрите раздел 2.3.2.3.

2.3.2.4.21. Column::setArrayType()

Описание. Устанавливает тип массива для колонки.

Сигнатура.

void setArrayType
(
  ArrayType type
)

Параметры. Значение Column::ArrayType. См. раздел 2.3.2.1.

Возвращаемое значение. Нет.

2.3.2.4.22. Column::setCharset()

Описание. Этот метод может использоваться, чтобы установить набор символов и сопоставление столбца типа Char, Varchar или Text.

Этот метод применим только к столбцам Char, Varchar и Text.

Изменения, внесенные в колонки, используя этот метод, невидимы в MySQL.

Сигнатура.

void setCharset
(
  CHARSET_INFO* cs
)

Параметры. Этот метод берет один параметр. cs это указатель на структуру CHARSET_INFO. Для получения дополнительной информации посмотрите раздел 2.3.2.4.4.

Возвращаемое значение. Нет.

2.3.2.4.23. Column::setDefaultValue()

Описание. Этот метод устанавливает значение столбца в его умолчание, если он у него есть, иначе это устанавливает колонку в NULL.

Чтобы определить, есть ли у таблицы какие-либо колонки со значениями по умолчанию, надо использовать Table::hasDefaultValues().

Сигнатура.

int setDefaultValue
(
  const void* buf,
  unsigned int len
)

Параметры. Этот метод берет 2 аргумента: указатель buf и длину данных len, как число значащих байтов. Для типов фиксированного размера это размер типа. Для типов переменной длины, ведущие 1 или 2 байта, которые указывают на buffer также содержат информацию о размере как нормальную для типа.

Возвращаемое значение. 0 на успехе, 1 на неудаче.

2.3.2.4.24. Column::setInlineSize

Описание. Этот метод получает действующий размер BLOB то есть, число начальных байтов, чтобы сохранить в признаке blob таблицы. Эта часть обычно сохраняется в оперативной памяти и может вноситься в указателе и интерпретироваться.

Этот метод применим только к BLOB.

Изменения, внесенные в колонки, используя этот метод, невидимы MySQL.

Сигнатура.

void setInlineSize
(
  int size
)

Параметры. integer size новый действующий размер для BLOB.

Возвращаемое значение. Нет.

2.3.2.4.25. Column::setLength()

Описание. Этот метод устанавливает длину колонки. Для множества переменной длины это максимальная длина, иначе это длина массива.

Изменения, внесенные в колонки, используя этот метод, невидимы MySQL.

Сигнатура.

void setLength
(
  int length
)

Параметры. Этот метод берет отдельный аргумент integer length, это новая длина для колонки.

Возвращаемое значение. Нет.

2.3.2.4.26. Column::setName()

Описание. Этот метод используется, чтобы определить имя колонки.

setName() единственный метод Column, результат которого видим MySQL Server. MySQL не видит никаких других изменений, внесенных в существующие столбцы, используя API NDB.

Сигнатура.

void setName
(
  const char* name
)

Параметры. Этот метод берет отдельный аргумент новое название колонки.

Возвращаемое значение. Нет.

2.3.2.4.27. Column::setNullable()

Описание. Этот метод переключает возможность столбца хранить null.

Изменения, внесенные в колонки, используя этот метод, невидимы MySQL.

Сигнатура.

void setNullable
(
  bool nullable
)

Параметры. true позволяет вставить NULL в колонку, если nullable = false, этот метод выполняет эквивалент изменения колонки к NOT NULL в MySQL.

Возвращаемое значение. Нет.

2.3.2.4.28. Column::setPartitionKey()

Описание. Этот метод позволяет добавить колонку к ключу разделения таблицы, к которой это принадлежит, или удалить колонку из ключа разделения таблицы.

Изменения, внесенные в колонки, используя этот метод, невидимы MySQL.

Для получения дополнительной информации посмотрите раздел 2.3.2.4.11.

Сигнатура.

void setPartitionKey
(
  bool enable
)

Параметры. Единственный параметр enable типа Boolean. true to this method делает колонку частью ключа разделения таблицы, если enable = false, тогда столбец удален из ключа разделения.

Возвращаемое значение. Нет.

2.3.2.4.29. Column::setPartSize()

Описание. Этот метод устанавливает размер части BLOB то есть, число байтов, чтобы сохранить в каждом кортеже BLOB.

Этот метод применим только к BLOB.

Изменения, внесенные в колонки, используя этот метод, невидимы MySQL.

Сигнатура.

void setPartSize
(
  int size
)

Параметры. integer size это число байтов, чтобы сохранить в BLOB. Используя ноль для этого значения, только действующие байты могут быть сохранены, в действительности делая тип колонки TINYBLOB.

Возвращаемое значение. Нет.

2.3.2.4.30. Column::setPrecision()

Описание. Этот метод может использоваться, чтобы установить точность десятичной колонки.

Этот метод применим только к десятичным столбцам.

Изменения, внесенные в колонки, используя этот метод, невидимы MySQL.

Сигнатура.

void setPrecision
(
  int precision
)

Параметры. Этот метод берет единственный параметр: целое число, значение новой точности колонки. Для получения дополнительной информации о десятичной точности и масштабе, посмотрите разделы 2.3.2.4.13 и 2.3.2.4.15.

Возвращаемое значение. Нет.

2.3.2.4.31. Column::setPrimaryKey()

Описание. Этот метод используется, чтобы сделать колонку частью первичного ключа таблицы или удалить ее из первичного ключа.

Изменения, внесенные в колонки, используя этот метод, невидимы MySQL.

Сигнатура.

void setPrimaryKey
(
  bool primary
)

Параметры. Если true, столбец становится частью первичного ключа таблицы, если false, тогда столбец удален из первичного ключа.

Возвращаемое значение. Нет.

2.3.2.4.32. Column::setScale()

Описание. Этот метод может использоваться, чтобы установить масштаб десятичной колонки.

Этот метод применим только к десятичным столбцам.

Изменения, внесенные в колонки, используя этот метод, невидимы MySQL.

Сигнатура.

void setScale
(
  int scale
)

Параметры. Этот метод берет единственный параметр integer scale, новый масштаб для десятичной колонки. Для получения дополнительной информации о десятичной точности и масштабе, посмотрите разделы 2.3.2.4.13 и 2.3.2.4.15.

Возвращаемое значение. Нет.

2.3.2.4.33. Column::setStripeSize()

Описание. Этот метод устанавливает размер полосы BLOB то есть, количество последовательных частей, чтобы сохранить в каждом узле кластера.

Этот метод применим только к BLOB.

Изменения, внесенные в колонки, используя этот метод, невидимы MySQL.

Сигнатура.

void setStripeSize
(
  int size
)

Параметры. Этот метод берет отдельный аргумент. integer size новый размер полосы для колонки.

Возвращаемое значение. Нет.

2.3.2.4.34. Column::setStorageType()

Описание. Устанавливает тип хранения для колонки.

Сигнатура.

void setStorageType
(
  StorageType type
)

Параметры. Значение Column::StorageType. См. раздел 2.3.2.2.

Возвращаемое значение. Нет.

2.3.2.4.35. Column::setType()

Описание. Этот метод устанавливает Type (тип данных) колонки.

setType() сбрасывает все атрибуты столбца к их значениям по умолчанию, это должен быть первый метод, который вы называете, изменяя признаки данной колонки.

Изменения, внесенные в колонки, используя этот метод, невидимы MySQL.

Сигнатура.

void setType
(
  Type type
)

Параметры. Этот метод берет единственный параметр Column::Type. По умолчанию The default is Unsigned. Для листинга всех разрешенных значений посмотрите раздел 2.3.2.3.

Возвращаемое значение. Нет.

2.3.3. Класс Datafile

Резюме

Эта секция покрывает класс Datafile.

Родительский класс. Object.

Дочерние классы. Нет

Описание. Класс Datafile моделирует файл данных Cluster Disk Data, который используется, чтобы хранить данные таблицы Disk Data.

В настоящее время только неиндексируемые данные столбца могут храниться на диске. Индексы и индексированные столбцы сохранены в памяти.

NDB Cluster до MySQL 5.1 не поддерживал Disk Data и файлы данных, таким образом класс Datafile недоступен приложениям API NDB, написанным для этих более старых выпусков.

Методы. В следующей таблице перечислены публичные методы этого класса и цели использования каждого метода:

Таблица 2.11.

Имя Описание
Datafile() Конструктор класса
~Datafile() Деструктор класса
getFileNo() Удалено в NDB 7.5.0 (Bug #47960, Bug #11756088)
getFree() Получает количество свободного пространства в файле данных
getNode() Удалено в NDB 7.5.0 (Bug #47960, Bug #11756088)
getObjectId() Получает идентификатор объекта файла данных
getObjectStatus() Получает статус объекта файла данных
getObjectVersion() Получает версию объекта файла данных
getPath() Получает путь файловой системы к файлу данных
getSize() Получает размер файла данных
getTablespace() Получает название табличного пространства, которому принадлежит файл данных
getTablespaceId() Получает ID табличного пространства, которому принадлежит файл данных
setNode() Удалено в NDB 7.5.0 (Bug #47960, Bug #11756088)
setPath() Устанавливает название и местоположение файла данных в файловой системе
setSize() Устанавливает размер файла данных
setTablespace() Устанавливает табличное пространство, которому принадлежит файл данных

Типы. Класс Datafile не определяет публичных типов.

2.3.3.1. Конструктор класса Datafile

Описание. Этот метод создает новый экземпляр Datafile или копию существующего.

Сигнатура. Создать новый экземпляр:

Datafile
(
  void
)

Создать копию существующего экземпляра Datafile:

Datafile
(
  const Datafile& datafile
)

Параметры. Новый экземпляр: Нет. Конструктор копии: ссылка на экземпляр Datafile, который будет скопирован.

Возвращаемое значение. Объект Datafile.

2.3.3.2. Datafile::getFileNo()

Описание. Этот метод не работал, как предназначено и был удален в NDB 7.5.0 (Bug #47960, Bug #11756088).

Сигнатура.

Uint32 getFileNo
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Номер файла как unsigned 32-bit integer.

2.3.3.3. Datafile::getFree()

Описание. Этот метод получает свободное пространство, доступное в файле данных.

Сигнатура.

Uint64 getFree
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Число байтов, свободных в файле данных как unsigned 64-bit integer.

2.3.3.4. Datafile::getNode()

Описание. Этот метод не работал, как предназначено и был удален в NDB 7.5.0 (Bug #47960, Bug #11756088).

Сигнатура.

Uint32 getNode
(
  void
) const

Параметры. Нет.

Возвращаемое значение. ID узла как unsigned 32-bit integer.

2.3.3.5. Datafile::getObjectId()

Описание. Этот метод используется, чтобы получить идентификатор объекта файла данных.

Сигнатура.

virtual int getObjectId
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Идентификатор объекта файла данных как integer.

2.3.3.6. Datafile::getObjectStatus()

Описание. Этот метод используется, чтобы получить статус объекта файла данных.

Сигнатура.

virtual Object::Status getObjectStatus
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Файл данных Status. См. раздел 2.3.31.4.

2.3.3.7. Datafile::getObjectVersion()

Описание. Этот метод получает версию объекта файла данных (см. NDB Schema Object Versions).

Сигнатура.

virtual int getObjectVersion
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Версия объекта файла данных как integer.

2.3.3.8. Datafile::getPath()

Описание. Этот метод возвращает путь файловой системы к файлу данных.

Сигнатура.

const char* getPath
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Путь к файлу данных в файловой системе узла данных, строка (указатель на символ).

2.3.3.9. Datafile::getSize()

Описание. Этот метод получает размер файла данных в байтах.

Сигнатура.

Uint64 getSize
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Размер файла данных в байтах как unsigned 64-bit integer.

2.3.3.10. Datafile::getTablespace()

Описание. Этот метод может использоваться, чтобы получить название табличного пространства, которому принадлежит файл данных.

Можно также получить доступ к ID связанного табличного пространства непосредственно. Посмотрите раздел 2.3.3.11.

Сигнатура.

const char* getTablespace
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Название связанного табличного пространства.

2.3.3.11. Datafile::getTablespaceId()

Описание. Этот метод получает ID табличного пространства, которому принадлежит файл данных.

Можно также получить доступ к названию связанного табличного пространства непосредственно. Посмотрите раздел 2.3.3.10.

Сигнатура.

Uint32 getTablespaceId
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Этот метод возвращает ID табличного пространства как unsigned 32-bit integer.

2.3.3.12. Datafile::setNode()

Описание. Этот метод не работал, как предназначено и был удален в NDB 7.5.0 (Bug #47960, Bug #11756088).

Сигнатура.

void setNode
(
  Uint32 nodeId
)

Параметры. nodeId узла, на котором файл данных должен быть расположен (unsigned 32-bit integer).

Возвращаемое значение. Нет.

2.3.3.13. Datafile::setPath()

Описание. Этот метод устанавливает путь к файлу данных в файловой системе узла данных.

Сигнатура.

const char* setPath
(
  void
) const

Параметры. Путь к файлу, строка.

Возвращаемое значение. Нет.

2.3.3.14. Datafile::setSize()

Описание. Этот метод устанавливает размер файла данных.

Сигнатура.

void setSize
(
  Uint64 size
)

Параметры. Этот метод берет единственный параметр: желаемый размер size в байтах для файла данных как unsigned 64-bit integer.

Возвращаемое значение. Нет.

2.3.3.15. Datafile::setTablespace()

Описание. Этот метод используется, чтобы связать файл данных с табличным пространством.

Сигнатуры. setTablespace() может быть вызван любым из двух способов, перечисленных здесь:

  • Используя название табличного пространства, как показано здесь:

    void setTablespace
    (
      const char* name
    )
    
  • Используя ссылку на объект Tablespace .

    void setTablespace
    (
      const class Tablespace& tablespace
    )
    

Параметры. Этот метод берет единственный параметр, который может быть одним из следующего:

  • Имя name табличного пространства (указатель на символ).

  • Ссылка tablespace для передачи объекта Tablespace.

Возвращаемое значение. Нет.

2.3.4. Класс Dictionary

Резюме

Эта секция описывает класс Dictionary.

Родительский класс. NdbDictionary.

Дочерние классы. List.

Описание. Это используется для определения и получения метаданных объекта данных. Это также включает методы для создания и удаления объектов базы данных.

Методы. В следующей таблице перечислены публичные методы этого класса:

Таблица 2.12.

Имя Описание
Dictionary() Метод конструктора класса
~Dictionary() Метод деструктора
beginSchemaTrans() Начинает транзакцию схемы
createDatafile() Создает файл данных
createEvent() Создает событие
createForeignKey() Создает внешний ключ
createHashMap() Создает хэш-карту
createIndex() Создает индекс
createLogfileGroup() Создает группу файла журнала
createRecord() Создает объект Ndbrecord
createTable() Составляет таблицу
createTablespace() Создает табличное пространство
createundofile() Создает undofile
dropDatafile() Удаляет файл данных
dropEvent() Удаляет событие
dropForeignKey() Удаляет внешний ключ
dropIndex() Удаляет индекс
dropLogfileGroup() Удаляет группу файла журнала
dropTable() Удаляет таблицу
dropTablespace() Удаляет табличное пространство
dropundofile() Удаляет undofile
endSchemaTrans() Заканчивает (передает и завершает) транзакцию схемы
getDatafile() Получает файл данных, имеющий имя
getDefaultHashMap() Получает хэш-карту таблицы по умолчанию
getEvent() Получает событие, имеющее имя
getForeignKey() Получает внешний ключ, имеющий имя или ссылку
getHashMap() Получает хэш-карту по ее имени или связанной таблице
getIndex() Получает индекс, имеющий имя
getLogfileGroup() Получает группу файла журнала, имеющую имя
getNdbError() Восстанавливает последнюю ошибку
getTable() Получает таблицу, имеющую имя
getTablespace() Получает табличное пространство, имеющее имя
getundofile() Получает undofile по имени
hasSchemaTrans() Говорит, существует ли транзакция схемы в настоящее время
initDefaultHashMap() Инициализирует хэш-карту по умолчанию таблицы
invalidateTable() Лишает законной силы объект таблицы
listObjects() Получает список объектов в словаре
listIndexes() Получает список индексов, определенных на данной таблице
listEvents() Получает список событий, определенных в словаре
prepareHashMap() Создает или восстанавливает хэш-карту, которая может быть обновлена
removeCachedTable() Удаляет таблицу из местного кэша
removeCachedIndex() Удаляет индекс из местного кэша

Объекты базы данных, такие как таблицы и индексы, созданные с использованием методов Dictionary::create *(), не могут быть замечены MySQL Server. Это означает, что к ним не могут получить доступ клиенты MySQL, и что они не могут копироваться. По этим причинам часто предпочтительно избежать работать с ними.

Класс Dictionary не имеет методов для работы непосредственно со столбцами. Необходимо использовать методы класса Column с этой целью, см. раздел 2.3.2.

Типы. См. разделы 2.3.14 и 2.3.5.

2.3.4.1. Конструктор класса Dictionary

Описание. Этот метод создает новый экземпляр класса Dictionary.

Конструктор и деструктор для этого класса защищенные методы, а не публичные.

Сигнатура.

protected Dictionary
(
  Ndb& ndb
)

Параметры. Объект Ndb.

Возвращаемое значение. Объект Dictionary.

Деструктор. Деструктор не берет параметров и ничего не возвращает.

protected ~Dictionary
(
  void
)

2.3.4.2. Dictionary::beginSchemaTrans()

Описание. Начинает транзакцию схемы. Ошибка происходит, если транзакция уже активна или если ядерные метаданные блокированы. Можно определить, существует ли уже транзакция схемы, используя метод hasSchemaTrans().

Операция по метаданным происходит каждый раз, когда объекты данных созданы, изменены или удалены, такая операция может создать дополнительные подоперации в ядре NDB.

Объект Ndb и его связанный Dictionary поддерживают одну транзакцию схемы за один раз. По умолчанию каждая операция по метаданным выполняется отдельно, то есть, для каждой операции транзакция схемы начата неявно, операция (включая любые подоперации) выполняется и транзакция закончена.

Также возможно начать и закончить транзакцию схемы явно и выполнить ряд определенных пользователями операций атомарно в ее границах. В этом случае все операции в транзакции схемы имеют успех или прерваны и отменены как единица. Это сделано, выполнив шаги, перечисленные здесь:

  1. Чтобы начать транзакцию схемы, вызовите beginSchemaTrans().

  2. Выполните желаемые операции (например, createTable()).

  3. Закончите транзакцию схемы, вызывая endSchemaTrans.

Каждую операцию посылают в ядро NDB, которое разбирает и сохраняет ее. Неудача разбора приводит к откату к предыдущей пользовательской операции перед возвратом, в этом пункте пользователь может продолжить или прервать всю транзакцию.

После того, как все операции были представлены, endSchemaTrans() обрабатывает и передает их. В случае ошибки немедленно прерывается транзакция.

Если пользователь выходит перед запросом endSchemaTrans(), ядро NDB прерывает транзакцию. Если пользователь выходит перед возвратом из endSchemaTrans(), ядро продолжает запрос, и о его статусе завершения сообщает в регистрации кластера.

Сигнатура.

int beginSchemaTrans
(
  void
)

Параметры. Нет.

Возвращаемое значение. 0 на успехе, -1 на ошибке.

2.3.4.3. Dictionary::createDatafile()

Описание. Этот метод создает новый файл данных, заданный объектом Datafile.

Сигнатура.

int createDatafile
(
  const Datafile& dFile
)

Параметры. Отдельный аргумент: ссылка на экземпляр Datafile.

Возвращаемое значение. 0 на успехе, -1 на ошибке.

2.3.4.4. Dictionary::createEvent()

Описание. Создает событие, учитывая ссылку на объект Event.

Необходимо иметь в виду, что API NDB не отслеживает ассигнованные объекты-события, что означает, что пользователь должен удалить Event, если это было получено, используя createEvent(), после того, как этот объект больше не требуется.

Сигнатура.

int createEvent
(
  const Event& event
)

Параметры. Ссылка event на объект Event .

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.5. Dictionary::createForeignKey()

Описание. Создает объект ForeignKey, учитывая ссылку на этот объект и ID Object .

Сигнатура.

int createForeignKey
(
  const ForeignKey&,
  ObjectId* = 0,
  int flags = 0
)

Параметры. Ссылка на объект ForeignKey и Object ID. Дополнительная значение flags , если используется, позволяет создание внешнего ключа, не выполняя проверок внешнего ключа. Если установлено, его значение должно быть CreateFK_NoVerify (1).

Возвращаемое значение. 0 при успехе.

2.3.4.6. Dictionary::createHashMap()

Описание. Создает HashMap.

Сигнатура.

int createHashMap
(
  const HashMap& hashmap,
  ObjectId* id = 0
)

Параметры. Ссылка на хэш-карту и опционально ID, который будет назначен на нее. Добавлено в NDB 7.2.7.

Возвращаемое значение. 0 на успехе, на неудаче вернет -1 и устанавливает ошибку.

2.3.4.7. Dictionary::createIndex()

Описание. Этот метод создает индекс, заданный экземпляром Index и возможно дополнительным экземпляром Table.

Сигнатура. Этот метод может быть вызван с или без ссылки на объект таблицы:

int createIndex
(
  const Index& index
)
int createIndex
(
  const Index& index,
  const Table& table
)

Параметры. Надо: ссылка на объект Index. Опционально: ссылка на объект Table.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.8. Dictionary::createLogfileGroup()

Описание. Этот метод создает новую группу файла журнала, заданную экземпляром LogfileGroup.

Сигнатура.

int createLogfileGroup
(
  const LogfileGroup& lGroup
)

Параметры. Отдельный аргумент, ссылка на объект LogfileGroup.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.9. Dictionary::createRecord()

Описание. Этот метод используется, чтобы создать объект NdbRecord для использования в таблице или операций по просмотру индекса.

Сигнатура. Вызов этого метода зависит от того, должна ли получающаяся NdbRecord использоваться в операциях по индексу или таблице:

Чтобы создать NdbRecord для использования в операциях по таблице используйте следующее:

NdbRecord* createRecord
(
  const Table* table,
  const RecordSpecification* recSpec,
  Uint32 length,
  Uint32 elSize
)

Чтобы создать NdbRecord для использования в операциях по индексу можно использовать любое из следующего:

NdbRecord* createRecord
(
  const Index* index,
  const Table* table,
  const RecordSpecification* recSpec,
  Uint32 length,
  Uint32 elSize
)

или

NdbRecord* createRecord
(
  const Index* index,
  const RecordSpecification* recSpec,
  Uint32 length,
  Uint32 elSize
)

Параметры. Dictionary::createRecord() берет следующие параметры:

  • Если NdbRecord должна использоваться с индексом, указатель на объект Index. Если NdbRecord должна использоваться с таблицей, этот параметр опущен. См. раздел 2.3.11.

  • Указатель на объект Table, представляющий таблицу, которая будет просмотрена. Если Ndbrecord будет использоваться с индексом, тогда это произвольно определяет таблицу, содержащую этот индекс. См. раздел 2.3.37.

  • RecordSpecification используется, чтобы описать колонку. См. раздел 2.3.34.

  • Длина length записи.

  • elSize задает размер элементов, составляющих запись.

Возвращаемое значение. NdbRecord для использования в операциях, включающих данную таблицу или индекс.

Пример. См. раздел 2.3.27.

2.3.4.10. Dictionary::createTable()

Описание. Составляет таблицу, используя данный экземпляр Table.

Таблицы, созданные с использованием этого метода, не могут быть видны MySQL Server, не могут быть обновлены клиентами MySQL и не могут копироваться.

Сигнатура.

int createTable
(
  const Table& table
)

Параметры. Экземпляр Table. См. раздел 2.3.37.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.11. Dictionary::createTablespace()

Описание. Этот метод создает новое табличное пространство, заданное объектом Tablespace .

Сигнатура.

int createTablespace
(
  const Tablespace& tSpace
)

Параметры. Этот метод требует отдельного аргумента: ссылки на экземпляр Tablespace.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.12. Dictionary::createundofile()

Описание. Этот метод создает новый файл отмен, заданный объектом undofile.

Сигнатура.

int createundofile
(
  const undofile& uFile
)

Параметры. Этот метод требует одного аргумента: ссылки на экземпляр undofile.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.13. Dictionary::dropDatafile()

Описание. Этот метод удаляет файл данных, заданный объектом Datafile.

Сигнатура.

int dropDatafile
(
  const Datafile& dFile
)

Параметры. Отдельный аргумент: ссылка на экземпляр Datafile.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.14. Dictionary::dropEvent()

Описание. Этот метод удаляет событие учитывая ссылку на объект Event.

Сигнатура.

int dropEvent
(
  const char* name,
  int force = 0
)

Параметры. Этот метод берет два параметра:

  • name имя события, которое будет удалено, как строка.

  • По умолчанию dropEvent() терпит неудачу, если определенное событие не существует. Можно отвергнуть это поведение, передав любое ненулевое значение для дополнительного параметра force, в этом случае никакая проверка не осуществлена относительно того, есть ли на самом деле такое событие, и ошибка возвращена, только если событие существует, но по любой причине невозможно его удалить.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.15. Dictionary::dropForeignKey()

Описание. Этот метод удаляет внешний ключ учитывая ссылку на объект ForeignKey.

Сигнатура.

int dropForeignKey
(
  const ForeignKey&
)

Параметры. Ссылка на удаляемый объект ForeignKey.

Возвращаемое значение. 0 при успехе.

2.3.4.16. Dictionary::dropIndex()

Описание. Этот метод удаляет индекс, переданный экземпляром Index, и возможно дополнительным экземпляром Table.

Сигнатура.

int dropIndex
(
  const Index& index
)
int dropIndex
(
  const Index& index,
  const Table& table
)

Параметры. Этот метод берет два параметра, один из которых дополнительный:

  • Надо. Ссылка на объект Index.

  • Опционально. Ссылка на объект Table.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.17. Dictionary::dropLogfileGroup()

Описание. Берет экземпляр LogfileGroup и удаляет соответствующую группу файла журнала.

Сигнатура.

int dropLogfileGroup
(
  const LogfileGroup& lGroup
)

Параметры. Отдельный аргумент, ссылка на объект LogfileGroup.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.18. Dictionary::dropTable()

Описание. Удаляет таблицу, заданную экземпляром Table.

Сигнатура.

int dropTable
(
  const Table& table
)

В NDB 7.3.5 и позже этот метод пропускает все ограничения внешнего ключа на table, то есть таблица удалена безотносительно того, действует ли она как родительская таблица, дочерняя таблица или обе (Bug #18069680).

До NDB 8.0.17 таблица NDB, удаляемая с использованием этого метода, сохранялась в словаре данных MySQL, но не могла быть удалена, используя DROP TABLE в клиенте mysql. В NDB 8.0.17 и выше такие таблицы могут быть удалены, используя DROP TABLE (Bug #29125206, Bug #93672).

Параметры. Экземпляр Table. См. раздел 2.3.37.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.19. Dictionary::dropTablespace()

Описание. Этот метод удаляет табличное пространство, заданное объектом Tablespace.

Сигнатура.

int dropTablespace
(
  const Tablespace& tSpace
)

Параметры. Этот метод требует отдельного аргумента: ссылки на экземпляр Tablespace.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.20. Dictionary::dropundofile()

Описание. Этот метод удаляет файл отката, заданный объектом undofile .

Сигнатура.

int dropundofile
(
  const undofile& uFile
)

Параметры. Этот метод требует один аргумент: ссылку на экземпляр undofile.

Возвращаемое значение. 0 при успехе, -1 при неудаче.

2.3.4.21. Dictionary::endSchemaTrans()

Описание. Заканчивает транзакцию схемы, начатую beginSchemaTrans(), операции будут обработаны и переданы или прерваны и отменены. Этот метод объединяет операционное выполнение и закрытие, отдельные методы для этих задач не требуются. Этот метод можно вызвать успешно, даже если никакая транзакция схемы в настоящее время неактивна.

Как со многими другими методами API NDB, возможно для endSchemaTrans() переписывать любой текущий код ошибки. Поэтому необходимо сначала проверить и сохранить любой код ошибки, который, возможно, следовал из предыдущей, неудавшейся операции.

Сигнатура.

int endSchemaTrans
(
  Uint32 flags = 0
)

Параметры. Флаги определяют, как законченная транзакция обработана. По умолчанию 0 заставляет транзакцию быть переданной.

Dictionary::SchemaTransFlag. Можно также использовать с endSchemaTrans() любое из этих значений SchemaTransFlag:

  • SchemaTransAbort (= 1): Заставляет транзакцию быть прерванной.

  • SchemaTransBackground (= 2): Заставляет транзакцию выполняться в фоновом режиме, результат написан регистрации кластера в то время, как приложение продолжается, не ожидая ответа.

Возвращаемое значение. 0 при удаче, в случае ошибки -1 и установит код ошибки NdbError.

2.3.4.22. Dictionary::getDatafile()

Описание. Этот метод используется, чтобы получить объект Datafile, учитывая ID узла данных, где файл данных расположен и путь к файлу данных в файловой системе того узла.

Сигнатура.

Datafile getDatafile
(
  Uint32 nodeId,
  const char* path
)

Параметры. Этот метод должен быть вызван, используя два аргумента, как показано здесь:

  • 32-bit unsigned integer nodeId узла данных, где файл данных расположен.

  • path задает путь к файлу данных в файловой системе узла (строка как указатель на символ).

Возвращаемое значение. Объект Datafile, см. раздел 2.3.3.

2.3.4.23. Dictionary::getDefaultHashMap()

Описание. Получите хэш-карту таблицы по умолчанию.

Добавлен в NDB 7.2.7.

Сигнатура.

int getDefaultHashMap
(
  HashMap& dst,
  Uint32 fragments
)

или

int getDefaultHashMap
(
  HashMap& dst,
  Uint32 buckets,
  Uint32 fragments
)

Возвращаемое значение. 0 при успехе, при неудаче -1 и установит ошибку.

2.3.4.24. Dictionary::getEvent()

Описание. Этот метод используется, чтобы получить новый объект Event, представляющий событие, учитывая имя события.

getEvent() ассигнует память каждый раз, когда это успешно вызывают. Необходимо иметь в виду, что последовательные вызовы этого метода, используя то же самое событие, вызывают возвращение многократных отдельных объектов.

NDB API не отслеживает ассигнованные объекты-события, что означает, что пользователь должен удалить каждый Event, созданный с использованием getEvent(), после того, как объект больше не требуется.

Сигнатура.

const Event* getEvent
(
  const char* eventName
)

Параметры. Строка eventName как указатель на символ.

Возвращаемое значение. Указатель на объект Event. См. раздел 2.3.6.

2.3.4.25. Dictionary::getForeignKey()

Описание. Этот метод используется, чтобы получить новый объект ForeignKey , представляющий событие, учитывая ссылку на внешний ключ и его имя.

Сигнатура.

int getForeignKey
(
  ForeignKey& dst,
  const char* name
)

Параметры. Ссылка на внешний ключ и name как указатель на символ.

Возвращаемое значение. Указатель на объект ForeignKey.

2.3.4.26. Dictionary::getHashMap()

Описание. Получает хэш-карту по имени или таблице.

Добавлено в NDB 7.2.7.

Сигнатура.

int getHashMap
(
  HashMap& dst,
  const char* name
)

или

int getHashMap
(
  HashMap& dst,
  const Table* table
)

Параметры. Ссылка на хэш-карту и имя или на Table.

Возвращаемое значение. 0 при успехе, при ошибке -1 и установит ошибку.

2.3.4.27. Dictionary::getIndex()

Описание. Этот метод получает указатель на индекс, учитывая название индекса и название таблицы, которой принадлежит индекс.

Сигнатура.

const Index* getIndex
(
  const char* iName,
  const char* tName
) const

Параметры. Требуются два параметра:

  • Название индекса (iName).

  • Название таблицы, которой принадлежит индекс (tName).

Оба это строковые значения, представленные указателями на символ.

Возвращаемое значение. Указатель на Index. См. раздел 2.3.11.

2.3.4.28. Dictionary::getLogfileGroup()

Описание. Этот метод получает объект LogfileGroup, учитывая имя группы файла журнала.

Сигнатура.

LogfileGroup getLogfileGroup
(
  const char* name
)

Параметры. Имя name группы файла журнала.

Возвращаемое значение. Экземпляр LogfileGroup, см. раздел 2.3.13.

2.3.4.29. Dictionary::getNdbError()

Описание. Этот метод получает ошибку NDB API.

Сигнатура.

const struct NdbError& getNdbError
(
  void
) const

Параметры. Нет.

Возвращаемое значение. Ссылка на объект NdbError, см. раздел 2.3.20.

2.3.4.30. Dictionary::getTable()

Описание. Этот метод может использоваться, чтобы получить доступ к таблице с известным именем. Посмотрите раздел 2.3.37.

Сигнатура.

const Table* getTable
(
  const char* name
) const

Параметры. Имя name.

Возвращаемое значение. Указатель на таблицу или NULL, если нет никакой таблицы с именем name.

2.3.4.31. Dictionary::getTablespace()

Описание. Учитывая имя или ID табличного пространства, этот метод возвращает объект Tablespace.

Сигнатуры. Этот метод может быть вызван любым из этих способов:

  • Используя имя табличного пространства:

    Tablespace getTablespace
    (
      const char* name
    )
    
  • Используя ID табличного пространства:

    Tablespace getTablespace
    (
      Uint32 id
    )
    

Параметры. Любой из следующего:

ul>
  • name имя табличного пространства, последовательность (как указатель на символ).

  • unsigned 32-bit integer id табличного пространства.

  • Возвращаемое значение. Объект Tablespace, рассмотренный в discussed in разделе 2.3.38.

    2.3.4.32. Dictionary::getundofile()

    Описание. Этот метод получает объект undofile, учитывая ID узла, где файл отмены расположен и путь файловой системы к файлу.

    Сигнатура.

    undofile getundofile
    (
      Uint32nodeId,
      const char* path
    )
    

    Параметры. Этот метод требует следующих двух аргументов:

    • nodeId узла данных, где расположен файл отмены, это значение передается как 32-bit unsigned integer.

    • path путь к файлу отмены в файловой системе узла (строка как указатель на символ).

    Возвращаемое значение. Экземпляр undofile . См. раздел 2.3.39.

    2.3.4.33. Dictionary::hasSchemaTrans()

    Описание. Говорит, продолжается ли транзакция схемы API NDB.

    Сигнатура.

    bool hasSchemaTrans
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. TRUE, если транзакция схемы происходит, иначе FALSE.

    2.3.4.34. Dictionary::initDefaultHashMap()

    Описание. Инициализирует хэш-карту по умолчанию для таблицы.

    Добавлено в NDB 7.2.7.

    Сигнатура.

    int initDefaultHashMap
    (
      HashMap& dst, Uint32 fragments
    )
    

    или

    int initDefaultHashMap
    (
      HashMap& dst,
      Uint32 buckets,
      Uint32 fragments
    )
    

    Параметры. Ссылка на хэш-карту и количество фрагментов. Произвольно количество букетов.

    Возвращаемое значение. 0 при успехе, при ошибке -1 и установит ошибку.

    2.3.4.35. Dictionary::invalidateIndex()

    Описание. Этот метод используется, чтобы лишить законной силы кэшированный индексный объект.

    Сигнатура. На индекс, лишенный законной силы этим методом, можно сослаться как на объект Index (используя указатель) или по имени индекса и таблицы, как показано здесь:

    void invalidateIndex
    (
      const char* indexName,
      const char* tableName
    )
    
    void invalidateIndex
    (
      const Index* index
    )
    

    Параметры. Названия индекса, который будет удален из кэша и таблицы, которой это принадлежит (indexName и tableName, соответственно) или указатель на объект Index.

    Возвращаемое значение. Нет.

    2.3.4.36. DIctionary::invalidateTable()

    Описание. Этот метод используется, чтобы лишить законной силы кэшированный объект таблицы.

    Сигнатура.

    void invalidateTable
    (
      const char* name
    )
    

    Допустимо использовать объект Table, а не название таблицы, как показано здесь:

    void invalidateTable
    (
      const Table* table
    )
    

    Параметры. Имя name таблицы, которая будет удалена из кэша таблиц или указатель на объект Table.

    Возвращаемое значение. Нет.

    2.3.4.37. Dictionary::listEvents()

    Описание. Этот метод возвращает список всех событий, определенных в рамках словаря.

    Сигнатура.

    int listEvents
    (
      List& list
    )
    

    Параметры. Ссылка на объект List. См. раздел 2.3.14.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.4.38. Dictionary::listIndexes()

    Описание. Этот метод используется, чтобы получить List всех индексов в таблице, учитывая название таблицы. См. раздел 2.3.14.

    Сигнатура.

    int listIndexes
    (
      List&list,
      const char* table
    ) const
    

    Параметры. listIndexes() берет два аргумента, оба из которых требуются:

    • Ссылка на List , это содержит индексы после вызова метода.

    • Название таблицы table, чьи индексы должны быть перечислены.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.4.39. Dictionary::listObjects()

    Описание. Этот метод используется, чтобы получить список объектов в словаре. Возможно получить все объекты в словаре или ограничить список объектами единственного типа.

    Сигнатуры.

    int listObjects
    (
      List&list,
      Object::Type type = Object::TypeUndefined
    ) const
    

    или

    int listObjects
    (
      List&list,
      Object::Type type,
      bool fullyQualified
    ) const
    

    Параметры. Ссылка на объект List требуется: это список, который содержит объекты словаря после вызова listObjects(). См. раздел 2.3.14. Дополнительный второй аргумент type может использоваться, чтобы ограничить список только объектами заданного типа то есть, указанного Object::Type. См. раздел 2.3.31.6. Если type не задан, тогда список содержит все объекты словаря.

    Можно также определить, действительно ли имена объектов в list полностью квалифицированы (то есть, включает ли имя объекта базу данных, схему и возможно имя таблицы). Если вы определяете fullyQualified, тогда необходимо также определить type.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.4.40. Dictionary::prepareHashMap()

    Описание. Создает или получает хэш-карту, подходящую для изменения. Требует, чтобы транзакция схемы произошла, посмотрите раздел 2.3.4.2.

    Добавлено в NDB 7.2.7.

    Сигнатура.

    int prepareHashMap
    (
      const Table& oldTable,
      Table& newTable
    )
    

    или

    int prepareHashMap
    (
      const Table& oldTable,
      Table& newTable,
      Uint32 buckets
    )
    

    Параметры. Ссылки на старые и новые таблицы. Произвольно число букетов.

    Возвращаемое значение. 0 при успехе, при ошибке -1 и установит ошибку.

    2.3.4.41. Dictionary::releaseRecord()

    Описание. Этот метод освобождает NdbRecord , когда это больше не необходимо.

    Сигнатура.

    void releaseRecord
    (
      NdbRecord* record
    )
    

    Параметры. NdbRecord для очистки.

    Возвращаемое значение. Нет.

    Пример. См. раздел 2.3.27.

    2.3.4.42. Dictionary::removeCachedTable()

    Описание. Этот метод удаляет указанную таблица из местного кэша.

    Сигнатура.

    void removeCachedTable
    (
      const char* table
    )
    

    Параметры. Название table для удаления из кэша.

    Возвращаемое значение. Нет.

    2.3.4.43. Dictionary::removeCachedIndex()

    Описание. Этот метод удаляет указанный индекс из местного кэша.

    Сигнатура.

    void removeCachedIndex
    (
      const char* index,
      const char* table
    )
    

    Параметры. Метод removeCachedIndex() требует двух аргументов:

    • Имя индекса index для удаления.

    • Имя таблицы table, в которой найден индекс.

    Возвращаемое значение. Нет.

    2.3.5. Структура Element

    Резюме

    Эта секция обсуждает структуру Element.

    Родительский класс. List.

    Описание. Структура Element моделирует элемент списка, это используется, чтобы хранить объект в List, заполненный Dictionary методами listObjects(), listIndexes() и listEvents().

    Атрибуты. Element имеет атрибуты:

    Таблица 2.13.

    Атрибут Тип Начальное значение Описание
    id unsigned int 0 ID объекта
    type Object::Type Object::TypeUndefined Тип объекта, см. раздел 2.3.31.6
    state Object::State Object::StateUndefined Статус объекта, см. раздел 2.3.31.3
    store Object::Store Object::StoreUndefined Как объект хранится, см. раздел 2.3.31.5
    database char* 0 База данных, в которой найден объект
    schema char* 0 Схема, в которой найден объект
    name char* 0 Имя объекта

    2.3.6. Класс Event

    Резюме

    Эта секция обсуждает класс Event, его методы и определенные типы.

    Родительский класс. NdbDictionary

    Дочерние классы. Нет

    Описание. Этот класс представляет событие базы данных в NDB Cluster.

    Методы.

    Таблица 2.14.

    Имя Описание
    Event() Конструктор класса
    ~Event() Деструктор
    addEventColumn() Добавляет столбец, в котором должны быть обнаружены события
    addEventColumns() Добавляет многочисленные колонки, в которых должны быть обнаружены события
    addTableEvent() Добавляет тип события, которое должно быть обнаружено
    getDurability() Получает длительность события
    getEventColumn() Получает колонку, для которой определяется событие
    getName() Получает имя события
    getNoOfEventColumns() Получает количество столбцов, для которых определяется событие
    getObjectId() Получает идентификатор объекта события
    getObjectStatus() Получает статус объекта события
    getObjectVersion() Получает версию объекта события
    getReport() Получает варианты сообщения события
    getTable() Получает объект Table, на котором определяется событие
    getTableEvent() Проверка, должно ли событие быть обнаружено
    getTableName() Получает название таблицы, на которой определяется событие
    mergeEvents() Устанавливает флаг слияния события
    setDurability() Устанавливает длительность события
    setName() Определяет имя события
    setReport() Варианты сообщения события
    setTable() Устанавливает объект Table, на котором определяется событие

    Улучшенное Event API (NDB 7.4.3 и выше). NDB 7.4.3 вводит управляемый эпохой Event API, который заменяет более раннюю основанную на GCI модель. Новая версия API также упрощает обнаружение ошибок и обработку. Эти изменения осознаны в API NDB, осуществив много новых методов для Ndb и NdbEventOperation, устарев несколько других методов обоих классов и добавив новый тип TableEvent.

    Некоторые новые методы непосредственно заменяют устаревшие, но не все устаревшие отображены к новым, некоторые из которых совершенно новые. Старые методы (устаревшие) показывают в первой колонке следующей таблицы и новые методы во второй колонке, старые методы, соответствующие новым методам, показывают в той же самой строке.

    Таблица 2.15.

    Имя Описание
    NdbEventOperation::getEventType() NdbEventOperation::getEventType2()
    NdbEventOperation::getGCI() NdbEventOperation::getEpoch
    NdbEventOperation::getLatestGCI() Ndb::getHighestQueuedEpoch()
    NdbEventOperation::isOverrun() Нет, используйте NdbEventOperation::getEventType2()
    NdbEventOperation::hasError() Нет, используйте NdbEventOperation::getEventType2()
    NdbEventOperation::clearError() Нет
    Нет NdbEventOperation::isEmptyEpoch()
    Нет NdbEventOperation::isErrorEpoch()
    Ndb::pollEvents() Ndb::pollEvents2()
    Ndb::nextEvent() Ndb::nextEvent2()
    Ndb::getLatestGCI() Ndb::getHighestQueuedEpoch()
    Ndb::getGCIEventOperations() Ndb::getNextEventOpInEpoch2()
    Ndb::isConsistent()Нет
    Ndb::isConsistentGCI() Нет

    Обработка ошибок используя новый API достигается, проверяя значение, возвращенное из getEventType2(), и больше не обрабатывается, используя методы hasError() и clearError(), которые теперь устарели. В поддержку этого изменения, диапазон возможных типов TableEvent расширен перечисленными здесь:

    • TE_EMPTY: Пустая эпоха.

    • TE_INCONSISTENT: Непоследовательная эпоха: недостающие данные или переполнение.

    • TE_OUT_OF_MEMORY: Непоследовательные данные: буфер событий или память переполнены.

    Результат этих изменений состоит в том, что в NDB 7.4.3 и позже можно проверить ошибки, проверяя тип события таблицы, как показано здесь:

    NdbDictionary::Event::TableEvent* error_type = 0;
    NdbEventOperation* pOp = nextEvent2();
    if (pOp->isErrorEpoch(error_type)
    {
       switch (error_type)
       {
         case TE_INCONSISTENT :
           // Handle error/inconsistent epoch...
           break;
         case TE_OUT_OF_MEMORY :
           // Handle error/inconsistent data...
           break;
         //...
       }
    }
    

    Для получения дополнительной информации см. подробные описания для методов Ndb и NdbEventOperation в разделе 2.3.6.23.

    Типы. Это публичныетипы класса Event:

    Таблица 2.16.

    Имя Описание
    TableEvent() Представляет тип события таблицы
    EventDurability() Определяет объем события, доступность и время жизни
    EventReport() Определяет возможность сообщения для события таблицы

    2.3.6.1. Event::addEventColumn()

    Описание. Этот метод используется, чтобы добавить колонку, на которой должны быть обнаружены события. Столбец может быть обозначен ID или именем.

    Необходимо вызвать Dictionary::createEvent() прежде, чем любые ошибки будут обнаружены. Посмотрите раздел 2.3.4.4.

    Если вы знаете несколько столбцов по имени, можно позволить обнаружение событий на всех сразу при помощи addEventColumns(). См. раздел 2.3.6.2.

    Сигнатура. Идентификация события, используя его идентификатор столбца:

    void addEventColumn
    (
      unsigned attrId
    )
    

    Идентификация колонки по имени:

    void addEventColumn
    (
      const char* columnName
    )
    

    Параметры. Этот метод берет отдельный аргумент, который может быть любым одним из следующего:

    • ID столбца (attrId), который должен быть целым числом больше чем или равным 0 и меньше, чем значение, возвращенное getNoOfEventColumns().

    • Имя столбца name (как постоянный указатель на символ).

    Возвращаемое значение. Нет.

    2.3.6.2. Event::addEventColumns()

    Описание. Этот метод используется, чтобы позволить обнаружение событий на нескольких столбцах в то же время. Необходимо использовать названия столбцов.

    Как и addEventColumn(), надо вызвать Dictionary::createEvent() прежде, чем любые ошибки будут обнаружены. Посмотрите раздел 2.3.4.4.

    Сигнатура.

    void addEventColumns
    (
      int n,
      const char** columnNames
    )
    

    Параметры. Этот метод требует двух аргументов, перечисленных здесь:

    • Количество столбцов n (integer).

    • Названия столбцов columnNames это должно быть передано как указатель на указатель на символ.

    Возвращаемое значение. Нет.

    2.3.6.3. Event::addTableEvent()

    Описание. Этот метод используется, чтобы добавить типы событий, которые должны быть обнаружены.

    Сигнатура.

    void addTableEvent
    (
      const TableEvent te
    )
    

    Параметры. Этот метод требует значение TableEvent.

    Возвращаемое значение. Нет.

    2.3.6.4. Конструктор Event

    Описание. Конструктор Event создает новый экземпляр с именем, произвольно связанный с таблицей.

    Необходимо иметь в виду, что API NDB не отслеживает ассигнованные объекты-события, что означает, что пользователь должен явно удалить the Event после того, как это больше не используется.

    Сигнатуры.

    Event
    (
      const char* name
    )
    

    Альтернативно, можно использовать имя событий и связанную таблицу:

    Event
    (
      const char* name,
      const NdbDictionary::Table& table
    )
    

    Параметры. Как минимум, имя name (как постоянный указатель на символ), поскольку событие требуется. Произвольно, событие может также быть связано с таблицей, этим аргументом, когда существует, является ссылка на объхект Table (см. раздел 2.3.37).

    Возвращаемое значение. Новый экземпляр Event.

    Деструктор. Деструктор для этого класса поставляется как виртуальный метод, который не берет аргументов и чей тип возвращения void.

    2.3.6.5. Event::EventDurability

    Резюме

    Эта секция обсуждает EventDurability, тип, определенный классом Event.

    Описание. Значения этого типа используются, чтобы описать жизнь или постоянство события, а также его объем.

    Возможные значения.

    Таблица 2.17.

    Имя Описание
    ED_UNDEFINED Событие не определено или неподдержанного типа.
    ED_SESSION Это событие сохраняется только на время текущей сессии и доступно только текущему приложению. Это удалено после того, как приложение разъединяется или после перезапуска кластера. Значение ED_SESSION резервируется для будущего использования и еще не поддерживается ни в каком выпуске кластера NDB.
    ED_TEMPORARY Любое приложение может использовать событие, но это удалено после перезапуска кластера. Значение ED_TEMPORARY резервируется для будущего использования и еще не поддерживается ни в каком выпуске кластера NDB.
    ED_PERMANENT Любое приложение может использовать событие и это сохраняется, пока не удалено приложением, даже после перезапуска кластера. Значение ED_PERMANENT резервируется для будущего использования и еще не поддерживается ни в каком выпуске кластера NDB.

    2.3.6.6. Event::EventReport

    Резюме

    Эта секция обсуждает тип EventReport, определенный классом Event.

    Описание. Значения этого типа используются, чтобы определить возможности сообщения для событий таблицы.

    Возможные значения.

    Таблица 2.18.

    Имя Описание
    ER_UPDATED Сообщение о событиях обновления.
    ER_ALL Сообщение обо всех событиях, за исключением тех, которые не приводят к любым обновлениям действующих частей столбцов BLOB.
    ER_SUBSCRIBE Сообщение о подписных событиях.
    ER_DDL Сообщение о событиях DDL (см. раздел 2.3.6.20).

    2.3.6.7. Event::getDurability()

    Описание. Этот метод получает жизнь и объем события (то есть, EventDurability).

    Сигнатура.

    EventDurability getDurability
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Значение EventDurability.

    2.3.6.8. Event::getEventColumn()

    Описание. Этот метод используется, чтобы получить определенную колонку из числа тех, на которых определяется событие.

    Сигнатура.

    const Column* getEventColumn
    (
      unsigned no
    ) const
    

    Параметры. Номер (no) колонки, как получено использованием getNoOfColumns() (см. раздел 2.3.6.10).

    Возвращаемое значение. Указатель на Column, соответствующий no.

    2.3.6.9. Event::getName()

    Описание. Этот метод получает название события.

    Сигнатура.

    const char* getName
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Название события, как указатель на символ.

    2.3.6.10. Event::getNoOfEventColumns()

    Описание. Этот метод получает количество столбцов, на которых определяется событие.

    Сигнатура.

    int getNoOfEventColumns
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Количество столбцов (integer) или -1 в случае ошибки.

    2.3.6.11. Event::getObjectStatus()

    Описание. Этот метод получает статус объекта события.

    Сигнатура.

    virtual Object::Status getObjectStatus
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Статус объекта события. Для возможных значений посмотрите раздел 2.3.31.4.

    2.3.6.12. Event::getObjectVersion()

    Описание. Этот метод получает версию объекта события (см. NDB Schema Object Versions).

    Сигнатура.

    virtual int getObjectVersion
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Версия объекта события как integer.

    2.3.6.13. Event::getObjectId()

    Описание. Этот метод получает идентификатор объекта события.

    Сигнатура.

    virtual int getObjectId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Идентификатор объекта события как integer.

    2.3.6.14. Event::getReport()

    Описание. Этот метод используется, чтобы получить опции сообщения для этого события.

    Сигнатура.

    EventReport getReport
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Опции сообщения определяются в разделе 2.3.6.6.

    2.3.6.15. Event::getTable()

    Описание. Этот метод используется, чтобы найти таблицу, с которой связано событие. Это возвращает ссылку на объект Table. Можно также получить название таблицы непосредственно, используя getTableName().

    Сигнатура.

    const NdbDictionary::Table* getTable
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Таблица, с которой событие связано, если есть, как указатель на объект Table, иначе NULL. См. раздел 2.3.37.

    2.3.6.16. Event::getTableEvent()

    Описание. Этот метод используется, чтобы проверить, будет ли данное событие таблицы обнаружено.

    Сигнатура.

    bool getTableEvent
    (
      const TableEvent te
    ) const
    

    Параметры. Этот метод берет единственный параметр, тип события таблицы, то есть значение TableEvent.

    Возвращаемое значение. Этот метод вернет true, если событие TableEvent типа te будет обнаружено. Иначе возвращаемое значение false.

    2.3.6.17. Event::getTableName()

    Описание. Этот метод получает название таблицы, с которой событие связано, может служить удобной альтернативой getTable(). См. раздел 2.3.6.15.

    Сигнатура.

    const char* getTableName
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Название таблицы, связанной с этим событием, как указатель на символ.

    2.3.6.18. Event::mergeEvents()

    Описание. Этот метод используется, чтобы установить флаг слияния событий, который является по умолчанию false. Установка его к true подразумевает, что события слиты следующим образом:

    • Для данного NdbEventOperation, связанного с этим событием, события на том же самом первичном ключе в том же самом глобальном индексе контрольной точки (GCI) слиты в единственное событие.

    • Событие таблицы blob создается для каждого признака blob и события blob обработаны как часть главных событий таблицы.

    • Данные о Blob из событий части blob могут быть прочитаны через методы NdbBlob как единственное значение.

    В настоящее время этот флаг не унаследован NdbEventOperation и должен быть установлен на NdbEventOperation явно, см. раздел 2.3.21.

    Сигнатура.

    void mergeEvents
    (
      bool flag
    )
    

    Параметры. Значение flag.

    Возвращаемое значение. Нет.

    2.3.6.19 Event::setDurability()

    Описание. Этот метод устанавливает длительность события то есть, время жизни и объем.

    Сигнатура.

    void setDurability(EventDurability ed)
    

    Параметры. Этот метод требует значение EventDurability.

    Возвращаемое значение. Нет.

    2.3.6.20. Event::setReport()

    Описание. Этот метод используется, чтобы установить возможность сообщения для события. Значения возможных опций могут быть найдены в разделе 2.3.6.6.

    Сообщение о событиях DDL. Необходимо вызвать setReport() с использованием EventReport = ER_DDL (добавлено в тех же самых версиях кластера NDB).

    Например, чтобы позволить событие DDL, сообщающее относительно объекта Event с именем myEvent, необходимо вызвать этот метод как показано здесь:

    myEvent.setReport(NdbDictionary::Event::ER_DDL);
    

    Сигнатура.

    void setReport
    (
      EventReport er
    )
    

    Параметры. Значение опции EventReport.

    Возвращаемое значение. Нет.

    2.3.6.21. Event::setName()

    Описание. Этот метод используется, чтобы определить имя события. Имя должно быть уникальным среди всех событий, видимых от текущего приложения (см. раздел 2.3.6.7).

    Можно также определить имя события, сначала создав его. Посмотрите раздел 2.3.6.4.

    Сигнатура.

    void setName
    (
      const char* name
    )
    

    Параметры. Имя name для события (как постоянный указатель на символ).

    Возвращаемое значение. Нет.

    2.3.6.22. Event::setTable()

    Описание. Этот метод определяет таблицу, на которой должны быть обнаружены события.

    По умолчанию обнаружение событий происходит на всех столбецх в таблице. Используйте addEventColumn(), чтобы отвергнуть это поведение. Для получения дополнительной информации посмотрите раздел 2.3.6.1.

    Сигнатура.

    void setTable
    (
      const NdbDictionary::Table& table
    )
    

    NDB 7.2.14, NDB 7.3.3 и позже поддерживают использование указателя с этим методом, как показано здесь:

    void setTable
    (
      const NdbDictionary::Table*; table
    )
    

    Когда используется так, эта версия setTable() вернет -1, если указатель таблицы NULL (Bug #16329082).

    Параметры. Этот метод требует единственного параметра, ссылки на таблицу (см. раздел 2.3.37) на которой должны быть обнаружены события. NDB 7.2.14, NDB 7.3.3 и позже: ссылка или указатель на таблицу могут использоваться.

    Возвращаемое значение. Нет. NDB 7.2.14, NDB 7.3.3 и позже: -1, если используется указатель null для таблицы.

    2.3.6.23. Event::TableEvent

    Резюме

    Эта секция описывает тип TableEvent, определенный классом Event.

    Описание. TableEvent используется, чтобы классифицировать типы событий, которые могут быть связаны с таблицами в API NDB.

    Возможные значения.

    Таблица 2.19.

    Имя Описание
    TE_INSERT Событие вставки на таблице
    TE_DELETE Событие удаления на таблице
    TE_UPDATE Событие обновления на таблице
    TE_DROP Происходит, когда таблица удалена
    TE_ALTER Происходит, когда определение таблицы изменяется
    TE_CREATE Происходит, когда таблица составлена
    TE_GCP_COMPLETE Происходит на завершении глобальной контрольной точки
    TE_CLUSTER_FAILURE Происходит на неудачах кластера
    TE_STOP Происходит, когда операция событий остановлена
    TE_NODE_FAILURE Происходит, когда узел кластера терпит неудачу
    TE_SUBSCRIBE Происходит, когда узел кластера подписывается на событие
    TE_UNSUBSCRIBE Происходит, когда узел кластера отказывается от подписки на событие
    TE_EMPTY Пустая эпоха получена от узлов данных
    TE_INCONSISTENT Недостающие данные или переполнение буфера в узле данных
    TE_OUT_OF_MEMORY Переполнение в буфере событий
    TE_ALL Происходит, когда любое событие имеет место на таблице (не релевантно, когда определенное событие получено)

    TE_EMPTY, TE_INCONSISTENT и TE_OUT_OF_MEMORY добавлены в NDB 7.4.3.

    2.3.7. Структура EventBufferMemoryUsage

    Резюме

    Эта секция описывает структуру EventBufferMemoryUsage.

    Родительский класс. Ndb.

    Описание. Эта структура была добавлена в NDB 7.4.3 для работы со статистикой использования буферной памяти событий. Это используется в качестве аргумента Ndb::get_event_buffer_memory_usage().

    Атрибуты.

    Таблица 2.20.

    Имя Тип Начальное значение Описание
    allocated_bytes unsigned Нет Полная ассигнованная буферная память событий в байтах
    used_bytes unsigned Нет Используемая общая память в байтах
    usage_percent unsigned Нет Использование буферной памяти событий как процент (100 * used_bytes/allocated_bytes)

    2.3.8. Класс ForeignKey

    Резюме

    Этот класс представляет внешний ключ на таблице NDB. Это было добавлено в NDB API в NDB Cluster 7.3.

    Родительский класс. Object.

    Дочерние классы. Нет.

    Методы.

    Таблица 2.21.

    Имя Описание
    ForeignKey() Конструктор класса
    ~ForeignKey() Деструктор класса
    getName() Получите имя внешнего ключа
    getParentTable() Получите родительскую таблицу внешнего ключа
    getChildTable() Получите дочернюю таблицу внешнего ключа
    getParentColumnCount() Получите количество столбцов в родительской таблице
    getChildColumnCount() Получите количество столбцов в дочерней таблице
    getParentColumnNo() Получите номер столбца в родительской таблице
    getChildColumnNo() Получите номер столбца в дочерней таблице
    getParentIndex() 0, если ключ часть первичного ключа родительской таблицы
    getChildIndex() 0, если дочерние ссылки решены, используя первичный ключ дочерней таблицы
    getOnUpdateAction() Получите действие обновления внешнего ключа ( FkAction)
    getOnDeleteAction() Получите действие удаления внешнего ключа ( FkAction)
    setName() Определите имя внешнего ключа
    setParent() Установите родительскую таблицу внешнего ключа
    setChild() Установите дочернюю таблицу внешнего ключа
    setOnUpdateAction() Установите действие обновления внешнего ключа ( FkAction)
    setOnDeleteAction() Установите действие удаления внешнего ключа ( FkAction)
    getObjectStatus() Получите статус объекта
    getObjectId() Получите идентификатор объекта
    getObjectVersion() Получите версию объекта

    Типы. Класс ForeignKey имеет один публичный тип, FkAction.

    2.3.8.1. ForeignKey()

    Описание. Создайте совершенно новую ссылку внешнего ключа или копию существующего.

    Сигнатура. Новый экземпляр:

    ForeignKey
    (
      void
    )
    

    Конструктор копии:

    ForeignKey
    (
      const ForeignKey&
    )
    

    Параметры. Для нового экземпляра: Нет.

    Для конструктора копии: ссылка на существующий экземпляр ForeignKey.

    Возвращаемое значение. Новый экземпляр ForeignKey.

    2.3.8.2. ForeignKey::FkAction

    FkAction это перечисление, которое представляет действие для внешнего ключа, когда обновление или удаление выполняется на родительской таблице.

    Возможные значения.

    Таблица 2.22.

    Имя Описание
    NoAction NO ACTION: Отсроченная проверка.
    Restrict RESTRICT: Отклоните операцию на родительской таблице.
    Cascade CASCADE: Выполните операцию на строке из родительской таблицы, выполните ту же самую операцию при соответствии строкам в дочерней таблице.
    SetNull SET NULL: Выполните операцию на строке из родительской таблицы, установите любые колонки внешнего ключа соответствия в дочерней таблице к NULL.
    SetDefault SET DEFAULT: В настоящее время не поддержано в NDB Cluster.

    См. FOREIGN KEY Constraints в MySQL Manual.

    2.3.8.3. ForeignKey::getName()

    Описание. Получает название экземпляра ForeignKey, для которого вызван метод.

    Сигнатура.

    const char* getName
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Имя ForeignKey.

    2.3.8.4. ForeignKey::getParentTable()

    Описание. Получает родительскую таблицу для экземпляра ForeignKey, для которого вызван метод.

    Сигнатура.

    const char* getParentTable
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на родительскую таблицу ForeignKey.

    2.3.8.5. ForeignKey::getChildTable()

    Описание. Получает дочернюю таблицу для экземпляра ForeignKey, для которого вызван метод.

    Сигнатура.

    const char* getChildTable
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на дочернюю таблицу ForeignKey.

    2.3.8.6. ForeignKey::getParentColumnCount()

    Описание. Получает количество столбцов в родительской таблице этого ForeignKey.

    Сигнатура.

    unsigned getParentColumnCount
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Количество столбцов в родительской таблице.

    2.3.8.7. ForeignKey::getChildColumnCount()

    Описание. Получает количество столбцов в дочерней таблице этого ForeignKey.

    Сигнатура.

    unsigned getChildColumnCount
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Количество столбцов в дочерней таблице.

    2.3.8.8. ForeignKey::getParentIndex()

    Описание. 0, если дочерняя таблица ссылается на первичный ключ родительской таблицы.

    Сигнатура.

    const char* getParentIndex
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. См. описание.

    2.3.8.9. ForeignKey::getChildIndex()

    Описание. 0, если дочерние ссылки решены, используя первичный ключ дочерней таблицы.

    Сигнатура.

    const char* getChildIndex
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. См. описание.

    2.3.8.10. ForeignKey::getParentColumnNo()

    Описание. Этот метод получает порядковый номер колонки внешнего ключа в родительской таблице для данного индекса. См. документацию для Column::getColumnNo().

    Сигнатура.

    int getParentColumnNo
    (
      unsigned no
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Порядковый номер колонки.

    2.3.8.11. ForeignKey::getChildColumnNo()

    Описание. Этот метод получает порядковый номер колонки внешнего ключа в дочерней таблице для данного индекса. См. документацию для Column::getColumnNo().

    Сигнатура.

    int getChildColumnNo
    (
      unsigned no
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Порядковый номер колонки.

    2.3.8.12. ForeignKey::getOnUpdateAction()

    Описание. Получите действие ON UPDATE внешнего ключа. Это ForeignKey::FkAction и имеет одно из значений NoAction, Restrict, Cascade или SetNull.

    Сигнатура.

    FkAction getOnUpdateAction
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Порядковый номер колонки.

    2.3.8.13. ForeignKey::getOnDeleteAction()

    Описание.

    Описание. Получите действие ON DELETE внешнего ключа. Это ForeignKey::FkAction и имеет одно из значений NoAction, Restrict, Cascade или SetNull.

    Сигнатура.

    FkAction getOnDeleteAction
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Порядковый номер колонки.

    2.3.8.14. ForeignKey::setName()

    Описание. Определите имя экземпляра ForeignKey, для которого вызван метод.

    Сигнатура.

    void setName
    (
      const char*
    )
    

    Параметры. Имя ForeignKey.

    Возвращаемое значение. Нет.

    2.3.8.15. ForeignKey::setParent()

    Описание. Установить родительскую таблицу ForeignKey, учитывая ссылку на таблицу и произвольно индекс, чтобы использовать в качестве внешнего ключа.

    Сигнатура.

    void setParent
    (
      const Table&,
      const Index* index = 0,
      const Column* cols[] = 0
    )
    

    Параметры. Ссылка на Table. Произвольно индекс, используя обозначенную колонку или колонки.

    Возвращаемое значение. Нет.

    2.3.8.16. ForeignKey::setChild()

    Описание. Установите дочернюю таблицу ForeignKey, учитывая ссылку на таблицу и произвольно индекс, чтобы использовать в качестве внешнего ключа.

    Сигнатура.

    void setChild
    (
      const Table&,
      const Index* index = 0,
      const Column* cols[] = 0
    )
    

    Параметры. Ссылка на Table. Произвольно индекс, используя обозначенную колонку или колонки.

    Возвращаемое значение. Нет.

    2.3.8.17. ForeignKey::setOnUpdateAction()

    Описание. Установите действие ON UPDATE внешнего ключа.

    Сигнатура.

    void setOnUpdateAction
    (
      FkAction
    )
    

    Параметры. Действие ON UPDATE, которое будет выполнено. Это должно быть ForeignKey::FkAction с одним из значений NoAction, Restrict, Cascade или SetNull.

    Возвращаемое значение. Нет

    2.3.8.18. ForeignKey::setOnDeleteAction()

    Описание. Установите действие ON DELETE внешнего ключа.

    Сигнатура.

    void setOnUpdateAction
    (
      FkAction
    )
    

    Параметры. Действие ON DELETE, которое будет выполнено. Это должно быть ForeignKey::FkAction с одним из значений NoAction, Restrict, Cascade или SetNull.

    Возвращаемое значение. Нет

    2.3.8.19. ForeignKey::getObjectStatus()

    Описание. Получите статус объекта (см. раздел 2.3.31.4) для этого объекта ForeignKey.

    Сигнатура.

    virtual Object::Status getObjectStatus
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Статус объекта ForeignKey как значение типа Object::Status. См. документацию этого типа для возможных значений и их интерпретации.

    2.3.8.20. ForeignKey::getObjectId()

    Описание. Получите идентификатор объекта (см. раздел 2.3.31.7) для данного объекта ForeignKey.

    Сигнатура.

    virtual int getObjectId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. ID объекта ForeignKey как возвращено Object::getObjectId().

    2.3.8.21. ForeignKey::getObjectVersion()

    Описание. Получите версию объекта (см. раздел 2.3.31.9) для этого объекта ForeignKey.

    Сигнатура.

    virtual int getObjectVersion
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Номер версии объекта ForeignKey (integer) как возвращено Object::getObjectVersion().

    2.3.9. Структура GetValueSpec

    Родительский класс. NdbOperation.

    Описание. Эта структура используется, чтобы определить дополнительное значение, чтобы получить как часть NdbRecord.

    Члены. Элементы, составляющие эту структуру, показаны в следующей таблице:

    Таблица 2.23.

    Имя Тип Описание
    column const Column* Чтобы определить дополнительное значение, чтобы читать, вызывающий должен обеспечить это, а также (произвольно NULL) указатель appStorage.
    appStorage void* Если этот указатель null, то полученное значение сохранено в памяти, управляемой объектом NdbRecAttr. Иначе полученное значение сохранено в местоположении, указанном (и все еще доступном с использованием объекта NdbRecAttr ). Обязанность вызывающего гарантировать, что следующие условия выполнены:

    1. appStorage указывает на достаточное место, чтобы сохранить любые возвращенные данные.

    2. Память, на которую указывает appStorage, не использована снова или освобождена до окончания execute().

    recAttr NdbRecAttr * После того, как операция определяется, recAttr содержит указатель на объект NdbRecAttr для получения данных.

    В настоящее время чтение blob не может быть определено, используя GetValueSpec.

    См. раздел 2.3.27.

    2.3.10. Класс HashMap

    Резюме

    Этот класс представляет хэш-карту в NDB Cluster. Добавлен в NDB 7.2.7.

    Родительский класс. Object.

    Дочерние классы. Нет.

    Методы.

    Таблица 2.24.

    Имя Описание
    HashMap() Конструктор класса
    ~HashMap() Деструктор класса
    setName() Определите имя для hashmap
    getName() Получает имя hashmap
    setMap() Устанавливает длину и значения hashmap
    getMapLen() Получает длину hashmap
    getMapValues() Получает значения в hashmap
    equal() Сравнивает значения из этой hashmap с значениями из другой hashmap
    getObjectStatus() Получает статус объекта hashmap
    getObjectVersion() Получает версию объекта схемы hashmap
    getObjectId() Получает ID hashmap

    Типы. Класс HashMap не имеет публичных типов.

    2.3.10.1. Конструктор HashMap

    Описание. Конструктор класса HashMap не требует никаких аргументов. Конструктор копии также доступен.

    См. раздел 2.3.4.6.

    Сигнатура. Основной конструктор:

    HashMap HashMap
    (
      void
    )
    

    Конструктор копии:

    HashMap HashMap
    (
      const HashMap& hashmap
    )
    

    Деструктор:

    virtual ~HashMap
    (
      void
    )
    

    Параметры. Нет или адрес существующего объекта HashMap, который будет скопирован.

    Возвращаемое значение. Новый экземпляр HashMap, возможно копия существующего.

    2.3.10.2. HashMap::setName()

    Описание. Определяет имя хэш-карты.

    Сигнатура.

    void setName
    (
      const char* name
    )
    

    Параметры. Имя, которое будет назначено hashmap.

    Возвращаемое значение. Нет.

    2.3.10.3. HashMap::getName()

    Описание. Получает название хэш-карты.

    Сигнатура.

    const char* getName
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Название хэш-карты.

    2.3.10.4. HashMap::setMap()

    Описание. Назначает ряд значений карте.

    Сигнатура.

    void setMap
    (
      const Uint32* values,
      Uint32 len
    )
    

    Параметры. Указатель на ряд values длиной len.

    Возвращаемое значение. Нет.

    2.3.10.5. HashMap::getMapLen()

    Описание. Получает длину хэш-карты, то есть, количество значений, которые это содержит. Можно получить значения с использованием getMapValues().

    Сигнатура.

    Uint32 getMapLen
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Длина хэш-карты.

    2.3.10.6. HashMap::getMapValues()

    Описание. Получает значения из карты.

    Сигнатура.

    int getMapValues
    (
      Uint32* dst,
      Uint32 len
    ) const
    

    Параметры. Указатель на ряд значений (dst) и количество значений (len).

    Возвращаемое значение. 0 при успехе, при неудаче -1 и установит ошибку.

    2.3.10.7. HashMap::equal()

    Описание. Сравнивает (только) значения этой HashMap со значениями из другой.

    Сигнатура.

    bool equal
    (
      const HashMap& hashmap
    ) const
    

    Параметры. Ссылка на карту, с которой будет сравнена эта.

    Возвращаемое значение. Нет.

    2.3.10.8. HashMap::getObjectStatus()

    Описание. Этот метод получает статус HashMap для которой это вызвано. Возвращаемое значение имеет тип Object::Status.

    Сигнатура.

    virtual Status getObjectStatus
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Возвращает текущий Status для HashMap .

    2.3.10.9. HashMap::getObjectVersion()

    Описание. Метод получает версию объекта схемы хэш-карты.

    Сигнатура.

    virtual int getObjectVersion
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Номер версии объекта integer.

    2.3.10.10. HashMap::getObjectId()

    Описание. Этот метод получает ID хэш-карты.

    Сигнатура.

    virtual int getObjectId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Идентификатор объекта integer.

    2.3.11. Класс Index

    Резюме

    Эта секция обеспечивает ссылку на класс Index и его публичные члены.

    Родительский класс. NdbDictionary.

    Дочерние классы. Нет.

    Описание. Этот класс представляет индекс на столбце таблицы NDB Cluster. Это потомок класса NdbDictionary , использующий класс Object.

    Методы.

    Таблица 2.25.

    Имя Описание
    Index() Конструктор класса
    ~Index() Деструктор
    addColumn() Добавляет объект Column в индекс
    addColumnName() Добавляет столбец по имени к индексу
    addColumnNames() Добавляет многочисленные колонки по именам к индексу
    getColumn() Получает колонки (часть) индекса
    getLogging() Проверка, зарегистрирован ли индекс на диске
    getName() Получает название индекса
    getNoOfColumns() Получает количество столбцов, принадлежащих индексу
    getObjectStatus() Получает статус индексного объекта
    getObjectVersion() Получает версию индексного объекта
    getObjectId() Получает ID индексного объекта
    getTable() Получает название внесенной в индекс таблицы
    getType() Получает тип индекса
    setLogging() Включает/отключает регистрацию индекса на диске
    setName() Определяет имя индекса
    setTable() Определяет имя таблицы, которая будет индексирована
    setType() Установите тип индекса

    Типы. У индекса есть один публичный тип Type.

    Если вы создаете или изменяете индексы, используя NDB API, эти модификации не могут быть видны MySQL. Единственное исключение: переименование индекса с использованием Index::setName().

    2.3.11.1. Конструктор класса индекса

    Описание. Это используется, чтобы создать новый экземпляр Index.

    Созданные с использованием API NDB индексы не видны MySQL Server.

    Сигнатура.

    Index
    (
      const char* name = ""
    )
    

    Параметры. Название нового индекса. Возможно создать индекс без имени, и затем назначить имя ему позже с использованием setName(). См. раздел 2.3.11.15.

    Возвращаемое значение. Новый экземпляр Index.

    Деструктор. Деструктор (~Index()) поставляется как виртуальный метод.

    2.3.11.2. Index::addColumn()

    Описание. Этот метод может использоваться, чтобы добавить колонку к индексу.

    Порядок столбцов соответствует порядку, в котором они добавляются к индексу. Однако это имеет значение только с упорядоченными индексами.

    Сигнатура.

    void addColumn
    (
      const Column& c
    )
    

    Параметры. Ссылка c к колонке, которая должна быть добавлена к индексу.

    Возвращаемое значение. Нет.

    2.3.11.3. Index::addColumnName()

    Описание. Этот метод работает таким же образом, как addColumn() за исключением того, что это берет название колонки в качестве параметра. Посмотрите раздел 2.3.11.5.

    Сигнатура.

    void addColumnName
    (
      const char* name
    )
    

    Параметры. Имя name колонки, которая будет добавлена к индексу как постоянный указатель на символ.

    Возвращаемое значение. Нет.

    2.3.11.4. Index::addColumnNames()

    Описание. Этот метод используется, чтобы добавить несколько имен столбцов к определению индекса.

    Как addColumn() и addColumnName(), индексы пронумерованы в порядке, в котором они были добавлены. Однако, это имеет значение только для упорядоченных индексов.

    Сигнатура.

    void addColumnNames
    (
      unsigned noOfNames,
      const char** names
    )
    

    Параметры. Этот метод берет два параметра, перечисленные здесь:

    • Количество столбцов и имен noOfNames для добавления к индексу.

    • Имена names для добавления к индексу (как указатель на указатель).

    Возвращаемое значение. Нет.

    2.3.11.5. Index::getColumn()

    Описание. Этот метод получает колонку в указанной позиции в индексе.

    Сигнатура.

    const Column* getColumn
    (
      unsigned no
    ) const
    

    Параметры. Порядковый номер позиции no колонки как unsigned integer. Используйте getNoOfColumns(), чтобы определить, сколько столбцов составляет индекс, см. раздел 2.3.11.8.

    Возвращаемое значение. Столбец, имеющий позицию no в индексе, как указатель на экземпляр Column . См. раздел 2.3.2.

    2.3.11.6. Index::getLogging()

    Описание. Используйте этот метод, чтобы определить, была ли регистрация на диск позволена для индекса.

    Индексы, которые не зарегистрированы, восстановлены, когда кластер запущен или перезапущен.

    Упорядоченные индексы в настоящее время не поддерживают регистрацию на диске, они восстановлены каждый раз, когда кластер запущен. Это включает перезапуски.

    Сигнатура.

    bool getLogging
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение.

    • true: Индекс регистрируется на диск.

    • false: Индекс не регистрируется на диск.

    2.3.11.7. Index::getName()

    Описание. Этот метод используется, чтобы получить название индекса.

    Сигнатура.

    const char* getName
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Название индекса, как постоянный указатель на символ.

    2.3.11.8. Index::getNoOfColumns()

    Описание. Этот метод используется, чтобы получить количество столбцов, составляющих индекс.

    Сигнатура.

    unsigned getNoOfColumns
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. unsigned integer, представляющий количество столбцов в индексе.

    2.3.11.9. Index::getObjectStatus()

    Описание. Этот метод получает статус объекта индекса.

    Сигнатура.

    virtual Object::Status getObjectStatus
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. A Status, см. раздел 2.3.31.4.

    2.3.11.10. Index::getObjectVersion()

    Описание. Этот метод получает версию объекта индекса (см. NDB Schema Object Versions).

    Сигнатура.

    virtual int getObjectVersion
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Версия объекта индекса как integer.

    2.3.11.11. Index::getObjectId()

    Описание. Этот метод используется, чтобы получить идентификатор объекта индекса.

    Сигнатура.

    virtual int getObjectId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Идентификатор объекта как integer.

    2.3.11.12. Index::getTable()

    Описание. Этот метод может использоваться, чтобы получить название таблицы, которой принадлежит индекс.

    Сигнатура.

    const char* getTable
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Название таблицы, как постоянный указатель на символ.

    2.3.11.13. Index::getType()

    Описание. Этот метод может использоваться, чтобы найти тип индекса.

    Сигнатура.

    Type getType
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Тип индекса. Посмотрите раздел 2.3.11.18.

    2.3.11.14. Index::setLogging

    Описание. Этот метод используется, чтобы включить или отключить регистрацию индекса на диск.

    Сигнатура.

    void setLogging
    (
      bool enable
    )
    

    Параметры. setLogging() берет единственный булев параметр enable. Если enable = true, тогда регистрация позволена для индекса, если false, выключена.

    Возвращаемое значение. Нет.

    2.3.11.15. Index::setName()

    Описание. Этот метод определяет имя индекса.

    Это единственный метод Index::set*() , результат которого видим MySQL Server.

    Сигнатура.

    void setName
    (
      const char* name
    )
    

    Параметры. Желаемое имя name для индекса как постоянный указатель на символ.

    Возвращаемое значение. Нет.

    2.3.11.16. Index::setTable()

    Описание. Этот метод устанавливает таблицу, которая должна быть внесена в индекс. На таблицу ссылаются по имени.

    Сигнатура.

    void setTable
    (
      const char* name
    )
    

    Параметры. Имя name таблицы, которая будет внесена в индекс как постоянный указатель на символ.

    Возвращаемое значение. Нет.

    2.3.11.17. Index::setType()

    Описание. Этот метод используется, чтобы установить тип индекса.

    Сигнатура.

    void setType
    (
      Type type
    )
    

    Параметры. Тип type индекса, см. раздел 2.3.11.18.

    Возвращаемое значение. Нет.

    2.3.11.18. Index::Type

    Описание. Это перечислимый тип, который описывает вид индекса столбца, представленного экземпляром Index.

    Не путайте этот перечислимый тип с Object::Type или с Column::Type.

    Возможные значения.

    Таблица 2.26.

    Имя Описание
    Undefined Неопределенный тип объекта (начальная буква/значение по умолчанию)
    UniqueHashIndex Уникальный неупорядоченный хэш-индекс (только тип индекса поддержанный в настоящее время)
    OrderedIndex Групповой, упорядоченный индекс

    2.3.12. Структура IndexBound

    Родительский класс. NdbIndexScanOperation.

    Описание. IndexBound это структура, используемая, чтобы описать границы просмотра индекса для NdbRecord .

    Члены.

    Таблица 2.27.

    Имя Тип Описание
    low_key const char* Строка, содержащая нижнюю границу для просмотра (или NULL для просмотра с начала).
    low_key_count Uint32 Количество столбцов в нижней границе (для ограничения частичным префиксом).
    low_inclusive bool True для отношения <=, false для <.
    high_key const char* Строка, содержащая верхнюю границу для просмотра (или NULL для просмотра до конца).
    high_key_count Uint32 Количество столбцов в верхней границе (для ограничения частичным префиксом).
    high_inclusive bool True для отношения >=, false для >.
    range_no Uint32 Значение, чтобы определить границу, может быть прочитано, используя метод get_range_no() (см. раздел 2.3.23.4 ). Это значение должна быть меньше 8192 (0, если это не используется). Для упорядоченных просмотров range_no должен строго увеличиваться для каждого диапазона, иначе набор результатов не будет сортирован правильно.

    См. раздел 2.3.27.

    2.3.13. Класс LogfileGroup

    Резюме

    Эта секция обсуждает класс LogfileGroup, который представляет группу файла журнала NDB Cluster Disk Data.

    Родительский класс. NdbDictionary .

    Дочерние классы. Нет.

    Описание. Этот класс представляет группу файла журнала NDB Cluster Disk Data, которая используется для того, чтобы хранить дисковые данные файла отмен. Для получения общей информации о группах файла журнала и файла отмен см. NDB Cluster Disk Data Tables в MySQL Manual.

    Только неиндексируемые данные столбца могут храниться на диске. Индексы и колонки индексов всегда хранятся в памяти.

    Методы.

    Таблица 2.28.

    группы файла журнала
    Имя Описание
    LogfileGroup() Конструктор класса
    ~LogfileGroup() Виртуальный деструктор
    getAutoGrowSpecification() Получает значения группы файла журнала AutoGrowSpecification
    getName() Получает имя файла журнала
    getObjectId() Получает идентификатор объекта группы файла журнала
    getObjectStatus() Получает значение статуса объекта группы файла журнала
    getObjectVersion() Получает версию объекта файла журнала
    getUndoBufferSize() Получает размер буфера UNDO
    getUndoFreeWords() Получаетколичество свободного пространства в буфере UNDO
    setAutoGrowSpecification() Задает значения AutoGrowSpecification для файла журнала
    setName() Определяет имя группы файла журнала
    setUndoBufferSize() Устанавливает размер буфера UNDO файла журнала

    Типы. Класс LogfileGroup самостоятельно не определяет публичных типов. Однако, два из его методов используют структуру AutoGrowSpecification в качестве параметра или возвращаемого значения. Для получения дополнительной информации посмотрите раздел 2.3.1.

    2.3.13.1. Конструктор LogfileGroup

    Описание. Класс LogfileGroup имеет два публичных конструктора, один из которых не берет аргументов и создает абсолютно новый экземпляр. Другой конструктор копии.

    Класс Dictionary также поставляет методы для создания и разрушения объектов LogfileGroup, см. раздел 2.3.4.

    Сигнатуры. Новый экземпляр:

    LogfileGroup
    (
      void
    )
    

    Конструктор копии:

    LogfileGroup
    (
      const LogfileGroup& logfileGroup
    )
    

    Параметры. Создавая новый экземпляр, конструктор не берет параметров. Копируя существующий экземпляр, конструктору нужна ссылка на экземпляр LogfileGroup, который будет скопирован.

    Возвращаемое значение. Объект LogfileGroup.

    Деструктор.

    virtual ~LogfileGroup
    (
      void
    )
    

    2.3.13.2. LogfileGroup::getAutoGrowSpecification()

    Описание. Этот метод получает AutoGrowSpecification связанный с группой файла журнала.

    Сигнатура.

    const AutoGrowSpecification& getAutoGrowSpecification
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Структура данных AutoGrowSpecification, см. раздел 2.3.1.

    2.3.13.3. LogfileGroup::getName()

    Описание. Этот метод получает имя группы файла журнала.

    Сигнатура.

    const char* getName
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Имя группы файла журнала, строка (как указатель на символ).

    2.3.13.4. LogfileGroup::getObjectId()

    Описание. Этот метод используется, чтобы получить идентификатор объекта группы файла журнала.

    Сигнатура.

    virtual int getObjectId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Идентификатор объекта файла журнала (integer).

    2.3.13.5. LogfileGroup::getObjectStatus()

    Описание. Этот метод используется, чтобы получить статус объекта LogfileGroup .

    Сигнатура.

    virtual Object::Status getObjectStatus
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Status группы файла журнала, см. раздел 2.3.31.4.

    2.3.13.6. LogfileGroup::getObjectVersion()

    Описание. Этот метод получает версию объекта файла журнала (см. NDB Schema Object Versions).

    Сигнатура.

    virtual int getObjectVersion
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Версия объекта кластера файла журнала как integer.

    2.3.13.7. LogfileGroup::getUndoBufferSize()

    Описание. Этот метод получает размер буфера UNDO.

    Сигнатура.

    Uint32 getUndoBufferSize
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Размер буфера UNDO в байтах.

    2.3.13.8. LogfileGroup::getUndoFreeWords()

    Описание. Этот метод получает число байтов, неиспользованных в буфере UNDO группы файла журнала.

    Сигнатура.

    Uint64 getUndoFreeWords
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Число свободных байтов как 64-bit integer.

    2.3.13.9. LogfileGroup::setAutoGrowSpecification()

    Описание. Этот метод устанавливает AutoGrowSpecification для группы файла журнала.

    Сигнатура.

    void setAutoGrowSpecification
    (
      const AutoGrowSpecification& autoGrowSpec
    )
    

    Параметры. Данные передаются как единственный параметр в виде структуры AutoGrowSpecification, см. раздел 2.3.1.

    Возвращаемое значение. Нет.

    2.3.13.10. LogfileGroup::setName()

    Описание. Этот метод используется, чтобы определить имя для группы файла журнала.

    Сигнатура.

    void setName
    (
      const char* name
    )
    

    Параметры. Имя name для группы файла журнала (указатель на символ).

    Возвращаемое значение. Нет.

    2.3.13.11. LogfileGroup::setUndoBufferSize()

    Описание. Этот метод может использоваться, чтобы установить размер буфера UNDO группы файла журнала.

    Сигнатура.

    void setUndoBufferSize
    (
      Uint32 size
    )
    

    Параметры. Размер size в байтах (32-bit unsigned integer).

    Возвращаемое значение. Нет.

    2.3.14. Класс List

    Резюме

    Эта секция покрывает класс List.

    Родительский класс. Dictionary.

    Дочерние классы. Нет.

    Описание. Класс List это подкласс Dictionary, который используется для представления списков, заполняемых методами Dictionary::listObjects(), Dictionary::listIndexes() и Dictionary::listEvents().

    Методы класса. У этого класса есть только два метода, конструктор и деструктор. Никакой метод не берет аргументов.

    Конструктор. Запрос конструктора List создает новый List, count и elements которого установлены равными 0.

    Деструктор. Деструктор ~List() просто определяется таким способом как, чтобы удалить все элементы и их свойства. Можно найти его определение в файле /storage/ndb/include/ndbapi/NdbDictionary.hpp.

    Атрибуты. List имеет следующие два признака:

    • count, unsigned integer, хранит число элементов в списке.

    • elements, указатель на множество структур данных Element, которые содержатся в списке. Посмотрите раздел 2.3.5.

    Типы. Класс List также определяет структуру Element.

    2.3.15. Структура Key_part_ptr

    Резюме

    Эта секция описывает структуру Key_part_ptr.

    Родительский класс. Ndb.

    Описание. Key_part_ptr обеспечивает удобный способ определить ключевые данные, запускаются транзакции и вычисляюются значения хэш-функции, передаваемые в указателях на значения ключа распределения. Когда у ключа распределения есть многократные части, они должны быть переданы как множество, причем последняя часть равна NULL. См. разделы 2.3.16.35 и 2.3.16.3.

    Атрибуты.

    Таблица 2.29.

    Атрибут Тип Начальное значение Описание
    ptr const void* Нет Указатель на одно или более значений ключа распределения
    len unsigned Нет Длина указателя

    2.3.16. Класс Ndb

    Резюме

    Этот класс представляет ядро NDB, это основной класс API NDB.

    Родительский класс. Нет.

    Дочерние классы. Нет.

    Описание. Любая нетривиальная программа API NDB использует по крайней мере один экземпляр Ndb. При помощи нескольких объектов Ndb возможно реализовать многопоточное приложение. Необходимо помнить, что один объект Ndb не может быть разделен между потоками, однако, для единственного потока возможно использовать многократные объекты Ndb. Единственный прикладной процесс может поддержать максимум объектов 4711 Ndb.

    Потребление ресурсов объектами Ndb. Объект Ndb потребляет память в пропорции к размеру самой большой операции, выполненной за жизнь объекта. Это особенно примечательно в случаях больших транзакций или использования столбцов BLOB или TEXT. Эта память выделяется для целой жизни объекта и когда-то используется таким образом, единственный способ освободить эту память состоит в том, чтобы разрушить объект (и затем создать новый экземпляр при желании).

    Объект Ndb ориентирован на многопотоковое исполнение в этом случае каждый объект Ndb может быть обработан одним потоком за один раз. Если Ndb передан другому потоку, тогда приложение должно гарантировать, что барьер памяти используется, чтобы гарантировать, что новый поток видит все обновления, выполненные предыдущим потоком.

    Семафоры и мьютексы это примеры легких способов обеспечить барьеры памяти, не имея необходимость беспокоиться о понятии барьера памяти.

    Также возможно использовать многократные объекты Ndb, чтобы выполнить операции на различных кластерах в отдельном приложении. Посмотрите здесь для условий и ограничений, относящихся к такому использованию.

    Методы.

    Таблица 2.30.

    Имя Описание
    Ndb() Конструктор класса, представляет связь с кластером NDB.
    ~Ndb() Деструктор класса, заканчивает связь кластера, когда она больше не должна использоваться
    closeTransaction() Закрывает транзакцию
    computeHash() Вычисляет значение хэш-функции распределения
    createEventOperation() Создает подписку на событие базы данных. См. раздел 2.3.21.
    dropEventOperation() Удаляет подписку на событие базы данных
    getDictionary() Получает словарь, который используется для работы с информацией схемы базы данных
    getDatabaseName() Получает название текущей базы данных
    getDatabaseSchemaName() Получает название текущей схемы базы данных
    get_eventbuf_max_alloc() Получает текущий максимальный размер буфера событий. Добавлено в NDB 7.2.14 и NDB 7.3.3.
    get_eventbuffer_free_percent() Получает процент буферной памяти событий, которая должна быть доступной прежде продолжения буферизации, когда предел был достигнут. Добавлено в NDB 7.4.3.
    get_event_buffer_memory_usage() Предоставляет информацию об использовании буферной памяти событий. Добавлено в NDB 7.4.3.
    getGCIEventOperations() Получает следующую операцию событий от GCI. Устарело в NDB 7.4.3.
    getHighestQueuedEpoch() Получает последнюю эпоху в очереди событий. Добавлено в NDB 7.4.3
    getLatestGCI() Получает новый GCI. Устарело в NDB 7.4.3
    getNdbError() Получает ошибку. См. раздел 2.3.20
    getNdbErrorDetail() Получает дополнительные детали ошибки
    getNdbObjectName() Получает имя объекта Ndb, если оно было установлено. Добавлено в NDB 7.2.17 и NDB 7.3.6
    getNextEventOpInEpoch2() Получает следующую операцию событий в этой глобальной контрольной точке
    getNextEventOpInEpoch3() Получает следующую операцию событий в этой глобальной контрольной точке, показывая, любые полученные значения. Добавлено в NDB 7.2.32, 7.3.20, 7.4.18, 7.5.9, 7.6.4
    getReference() Получает ссылку или идентификатор для экземпляра объекта Ndb
    init() Инициализирует объект Ndb и делает его готовым к употреблению
    isConsistent() Последовательны ли все полученные события. Устарело в NDB 7.4.3
    isConsistentGCI() Последовательны ли все полученные события для данной глобальной контрольной точки. Устарело в NDB 7.4.3
    isExpectingHigherQueuedEpochs() Проверяет, есть ли новые очереди эпох или было событие неудачи кластера. Добавлено в NDB 7.2.21, NDB 7.3.10 и NDB 7.4.7
    nextEvent() Получает следующее событие от очереди. Устарело в NDB 7.4.3.
    nextEvent2() Получает следующее событие от очереди. Добавлено в NDB 7.4.3.
    pollEvents() Ждет события. Устарело в NDB 7.4.3.
    pollEvents2() Ждет события. Добавлено в NDB 7.4.3.
    setDatabaseName() Определяет имя текущей базы данных
    setDatabaseSchemaName() Определяет имя текущей схемы базы данных
    setEventBufferQueueEmptyEpoch() Позволяет стоять в очереди пустым событиям. Добавлено в NDB 7.4.11 и NDB 7.5.2
    set_eventbuf_max_alloc() Устанавливает ассигнованный максимальный размер буфера событий. Добавлено в NDB 7.2.14 и NDB 7.3.3
    set_eventbuffer_free_percent() Устанавливает процент буферной памяти событий, которая должна быть доступной прежде, чем продолжить буферизацию, когда предел был достигнут. Добавлено в NDB 7.4.3.
    setNdbObjectName() Для целей отладки: определяет произвольное имя для этого объекта Ndb. Добавлено в NDB 7.2.17 и NDB 7.3.6
    startTransaction() Начинает транзакцию. См. раздел 2.3.30

    2.3.16.1. Конструктор класса Ndb

    Описание. Это создает экземпляр Ndb, который представляет связь с кластером NDB. Все приложения API NDB должны начаться с создания по крайней мере одного объекта Ndb. Это требует создания по крайней мере одного экземпляра Ndb_cluster_connection, который служит контейнером для строки подключения кластера.

    Сигнатура.

    Ndb
    (
      Ndb_cluster_connection* ndb_cluster_connection,
      const char* catalogName = "",
      const char* schemaName = "def"
    )
    

    Параметры. Конструктор класса Ndb может взять до 3 параметров, из которых требуется только первый:

    • ndb_cluster_connection экземпляр Ndb_cluster_connection, который представляет строку подключения кластера. См. раздел 2.3.17.

      До NDB 7.3.8 и NDB 7.4.3 было возможно удалить Ndb_cluster_connection используемый, чтобы создать экземпляр Ndb без удаления объекта Ndb (Bug #19999242).

    • catalogName дополнительный параметр, обеспечивающий пространство имен для таблиц и индексов, созданных в любой связи из объекта Ndb.

      Это эквивалентно тому, что mysqld рассматривает как базу данных.

      Значение по умолчанию для этого параметра пустая строка.

    • Дополнительно schemaName обеспечивает дополнительное пространство имен для таблиц и индексов, созданных в данном каталоге.

      Значение по умолчанию для этого параметра последовательность def.

    Возвращаемое значение. Объект Ndb.

    ~Ndb() (Деструктор класса). Деструктор для класса Ndb нужно вызвать, чтобы закончить экземпляр Ndb. Это не требует никаких аргументов и любой специальной обработки.

    2.3.16.2. Ndb::closeTransaction()

    Описание. Это - один из двух методов API NDB, предусмотренных для закрытия транзакции (другой NdbTransaction::close()). Необходимо назвать один из этих двух методов, чтобы закончить транзакцию, как только это было закончено.

    Если транзакция еще не была передана, она прерывается, когда этот метод вызывают. Посмотрите раздел 2.3.16.35.

    Сигнатура.

    void closeTransaction
    (
      NdbTransaction *transaction
    )
    

    Параметры. Этот метод берет отдельный аргумент, указатель на транзакцию NdbTransaction.

    2.3.16.3. Ndb::computeHash()

    Описание. Этот метод может использоваться, чтобы вычислить значение хэш-функции распределения, учитывая таблицу и ее ключи.

    computeHash() может использоваться только для таблиц, использующих разделение NDB.

    Сигнатура.

    static int computeHash
    (
      Uint32* hashvalueptr,
      const NdbDictionary::Table* table,
      const struct Key_part_ptr*keyData,
      void* xfrmbuf = 0,
      Uint32 xfrmbuflen = 0
    )
    

    Параметры.

    • Если вызов метода успешен, hashvalueptr установлен в вычисленное значение хэш-функции.

    • Указатель на table (см. раздел 2.3.37).

    • keyData законченное пустым указателем множество указателей на ключевые части, которые являются частью ключа распределения таблицы. Длина каждой ключевой части прочитана из метаданных и сравнена с переданным значением (см. раздел 2.3.15).

    • xfrmbuf указатель на временный буфер, используемый, чтобы вычислить значение хэш-функции.

    • xfrmbuflen длина этого буфера.

      Если xfrmbuf = NULL (по умолчанию), вызов malloc() или free() сделан автоматически. computeHash() терпит неудачу, если xfrmbuf не NULL и xfrmbuflen слишком маленькое.

      Ранее предполагалось что память, возвращенная malloc(), всегда соответственно выравнивалась, что не всегда имеет место. Начиная с версий 7.2.13 и 7.3.2 кластера NDB, когда malloc() предоставляет буфер этому методу, буфер явно выровнен после того, как это ассигнуется, и прежде чем это будет на самом деле использоваться (Bug #16484617).

    Возвращаемое значение. 0 при удаче, код ошибки при сбое. Если вызов метода имеет успех, вычисленное значение хэш-функции сделано доступным через hashvalueptr.

    2.3.16.4. Ndb::createEventOperation()

    Описание. Этот метод создает подписку на событие базы данных.

    Подписки событий NDB API не сохраняются после того, как кластер NDB был восстановлен, используя ndb_restore, в таких случаях все подписки должны быть воссозданы явно.

    Сигнатура.

    NdbEventOperation* createEventOperation
    (
      const char *eventName
    )
    

    Параметры. Этот метод берет отдельный аргумент, уникальное имя eventName, идентифицирующее событие, на которое вы хотите подписаться.

    Возвращаемое значение. Указатель на объект NdbEventOperation (или NULL в случае неудачи). Посмотрите раздел 2.3.21.

    2.3.16.5. Ndb::dropEventOperation()

    Описание. Этот метод удаляет подписку на событие базы данных, представленное объектом NdbEventOperation.

    Память, используемая операцией события, которое было удалено, не освобождена, пока буфер событий не был полностью прочитан. Это означает, что необходимо продолжить вызывать pollEvents() и nextEvent() в таких случаях пока методы не вернут 0 и NULL, соответственно для этой памяти, которая будет освобождена.

    Сигнатура.

    int dropEventOperation
    (
      NdbEventOperation *eventOp
    )
    

    Параметры. Этот метод требует единственного входного параметра, указателя на экземпляр NdbEventOperation.

    Возвращаемое значение. 0 при успехе, любой другой результат указывает на неудачу.

    2.3.16.6. Ndb::getDictionary()

    Описание. Этот метод используется, чтобы получить объект для восстановления или управления информацией о схеме базы данных. Этот объект Dictionary содержит метаинформацию обо всех таблицах в кластере.

    Словарь, возвращенный этим методом, работает независимо от любой транзакции. См. раздел 2.3.4.

    Сигнатура.

    NdbDictionary::Dictionary* getDictionary
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Экземпляр класса Dictionary.

    2.3.16.7. Ndb::getDatabaseName()

    Описание. Этот метод может использоваться, чтобы получить название текущей базы данных.

    Сигнатура.

    const char* getDatabaseName
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Название текущей базы данных.

    2.3.16.8. Ndb::getDatabaseSchemaName()

    Описание. Этот метод может использоваться, чтобы получить текущее название схемы базы данных.

    Сигнатура.

    const char* getDatabaseSchemaName
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Название текущей схемы базы данных.

    2.3.16.9. Ndb::getGCIEventOperations()

    Описание. Проходит по отличным операциям событий, которые являются частью текущего GCI, становясь действительными после запроса nextEvent() . Можно использовать этот метод, чтобы получить итоговую информацию в течение эпохи (такой как список всех таблиц) прежде, чем обработать данные о событии.

    Этот метод устарел в NDB 7.4.3 и подвергается удалению в будущем выпуске. В NDB 7.4.3 и позже необходимо использовать getNextEventOpInEpoch2().

    Сигнатура.

    const NdbEventOperation* getGCIEventOperations
    (
      Uint32* iter,
      Uint32* event_types
    )
    

    Параметры. Итератор и маска типов событий. Установите для начала *iter=0 .

    Возвращаемое значение. Следующая операция событий, вернет NULL, когда больше нет операций событий. Если event_types не NULL, тогда после запроса метода это содержит битовую маску полученных типов событий.

    2.3.16.10. Ndb::get_eventbuf_max_alloc()

    Описание. Получает максимальную память в байтах, которая может использоваться для буфера событий. Это совпадает с чтением значения системной переменной MySQL Server ndb_eventbuffer_max_alloc.

    Добавлено в NDB 7.2.14 и NDB 7.3.3.

    Сигнатура.

    unsigned get_eventbuf_max_alloc
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Максимальная память, доступная для буфера событий, в байтах.

    2.3.16.11. Ndb::get_eventbuffer_free_percent()

    Описание. Получает ndb_eventbuffer_free_percent то есть, процент буферной памяти событий, которая должна быть доступной прежде, чем продолжить буферизацию после тогго, как был достигнут ndb_eventbuffer_max_alloc. Это значение вычисляется как used*100/ ndb_eventbuffer_max_alloc, где used это сумма на самом деле используемой буферной памяти событий в байтах.

    Добавлено в NDB 7.4.3.

    Сигнатура.

    unsigned get_eventbuffer_free_percent
    (
      void
    )
    

    Параметры. Процент (pct) буферной памяти событий, которая должна присутствовать. Действительный диапазон равняется от 1 до 99, включая границы.

    Возвращаемое значение. Нет.

    2.3.16.12. Ndb::get_event_buffer_memory_usage()

    Описание. Получает использование буфера событий как процент ndb_eventbuffer_max_alloc. В отличие от get_eventbuffer_free_percent(), этот метод делает полную информацию об использовании доступной в форме структуры данных EventBufferMemoryUsage.

    Добавлено в NDB 7.4.3.

    Сигнатура.

    void get_event_buffer_memory_usage
    (
      EventBufferMemoryUsage&
    )
    

    Параметры. Ссылка на структуру EventBufferMemoryUsage, которая получает данные об использовании.

    Возвращаемое значение. Нет.

    2.3.16.13. Ndb::getHighestQueuedEpoch()

    Описание. Добавлено в NDB 7.4.3, этот метод заменяет устаревший getLatestGCI().

    До NDB 7.4.7 этот метод возвратил самый большой номер эпохи в очереди событий. В NDB 7.4.7 и позже это возвращает самый большой номер эпохи после запроса pollEvents2() (Bug #20700220).

    Сигнатура.

    Uint64 getHighestQueuedEpoch
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Новый номер эпохи, integer.

    2.3.16.14. Ndb::getLatestGCI()

    Описание. Получает индекс для новой глобальной контрольной точки.

    Этот метод устарел в NDB 7.4.3. В NDB 7.4.3 и позже необходимо использовать getHighestQueuedEpoch().

    Сигнатура.

    Uint64 getLatestGCI
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Новый GCI, integer.

    2.3.16.15. Ndb::getNdbError()

    Описание. Этот метод предоставляет вам два различных способа получить объект NdbError, представляющий состояние ошибки. Для более подробной информации об обработке ошибок в API NDB см. NDB Cluster API Errors.

    Сигнатура. Метод getNdbError() имеет два варианта.

    Первый из них просто получает новую ошибку:

    const NdbError& getNdbError
    (
      void
    )
    

    Второй вариант возвращает ошибку при соответствии данному коду ошибки:

    const NdbError& getNdbError
    (
      int errorCode
    )
    

    Независимо от того, которая версия метода используется, объект NdbError сохраняется, пока следующий метод API NDB не вызван.

    Параметры. Чтобы получить новую ошибку, просто вызовите getNdbError() без любых параметров. Получить ошибку при соответствии определенному errorCode можно, вызвав метод, принимающий код (int) в качестве параметра. Для списка кодов ошибок API NDB и соответствующих сообщений об ошибках, посмотрите раздел 2.4.

    Возвращаемое значение. Объект NdbError, содержащий информацию об ошибке, включая ее тип и, когда это применимо, контекстная информация относительно того, как ошибка возникла. Посмотрите раздел 2.3.20.

    2.3.16.16. Ndb::getNdbErrorDetail()

    Описание. Этот метод обеспечивает легкий и безопасный способ получить доступ к любой дополнительной информации об ошибке, вместо того, чтобы читать эти дополнительные детали от объекта NdbError (свойство details, устарело в пользу getNdbErrorDetail(), см. Bug #48851). Этот метод позволяет хранение таких деталей в предоставленном пользователем буфере, возвращая указатель на начало этого буфера. Если последовательность, содержащая детали, превышает длину буфера, это усечено, чтобы ему соответствовать.

    getErrorDetail() обеспечивает источник ошибки в форме последовательности. В случае нарушения ограничения на уникальность данных (ошибка 893), эта последовательность поставляет полностью определенное имя индекса, где порождена проблема, в формате database-name/ schema-name/ table-name/ index-name, (NdbError.details поставляет только ID индекса и часто неочевидно, которой таблице этот индекс принадлежит. Независимо от типа ошибки и деталей относительно этой ошибки, последовательность, полученная getErrorDetail(), всегда заканчивается пустым указателем.

    Сигнатура.

    const char* getNdbErrorDetail
    (
      const NdbError& error,
      char* buffer,
      Uint32 bufferLength
    ) const
    

    Параметры. Чтобы получить подробную информацию об ошибке, вызовите getNdbErrorDetail() со ссылкой на объект NdbError, buffer и длину этого буфера (unsigned 32-bit integer).

    Возвращаемое значение. Когда дополнительные детали о error доступны, этот метод возвращает указатель на начало поставляемого буфера buffer. Как указано ранее, если последовательность, содержащая детали, более длинна, чем bufferLength, последовательность усечена, чтобы соответствовать. Если никакие дополнительные детали недоступны, getNdbErrorDetail() вернет NULL.

    2.3.16.17. Ndb::getNdbObjectName()

    Описание. Если имя было определено для объекта Ndb до его инициализации, можно получить его, используя этот метод. Используемый для отладки.

    Сигнатура.

    const char* getNdbObjectName
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Имя объекта Ndb, если было установлено, используя setNdbObjectName(). Иначе 0.

    Добавлено в NDB 7.2.17 и NDB 7.3.6 (Bug #18419907).

    2.3.16.18. Ndb::getNextEventOpInEpoch2()

    Описание. Проходит по операциям по одиночным событиям, составляющим текущую глобальную контрольную точку. Используйте следующий nextEvent2(), чтобы получить итоговую информацию в течение эпохи, такую как список всех таблиц, прежде, чем обработать данные о событии.

    Исключительные эпохи не начинают операций событий, связанных с ними.

    Сигнатура.

    const NdbEventOperation* getNextEventOpInEpoch2
    (
      Uint32* iter,
      Uint32* event_types
    )
    

    Параметры. Первоначально задайте iter = 0, это NULL, когда больше нет событий в течение этой эпохи. Если event_types не NULL, это считает битовую маску типов событий полученной.

    Возвращаемое значение. Указатель на следующий NdbEventOperation, если он есть.

    2.3.16.19. Ndb::getNextEventOpInEpoch3()

    Описание. Проходит по операциям по одиночным событиям, составляющим текущую глобальную контрольную точку. Используйте следующий nextEvent2(), чтобы получить итоговую информацию в течение эпохи, такую как список всех таблиц, прежде, чем обработать данные о событии. Совпадает с getNextEventOpInEpoch3(), но с добавлением третьего аргумента, который считает слияние всех AnyValues полученным, показывая, какие биты установлены для всех операций на данной таблице.

    Исключительные эпохи не начинают операций событий, связанных с ними.

    Сигнатура.

    const NdbEventOperation* getNextEventOpInEpoch2
    (
      Uint32* iter,
      Uint32* event_types
      Uint32* cumulative_any_value
    )
    

    Параметры. Первоначально задайте iter = 0, это NULL, когда больше нет событий в течение этой эпохи. Если event_types не NULL, это считает битовую маску типов событий полученной. Если cumulative_any_value не NULL, это считает слияние всех AnyValues полученным.

    Возвращаемое значение. Указатель на следующий NdbEventOperation, если есть.

    Добавлено в NDB 7.2.32, 7.3.20, 7.4.18, 7.5.9 и 7.6.4 (Bug #26333981).

    2.3.16.20. Ndb::getReference()

    Описание. Этот метод может использоваться, чтобы получить ссылку на данный объект Ndb . Это то же самое значение, которое возвращено для данной операции, соответствующей этому объекту в выводе DUMP 2350.

    Сигнатура.

    Uint32 getReference
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 32-bit unsigned integer.

    2.3.16.21. Ndb::init()

    Описание. Этот метод используется, чтобы инициализировать объект Ndb.

    Сигнатура.

    int init
    (
      int maxNoOfTransactions = 4
    )
    

    Параметры. Метод init() берет единственный параметр maxNoOfTransactions типа integer. Этот параметр определяет максимальное количество параллельных объектов NdbTransaction, которые могут быть обработаны этим экземпляром Ndb. Максимальное разрешенное значение для value for maxNoOfTransactions = 1024, по умолчанию 4.

    Каждая операция по просмотру или индексу использует дополнительный объект NdbTransaction.

    Возвращаемое значение. Этот метод возвращает int, который может иметь любой следующие два значения:

    • 0: указывает, что объект Ndb был инициализирован успешно.

    • -1: указывает на ошибку.

    2.3.16.22. Ndb::isConsistent()

    Описание. Проверяет, последовательны ли все события. Если сбой узла происходит, когда ресурсы исчерпаны, события могут быть потеряны и поставленные данные о событии могли бы таким образом быть неполными. Этот метод позволяет определить это.

    Устарело в NDB 7.4.3, в NDB 7.4.3 и позже необходимо вместо этого использовать NdbEventOperation::getEventType2(), чтобы определить тип события в этом экземпляре, имеет ли событие тип TE_INCONSISTENT. См. раздел 2.3.6.23.

    Сигнатура.

    bool isConsistent
    (
      Uint64& gci
    )
    

    Параметры. Ссылка на глобальный индекс контрольной точки. Это первый непоследовательный найденный GCI, если таковые имеются.

    Возвращаемое значение. true, если все события последовательны.

    2.3.16.23. Ndb::isConsistentGCI()

    Описание. Если сбой узла происходит, когда ресурсы исчерпаны, события могут быть потеряны и поставленные данные о событии могли бы таким образом быть неполными. Этот метод позволяет определить это проверяя, последовательны ли все события в данном GCI.

    Устарело в NDB 7.4.3, в NDB 7.4.3 и позже необходимо вместо этого использовать NdbEventOperation::getEventType2(), чтобы определить тип события в этом экземпляре, имеет ли событие тип TE_INCONSISTENT. См. раздел 2.3.6.23.

    Сигнатура.

    bool isConsistentGCI
    (
      Uint64 gci
    )
    

    Параметры. Глобальный индекс контрольной точки.

    Возвращаемое значение. true, если этот GCI последователен, false указывает, что GCI может быть непоследовательным.

    2.3.16.24. Ndb::isExpectingHigherQueuedEpochs()

    Описание. Проверяет были ли эпохи с очередями выше замечены последним вызовом Ndb::pollEvents2() или найдено событие TE_CLUSTER_FAILURE.

    Это возможно, после того, как был сбой кластера в течение самой высокой очереди эпохи, возвращенной pollEvents2(). В этом случае вместо того, чтобы буферизовать события, необходимо потреблять события с nextEvent() пока не обнаруживается TE_CLUSTER_FAILURE, затем снова соединитесь с кластером, когда он становится доступным снова.

    Добавлено в NDB 7.2.21, NDB 7.3.10 и NDB 7.4.7 (Bug #18753887).

    Сигнатура.

    bool isExpectingHigherQueuedEpochs
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. True, если эпохи с очередями были замечены последним pollEvents2(), или в случае сбоя кластера.

    2.3.16.25. Ndb::nextEvent()

    Описание. Возвращает следующую операцию событий, имеющую данные из подписной очереди.

    Устарело в NDB 7.4.3, в NDB 7.4.3 и позже необходимо использовать nextEvent2().

    Сигнатура.

    NdbEventOperation* nextEvent
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Этот метод возвращает объект NdbEventOperation, представляющий следующее событие в подписной очереди, если есть такое событие. Если нет никакого события в очереди, он возвращает NULL.

    Начиная с NDB 7.2.17 и NDB 7.3.6, этот метод очищает непоследовательные события данных из очереди событий, обрабатывая их. Чтобы очистить все такие события в этих и более поздних версиях, приложения должны вызвать этот метод даже в случаях, когда pollEvents() вернул 0 (Bug #18716991).

    2.3.16.26. Ndb::nextEvent2()

    Описание. Возвращает операцию событий, связанную с данными, из очереди событий. Это нужно вызывать неоднократно после того, как pollEvents2() наполнит очередь, пока очередь событий не будет пуста.

    Добавлено в NDB 7.4.3, этот метод заменяет устаревший nextEvent() .

    После запроса этого метода надо использовать NdbEventOperation::getEpoch(), чтобы определить эпоху, затем проверьте тип возвращенного события, используя NdbEventOperation::getEventType2(). Обработка должна быть предоставлена типами TableEvent, включая TE_EMPTY, TE_INCONSISTENT и TE_OUT_OF_MEMORY (введен в NDB 7.4.3). Никакие другие методы NdbEventOperation, чем эти два, названные здесь, не нужно вызывать в течение исключительной эпохи. Возвращение пустых эпох (TE_EMPTY) может затопить приложение, когда узлы данных не работают. Если это нежелательно, приложения должны отфильтровать любые пустые эпохи.

    Сигнатура.

    NdbEventOperation* nextEvent2
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Этот метод возвращает объект NdbEventOperation, представляющий следующее событие в очереди событий, если есть такое событие. Если нет никакого события в очереди, он возвращает NULL.

    2.3.16.27. Ndb::pollEvents()

    Описание. Этот метод ждет GCP, чтобы закончить. Это используется, чтобы определить, доступны ли какие-либо события в подписной очереди.

    метод ждет в течение следующей эпохи , а не следующего GCP. Посмотрите раздел 2.3.21.

    В NDB 7.4.3 и позже, вы можете (и должны) использовать pollEvents2() вместо этого метода.

    До NDB 7.4.7 pollEvents() не был совместим с исключительными типами TableEvent, добавленными в NDB 7.4.3 (Bug #20646496), в NDB 7.4.7 и позже pollEvents() совместим с этими типами событий, как описано позже в этой секции.

    Сигнатура.

    int pollEvents
    (
      int maxTimeToWait,
      Uint64* latestGCI = 0
    )
    

    Параметры. Этот метод берет эти два параметра:

    • Максимальное время, чтобы ждать, в миллисекундах, перед отказом и сообщением, что никакие события не были доступны (то есть, прежде чем метод автоматически возвращает 0).

      Отрицательная величина заставляет ожидание быть неопределенным . Это не рекомендуется (и не поддерживается методом-преемником pollEvents2()).

    • Индекс новой глобальной контрольной точки. Обычно этому можно безопасно разрешить принять его значение по умолчанию, которое является 0.

    Возвращаемое значение. pollEvents() возвращает значение типа int:

    • > 0: Есть события, доступные в очереди.

    • 0: Нет никаких доступных событий.

    • В NDB 7.4.7 и позже отрицательная величина указывает на неудачу и NDB_FAILURE_GCI (~(Uint64)0) указывает на сбой кластера (Bug #18753887), 1 возвращен, сталкиваясь с исключительным событием, кроме тех случаев, когда найдены только события TE_EMPTY, как описано позже в этой секции.

    В NDB 7.4.7 и позже, когда pollEvents() находит исключительное событие во главе очереди событий, метод возвращает 1 и ведет себя следующим образом:

    • Пустые события (TE_EMPTY) удалены из главы очереди событий, пока событие, содержащее данные, не найдено. Когда это приводит ко всей очереди, обрабатываемой, не сталкиваясь ни с какими данными, метод возвращает 0 (никаких доступных событий), а не 1. Это поведение делает этот тип события очевидным для прикладного использования pollEvents().

    • После столкновения с событием, содержащим непоследовательные данные (TE_INCONSISTENT) из-за переполнения буфера узла данных, следующий вызов nextEvent() удаляет непоследовательные данные о событии данных из очереди событий и вернет NULL. Необходимо проверить несоответствие, вызывая isConsistent() немедленно после этого.

      Важно: Хотя непоследовательные данные о событии удалены из очереди событий, вызывая nextEvent(), информация о несоответствии удалена только другим nextEvent() после этого, который на самом деле находит событие, содержащее данные.

    • Когда pollEvents() находит событие переполнения буфера данных (TE_OUT_OF_MEMORY), данные о событии добавляются к очереди событий каждый раз, когда использование буфера событий превышает ndb_eventbuffer_max_alloc. В этом случае следующий вызов nextEvent() выходит из процесса.

    2.3.16.28. Ndb::pollEvents2()

    Описание. Ждет события. Срабатывает как только любые данные о событии доступны. Этот метод также перемещает полные данные о событии эпохи в очередь событий.

    Добавлено в NDB 7.4.3, этот метод заменяет устаревший pollEvents().

    Сигнатура.

    int pollEvents2
    (
      int aMillisecondNumber,
      Uint64* highestQueuedEpoch = 0
    )
    

    Параметры. Этот метод берет эти два параметра, перечисленные здесь:

    • Максимальное время, чтобы ждать, в миллисекундах, перед отказом и сообщая, что никакие события не были доступны (то есть, прежде чем метод автоматически возвращает 0).

      В NDB 7.4.7 и позже, определяя отрицательную величину для этого аргумента, pollEvents2() возвращает -1, указывая на ошибку (Bug #20762291).

    • Индекс самой высокой эпохи с очередями. Обычно этому можно безопасно разрешить принять значение по умолчанию, которое является 0. Если это значение не NULL и новые данные о событии доступны в очереди событий, оно установлено в самую высокую эпоху, найденную в доступных данных о событии.

    Возвращаемое значение. pollEvents2() вернет integer:

    • > 0: Есть события, доступные в очереди.

    • 0: Нет никаких доступных событий.

    • < 0: Указывает на неудачу (возможная ошибка).

    2.3.16.29. Ndb::setDatabaseName()

    Описание. Этот метод используется, чтобы определить имя текущей базы данных.

    Сигнатура.

    void setDatabaseName
    (
      const char *databaseName
    )
    

    Параметры. setDatabaseName() берет единственный обязательный параметр, название новой базы данных, которая будет установлена как текущая база данных.

    2.3.16.30. Ndb::setDatabaseSchemaName()

    Описание. Этот метод определяет имя текущей схемы базы данных.

    Сигнатура.

    void setDatabaseSchemaName
    (
      const char *databaseSchemaName
    )
    

    Параметры. Название схемы базы данных.

    2.3.16.31. Ndb::setEventBufferQueueEmptyEpoch()

    Описание. Организация очереди пустых эпох отключена по умолчанию. Этот метод может использоваться, чтобы позволить такую организацию очереди, в этом случае любые новые пустые эпохи, входя в буфер событий после вызова метода, стоят в очереди.

    Когда организация очереди пустых эпох позволена, nextEvent() связывает пустую эпоху с одной и только одной из подписок (операции событий), связанной с подпиской объекта Ndb. Это означает, что может быть не больше, чем одна пустая эпоха на подписку, даже при том, что у пользователя может быть много подписок, связанных с тем же самым объектом Ndb.

    Сигнатура.

    void setEventBufferQueueEmptyEpoch
    (
      bool queue_empty_epoch
    )
    

    Параметры. Этот метод берет единственный входной параметр. Вызов метода с true позволяет стоять в очереди пустым событиям, false отключает такую организацию очереди.

    Возвращаемое значение. Нет.

    setEventBufferQueueEmptyEpoch() не имеет никакого связанного метода получателя. Это намерено и происходит из-за того, что этот сеттер обращается к стоящим в очереди новым эпохам, тогда как сама очередь может все еще отразить положение дел, которое существовало до вызыва сеттера. Таким образом, во время переходного периода, пустая эпоха могла бы быть найдена в очереди, даже если такая организация очереди выключена.

    setEventBufferQueueEmptyEpoch() добавлен в NDB 7.4.11 и NDB 7.5.2.

    2.3.16.32. Ndb::set_eventbuf_max_alloc()

    Описание. Устанавливает максимальную память в байтах, которая может использоваться для буфера событий. Это имеет тот же самый эффект как установка значения системной переменной MySQL Server ndb_eventbuffer_max_alloc.

    Добавлено в NDB 7.2.14 и NDB 7.3.3.

    Сигнатура.

    void set_eventbuf_max_alloc
    (
      unsigned size
    )
    

    Параметры. Желаемый максимум size для буфера событий в байтах.

    Возвращаемое значение. Нет.

    2.3.16.33. Ndb::set_eventbuffer_free_percent()

    Описание. Устанавливает переменную ndb_eventbuffer_free_percent то есть, процент буферной памяти событий, которая должна быть доступной прежде, чем продолжить буферизовать после достижения ndb_eventbuffer_max_alloc.

    Добавлено в NDB 7.4.3.

    Сигнатура.

    int set_eventbuffer_free_percent
    (
      unsigned pct
    )
    

    Параметры. Процент (pct) буферной памяти событий, которая должна присутствовать. Действительный диапазон равняется 1-99 включительно.

    Возвращаемое значение. Значение, которое было установлено.

    2.3.16.34. Ndb::setNdbObjectName()

    Описание. Начиная с NDB 7.2.17 и NDB 7.3.6, можно определить произвольное, человекочитаемое имя, чтобы определить объект Ndb при отладке. Это имя может тогда быть получено, используя getNdbObjectName() (Bug #18419907). Это должно быть сделано до запроса init() для этого объекта, пытаясь определить имя после, инициализация терпит неудачу с ошибкой.

    Можно определить имя только однажды для данного объекта Ndb, последующие попытки после определения имени терпят неудачу с ошибкой.

    Сигнатура.

    int setNdbObjectName
    (
      const char* name
    )
    

    Параметры. Имя name.

    Возвращаемое значение. 0 при успехе.

    2.3.16.35. Ndb::startTransaction()

    Описание. Этот метод используется, чтобы начать новую транзакцию. Есть три варианта, самый простой из них, используя таблицу и ключ разделения или ID разделения, чтобы определить операционного координатора (TC). Третий вариант позволяет вам определить TC посредством указателя на данные ключа.

    Когда транзакция закончена, она должна быть закрыта, используя NdbTransaction::close() или Ndb::closeTransaction(). Отказ сделать это прерывает транзакцию. Это должно быть сделано независимо от конечного результата транзакции, даже если она терпит неудачу из-за ошибки.

    См. разделы 2.3.16.2 и раздел 2.3.30.1.

    Сигнатура.

    NdbTransaction* startTransaction
    (
      const NdbDictionary::Table* table = 0,
      const char* keyData = 0,
      Uint32* keyLen = 0
    )
    

    Параметры. Этот метод берет следующие три параметра:

    • table: Указатель на объект Table. Это используется, чтобы определить, на котором узле должен работать операционный координатор.

    • keyData: Указатель на соответствие ключа разделения таблице table.

    • keyLen: Длина ключа разделения в байтах.

    Осведомленные о распределении формы startTransaction(). Также возможно использовать осведомленность распределения с этим методом, то есть, чтобы предложить, какой узел должен действовать как операционный координатор.

    Сигнатура.

    NdbTransaction* startTransaction
    (
      const NdbDictionary::Table* table,
      const struct Key_part_ptr*keyData,
      void* xfrmbuf = 0,
      Uint32 xfrmbuflen = 0
    )
    

    Параметры. Определяя операционного координатора, этот метод берет эти четыре параметра:

    • Указатель на table (объект Table ), используемый для решения, какой узел должен действовать как операционный координатор.

    • Законченное пустым указателем множество указателей на значения столбцов ключа распределения. Длина ключевой части прочитана из метаданных и сравнена с переданным значением.

      Key_part_ptr определяется как показано в shown in разделе 2.3.15.

    • Указатель на временный буфер, используемый, чтобы вычислить значение хэш-функции.

    • Длина буфера.

    Если xfrmbuf = NULL (по умолчанию), вызов malloc() или free() сделан автоматически. startTransaction() терпит неудачу, если xfrmbuf не NULL и xfrmbuflen слишком маленькое.

    Пример. Предположим, что ключ разделения таблицы столбец BIGINT. Тогда вы объявили бы множество ключа распределения как показано здесь:

    Key_part_ptr distkey[2];
    

    Значение ключа распределения было бы определено как показано здесь:

    unsigned long long distkeyValue= 23;
    

    Указатель на множество ключа распределения был бы установлен следующим образом:

    distkey[0].ptr= (const void*) &distkeyValue;
    

    Длина этого указателя была бы установлена соответственно:

    distkey[0].len= sizeof(distkeyValue);
    

    Множество ключа распределения должно закончиться NULL. Это необходимо, чтобы избежать наличия дополнительного параметра, обеспечивающего количество столбцов в ключе распределения:

    distkey[1].ptr= NULL;
    distkey[1].len= NULL;
    

    Установка буфера к NULL разрешает startTransaction() ассигновать и освобождать память автоматически:

    xfrmbuf= NULL;
    xfrmbuflen= 0;
    

    Можно также определить буфер, чтобы сохранить необходимость сделать явно malloc() и free(), но вычисление соответствующего размера для этого буфера не простой вопрос, если буфер не NULL, но его длина слишком коротка, тогда startTransaction() терпит неудачу. Однако, если вы принимаете решение определить буфер, 1 МБ обычно достаточный размер.

    Теперь, когда вы начинаете транзакцию, можно получить доступ к узлу, который содержит желаемую информацию непосредственно.

    Другая осведомленная о распределении версия этого метода позволяет вам определить таблицу и разделение (используя ID разделения) как намек для отбора операционного координатора, определяется как показано здесь:

    NdbTransaction* startTransaction
    (
      const NdbDictionary::Table* table,
      Uint32 partitionId
    )
    

    Если у кластера есть то же самое количество узлов данных, как реплик, определение операционного координатора не получает улучшения работы, так как каждый узел данных содержит всю базу данных. Однако, где количество узлов данных больше, чем количество реплик (например, где NoOfReplicas = 2 в кластере с 4 узлами данных), вы увидите улучшение работы при помощи осведомленной о распределении версии этого метода.

    Все еще возможно использовать этот метод как прежде, не определяя операционного координатора. В любом случае необходимо все еще явно закрыть транзакцию, независимо от успешности вызова startTransaction().

    Возвращаемое значение. При успехе вернет объект NdbTransaction, при ошибке вернет NULL.

    2.3.17. Класс Ndb_cluster_connection

    Резюме

    Этот класс представляет связь с кластером узлов данных.

    Родительский класс. Нет.

    Дочерние классы. Нет.

    Описание. Прикладная программа NDB должна начаться с создания объекта Ndb_cluster_connection и как правило использует один Ndb_cluster_connection. Приложение соединяется с сервером управления кластера когда этот объект вызывает метод connect(). При помощи метода wait_until_ready() возможно ждать связи, чтобы достигнуть одного или более узлов данных.

    Экземпляр Ndb_cluster_connection, используется, чтобы создать объект Ndb. До NDB 7.3.8 и NDB 7.4.3 было возможно удалить Ndb_cluster_connection, используемый, чтобы создать экземпляр Ndb без удаления объекта Ndb (Bug #19999242).

    Разделение уровня приложения. Нет никакого ограничения против создания многократных объектов Ndb_cluster_connection, представляющих связи с различными серверами управления в отдельном приложении, ни против использования их для создания многократных экземпляров класса Ndb. Такие объекты Ndb_cluster_connection (и экземпляры Ndb на основе их) не требуются, чтобы соединиться с тем же самым кластером.

    Например, возможно выполнить разделение уровня приложения данных таким способом, которым данные, встречающие один набор критериев переданы одному кластеру, используя объект Ndb, который использует объект Ndb_cluster_connection представляющий связь с кластером в то время, как данные, не соответствующие тем критериям (или возможно различный набор критериев) можно послать в иной кластер через иной экземпляр Ndb, который использует Ndb_cluster_connection указывающий на второй кластер.

    Возможно расширить этот сценарий, чтобы разработать отдельное приложение, которое получает доступ к произвольному числу кластеров. Однако, при этом следующие условия и требования должны иметься в виду:

    • Сервер управления кластера (ndb_mgmd) может соединиться с одним и только одним кластером, не будучи перезапущенным и повторно настроенным, поскольку это должно прочитать данные, какие узлы данных составляют кластер, из конфигурационного файла (config.ini).

    • Объект Ndb_cluster_connection принадлежит единственному серверу управления, имя хоста которого или IP-адрес используются в создании этого объекта (как параметр connection_string конструктора), как только объект создается, он не может использоваться, чтобы начать связь с различным сервером управления.

      См. раздел 2.3.17.1.

    • Объект Ndb , использующий эту связь (Ndb_cluster_connection ), не может быть снова использован, чтобы соединиться с иным сервером управления кластера (и таким образом с иной коллекцией узлов данных, составляющих кластер). Любой экземпляр Ndb связан с определенным Ndb_cluster_connection когда создан и этот Ndb_cluster_connection в свою очередь связан с единственным и уникальным сервером управления, когда он создается.

      См. раздел 2.3.16.1.

    • Связи, описанные выше, сохраняются для сроков существования объектов Ndb и Ndb_cluster_connection.

    Поэтому обязательно в проектировании и реализовывании любого приложения, что доступ к многократным кластерам в единственной сессии обеспечивается отдельными экземплярами объектов Ndb_cluster_connection и Ndb для соединения с каждым сервером управления кластера.

    Также важно иметь в виду, что никакое прямое разделение данных или узлов данных между различными кластерами невозможно. Узел данных может принадлежать одному и только одному кластеру и любое движение данных между кластерами должно быть достигнуто на уровне приложения.

    Для примеров, демонстрирующих, как связи с двумя различными кластерами могут устанавливаться и использоваться в отдельном приложении, посмотрите разделы 2.5.2 и 3.6.2.

    Методы.

    Таблица 2.31.

    Имя Описание
    Ndb_cluster_connection() Конструктор создает связь с кластером узлов данных
    connect() Соединяется с сервером управления кластера
    get_auto_reconnect()

    Получает настройки автоповтора соединения для узлов API, используя Ndb_cluster_connection

    get_latest_error()

    Действительно ли новая попытка соединиться успешна

    get_latest_error_msg()

    Если новая попытка соединиться провалилась, обеспечивает причину

    get_max_adaptive_send_time()

    Тайм-аут перед адаптивной отправкой всех сигналов

    get_num_recv_threads()

    Количество потоков получения

    get_next_ndb_object()

    Используемый, чтобы повторить кратное число объектов Ndb.

    get_recv_thread_activation_threshold()

    Получить уровень активации для связанного потока получения

    get_system_name()

    Получите имя системы кластера

    lock_ndb_objects()

    Отключает создание новых объектов Ndb

    set_auto_reconnect()

    Позволяет или отключает повторное автосоединение с узлами API, используя Ndb_cluster_connection

    set_data_node_neighbour() SУстанавливает соседний узел для оптимального размещения операционного координатора
    set_max_adaptive_send_time()

    Тайм-аут перед адаптивной передачей всех сигналов

    set_name() Обеспечивает название связи
    set_num_recv_threads()

    Определите номер потока получения, которые будет связан

    set_recv_thread_cpu()

    Установите один или несколько CPU для потока получения

    set_optimized_node_selection() Используемый, чтобы управлять поведением выбора узла
    set_service_uri() URI для публикации в таблице ndbinfo.processes
    set_timeout() Устанавливает тайм-аут связи
    unlock_ndb_objects()

    Позволяет создание новых объектов Ndb

    unset_recv_thread_cpu()

    Сброс привязки потока получения к CPU

    wait_until_ready() Ждет, пока связь с одним или более узлами данных не будет успешной

    2.3.17.1. Конструктор класса Ndb_cluster_connection

    Описание. Этот метод создает связь с кластером NDB то есть, с кластером узлов данных. Объект, возвращенный этим методом, требуется, чтобы создать экземпляр объекта Ndb. Таким образом каждое применение API NDB требует использования Ndb_cluster_connection.

    Ndb_cluster_connection имеет двух конструкторов. Первый из них:

    Сигнатура.

    Ndb_cluster_connection
    (
      const char* connection_string = 0
    )
    

    Параметры. Эта версия конструктора требует параметр connection_string, указывая на местоположение сервера управления.

    Второй конструктор берет ID узла в дополнение к аргументу строки подключения.

    Сигнатура.

    Ndb_cluster_connection
    (
      const char* connection_string,
      int force_api_nodeid
    )
    

    Параметры. Эта версия конструктора берет два аргумента: connection_string и ID узла (force_api_nodeid), используемый этим узлом API. Этот ID узла отвергает любое значение идентификатора узла, заданное connection_string.

    Возвращаемое значение. Обе версии: Экземпляр Ndb_cluster_connection.

    2.3.17.2. Ndb_cluster_connection::connect()

    Описание. Этот метод соединяется с сервером управления кластера.

    Сигнатура.

    int connect
    (
      int retries = 30,
      int delay = 1,
      int verbose = 0
    )
    

    Параметры. Этот метод берет три параметра, все из которых дополнительные:

    • retries определяет число раз, чтобы повторить связь в случае неудачи. Значение по умолчанию равняется 30.

      0 означает, что никакие дополнительные попытки соединиться не предприняты в случае неудачи, использование отрицательной величины для retries приводит к бесконечным попыткам подключения.

    • delay представляет число секунд между повторными попытками подключения, по умолчанию 1 секунда.

    • verbose указывает, должен ли метод произвести сообщение о своем прогрессе: 1 = да, 0 (по умолчанию) = нет.

    Возвращаемое значение. Этот метод возвращает int, у которого может быть одно из следующих 3 значений:

    • 0: Попытка подключения была успешна.

    • 1: Указывает на исправимую ошибку.

    • -1: Указывает на невосстанавливаемую ошибку.

    2.3.17.3. Ndb_cluster_connection::get_auto_reconnect()

    Описание. Этот метод получает текущее значение AutoReconnect для данного a given Ndb_cluster_connection. Для более подробной информации посмотрите раздел 2.3.17.12.

    Сигнатура.

    int get_auto_reconnect
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. integer 0 или 1, соответствующее текущему AutoReconnect для этой связи. 0 предписывает узлам API использовать новые связи с кластером в то время, как 1 позволяет узлам API снова использовать существующие связи.

    2.3.17.4. Ndb_cluster_connection::get_latest_error()

    Описание. Этот метод может использоваться, чтобы определить действительно ли новая попытка connect() предпринята этим Ndb_cluster_connection. Если связь имела успех, get_latest_error() вернет 0, иначе вернет 1. Если попытка подключения потерпела неудачу, надо использовать Ndb_cluster_connection::get_latest_error_msg() , чтобы получить сообщение об ошибке, приводящее причину для неудачи.

    Сигнатура.

    int get_latest_error
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 1 или 0. Возвращаемое значение 1 указывает, что последняя попытка соединиться провалилась, если попытка имела успех, возвращается 0.

    2.3.17.5. Ndb_cluster_connection::get_latest_error_msg()

    Описание. Если новая попытка подключения этим Ndb_cluster_connection провалилась (как определено, вызывая get_latest_error()), этот метод предоставляет сообщение об ошибке, поставляющее информацию о причине неудачи.

    Сигнатура.

    const char* get_latest_error_msg
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Последовательность, содержащая сообщение об ошибке, описывающее неудачу Ndb_cluster_connection::connect(). Если новая попытка подключения имела успех, пустая строка возвращена.

    2.3.17.6. Ndb_cluster_connection::get_max_adaptive_send_time()

    Описание. Получите минимальное время в миллисекундах до того, как механизм адаптивной передачи пошлет все сигналы.

    Сигнатура.

    Uint32 get_max_adaptive_send_time ()
    

    Параметры. Нет.

    Возвращаемое значение. Время ожидания в миллисекундах. Это должно всегда быть значением между 0 и 10 включительно.

    2.3.17.7. Ndb_cluster_connection::get_next_ndb_object()

    Описание. Этот метод используется, чтобы итерировать набор объектов Ndb, получая их по одному.

    Сигнатура.

    const Ndb* get_next_ndb_object
    (
      const Ndb* p
    )
    

    Параметры. Этот метод берет единственный параметр, указатель на последний объект Ndb , который был получен или NULL.

    Возвращаемое значение. Возвращает следующий объект Returns the next Ndb или NULL, если больше нет объектов Ndb.

    Итерирование объектов Ndb. Чтобы получить все существующие объекты Ndb, выполните следующее:

    1. Вызовите метод lock_ndb_objects(). Это предотвращает создание любых новых экземпляров Ndb до вызова unlock_ndb_objects().

    2. Получите первый доступный Ndb, передав NULL в get_next_ndb_object(). Можно получить второй объект Ndb, передавая указатель, полученный первым вызовом, следующему get_next_ndb_object() и т.д. Когда указатель на последний доступный экземпляр Ndb используется, метод вернет NULL.

    3. После того, как вы получили все желаемые объекты Ndb, необходимо повторно включить создание объектов Ndb вызовом метода unlock_ndb_objects().

    2.3.17.8. Ndb_cluster_connection::get_num_recv_threads()

    Описание. Получите количество потоков приемника.

    Сигнатура.

    int get_num_recv_threads
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Количество потоков приемника.

    2.3.17.9. Ndb_cluster_connection::get_recv_thread_activation_threshold()

    Описание. Получить уровень для активации потока приемника, связанного set_recv_thread_cpu().

    Сигнатура.

    int get_recv_thread_activation_threshold
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Пороговое значение как integer. См. раздел 2.3.17.18.

    2.3.17.10. Ndb_cluster_connection::get_system_name()

    Описание. Получает имя системы от кластерной конфигурации. Это значение параметра конфигурации системы Name устанавливается в конфигурационном файле config.ini.

    Сигнатура.

    const char* get_system_name
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Имя кластерной системы. Если не задано в файле кластерной конфигурации, это произведенное значение в форме MC_timestamp (например, MC_20170426182343), используя время, когда сервер управления был запущен.

    2.3.17.11. ndb_cluster_connection::lock_ndb_objects()

    Описание. Запрос этого метода предотвращает создание новых экземпляров класса Ndb . Этот метод нужно вызвать до итерации по объектам Ndb, используя get_next_ndb_object().

    Сигнатура.

    void lock_ndb_objects
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Нет.

    Этот метод был сделан const в NDB 7.3.15, 7.4.13 и 7.5.4 (Bug #23709232).

    См. раздел 2.3.17.7.

    2.3.17.12. Ndb_cluster_connection::set_auto_reconnect()

    Описание. Узел API, который отсоединен от кластера, вынужден использовать новый объект связи, чтобы снова соединиться, если это поведение не отвергнуто, установив AutoReconnect = 1 в файле config.ini или вызывая этот метод с 1 как входное значение. Вызов метода с 0 имеет тот же самый эффект как задание AutoReconnect (также введен в тех версиях кластера NDB) к 0, то есть, узлы API вынуждены создать новые связи.

    Когда вызван, этот метод отвергает любое значение для AutoReconnect из файла config.ini.

    См. Defining SQL and Other API Nodes in an NDB Cluster.

    Сигнатура.

    void set_auto_reconnect
    (
      int value
    )
    

    Параметры. Значение value 0 или 1, которое определяет поведение повторного соединения узла API. 0 предписывает узлам API использовать новые связи (объекты Ndb_cluster_connection), 1 разрешает узлам API снова использовать существующие связи с кластером.

    Возвращаемое значение. Нет.

    2.3.17.13. Ndb_cluster_connection::set_data_node_neighbour()

    Описание. Устанавливает окружение узла данных, используемое для оптимального размещения операционного координатора. Этот метод используется после создания Ndb_cluster_connection, но до старта любых потоков запроса. Это потому, что этот метод может изменить внутреннее состояние Ndb_cluster_connection, разделенного потоками. Это состояние не ориентировано на многопотоковое исполнение, изменение его может привести к неоптимальному выбору узла во время изменения.

    Можно использовать системную переменную сервера ndb_data_node_neighbour, чтобы установить соседний узел данных для узла SQL кластера NDB.

    Добавлено в NDB 7.5.2.

    Сигнатура.

    void set_data_node_neighbour
    (
      Uint32 neighbour_node
    )
    

    Параметры. ID узла, который будет использоваться в качестве соседа.

    Возвращаемое значение. Нет.

    2.3.17.14. Ndb_cluster_connection::set_max_adaptive_send_time()

    Описание. Установите минимальное время в миллисекундах, которое адаптивный механизм передачи ждет прежде чем послать все сигналы.

    Сигнатура.

    void set_max_adaptive_send_time
    (
      Uint32 milliseconds
    )
    

    Параметры. Время ожидания в миллисекундах. Диапазон 0-10, по умолчанию 10.

    Возвращаемое значение. Нет.

    2.3.17.15. Ndb_cluster_connection::set_name()

    Описание. Определяет имя для связи. Если имя определяется, о нем сообщают в регистрации кластера.

    Сигнатура.

    void set_name
    (
      const char* name
    )
    

    Параметры. Имя name, которое будет использоваться в качестве идентификатора для связи.

    Возвращаемое значение. Нет.

    2.3.17.16. Ndb_cluster_connection::set_num_recv_threads()

    Описание. Определите число потоков приемника, связанных с CPU, определенное использованием set_recv_thread_cpu() с порогом, установленным set_recv_thread_activation_threshold().

    Этот метод должен быть вызван прежде, чем попытаться соединиться с любыми другими узлами.

    Сигнатура.

    int set_num_recv_threads
    (
      Uint32 num_recv_threads
    )
    

    Параметры. Количество потоков. Единственное поддержанное значение 1.

    Возвращаемое значение. -1 указывает на ошибку, любое другое значение указывает на успех.

    2.3.17.17. Ndb_cluster_connection::set_optimized_node_selection()

    Описание. Этот метод может использоваться, чтобы отвергнуть поведение метода connect() по умолчанию, в отношении которого узел должен быть связан сначала.

    Сигнатура.

    void set_optimized_node_selection
    (
      int value
    )
    

    Параметры. integer value.

    Возвращаемое значение. Нет.

    2.3.17.18. Ndb_cluster_connection::set_recv_thread_activation_threshold()

    Описание. Установите уровень для активации потока приемника, связанного с помощью set_recv_thread_cpu(). Ниже этого уровня потоки обычного пользователя используются, чтобы получить сигналы.

    Сигнатура.

    int set_recv_thread_activation_threshold
    (
      Uint32 threshold
    )
    

    Параметры. integer threshold . 16 или более высокие значения означают, что потоки получения никогда не используются в качестве приемников. 0 указывает, что поток получения всегда активна, это сохраняет права опроса для его собственного исключительного использования, эффективно блокируя все пользовательские потоки от становления приемниками. В таких случаях нужно соблюдать аккуратность, чтобы гарантировать, что поток получения не конкурирует с пользовательским потоком за ресурсы CPU, предпочтительно для него быть привязанным к CPU для его собственного исключительного использования. По умолчанию значение 8.

    Возвращаемое значение. -1 указывает на ошибку, любое другое значение указывает на успех.

    2.3.17.19. Ndb_cluster_connection::set_service_uri()

    Описание. Начиная с NDB 7.5.7 и NDB 7.8.2, этот метод может использоваться, чтобы создать URI для публикации в столбце service_URI строки приложения в таблице ndbinfo.processes.

    При условии, что этот метод вызывают до connect(), URI издается непосредственно после связи, иначе это издается после задержки в HeartbeatIntervalDbApi миллисекунд.

    Сигнатура.

    int set_service_uri
    (
      const char* scheme,
      const char* host,
      int port,
      const char* path
    )
    

    Параметры. Этот метод берет параметры, перечисленные здесь:

    • scheme: Схема URI. Это ограничено к строчным буквам, числам и знакам ., + и -. Максимальная длина 16 знаков, любые знаки сверх этого предела усечены.

    • host: Адрес сети URI или имя хоста. Максимальная длина 48 знаков (достаточно для адреса сети IPv6), любые знаки сверх этого предела усечены. Если ноль, каждый узел данных сообщает о сетевом адресе от своей собственной связи до этого узла. Ndb_cluster_connection, который использует многократные транспортеры или сетевые адреса, чтобы соединиться с различными узлами данных, отражен в многократных строках таблицы ndbinfo.processes.

    • port: Порт URI. Это не издается, если это равно 0.

    • path: Путь URI, возможно сопровождаемый началом строки запроса с ?. Максимальная объединенная длина пути и запроса не может превысить 128 знаков.

      Путь не может начаться с двойного слэша (//).

    Возвращаемое значение. 0 при успехе, 1 в случае синтаксической ошибки.

    2.3.17.20. Ndb_cluster_connection::set_recv_thread_cpu()

    Описание. Установите CPU, с которым должен быть связан поток приемника. Установите уровень для активации потока приемника, вызвав set_recv_thread_activation_threshold(). Сбросьте привязку потока вызовом unset_recv_thread_cpu().

    Сигнатура.

    int set_recv_thread_cpu
    (
      Uint16* cpuid_array,
      Uint32 array_len,
      Uint32 recv_thread_id = 0
    )
    

    Параметры.

    • Множество из одного или более CPU ID, с которыми должен быть связан поток получения

    • Длина этого множества

    • ID потока получения для привязки, по умолчанию 0.

    Возвращаемое значение. -1 указывает на ошибку, любое другое значение указывает на успех.

    2.3.17.21. Ndb_cluster_connection::set_timeout()

    Описание. Используемый, чтобы установить тайм-аут для связи, ограничить количество времени, которое мы можем заблокировать, соединяясь.

    Этот метод на самом деле обертка для функции ndb_mgm_set_timeout(), см. see раздел 3.2.4.12.

    Сигнатура.

    int set_timeout
    (
      int timeout_ms
    )
    

    Параметры. Длина тайм-аута в миллисекундах (timeout_ms). В настоящее время приняты только кратные 1000 значения.

    Возвращаемое значение. 0 при успехе, любое другое значение указывает на ошибку.

    2.3.17.22. Ndb_cluster_connection::unlock_ndb_objects()

    Описание. Этот метод отменяет эффекты lock_ndb_objects(), позволяя создать новые экземпляры Ndb. unlock_ndb_objects() должен быть вызван после того, как вы закончили получать объекты Ndb, используя метод get_next_ndb_object().

    Сигнатура.

    void unlock_ndb_objects
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Нет.

    Этот метод был сделан const в NDB 7.3.15, 7.4.13 и 7.5.4 (Bug #23709232).

    См. раздел 2.3.17.7.

    2.3.17.23. Ndb_cluster_connection::unset_recv_thread_cpu()

    Описание. Сбросить CPU, к которым привязан поток получения, используя set_recv_thread_cpu().

    Сигнатура.

    int unset_recv_thread_cpu
    (
      Uint32 recv_thread_id
    )
    

    Параметры. ID потока получения.

    Возвращаемое значение. -1 указывает ошибку, любое другое значение указывает на успех.

    2.3.17.24. Ndb_cluster_connection::wait_until_ready()

    Описание. Этот метод необходим, чтобы установить связи с узлами данных. Это ждет, пока требуемая связь с одним или более узлами данных не будет успешна, или пока не кончится тайм-аут.

    Сигнатура.

    int wait_until_ready
    (
      int timeoutBefore,
      int timeoutAfter
    )
    

    Параметры.

    • timeoutBefore определяет число секунд, чтобы ждать, пока первый живой узел будет найден. Если это количество времени превышено без обнаруженных живых узлов, то метод немедленно возвращает отрицательную величину.

    • timeoutAfter определяет число секунд, чтобы ждать после того, как первый живой узел будет обнаружен для всех узлов, чтобы стать активным. Если это количество времени превышено без получения активного узла, то метод немедленно возвращает значение больше 0.

    Возвращаемое значение. wait_until_ready() вернет int, чье значение интерпретируется следующим образом:

    • = 0: все узлы живые.

    • > 0: По крайней мере один узел живой (однако, неизвестно, живы ли все узлы).

    • < 0: Ошибка произошла.

    2.3.18. Класс NdbBlob

    Резюме

    Этот класс представляет обработчик столбца BLOB и обеспечивает и доступ для чтения и записи к значениям столбцов BLOB. Этот объект имеет много различных статусов и обеспечивает несколько способов доступа к BLOB.

    Родительский класс. Нет.

    Дочерние классы. Нет.

    Описание. У этого класса нет публичного конструктора. Экземпляр NdbBlob создается, используя метод NdbOperation::getBlobHandle() во время операционной фазы подготовки. См. раздел 2.3.25. Этот объект действует как обработчик столбца on a BLOB.

    Хранение данных BLOB. Данные BLOB хранятся в 2 местах:

    • Заголовок и действующие байты сохранены в признаке blob.

    • Сегменты данных blob сохранены в отдельной таблице NDB$BLOB_tid_ cid, где tid ID таблицы, а cid ID столбца blob.

    Размеры сегмента данных могут быть установлены, используя соответствующмй метод Column , когда таблица составлена. Посмотрите раздел 2.3.2.

    Типы доступа к данным. NdbBlob поддерживает 3 типа доступа к данным. Эти типы доступа к данным могут быть применены в комбинации при условии, что они используются в порядке, данном выше.

    • В фазе подготовки методы NdbBlob getValue() и setValue() используются, чтобы подготовить чтение или запись BLOB известного размера.

    • Также в фазе подготовки setActiveHook() используется, чтобы определить установленный порядок, который вызван, как только обработчик становится активным.

    • В активной фазе readData() и writeData() используются, чтобы читать и писать BLOB, имеющие произвольные размеры.

    Работа с BLOB. Операции BLOB вступают в силу, когда следующая транзакция выполняется. В некоторых случаях NdbBlob вынужден выполнить неявное выполнение. Чтобы избежать этого, необходимо всегда воздействовать на полные сегменты данных.

    Используйте NdbTransaction::executePendingBlobOps() для сброса чтения и записи, который избегает любого штрафа выполнения, если никакие операции не находятся на рассмотрении. Это не требуется после выполнения операций или после следующего результата просмотра.

    NdbBlob также поддерживает чтение данные перед или после blob из событий. Обработчик может быть прочитан после того, как следующее событие на главной таблице было получено. Данные становятся доступными немедленно. См. раздел 2.3.21.

    BLOB и NdbOperation. Методы NdbOperation, действующие на объекты NdbBlob имеют параметры:

    • NdbOperation::insertTuple() должен использовать NdbBlob::setValue(), если признак BLOB не nullable.

    • NdbOperation::readTuple() используемый с любым способом блокировки, может прочитать, но не написать значения blob.

      Когда блокировка LM_CommittedRead используется с readTuple(), режим блокировки автоматически модернизирован до LM_Read каждый раз, когда к признакам blob получают доступ.

    • NdbOperation::updateTuple() может переписать существующее значение с использованием NdbBlob::setValue() или обновить его во время активной фазы.

    • NdbOperation::writeTuple() всегда переписывает значения blob и должен использовать NdbBlob::setValue(), если атрибут BLOB не nullable.

    • NdbOperation::deleteTuple() создает неявный недоступный обработчик BLOB.

    • Просмотр с любым способом блокировки может использовать свои обработчики, чтобы прочитать значения, но не написать их.

      Просмотр, используя способ блокировки LM_Exclusive может обновить строку и значения blob, применяя updateCurrentTuple(), возвращенная операция должна явно создать собственный обработчик blob.

      Просмотр, используя способ блокировки LM_Exclusive может удалить значения строки (и поэтому значения blob) с использованием deleteCurrentTuple(), это создает неявные недоступные обработчики blob.

    • Операция, которая возвращена lockCurrentTuple(), не может обновить blob.

    Известные проблемы. Следующее это известные проблемы или ограничения, с которыми сталкиваются, работая с объектами NdbBlob:

    • Слишком многие ожидающие операции BLOB могут переполнить буфера I/O.

    • Таблица и ее таблицы сегментов данных BLOB не создаются атомарно.

    Методы.

    Таблица 2.32.

    Имя Описание
    blobsFirstBlob() Получает первый blob в списке
    blobsNextBlob() Получает следующий blob в списке
    close() Высвободите внутренние средства до передачи или отмены
    getBlobEventName() Получает имя события blob
    getBlobTableName() Получает имя таблицы сегмента данных blob
    getColumn() Получает колонку blob
    getLength() Получает длину blob в байтах
    getNdbError() Получает ошибку (объект NdbError)
    getNdbOperation() Получает указатель на операцию (объект NdbOperation), к которой этот объект NdbBlob принадлежал, когда был создан
    getNull() Проверка, является ли значение blob NULL
    getPos() Получает настоящее положение для чтения/записи
    getState() Получает состояние объекта NdbBlob
    getValue() Готовится читать значение blob
    getVersion() Проверка, основан ли blob на запросе или событии
    readData() Читает данные из blob
    setActiveHook() Определяет отзыв для активации обработчика blob
    setNull() Устанавливает blob в NULL
    setPos() Устанавливает положение, в котором можно начать читать/писать
    setValue() Готовится вставлять или обновлять значение blob
    truncate() Усекает blob к данной длине
    writeData() Пишет данные blob

    Методы getBlobTableName() и getBlobEventName() статические.

    Большинство методов NdbBlob (почти все те, тип возвращения которых int) вернут 0 при успехе и -1 при ошибке.

    Типы.

    Таблица 2.33.

    Имя Описание
    ActiveHook() Отзыв для NdbBlob::setActiveHook()
    State() Представляет статусы, которые могут быть приняты NdbBlob.

    2.3.18.1. NdbBlob::ActiveHook

    Резюме

    ActiveHook это тип данных, определенный для использования в качестве отзыва для метода setActiveHook(), см. раздел 2.3.18.17.

    Определение. ActiveHook это пользовательский тип данных, определенный так:

    typedef int ActiveHook
    (
      NdbBlob* me,
      void* arg
    )
    

    Описание. Это отзыв для NdbBlob::setActiveHook(), немедленно вызван, как только подготовленная операция была выполнена (но не передана). Любые вызовы getValue() или setValue() выполняются сначала. Обработчик BLOB активен, так что readData() или writeData() могут использоваться, чтобы управлять значением BLOB. Определенный пользователями аргумент передается вместе с NdbBlob. setActiveHook() вернет ненулевое значение в случае ошибки.

    2.3.18.2. NdbBlob::blobsFirstBlob()

    Описание. Этот метод инициализирует список blob, принадлежащих текущей операции, и возвращает первый blob в списке.

    Сигнатура.

    NdbBlob* blobsFirstBlob
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на желаемый blob.

    2.3.18.3. NdbBlob::blobsNextBlob()

    Описание. Используйте метод, чтобы получить следующий в списке blob. См. раздел 2.3.18.2 .

    Сигнатура.

    NdbBlob* blobsNextBlob
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на желаемый blob.

    2.3.18.4. NdbBlob::close()

    Описание. Закрывает обработчик, высвобождая внутренние средства до совершения или прерывания транзакции. Другими словами, это сигнализирует, что приложение закончило с чтением от данного blob. Этот метод можно вызвать только когда blob State = Active.

    Операции чтения и блокировки. Когда обработчик blob создается на операции чтения при использовании LM_Read или LM_Exclusive как LockMode, операцию чтения можно открыть только когда все обработчики, созданные на этой операции, были закрыты.

    Когда строка, содержащая blob, была прочитана со способом блокировки LM_CommittedRead, способ автоматически модернизирован до LM_Read, чтобы гарантировать последовательность. В этом случае, когда все обработчики для строки были закрыты, операция разблокировки строки автоматически выполняется методом close(), который добавляет надвигающуюся операцию записи к blob. Модернизированная блокировка выпущена после вызова execute().

    Сигнатура.

    int close
    (
      bool execPendingBlobOps = true
    )
    

    Параметры. У этого метода есть единственный булев параметр execPendingBlobOps. Если значение этого параметра true (по умолчанию), любые надвигающиеся операции по blob сброшены прежде, чем обработчик закрывается. Если execPendingBlobOps = false, предполагается, что у обработчика нет ожидающих операций чтения или записи.

    Возвращаемое значение. 0 при успехе.

    2.3.18.5. NdbBlob::getBlobEventName()

    Описание. Этот метод получает имя события blob. Событие создается, если главное событие контролирует колонку blob. Имя включает главное имя события.

    Сигнатура.

    static int getBlobEventName
    (
      char* name,
      Ndb* ndb,
      const char* event,
      const char* column
    )
    

    Параметры.

    • Название события name.

    • ndb: Соответствующий объект Ndb.

    • event: Название главного события.

    • column: Столбец blob.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.18.6. NdbBlob::getBlobTableName()

    Описание. Этот метод получает название таблицы сегментов данных blob.

    Этот метод обычно имеет использование только для тестирования и отладки.

    Сигнатура.

    static int getBlobTableName
    (
      char* name,
      Ndb* ndb,
      const char* table,
      const char* column
    )
    

    Параметры.

    • name: Название таблицы сегментов данных blob.

    • ndb: Соответствующий объект Ndb.

    • table: Название главной таблицы.

    • column: Столбец blob.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.18.7. NdbBlob::getColumn()

    Описание. Используйте этот метод, чтобы получить столбец BLOB, который принадлежит NdbBlob.

    Сигнатура.

    const Column* getColumn
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Объект Column. См. раздел 2.3.2.

    2.3.18.8. NdbBlob::getLength()

    Описание. Этот метод получает текущую длину blob в байтах.

    Сигнатура.

    int getLength
    (
      Uint64& length
    )
    

    Параметры. Ссылка на длину.

    Возвращаемое значение. Длина blob в байтах. Для NULL этот метод вернет 0. Чтобы отличить blob длины 0, используйте getNull().

    2.3.18.9. NdbBlob::getNull()

    Описание. Этот метод проверяет, является ли значение NULL.

    Сигнатура.

    int getNull
    (
      int& isNull
    )
    

    Параметры. Ссылка на integer isNull. У этого параметра есть одно из следующих значений, интерпретируемых как показано здесь:

    • -1: blob не определен. Если это blob без события, этот результат вызывает статусную ошибку.

    • 0: blob не null.

    • 1: blob = NULL.

    Возвращаемое значение. Нет.

    2.3.18.10. NdbBlob::getNdbError()

    Описание. Используйте этот метод, чтобы получить ошибочный объект. Ошибка может быть определенной для blob или может быть скопирована с неудавшейся неявной операции. Код ошибки копируется назад к операции, если у операции уже нет кода ошибки отличного от нуля.

    Сигнатура.

    const NdbError& getNdbError
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Объект NdbError , см. раздел 2.3.20.

    2.3.18.11. NdbBlob::getNdbOperation()

    Описание. Этот метод может использоваться, чтобы найти операцию с который связан обработчик для этого NdbBlob.

    Сигнатура.

    const NdbOperation* getNdbOperation
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на операцию.

    Операция, на которую ссылается указатель, возвращенный этим методом, может быть представлена любым объектом NdbOperation или NdbScanOperation.

    См. разделы 2.3.25 и 2.3.29.

    2.3.18.12. NdbBlob::getPos()

    Описание. Этот метод получает текущее положение чтения-записи в blob.

    Сигнатура.

    int getPos
    (
      Uint64& pos
    )
    

    Параметры. Один параметр, ссылка на положение.

    Возвращаемое значение. 0 при успехе или -1 при неудаче. После успешного вызова pos займет текущую позицию чтения-записи в blob.

    2.3.18.13. NdbBlob::getState()

    Описание. Этот метод получает текущее состояние объекта NdbBlob, для которого это вызвано. Возможные статусы описаны в разделе 2.3.18.21.

    Сигнатура.

    State getState
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Значение State. См. раздел 2.3.18.21.

    2.3.18.14. NdbBlob::getValue()

    Описание. Используйте этот метод, чтобы подготовиться читать значение blob, значение доступно следующим вызовом. Используйте getNull(), чтобы проверять на NULL, getLength(), чтобы получить фактическую длину blob и проверить на усечение. getValue() устанавливает текущее положение чтения-записи в пункт после конца данных, которые были прочитаны.

    Сигнатура.

    int getValue
    (
      void* data,
      Uint32 bytes
    )
    

    Параметры. Этот метод берет два параметра. Первым из них является указатель на data для чтения, вторым является количество bytes.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.18.15. NdbBlob::getVersion()

    Описание. Этот метод используется, чтобы различать, основана ли на запросе или на событии операция по blob.

    Сигнатура.

    void getVersion
    (
      int& version
    )
    

    Параметры. Этот метод берет единственный параметр, ссылку на integer на версию blob (операционный тип).

    Возвращаемое значение.

    • -1: Это нормальный (основанный на запросе) blob.

    • 0: Это базирующийся на операции событий blob после изменения в его данных.

    • 1: Это базирующийся на операции событий blob до любого изменения в его данных.

    getVersion() всегда успешно, предполагая, что это вызвано как метод действительного экземпляра NdbBlob.

    2.3.18.16. NdbBlob::readData()

    Описание. Этот метод используется, чтобы прочитать данные из blob.

    Сигнатура.

    int readData
    (
      void* data,
      Uint32&bytes
    )
    

    Параметры. readData() принимает указатель на data для чтения и ссылку на количество bytes.

    Возвращаемое значение. 0 при успехе, -1 при ошибке. После успешного вызова data указывает на данные, которые были прочитаны, а bytes считает число байтов.

    2.3.18.17. NdbBlob::setActiveHook()

    Описание. Этот метод определяет отзыв для активации обработчика blob. Очередь подготовленных операций будет выполнена в непередаваемом режиме до этого пункта, затем отзыв вызван. Для получения дополнительной информации посмотрите раздел 2.3.18.1.

    Сигнатура.

    int setActiveHook
    (
      ActiveHook* activeHook,
      void* arg
    )
    

    Параметры.

    • Указатель на значение ActiveHook, это отзыв, как объяснено в разделе 2.3.18.1.

    • Указатель на void для любых данных, которые будут переданы отзыву.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.18.18. NdbBlob::setNull()

    Описание. Этот метод устанавливает значение blob = NULL.

    Сигнатура.

    int setNull
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.18.19. NdbBlob::setPos()

    Описание. Этот метод устанавливает положение, в котором можно прочитать или написать данные.

    Сигнатура.

    int setPos
    (
      Uint64 pos
    )
    

    Параметры. Метод setPos() берет единственный параметр pos (unsigned 64-bit integer), который является положением для чтения или написания данных. Значение pos должно быть между 0 и текущей длиной blob.

    Sparse blob не поддерживаются в API NDB, другими словами, не может быть никаких неиспользованных положений данных.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.18.20. NdbBlob::setValue()

    Описание. Этот метод используется, чтобы подготовиться к вставке или обновлению blob. Любые существующие данные, которые более длинны, чем новые данные, усечены. Буфер данных должен остаться действительным, пока операция не была выполнена. setValue() устанавливает текущее положение чтения-записи в пункт после конца данных. Можно установить data = null (0), чтобы создать значение NULL.

    Сигнатура.

    int setValue
    (
      const void* data,
      Uint32 bytes
    )
    

    Параметры.

    • data, это должно вставляться или использоваться, чтобы переписать значение.

    • bytes длина data.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.18.21. NdbBlob::State

    Резюме

    Это перечисляемый тип данных, который представляет возможные статусы NdbBlob.

    Описание. NdbBlob может принять любой из этих статусов.

    Возможные значения.

    Таблица 2.34.

    Имя Описание
    Idle NdbBlob еще не был подготовлен к использованию ни с какими операциями.
    Prepared Это состояние NdbBlob до операционного выполнения.
    Active Это состояние обработчика BLOB после выполнения или установки следующего результата, но прежде, чем транзакция передается.
    Closed Это состояние происходит после того, как транзакция была передана.
    Invalid Это следует за отменой или завершением транзакции.

    2.3.18.22. NdbBlob::truncate()

    Описание. Этот метод используется, чтобы усечь blob к данной длине.

    Сигнатура.

    int truncate
    (
      Uint64 length = 0
    )
    

    Параметры. truncate() берет единственный параметр, который определяет новую длину length, к которой blob должна быть усечена. Этот метод не имеет никакого эффекта, если length больше, чем текущая длина (которую можно проверить использованием getLength()).

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.18.23. NdbBlob::writeData()

    Описание. Этот метод используется, чтобы написать данные NdbBlob. После успешного вызова положение чтения-записи будет на уровне первого байта после данных, которые были записаны.

    Запись после текущего конца данных расширяет blob автоматически.

    Сигнатура.

    int writeData
    (
      const void* data,
      Uint32 bytes
    )
    

    Параметры. Этот метод берет два параметра, указатель на данные data для записи и количество байт bytes в них.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.19. Класс NdbDictionary

    Резюме

    Этот класс обеспечивает метаинформацию об объектах базы данных, таких как таблицы, колонки и индексы.

    В то время как предпочтительный метод создания объекта базы данных и удаления через MySQL Server, NdbDictionary также разрешает разработчику выполнять эти задачи через NDB API.

    Родительский класс. Нет.

    Дочерние классы. Dictionary , Column , Object .

    Описание. Это класс словаря данных, который поддерживает запросы о таблицах, столбцах и индексах. Это также обеспечивает способы определить эти объекты базы данных и удалить их. Оба вида функциональности поставляются, используя внутренние классы. Они включают следующие внутренние классы:

    • Table для работы с таблицами

    • Column для создания столбцов таблицы

    • Index для работы с вторичными индексами

    • Dictionary для создания объектов базы данных и схем

    • Event для работы с событиями

    Дополнительные подклассы Object моделируют табличные пространства, группы файла журнала, файлы данных и файлы отмен, требуемые для работы с таблицами NDB Cluster Disk Data (введено в MySQL 5.1), а также внешними ключами (NDB Cluster 7.3 и позже).

    Таблицы и индексы, созданные с использованием NdbDictionary, не могут быть рассмотрены из MySQL Server.

    Удаление индексов через API NDB, которые были созданы первоначально из кластера NDB, вызывает несоответствия. Возможно, что таблица, из которой один или больше индексов были исключены, используя API NDB, больше не будет применима MySQL после таких операций. В этом случае таблица должен быть удалена, а затем воссоздана с использованием MySQL, чтобы сделать ее доступной для MySQL еще раз.

    Методы. NdbDictionary самостоятельно не имеет никаких публичных методов экземпляра, только статические методы, которые используются для работы с объектами NdbRecord. Операции, не использующие NdbRecord, достигаются посредством подметодов экземпляров классов NdbDictionary.

    Таблица 2.35.

    Имя Описание
    getEmptyBitmask() Возвращает битовую маску присутствия пустого столбца, которая может использоваться с NdbRecord
    getFirstAttrId() Получите первый признак ID, определенный данным объектом NdbRecord
    getRecordIndexName() Получает название индексного объекта, упомянутого NdbRecord
    getRecordRowLength() Получить число байтов для того, чтобы сохранить одну строку данных, используя данный NdbRecord
    getRecordTableName() Получает название объекта таблицы, упомянутого NdbRecord
    getRecordType() Получает RecordType NdbRecord
    getValuePtr() Возвращает указатель на начало хранимых данных, определенных признаком ID, используя NdbRecord
    isNull() Покажите, является ли колонка null
    setNull() Установите колонку в null

    Для числовых эквивалентов перечисленным подклассам NdbDictionary посмотрите файл /storage/ndb/include/ndbapi/NdbDictionary.hpp в дереве исходных текстов NDB Cluster.

    2.3.19.1. NdbDictionary::getEmptyBitmask()

    Описание. Возвращает битовую маску присутствия пустого столбца, которая может использоваться с любым NdbRecord , чтобы определить, что нет столбцов NdbRecord , которые должны быть включены в операцию.

    Сигнатура.

    static const unsigned char* getEmptyBitmask
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Пустая битовая маска.

    2.3.19.2. NdbDictionary::getFirstAttrId()

    Описание. Получите первый признак ID, определенный объектом NdbRecord . Вернет false, если никакой признак ID не определяется.

    Сигнатура.

    static bool getFirstAttrId
    (
      const NdbRecord* record,
      Uint32& firstAttrId
    )
    

    Параметры. Указатель на NdbRecord и ссылка на признак (firstAttrID).

    Возвращаемое значение. Boolean false, когда никакой признак ID не может быть получен.

    2.3.19.3. NdbDictionary::getNextAttrId()

    Описание. Получите следующий признак ID, определенный объектом NdbRecord после переданного признака ID. Вернет false, когда больше нет признаков ID, которые будут возвращены.

    Сигнатура.

    static bool getNextAttrId
    (
      const NdbRecord* record,
      Uint32& attrId
    )
    

    Параметры. Указатель на NdbRecord и ссылка на ID признака.

    Возвращаемое значение. Boolean false, когда никакой признак ID не может быть получен.

    2.3.19.4. NdbDictionary::getNullBitOffset()

    Описание. Получить смещение бита null данного атрибута ID от начала строки NdbRecord. Вернет false, если признак ID не присутствует.

    Сигнатура.

    static bool getNullBitOffset
    (
      const NdbRecord* record,
      Uint32 attrId,
      Uint32& bytes,
      Uint32& bit
    )
    

    Параметры. NdbRecord record, в которой можно получить смещение данного признака ID (attrId). Смещение выражается как число байт (bytes) плюс число бит в последнем байте (bit).

    Возвращаемое значение. Boolean false, если признак с данным ID не присутствует.

    2.3.19.5. NdbDictionary::getOffset()

    Описание. Получить смещение данного атрибута ID от начала строки NdbRecord. Вернет false, если признак ID не присутствует.

    Сигнатура.

    static bool getOffset
    (
      const NdbRecord* record,
      Uint32 attrId,
      Uint32& offset
    )
    

    Параметры. Смещение offset данного признака ID с начала строки NdbRecord .

    Возвращаемое значение. Boolean false, если признак ID не присутствует.

    2.3.19.6. NdbDictionary::getRecordIndexName()

    Описание. Получите название объекта Index, на который ссылается NdbRecord .

    Если объект NdbRecord не IndexAccess NdbRecord , метод возвращает пустой указатель.

    Сигнатура.

    static const char* getRecordIndexName
    (
      const NdbRecord* record
    )
    

    Параметры. Указатель на NdbRecord для которого надо получить имя.

    Возвращаемое значение. Имя, если есть. Иначе или если объект NdbRecord не типа IndexAccess, этот метод вернет пустой указатель.

    2.3.19.7. NdbDictionary::getRecordRowLength()

    Описание. Получить число байтов, чтобы сохранить одну строку данных, как описано структурой NdbRecord, переданной этому методу.

    Сигнатура.

    static Uint32 getRecordRowLength
    (
      const NdbRecord* record
    )
    

    Параметры. Объект NdbRecord.

    Возвращаемое значение. Число байтов на строку.

    2.3.19.8. NdbDictionary::getRecordTableName()

    Описание. Возвратит название объекта таблицы, на который ссылается NdbRecord. Этот метод возвращает пустой указатель, если запись не TableAccess.

    Сигнатура.

    static const char* getRecordTableName
    (
      const NdbRecord* record
    )
    

    Параметры. record (объект NdbRecord ), для которого надо получить имя таблицы.

    Возвращаемое значение. Название таблицы или пустой указатель, если тип объекта NdbRecord не TableAccess.

    2.3.19.9. NdbDictionary::getRecordType()

    Описание. Возвратит тип объекта NdbRecord .

    Сигнатура.

    static RecordType getRecordType
    (
      const NdbRecord* record
    )
    

    Параметры. Объект NdbRecord.

    Возвращаемое значение. RecordType NdbRecord (IndexAccess или TableAccess).

    2.3.19.10. NdbDictionary::getValuePtr()

    Описание. Возвращает указатель на начало данных, определенных признаком ID, ища смещение колонки, сохраненной в объекте NdbRecord и возвращая сумму положения строки и смещения.

    Этот метод обеспечивает версии row-const и не-row-const.

    Сигнатура.

    static const char* getValuePtr
    (
      const NdbRecord* record,
      const char* row,
      Uint32 attrId
    )
    
    static char* getValuePtr
    (
      const NdbRecord* record,
      char* row,
      Uint32 attrId
    )
    

    Параметры. Указатель на объект NdbRecord , описывающий формат строки, указатель на начало данных строки (const в const-версии) и признак ID колонки.

    Возвращаемое значение. Указатель на начало признака в строке. Это null, если признак не часть определения NdbRecord.

    2.3.19.11. NdbDictionary::isNull()

    Описание. Установлен ли бит null для данной колонки в true or false. Местоположение пустого бита относительно указателя строки получено из переданного объекта NdbRecord. Если столбец не может быть null или он не часть определения NdbRecord, метод вернет false.

    Сигнатура.

    static bool isNull
    (
      const NdbRecord* record,
      const char* row,
      Uint32 attrId
    )
    

    Параметры. Указатель на объект NdbRecord, описывающий формат строки, указатель на начало данных строки и признак ID колонки, чтобы проверить.

    Возвращаемое значение. Boolean true, если признак ID существует в этом NdbRecord, он может быть null и пустой бит этой строки установлен, иначе Boolean false.

    2.3.19.12. NdbDictionary::setNull()

    Описание. Установите бит null для данной колонки к поставляемому значению. Смещение бита получено из переданного объекта NdbRecord . Если признак ID не является частью NdbRecord или если это не может быть null, этот метод возвращает ошибку (-1).

    Сигнатура.

    static int setNull
    (
      const NdbRecord* record,
      char* row,
      Uint32 attrId,
      bool value
    )
    

    Параметры. Указатель на record (объект NdbRecord) с описанием формата строки, указатель на начало данных строки row, признак ID колонки (attrId) и value, чтобы установить бит null (true или false).

    Возвращаемое значение. 0 при успехе, -1 если attrId не часть record или не может быть null.

    2.3.20. Структура NdbError

    Резюме

    структуру

    Эта секция обсуждает структуру NdbError, которая содержит статус и другую информацию об ошибках, включая коды ошибок, классификации и сообщения.

    Описание. NdbError состоит из шести частей, перечисленных здесь, которые устарели:

    1. Error status: Это описывает воздействие ошибки на приложении и отражает то, что должно сделать приложение, когда с ошибкой сталкивается.

      Ошибочный статус описан значением типа Status. См. раздел 2.3.20.2.

    2. Error classification: Это представляет логический ошибочный тип или группировку.

      Классификация ошибок описана значением типа Classification. См. раздел 2.3.20.1 для возможных классификаций и их интерпретации. Дополнительная информация предоставляется в разделе 2.4.4.

    3. Error code: Это внутренний код ошибки API NDB, который однозначно определяет ошибку.

      Не рекомендуется писать прикладные программы, которые зависят от определенных кодов ошибок. Вместо этого они должны проверить ошибочный статус и классификацию. Больше информации об ошибках может также быть получено, проверив сообщения об ошибках и (когда доступно) сообщения деталей ошибки. Однако, как коды ошибок, эти сообщения об ошибках и сообщения деталей ошибки подвержены изменениям.

      Список текущих кодов ошибок, представлен в разделе 2.4.2. Этот листинг обновляется с новыми выпусками кластера NDB. Можно также проверить файл storage/ndb/src/ndbapi/ndberror.c в исходных текстах NDB Cluster.

    4. MySQL Error code: Это соответствующий код ошибки MySQL Server. Коды ошибок MySQL не обсуждены в этом документе, пожалуйста, см. Server Error Message Reference в MySQL Manual.

    5. Error message: Это универсальное, независимое от контекста описание ошибки.

    6. Error details: Это может часто предоставлять дополнительную информацию (не найденную в сообщении об ошибке) об ошибке, определенную для обстоятельств, при которых сталкиваются с ошибкой. Однако это доступно не во всех случаях.

      Где не определено, сообщение деталей ошибки NULL.

      Это свойство устарело. Для получения деталей ошибки необходимо использовать метод Ndb::getNdbErrorDetail().

    Определенные коды ошибок API NDB, сообщения и детали подлежат изменению без уведомления.

    Определение. Структура NdbError содержит следующих участников, типы которых показаны здесь:

    • Status status: Ошибочный статус.

    • Classification classification: Ошибочный тип (классификация).

    • int code: Код ошибки NDB API.

    • int mysql_code: Код ошибки MySQL.

    • const char* message: Сообщение об ошибке.

    • char* details: Сообщение деталей ошибки.

      details устарел. Необходимо использовать метод Ndb::getNdbErrorDetail() (Bug #48851).

    Типы. NdbError определяет эти два типа данных:

    • Classification: Тип ошибки или логической группировки, которой принадлежит ошибка.

    • Status: Ошибочный статус.

    2.3.20.1. NdbError::Classification

    Описание. Этот тип описывает тип ошибки или логическую группу, которой это принадлежит.

    Возможные значения.

    Таблица 2.36.

    Имя Описание
    NoError Указывает на успех (никакая ошибка не произошла)
    ApplicationError Ошибка произошла в прикладной программе
    NoDataFound Операция чтения потерпела неудачу из-за одной или нескольких недостающих записей
    ConstraintViolation Ограничительное нарушение произошло, такое как попытка вставить кортеж, имеющий значение первичного ключа, который уже есть в целевой таблице
    SchemaError Ошибка произошла, пытаясь создать или использовать таблицу
    InsufficientSpace Было недостаточно памяти для данных или индексов
    TemporaryResourceError С этим типом ошибки, как правило, сталкиваются, когда есть слишком много активных транзакций
    NodeRecoveryError Это временный отказ, который был, вероятно, вызван происходящим восстановлением узла, например, когда информация, посланная между приложением и NDB потеряна, или когда есть изменение распределения.
    OverloadError Этот тип ошибки часто вызывается, когда недостаточно пространства файла журнала
    TimeoutExpired Тайм-аут часто вызываемый мертвой блокировкой
    UnknownResultError Неизвестно, была ли транзакция передана
    InternalError Серьезная ошибка произошла в NDB
    FunctionNotImplemented Приложение попыталось использовать функцию, которая еще не осуществляется
    UnknownErrorCode Это замечено, если обработчик ошибок NDB не может определить правильный код ошибки, чтобы сообщить
    NodeShutdown Это вызывается закрытием узла
    SchemaObjectExists Приложение попыталось создать объект схемы, который уже существует
    InternalTemporary Запрос был отправлен не к основному узлу

    Соответствующая информация, определенная для определенного состояния ошибки, может быть найдена в разделах 2.4.2 и 2.4.4.

    2.3.20.2. NdbError::Status

    Описание. Этот тип используется, чтобы описать статус ошибки.

    Возможные значения.

    Таблица 2.37.

    Имя Описание
    Success Никакая ошибка не произошла
    TemporaryError Временная и обычно исправимая ошибка, приложение должно повторить операцию, дающую начало ошибке
    PermanentError Систематическая ошибка, не восстанавливаемая
    UnknownResult Результат или статус операции неизвестны

    Соответствующая информация, определенная для определенного состояния ошибки, может быть найдена в разделе 2.4.4.

    2.3.21. Класс NdbEventOperation

    Резюме

    Эта секция описывает класс NdbEventOperation, который используется, чтобы наблюдать изменения (события) в базе данных. Это обеспечивает базовую функциональность, которая ранее была в NDB Cluster Replication.

    Родительский класс. Нет.

    Дочерние классы. Нет.

    Описание. NdbEventOperation представляет событие базы данных.

    Создание экземпляра NdbEventOperation. У этого класса нет публичного конструктора или деструтора. Вместо этого экземпляры NdbEventOperation создаются как результат вызовов метода на объектах Ndb и NdbDictionary , согласно следующим условиям:

    1. Должно существовать событие, которое было создано, используя Dictionary::createEvent(). Этот метод возвращает экземпляр класса Event.

    2. Объект NdbEventOperation создается, используя Ndb::createEventOperation(), который действует на экземпляр Event.

    Экземпляр этого класса удален, вызвав Ndb::dropEventOperation.

    Подробное создание демонстрации в качестве примера и удаление операций событий обеспечиваются в разделе 2.5.8.

    Известные проблемы. Со следующими проблемами можно столкнуться, работая с операциями событий в API NDB:

    • Максимальное количество активных объектов NdbEventOperation в настоящее время фиксируются во время компиляции как 2 * MaxNoOfTables.

    • В настоящее время все события INSERT, DELETE и UPDATE, а также все изменения признака посылают в API, даже если были определены только некоторые признаки. Однако они скрыты от пользователя, и только соответствующие данные показывают после запроса Ndb::nextEvent().

      Отметьте что ложные выходы из Ndb::pollEvents() могут произойти и таким образом следующий вызов nextEvent() вернет 0, так как не было никаких доступных данных. В таких случаях просто вызовите pollEvents() еще раз.

      См. разделы 2.3.16.27 и 2.3.16.25.

    • Код события не проверяет версию схемы таблицы. Когда таблица удалена, удостоверьтесь, что вы пропускаете любые связанные события.

    • Если вы получили полную эпоху, события с этой эпохи не перепосланы даже в случае неудачи узла. Однако, если неудача узла произошла, последующие эпохи могут содержать двойные события, которые могут быть определены по дубликатам первичного ключа.

      В коде NDB Cluster replication дубликаты первичного ключа при INSERT обычно обрабатываются, рассматривая такие вставки как REPLACE.

    Чтобы рассмотреть содержание системной таблицы, содержащей созданные события, можно использовать утилиту ndb_select_all :

    Ndb_select_all -d sys 'NDB$EVENTS_0'
    

    Методы.

    Таблица 2.38.

    Имя Описание
    clearError() Очищает новую ошибку. Устарело в NDB 7.4.3.
    execute() Активирует NdbEventOperation
    getBlobHandle() Получает обработчик для чтения признаков blob
    getEpoch() Восстанавливает эпоху для данных о событии, полученных последними. Добавлено в NDB 7.4.3.
    getEventType() Получает тип события. Устарело в NDB 7.4.3.
    getEventType2() Получает тип события. Добавлено в NDB 7.4.3.
    getGCI() Восстанавливает GCI последнего полученного события. Устарело в NDB 7.4.3.
    getLatestGCI() Получает новый GCI (было ли соответствующее событие получено или нет) Устарело в NDB 7.4.3.
    getNdbError() Получает новую ошибку.
    getPreBlobHandle() Получает обработчик для чтения предыдущего признака blob
    getPreValue() Восстанавливает предыдущее значение признака
    getState() Получает текущее состояние операции событий
    getValue() Восстанавливает значение атрибута
    hasError() Произошла ли ошибка как часть этой операции. Устарело в NDB 7.4.3.
    isConsistent() Обнаруживает потерю событий, вызванную неудачей узла. Устарело в NDB 7.4.3.
    isEmptyEpoch() Обнаруживает пустую эпоху. Добавлено в NDB 7.4.3.
    isErrorEpoch() Обнаруживает ошибочную эпоху и восстанавливает ошибку, если есть. Добавлено в NDB 7.4.3.
    isOverrun() Произошла ли потеря событий из-за переполнения буфера. Устарело в NDB 7.4.3.
    mergeEvents() Позволяет событиям быть слитыми
    tableFragmentationChanged() Проверка, изменилась ли фрагментация для таблицы
    tableFrmChanged() Проверка, что файл .FRM таблицы изменился
    tableNameChanged() Проверяет, изменилось ли название таблицы
    tableRangeListChanged() Проверяет, изменилось ли название списка разделения диапазона таблицы

    Типы. NdbEventOperation определяет один перечислимый тип State.

    2.3.21.1. NdbEventOperation::clearError()

    Описание. Очищает ошибку, последний раз связанную с этой операцией событий.

    Устарело в NDB 7.4.3.

    Сигнатура.

    void clearError
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Нет.

    2.3.21.2. NdbEventOperation::execute()

    Описание. Активирует NdbEventOperation, так, чтобы это могло начать получать события. Измененные значения атрибута могут быть получены после того, как Ndb::nextEvent() вернет значение кроме NULL.

    Один из getValue(), getPreValue(), getBlobValue() или getPreBlobValue() должен быть вызван перед invoking execute().

    Прежде, чем попытаться использовать этот метод, необходимо было прочитать объяснения, обеспеченные в разделах 2.3.16.25, 2.3.21.13 и 2.3.21.

    Сигнатура.

    int execute
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе и -1 при неудаче.

    2.3.21.3. NdbEventOperation::getBlobHandle()

    Описание. Этот метод используется вместо getValue() для blob. Обработчик blob (NdbBlob), возвращенный этим методом поддерживает только операции чтения.

    Чтобы получить предыдущее значение для признака blob, надо использовать getPreBlobHandle().

    Сигнатура.

    NdbBlob* getBlobHandle
    (
      const char* name
    )
    

    Параметры. Имя name атрибута blob.

    Возвращаемое значение. Указатель на объект NdbBlob.

    2.3.21.4. NdbEventOperation::getEpoch()

    Описание. Получает эпоху для полученных данных последнего события.

    Добавлено в NDB 7.4.3, этот метод заменяет getGCI(), который теперь устарел.

    Сигнатура.

    Uint64 getEpoch
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Номер эпохи (integer).

    2.3.21.5. NdbEventOperation::getEventType()

    Описание. Этот метод используется, чтобы получить тип события ( TableEvent).

    Устарело в NDB 7.4.3. В NDB 7.4.3 и позже необходимо использовать вместо этого getEventType2().

    Сигнатура.

    NdbDictionary::Event::TableEvent getEventType
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. TableEvent.

    2.3.21.6. NdbEventOperation::getEventType2()

    Описание. Этот метод используется, чтобы получить тип события ( TableEvent).

    Добавлено в NDB 7.4.3, этот метод заменяет устаревший getEventType().

    Сигнатура.

    NdbDictionary::Event::TableEvent getEventType2
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. TableEvent.

    2.3.21.7. NdbEventOperation::getGCI()

    Описание. Этот метод восстанавливает GCI для последнего события.

    Устарело в NDB 7.4.3, в NDB 7.4.3 и позже необходимо использовать getEpoch().

    Сигнатура.

    Uint64 getGCI
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Глобальный индекс контрольной точки последнего полученного события (integer).

    2.3.21.8. NdbEventOperation::getLatestGCI()

    Описание. Этот метод получает новый GCI.

    Этот метод возвращает последнее число эпохи.

    Устарело в NDB 7.4.3, в NDB 7.4.3 и позже необходимо использовать Ndb::getHighestQueuedEpoch().

    Полученное с использованием этого метода GCI не обязательно связано с событием.

    Сигнатура.

    Uint64 getLatestGCI
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Индекс последней глобальной контрольной точки, integer.

    2.3.21.9. NdbEventOperation::getNdbError()

    Описание. Этот метод получает новую ошибку.

    Сигнатура.

    const struct NdbError& getNdbError
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Ссылка на структуру NdbError.

    2.3.21.10. NdbEventOperation::getPreBlobHandle()

    Описание. Эта функция совпадает с getBlobHandle() за исключением того, что это используется, чтобы получить доступ к предыдущему значению признака blob. См. раздел 2.3.21.3 .

    Сигнатура.

    NdbBlob* getPreBlobHandle
    (
      const char* name
    )
    

    Параметры. Имя name для атрибута blob.

    Возвращаемое значение. Указатель на NdbBlob.

    2.3.21.11. NdbEventOperation::getPreValue()

    Описание. Этот метод выступает тождественно к getValue() за исключением того, что это используется, чтобы определить поисковую операцию предыдущего значения признака, а не текущего. Посмотрите раздел 2.3.21.13.

    Сигнатура.

    NdbRecAttr* getPreValue
    (
      const char* name,
      char* value = 0
    )
    

    Параметры. Этот метод берет эти два параметра, перечисленные здесь:

    • Имя name из признака (как постоянный указатель на символ).

    • Указатель на value таким образом, что:

      • Если значение атрибута не NULL, значение атрибута возвращено в этом параметре.

      • Если значение атрибута NULL, значение атрибута сохранено только в объекте NdbRecAttr , который возвращен этим методом.

      См. value Buffer Memory Allocation.

    Возвращаемое значение. Объект NdbRecAttr , чтобы хранить значение признака или NULL, указывающий, что ошибка произошла.

    2.3.21.12. NdbEventOperation::getState()

    Описание. Этот метод получает текущее состояние операции событий.

    Сигнатура.

    State getState
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Значение State. См. раздел 2.3.21.20.

    2.3.21.13. NdbEventOperation::getValue()

    Описание. Этот метод определяет поиск значения атрибута. API NDB ассигнует память для объекта NdbRecAttr , который должен содержать возвращенное значение атрибута.

    Этот метод не получает значение атрибута от базы данных и объект NdbRecAttr , возвращенный этим методом, не удобочитаемый или пригодный для печати прежде, чем будет вызван execute() и Ndb::nextEvent() возвратит значение не-NULL.

    Если определенный признак не изменился, соответствующий NdbRecAttr будет в статусе UNDEFINED. Это может быть проверено при помощи NdbRecAttr::isNULL(), который вернет -1.

    value Buffer Memory Allocation. Это обязанность приложения ассигновать достаточную память для буфера value (если не NULL), этот буфер должен быть выровнен соответственно. Буфер используется непосредственно (таким образом избегая штрафа копии), только если он выровнен на 4-байтовой границе и размере признака в байтах (вычисленный как NdbRecAttr::get_size_in_bytes()) кратен 4.

    getValue() получает текущее значение. Надо использовать getPreValue() для получения предыдущего значения.

    Сигнатура.

    NdbRecAttr* getValue
    (
      const char* name,
      char* value = 0
    )
    

    Параметры. Этот метод берет эти два параметра, перечисленные здесь:

    • Имя name из признака (как постоянный указатель на символ).

    • Указатель на value таким образом, что:

      • Если значение атрибута не NULL, значение атрибута возвращено в этом параметре.

      • Если значение атрибута NULL, тогда значение атрибута сохранено только в объекте NdbRecAttr , который возвращен этим методом.

    Возвращаемое значение. Объект NdbRecAttr , чтобы хранить значение признака или NULL указывающий, что ошибка произошла.

    2.3.21.14. NdbEventOperation::hasError()

    Описание. Этот метод используется, чтобы определить, есть ли ошибка, связанная с этой операцией событий.

    Устарело в NDB 7.4.3, в NDB 7.4.3 и позже, необходимо вместо этого использовать getEventType2(), чтобы определить тип события. Посмотрите раздел 2.3.6.23.

    Сигнатура.

    int hasError
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Если потеря событий произошла, то этот метод возвращает 0, иначе 1.

    2.3.21.15. NdbEventOperation::isConsistent()

    Описание. Этот метод используется, чтобы определить, произошла ли потеря событий после сбоя узла.

    Устарело в NDB 7.4.3, в NDB 7.4.3 и позже необходимо вместо этого использовать getEventType2(), чтобы определить, имеет ли событие тип TE_INCONSISTENT. См. раздел 2.3.6.23.

    Сигнатура.

    bool isConsistent
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Если потеря событий произошла, то этот метод возвращает false, иначе true.

    2.3.21.16. NdbEventOperation::isEmptyEpoch()

    Описание. Этот метод используется, чтобы определить, отмечают ли потребляемые данные о событии пустую эпоху.

    Добавлено в NDB 7.4.3.

    Сигнатура.

    bool isEmptyEpoch
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Если эта эпоха пуста, вернет true, иначе false.

    2.3.21.17. NdbEventOperation::isErrorEpoch()

    Описание. Этот метод используется, чтобы определить, отмечают ли потребляемые данные о событии пустую эпоху.

    Добавлено в NDB 7.4.3.

    Сигнатура.

    bool isErrorEpoch
    (
      NdbDictionary::Event::TableEvent* error_type = 0
    )
    

    Параметры. Если это ошибочная эпоха, error_type содержит значение TableEvent, соответствующее ошибке.

    Возвращаемое значение. Если эта эпоха ошибочна, вернет true, иначе false.

    2.3.21.18. NdbEventOperation::isOverrun()

    Описание. Этот метод используется, чтобы определить, произошла ли потеря событий из-за переполнения буфера.

    Сигнатура.

    bool isOverrun
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Если буфер событий был переполнен, то этот метод возвращает true, иначе false.

    2.3.21.19. NdbEventOperation::mergeEvents()

    Описание. Этот метод используется, чтобы установить флаг слияния событий. Для получения информации о слиянии событий посмотрите раздел 2.3.6.18.

    Флаг слияния событий по умолчанию false.

    Сигнатура.

    void mergeEvents
    (
      bool flag
    )
    

    Параметры. A Boolean flag.

    Возвращаемое значение. Нет.

    2.3.21.20. NdbEventOperation::State

    Описание. Этот тип описывает состояние операции событий.

    Возможные значения.

    Таблица 2.39.

    Имя Описание
    EO_CREATED Операция событий была создана, но execute() еще не был вызван.
    EO_EXECUTING Метод execute() был вызван для этой операции событий.
    EO_DROPPED Операция событий ждет, чтобы быть удаленной и больше не применима.
    EO_ERROR Ошибка произошла, операция событий непригодна.

    Значение State возвращено методом getState().

    2.3.21.21. NdbEventOperation::tableFragmentationChanged()

    Описание. Этот метод используется, чтобы проверить, изменилась ли фрагментация таблицы в связи с событием TE_ALTER . См. раздел 2.3.6.23.

    Сигнатура.

    bool tableFragmentationChanged
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Вернет true, если фрагментация таблицы изменилась, иначе false.

    2.3.21.22. NdbEventOperation::tableFrmChanged()

    Описание. Используйте этот метод, чтобы определить, изменился ли у таблицы файл .FRM в связи с событием TE_ALTER, см. раздел 2.3.6.23.

    Сигнатура.

    bool tableFrmChanged
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. true, если файл .FRM изменен, иначе method returns false.

    2.3.21.23. NdbEventOperation::tableNameChanged()

    Описание. Этот метод проверяет, изменилось ли имя таблицы как результат события TE_ALTER, см раздел 2.3.6.23.

    Сигнатура.

    bool tableNameChanged
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. true, если название таблицы изменилось, иначе false.

    2.3.21.24. NdbEventOperation::tableRangeListChanged()

    Описание. Используйте этот метод, чтобы проверить, изменилось ли название списка разделения диапазона таблицы в связи с событием TE_ALTER.

    Сигнатура.

    bool tableRangeListChanged
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. true, если имя раздела диапазона или списка изменилось, иначе false.

    2.3.22. Класс NdbIndexOperation

    Резюме

    Эта секция описывает класс NdbIndexOperation и его публичные методы.

    Родительский класс. NdbOperation.

    Дочерние классы. Нет.

    Описание. NdbIndexOperation представляет операцию по индексу для использования в транзакциях. Этот класс наследует NdbOperation.

    NdbIndexOperation может использоваться только с уникальными хэш-индексами, чтобы работать с упорядоченными индексами, надо использовать NdbIndexScanOperation.

    У этого класса нет публичного конструктора. Создать экземпляр NdbIndexOperation можно с использованием метода NdbTransaction::getNdbIndexOperation().

    Методы.

    Таблица 2.40.

    Имя Описание
    deleteTuple() Удаляет кортеж из таблицы
    getIndex() Получает индекс, использованный операцией
    readTuple() Читает кортеж от таблицы
    updateTuple() Обновляет существующий кортеж в таблице

    Операциям по индексу не разрешают вставить кортежи.

    Типы. Класс NdbIndexOperation не определяет собственных публичных типов.

    См. раздел 1.3.2.3.2 .

    2.3.22.1. NdbIndexOperation::deleteTuple()

    Описание. Этот метод определяет NdbIndexOperation как операцию DELETE. Когда метод NdbTransaction::execute() вызван, операция удаляет кортеж из таблицы.

    Сигнатура.

    int deleteTuple
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.22.2. NdbIndexOperation::getIndex()

    Описание. Получает индекс, учитывая операцию по индексу.

    Сигнатура.

    const NdbDictionary::Index* getIndex
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на объект Index.

    2.3.22.3. NdbIndexOperation::readTuple()

    Описание. Этот метод определяет NdbIndexOperation как операцию READ. Когда метод NdbTransaction::execute() вызван, операция читает кортеж.

    Сигнатура.

    int readTuple
    (
      LockMode mode
    )
    

    Параметры. mode определяет режим блокировки, используемый операцией чтения. Посмотрите раздел 2.3.25.15.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.22.4. NdbIndexOperation::updateTuple()

    Описание. Этот метод определяет NdbIndexOperation как операцию UPDATE. При вызове метода NdbTransaction::execute() операция обновляет кортеж, найденный в таблице.

    Сигнатура.

    int updateTuple
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.23. Класс NdbIndexScanOperation

    Резюме

    Эта секция обсуждает класс NdbIndexScanOperation.

    Родительский класс. NdbScanOperation.

    Дочерние классы. Нет.

    Описание. Класс NdbIndexScanOperation представляет операцию по просмотру, используя упорядоченный индекс. Этот класс наследует от NdbScanOperation и NdbOperation.

    NdbIndexScanOperation предназначен для использования только с упорядоченными индексами, чтобы работать с уникальными хэш-индексами, применяйте NdbIndexOperation.

    Методы.

    Таблица 2.41.

    Имя Описание
    end_of_bound() Отмечает конец привязки
    get_range_no() Получает число диапазона для текущей строки
    getDescending() Проверка, сортирован ли текущий просмотр
    getSorted() Проверка, сортирован ли текущий просмотр
    readTuples() Читает кортежи, используя индекс
    reset_bounds() Сброс границ, помещает в очередь отправки операцию
    setBound() Определяет привязанный ключ индекса для просмотра диапазона

    Типы. Класс NdbIndexScanOperation определяет один публичный тип BoundType.

    Этот класс также определяет структуру IndexBound для использования с операционным использованием NdbRecord .

    См. разделы 1.3.2.3.3 и 1.3.2.3.4.

    2.3.23.1. NdbIndexScanOperation::BoundType

    Описание. Этот тип используется, чтобы описать связанный ключ.

    Числовые значения фиксируются в API и могут использоваться явно, другими словами, допустимо вычислить значения и использовать их.

    Возможные значения.

    Таблица 2.42.

    Значение Числовое значение Описание
    BoundLE 0 Нижняя граница
    BoundLT 1 Строгая нижняя граница
    BoundGE 2 Верхняя граница
    BoundGT 3 Строгая верхняя граница
    BoundEQ 4 Равенство

    2.3.23.2. NdbIndexScanOperation::end_of_bound()

    Описание. Этот метод используется, чтобы отметить конец привязки, это используется, когда читается пакет индекса (то есть, используя многократные диапазоны).

    Сигнатура.

    int end_of_bound
    (
      Uint32 range_no
    )
    

    Параметры. Номер диапазона, на котором происходит привязка.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.23.3. NdbIndexScanOperation::getDescending()

    Описание. Этот метод используется, чтобы проверить, спускается ли просмотр.

    Сигнатура.

    bool getDescending
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. true, если просмотр сортирован в порядке убывания, иначе false.

    2.3.23.4. NdbIndexScanOperation::get_range_no()

    Описание. Этот метод возвращает номер диапазона для текущей строки.

    Сигнатура.

    int get_range_no
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Номер диапазона (integer).

    2.3.23.5. NdbIndexScanOperation::getSorted()

    Описание. Этот метод используется, чтобы проверить, сортирован ли просмотр.

    Сигнатура.

    bool getSorted
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. true, если просмотр сортирован, иначе false.

    2.3.23.6. NdbIndexScanOperation::readTuples()

    Описание. Этот метод используется, чтобы прочитать кортежи, используя упорядоченный индекс.

    Сигнатура.

    virtual int readTuples
    (
      LockMode mode = LM_Read,
      Uint32 flags = 0,
      Uint32 parallel = 0,
      Uint32 batch = 0
    )
    

    Параметры. Метод readTuples() берет эти три параметра:

    • Режим блокировки mode для просмотра. Это LockMode, см. раздел 2.3.25.15.

    • Один или более флагов просмотра, многократные flags соединяются OR вместе, как когда используются с NdbScanOperation::readTuples(). См. раздел 2.3.29.9.

    • Количество фрагментов, чтобы просмотреть в parallel, надо использовать 0, чтобы определить максимум автоматически.

    • batch определяет, сколько записей будет возвращено клиенту от сервера следующим NdbScanOperation::nextResult(true). Надо использовать 0, чтобы определить максимум автоматически.

      Этот параметр был проигнорирован до MySQL 5.1.12, всегда использовался максимум (Bug #20252).

    Возвращаемое значение. integer: 0 при успехе, -1 при ошибке.

    2.3.23.7. NdbIndexScanOperation::reset_bounds()

    Описание. Перезагружает границы и помещает операцию в список, который пошлют при следующем вызове NdbTransaction::execute().

    Сигнатура.

    int reset_bounds
    (
      bool forceSend = false
    )
    

    Параметры. Установите forceSend = true, чтобы вынудить операцию быть посланной немедленно.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.23.8. NdbIndexScanOperation::setBound()

    Описание. Этот метод определяет привязанный ключ индекса, используемый в просмотре диапазона, и устанавливает границы для просмотров индекса, определенных, используя NdbRecord .

    "Старое" использование API (до введения NdbRecord). У каждого ключа индекса могут быть нижняя граница, верхняя граница или обе. Установка ключа, равного значению, определяет верхние и нижние границы. Границы могут быть определены в любом порядке. Противоречивые определения дают ошибку.

    Границы должны быть установлены на начальных последовательностях ключей индекса и все кроме возможно связанного последнего должны быть нестрогими. Это означает, например, что a >= 2 AND b > 3 является допустимым, но a >2 AND b >=3 нет.

    Просмотр может в настоящее время возвращать кортежи, для которых не удовлетворены границы. Например, <= 2 && b <= 3 не только просматривает индекс до (a=2, b=3), но также вернет (a=1, b=4).

    Устанавливая границы на основе равенства, лучше использовать BoundEQ вместо эквивалентной пары BoundLE и BoundGE. Это особенно верно, когда ключ разделения таблицы префикс ключа индекса.

    NULL считается меньше, чем кто-либо не-NULL и равный другому NULL. Чтобы выполнить сравнения с NULL, примените setBound() с пустым указателем (0).

    Индекс также хранит все ключи NULL также и выполнение просмотра индекса с пустым связанным набором возвращает все кортежи из таблицы.

    Сигнатура (старый API). Используя старый API, этот метод можно было вызвать любым из двух способов. Оба из них используют связанный тип и значение, первый также использует название границ, как показано здесь:

    int setBound
    (
      const char* name,
      int type,
      const void* value
    )
    

    Второй способ вызвать этот метод в старом API использует ID границ, а не имя, как показано здесь:

    int setBound
    (
      Uint32 id,
      int type,
      const void* value
    )
    

    Параметры (старый API).

    • Имя name или id признака, на котором должна быть установлена граница.

    • Тип границы type см. раздел 2.3.23.1.

    • Указатель на границу value (0 = NULL).

    Работа с NdbRecord. Этот метод вызывают, чтобы добавить диапазон к операции по просмотру индекса, которая была определена NdbTransaction::scanIndex(). Чтобы добавить больше чем один диапазон, операция по просмотру индекса, должна быть определена с установленным флагом SF_MultiRange, см. раздел 2.3.29.9.

    Где многократные пронумерованные диапазоны определяются с множественными вызовами setBound() и просмотр упорядочен, номер диапазона для каждого диапазона должен быть больше, чем номер диапазона для ранее определенного диапазона.

    Сигнатура.

    int setBound
    (
      const NdbRecord* keyRecord,
      const IndexBound& bound
    )
    

    Параметры. Если используется с NdbRecord, этот метод берет 2 параметра:

    • keyRecord: Структура NdbRecord , соответствующая ключу, который определяет индекс.

    • bound для добавления (см. раздел 2.3.12).

    Дополнительная версия этого метода может использоваться, когда приложение знает, что строки в диапазоне будут найдены только в рамках конкретного разделения. Это совпадает с показанным ранее, за исключением добавления PartitionSpec . Это ограничивает просмотр единственным разделением, повышая системную эффективность.

    Сигнатура (определяя разделение).

    int setBound
    (
      const NdbRecord* keyRecord,
      const IndexBound& bound,
      const Ndb::PartitionSpec* partInfo,
      Uint32 sizeOfPartInfo = 0
    )
    

    Параметры (определяя разделение).

    • keyRecord: Это структура NdbRecord , соответствующая ключу, который определяет индекс.

    • bound добавляемый к просмотру (см. раздел 2.3.12).

    • partInfo: Это указатель на PartitionSpec, который предоставляет дополнительную информацию, позволяющую просмотреть уменьшенный набор разделения.

    • sizeOfPartInfo: Длина спецификации разделения.

    keyRecord и bound определяются и используются таким же образом, как с версией с 2 параметрами этого метода.

    Возвращаемое значение. Returns 0 при успехе, -1 при неудаче.

    2.3.24. Класс NdbInterpretedCode

    Резюме

    Эта секция обсуждает класс NdbInterpretedCode , который может использоваться, чтобы подготовить и выполнить программу NDB API.

    Родительский класс. Нет.

    Дочерние классы. Нет.

    Описание. NdbInterpretedCode представляет интерпретируемую программу для использования в операциях, созданных, используя NdbRecord, или с просмотрами, созданными, используя старый API. Класс NdbScanFilter может также использоваться, чтобы произвести интерпретируемую программу NDB, используя этот класс.

    Этот интерфейс все еще разрабатывается и подлежит изменению без уведомления. NdbScanFilter API более стабильный API для определения просмотра и фильтрации программ.

    Применение NdbInterpretedCode. Чтобы создать объект NdbInterpretedCode, вызовите конструктор, произвольно поставляя таблица для программы и буфер для хранения программы. Если никакой таблица не поставляется, то только инструкции, которые не получают доступ к признакам таблицы, могут использоваться. Начиная с NDB 8.0.18, экземпляр Ndbrecord может использоваться с этой целью вместо Table.

    Каждая операция API NDB относится к одной таблице, любая программа NdbInterpretedCode приложена к той операции.

    Если никакой буфер не поставляется, то внутренний буфер динамично ассигнован и расширен по мере необходимости. Создав объект NdbInterpretedCode, можно добавить инструкции и этикетки к нему, вызвав соответствующие методы, как описано позже в этой секции. Когда программа закончится, завершите ее, вызвав метод finalise(), который закрывает любые остающиеся внутренние отделения и вызываемые подпрограммы.

    Программа может использоваться больше чем одной операцией. Это не должно быть повторно подготовлено к последовательным операциям.

    Чтобы использовать программу с NdbRecord, передайте его во время определения операции, используя OperationOptions или ScanOptions . Когда программа больше не требуется, объект NdbInterpretedCode может быть удален.

    Проверка на ошибки. По причинам эффективности методы этого класса обеспечивают минимальную проверку на ошибки.

    Методы.

    Таблица 2.43.

    Имя Описание
    NdbInterpretedCode() Конструктор класса
    add_reg() Добавьте два значения регистра и сохраните результат в третьем регистре
    add_val() Добавьте значение к значениям столбца таблицы
    branch_col_and_mask_eq_mask() Пройти, если значение столбца AND битовая маска равно битовой маске
    branch_col_and_mask_eq_zero() Пройти, если значение столбца AND битовая маска равно 0
    branch_col_and_mask_ne_mask() Пройти, если значение столбца AND битовая маска не равно битовой маске
    branch_col_and_mask_ne_zero() Пройти, если значение столбца AND битовая маска не равно 0
    branch_col_eq() Пройти, если значение столбца равно другому
    branch_col_eq_null() Пройти, если значение столбца NULL
    branch_col_ge() Пройти, если значение столбца больше чем или равно другому
    branch_col_gt() Пройти, если значение столбца больше чем другой
    branch_col_le() Пройти, если значение столбца меньше чем или равно другому
    branch_col_like() Пройти, если значение столбца соответствует образцу
    branch_col_lt() Пройти, если значение столбца меньше чем другой
    branch_col_ne() Пройти, если значение столбца не равно другому
    branch_col_ne_null() Пройти, если значение столбца не NULL
    branch_col_notlike() Пройти, если значение столбца не соответствует образцу
    branch_eq() Пройти, если одно значение регистра равно другому
    branch_eq_null() Пройти, если значение регистра NULL
    branch_ge() Пройти, если одно значение регистра больше чем или равно другому
    branch_gt() Пройти, если одно значение регистра больше другого
    branch_label() Переход на метку
    branch_le() Пройти, если одно значение регистра меньше чем или равно другому
    branch_lt() Пройти, если одно значение регистра меньше другого
    branch_ne() Пройти, если одно значение регистра не равно другому
    branch_ne_null() Пройти, если значение регистра не NULL
    call_sub() Вызовите подпрограмму
    copy() Сделайте глубокую копию объекта NdbInterpretedCode
    def_label() Создайте этикетку для использования в рамках интерпретируемой программы
    def_sub() Определите подпрограмму
    finalise() Заканчивает интерпретируемую программу и готовит ее к использованию
    getNdbError() Получает последнюю ошибку, связанную с этим объектом NdbInterpretedCode
    getTable() Получает таблицу, на которой определяется программа
    getWordsUsed() Получает количество слов, используемых в буфере
    interpret_exit_last_row() Возвратите строку как часть результата и не проверяйте больше строки в этом фрагменте
    interpret_exit_nok() Не возвращайте строку как часть результата
    interpret_exit_ok() Возвратите строку как часть результата
    load_const_null() Загрузить значение NULL в регистр
    load_const_u16() Загрузите 16-битное числовое значение в регистр
    load_const_u32() Загрузите 32-битное числовое значение в регистр
    load_const_u64() Загрузите 64-битное числовое значение в регистр
    read_attr() Прочитайте значение столбца таблицы в регистр
    ret_sub() Возвратитесь из подпрограммы
    sub_reg() Вычтите два значения регистра и сохраните результат в третьем регистре
    sub_val() Вычтите значение из значения столбца таблицы
    write_attr() Напишите значение регистра в столбец таблицы

    См. раздел 2.3.24.1.

    Типы. Этот класс не определяет публичных типов.

    2.3.24.1. Применение NdbInterpretedCode

    Следующие несколько секций предоставляют информацию о выполнении различных типов операций с методами NdbInterpretedCode, включая использование ресурсов.

    2.3.24.1.1. Методы NdbInterpretedCode для загрузки значений в регистры

    Методы, описанные в этой секции, используются, чтобы загрузить постоянные величины в регистры NdbInterpretedCode. Пространство, требуемое каждым из этих методов, показывают в следующей таблице:

    Таблица 2.44.

    Метод Буфер (слов) Сообщение запроса (слов)
    load_const_null()1 1
    load_const_u16()1 1
    load_const_u32()2 2
    load_const_u64()3 3

    2.3.24.1.2. Методы NdbInterpretedCode для копирования значений между регистрами и столбцами таблицы

    NdbInterpretedCode предоставляет два метода для копирования значений между колонкой в текущей строке таблицы и регистром программы. read_attr() используется, чтобы скопировать значение столбца таблицы в регистр программы, write_attr() используется, чтобы скопировать значение регистра программы в столбец таблицы. Оба этих метода требуют, чтобы таблица была определен, создавая объект NdbInterpretedCode, для которого их вызывают.

    Пространство, требуемое каждым из этих методов, показывают в следующей таблице:

    Таблица 2.45.

    Метод Буфер (слова) Сообщение запроса (слова)
    read_attr()1 1
    write_attr()1 1

    См. разделы 2.3.24.43 и 2.3.24.47.

    2.3.24.1.3. Методы арифметики регистров NdbInterpretedCode

    NdbInterpretedCode предоставляет два метода для выполнения арифметических операций в регистрах. Используя add_reg(), можно загрузить сумму двух регистров в другой регистр, sub_reg() позволяет загрузить разность двух регистров в другой регистр.

    Пространство, требуемое каждым из этих методов, показывают в следующей таблице:

    Таблица 2.46.

    Метод Буфер (слова) Сообщение запроса (слова)
    add_reg()1 1
    sub_reg()1 1

    См. разделы 2.3.24.3 и 2.3.24.45.

    2.3.24.1.4. NdbInterpretedCode: этикетки и переходы

    Класс NdbInterpretedCode позволяет вам определить этикетки в рамках интерпретируемых программ и предоставляет много методов для выполнения переходов к ним на основе любого из следующих типов условий:

    • Сравнение между двумя значениями регистра

    • Сравнение между значением столбца и данной константой

    • Соответствует ли значение столбца данному образцу

    Чтобы определить этикетку, используйте метод def_label().

    Чтобы выполнить безусловный переход к этикетке, используйте метод branch_label().

    Чтобы выполнить переход на данную этикетку на основе сравнения значений регистра, используйте один из методов branch_*() ( branch_ge(), branch_gt(), branch_le(), branch_lt(), branch_eq(), branch_ne(), branch_ne_null() или branch_eq_null()). См. раздел 2.3.24.1.5.

    Чтобы выполнить переход на данную этикетку на основе сравнения значений столбца таблицы, используйте один из методов branch_col_* () ( branch_col_ge(), branch_col_gt(), branch_col_le(), branch_col_lt(), branch_col_eq(), branch_col_ne(), branch_col_ne_null() или branch_col_eq_null()). См. раздел 2.3.24.1.6.

    Чтобы выполнить переход на данную этикетку на основе сопоставления с образцом значения столбца таблицы, используйте один из методов branch_col_like() или branch_col_notlike(). См. раздел 2.3.24.1.7.

    2.3.24.1.5. Основанные на регистре операции ветвления NdbInterpretedCode

    Большинство из них используется, чтобы ветвиться на основе результатов сравнений регистров. Есть также два метода, используемые, чтобы сравнить значение регистра с NULL. Все эти методы требуют в качестве параметра, чтобы этикетка была определена методом def_label().

    Эти методы могут считаться выполнением следующей логики:

    if (register_value1 condition register_value2)
    goto Label
    

    Пространство, требуемое каждым из этих методов, показывают в следующей таблице:

    Таблица 2.47.

    Метод Буфер (слова) Сообщение запроса (слова)
    branch_ge()1 1
    branch_gt()1 1
    branch_le()1 1
    branch_lt()1 1
    branch_eq()1 1
    branch_ne()1 1
    branch_ne_null()1 1
    branch_eq_null()1 1

    2.3.24.1.6. Основанные на колонке операции ветвления NdbInterpretedCode

    Методы, описанные в этой секции, используются, чтобы выполнить переход на основе сравнения между значением столбца таблицы и данной постоянной величиной. Каждый из этих методов ожидает признак ID колонки, значение которой должно быть проверено, а не ссылку на объект Column.

    Эти методы, за исключением branch_col_eq_null() и branch_col_ne_null(), могут считаться выполнением следующей логики:

    if (constant_value condition column_value)
    goto Label
    

    В каждом случае (еще раз за исключением branch_col_eq_null() и branch_col_ne_null()), произвольная постоянная первый параметр, переданный методу.

    Требования места для каждого из этих методов показывают в следующей таблице, где L представляет длину постоянной величины:

    Таблица 2.48.

    Метод Буфер (слова) Сообщение запроса (слова)
    branch_col_eq_null()2 2
    branch_col_ne_null()2 2
    branch_col_eq()2 2 + CEIL( L / 8)
    branch_col_ne()2 2 + CEIL( L / 8)
    branch_col_lt()2 2 + CEIL( L / 8)
    branch_col_le()2 2 + CEIL( L / 8)
    branch_col_gt()2 2 + CEIL( L / 8)
    branch_col_ge()2 2 + CEIL( L / 8)

    Выражение CEIL( L /8) это количество целых 8-байтовых слов, требуемых, чтобы хранить постоянную величину, которая будет сравнена.

    2.3.24.1.7. Основанные на образце операции ветвления NdbInterpretedCode

    Класс NdbInterpretedCode предоставляет два метода, которые могут использоваться, чтобы ветвиться на основе сравнения между колонкой, содержащей символьные данные (то есть, a CHAR, VARCHAR, BINARY или VARBINARY) и образцом регулярного выражения.

    Синтаксис образца, поддержанный регулярным выражением, совпадает с MySQL Server LIKE и NOT LIKE , включая метасимволы _ и %, см. String Comparison Functions and Operators.

    Это тот же самый синтаксис образца регулярного выражения, который поддерживается NdbScanFilter, см. раздел 2.3.28.3.

    Таблица должна поставляться, когда объект NdbInterpretedCode создан. Образец регулярного выражения должен быть в простом формате CHAR, даже если столбец на самом деле VARCHAR (другими словами, не должно быть никаких ведущих байтов длины).

    Эти функции ведут себя как показано здесь:

    if (column_value
        [NOT] LIKE pattern)
    goto Label;
    

    Требования к месту для этих методов показывают в следующей таблице, где L представляет длину постоянной величины:

    Таблица 2.49.

    Метод Буфер (слова) Сообщение запроса (слова)
    branch_col_like()2 2 + CEIL( L / 8)
    branch_col_notlike()2 2 + CEIL( L /8)

    CEIL( L /8) это количество целых 8-байтовых слов, требуемых, чтобы хранить постоянную величину, которая будет сравнена.

    2.3.24.1.8. Операции битового сравнения NdbInterpretedCode

    Эти инструкции используются, чтобы ветвиться на основе результата логического сравнения AND между значением столбца BIT и образцом битовой маски.

    Использование этих методов требует, чтобы таблица поставлялась когда объект NdbInterpretedCode создан. Значение маски должно быть того же самого размера, как сравниваемый столбец. BIT передаются в и из API NDB как 32-битные слова с битами, приведенными в порядок от младшего значащего бита до старшего значащего бита. На x86 это первый байт (байт 0), на SPARC и PPC, это последний байт.

    Длина буфера и продолжительность запроса для каждого из методов, перечисленных здесь, требует суммы пространства, равного 2 словам плюс ширина столбца, округленная к самому близкому целому слову:

    2.3.24.1.9. Методы обработки результата NdbInterpretedCode

    Методы, описанные в этой секции, используются, чтобы сказать транслятору, что обработка текущей строки завершена и (в случае просмотров) включать ли эту строку в результаты просмотра.

    Требования к месту для этих методов показывают в следующей таблице, где L представляет длину постоянной величины:

    Таблица 2.50.

    Метод Буфер (слова) Сообщение запроса (слова)
    interpret_exit_ok()1 1
    interpret_exit_nok()1 1
    interpret_exit_last_row()1 1

    2.3.24.1.10. Удобные методы NdbInterpretedCode

    Методы, описанные в этой секции, могут использоваться, чтобы вставить многоадресные команды (использующие определенные регистры) в интерпретируемую программу.

    В дополнение к обновлению столбца таблицы эти методы используют списки регистров 6 и 7, заменяя любое существующее содержание регистра 6 значениею первоначального столбца и любое существующее содержание регистра 7 измененным значением столбца. Сама таблица должна быть ранее определена, создавая объект NdbInterpretedCode, для которого вызван метод.

    Требования к месту для этих методов показывают в следующей таблице, где L представляет длину постоянной величины:

    Таблица 2.51.

    Метод Буфер (слова) Сообщение запроса (слова)
    add_val()4 1, если поставляемое значение >= 216: 2, если >= 232: 3
    sub_val()4 1, если поставляемое значение >= 216: 2, если >= 232: 3

    2.3.24.1.11. Используя подпрограммы с NdbInterpretedCode

    NdbInterpretedCode допускает подпрограммы, которые могут быть вызваны из интерпретируемых программ с каждой подпрограммой, определяемой уникальным числом. Подпрограммы могут быть определены, только следуя всем главным инструкциям по программе.

    Числа определяют, что подпрограммы должны быть смежными, однако, они не должны быть ни в каком конкретном порядке.

    • Начало подпрограммы обозначается, вызывая метод def_sub().

    • ret_sub() заканчивает подпрограмму, все инструкции после def_sub() принадлежат подпрограмме, пока она не будет закончена, используя этот метод.

    • Подпрограмму вызывают, используя метод call_sub().

    Как только подпрограмма закончится, выполнение программы продолжится с инструкции немедленно после той, которая вызвала подпрограмму. Подпрограммы могут также быть вызваны от других подпрограмм, в настоящее время максимальная глубина стека подпрограмм равняется 32.

    2.3.24.1.12. Служебные методы NdbInterpretedCode

    Некоторые дополнительные служебные методы, поставляемые NdbInterpretedCode:

    • copy(): Копирует существующую интерпретируемую программу, выполняя глубокую копию на связанном объекте NdbInterpretedCode.

    • finalise(): Готовит интерпретируемую программу, решая все команды ветвления и вызовы подпрограммы.

    • getTable(): Получает ссылку на таблицу, для которой был определен объект NdbInterpretedCode.

    • getNdbError(): Связывает новую ошибку с этим объектом NdbInterpretedCode.

    • getWordsUsed(): Получает количество слов, используемых из буфера.

    2.3.24.2. Конструктор NdbInterpretedCode

    Описание. Это конструктор класса NdbInterpretedCode.

    Сигнатура.

    NdbInterpretedCode
    (
      const NdbDictionary::Table* table = 0,
      Uint32* buffer = 0,
      Uint32 buffer_word_size = 0
    )
    

    Альтернативный конструктор (NDB 8.0.18 и позже).

    NdbInterpretedCode
    (
      const NdbRecord&,
      Uint32* buffer = 0,
      Uint32 buffer_word_size = 0);
    

    Параметры.

    • table на которой нужно управлять этой программой. До NDB 8.0.18 должен поставляться этот параметр, если программа определена для таблицы, то есть, если это читает от или пишет столбцы в таблице. В NDB 8.0.18 и позже конструктор принимает NdbRecord вместо Table.

    • Указатель на buffer из 32-битных слов, используемых, чтобы сохранить программу.

    • buffer_word_size длина переданного буфера. Если программа превышает эту длину, лишние инструкции потерпят неудачу с ошибкой 4518 Too many instructions in interpreted program.

      Альтернативно, если никакой буфер не будет передан, буфер будет динамично ассигнован внутренне и расширен пока добавляются инструкции.

    Возвращаемое значение. Экземпляр NdbInterpretedCode.

    2.3.24.3. NdbInterpretedCode::add_reg()

    Описание. Этот метод суммирует значения, сохраненные в любых двух данных регистрах, и хранит результат в третьем регистре.

    Сигнатура.

    int add_reg
    (
      Uint32 RegDest,
      Uint32 RegSource1,
      Uint32 RegSource2
    )
    

    Параметры. Этот метод берет три параметра. Первым из них является регистр, в котором должен быть сохранен результат (RegDest). Второй и третий параметры (RegSource1 и RegSource2) это регистры, значения которых должны быть суммированы.

    Возможно повторное использоване для хранения результата одного из регистров, значения которых суммированы, то есть, RegDest может быть RegSource1 или RegSource2.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.4. NdbInterpretedCode::add_val()

    Описание. Этот метод добавляет указанное значение к значению данного столбца таблицы и помещает оригинальное и измененное значения столбцов в регистры 6 и 7. Это эквивалентно следующей серии вызовов NdbInterpretedCode, где attrId ID признака столбца таблицы и aValue значение, которое будет добавлено:

    read_attr(6, attrId);
    load_const_u32(7, aValue);
    add_reg(7,6,7);
    write_attr(attrId, 7);
    

    aValue может быть 32-bit или 64-bit integer.

    Сигнатура. Этот метод может быть призван любым из двух способов, в зависимости от того, aValue 32-bit или 64-bit.

    32-bit aValue:

    int add_val
    (
      Uint32 attrId,
      Uint32 aValue
    )
    

    64-bit aValue:

    int add_val
    (
      Uint32 attrId,
      Uint64 aValue
    )
    

    Параметры. ID признака столбца таблицы и 32-битное или 64-битное integer, которое будет добавлено к этому значению столбца.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.5. NdbInterpretedCode::branch_col_and_mask_eq_mask()

    Описание. Этот метод используется, чтобы сравнить значение столбца BIT с битовой маской, если значение столбца AND с битовой маской равно битовой маске, выполнение передается на указанную этикетку, определенную в вызове метода.

    Сигнатура.

    int branch_col_and_mask_eq_mask
    (
      const void* mask,
      Uint32 unused,
      Uint32 attrId,
      Uint32 Label
    )
    

    Параметры.

    • Указатель на константу mask, которой надо сравнить значение столбца.

    • Uint32, которое в настоящее время не используется.

    • attrId колонки, которая будет сравнена.

    • Программная этикетка Label для перехода, если условие верно.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.6. NdbInterpretedCode::branch_col_and_mask_eq_zero()

    Описание. Этот метод используется, чтобы сравнить столбец BIT с битовой маской, если значение столбца AND с битовой маской равно 0, тогда выполнение переходит к указанной этикетке, определенной в вызове метода.

    Сигнатура.

    int branch_col_and_mask_eq_zero
    (
      const void* mask,
      Uint32 unused,
      Uint32 attrId,
      Uint32 Label
    )
    

    Параметры.

    • Указатель на константу mask, с которой сравнить значение столбца.

    • Uint32 в настоящее время не используется.

    • attrId колонки, которая будет сравнена.

    • Этикетка Label для перехода, если условие верно.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.7. NdbInterpretedCode::branch_col_and_mask_ne_mask()

    Описание. Этот метод используется, чтобы сравнить столбец BIT с битовой маской, AND с битовой маской не равно битовой маске, выполнение передается на указанную этикетку, определенную в вызове метода.

    Сигнатура.

    int branch_col_and_mask_ne_mask
    (
      const void* mask,
      Uint32 unused,
      Uint32 attrId,
      Uint32 Label
    )
    

    Параметры.

    • Указатель на константу mask, с которой надо сравнить.

    • Uint32 пока не используется.

    • attrId колонки, которая будет сравнена.

    • Этикетка Label на которую передать выполнение, если условие верно.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.8. NdbInterpretedCode::branch_col_and_mask_ne_zero()

    Описание. Этот метод используется, чтобы сравнить значение BIT с битовой маской, если значение столбца AND с битовой маской не равно 0, выполнение переходит к указанной этикетке, определенной в вызове метода.

    Сигнатура.

    int branch_col_and_mask_ne_zero
    (
      const void* mask,
      Uint32 unused,
      Uint32 attrId,
      Uint32 Label
    )
    

    Параметры.

    • Указатель на константу mask, с которой надо сравнить.

    • Uint32 пока не используется.

    • attrId колонки, которая будет сравнена.

    • Этикетка Label на которую передать выполнение, если условие верно.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.9. NdbInterpretedCode::branch_col_eq()

    Описание. Этот метод сравнивает значение столбца таблицы с произвольной постоянной и переходит на указанную этикетку программы, если значения равны. В NDB 8.0.18 и позже, это может также использоваться, чтобы сравнить две колонки на равенство.

    Сигнатура. Сравните колонку со значением:

    int branch_col_eq
    (
      const void* val,
      Uint32 len,
      Uint32 attrId,
      Uint32 Label
    )
    

    Сравните две колонки:

    int branch_col_eq
    (
      Uint32 attrId1,
      Uint32 attrId2,
      Uint32 label
    )
    

    Параметры. Сравнивая колонку и значение, этот метод берет следующие четыре параметра:

    • Постоянная величина (val).

    • Длина значения (в байтах).

    • ID признака столбца таблицы, значение которого должно быть сравнено с val.

    • Этикетка Label (ранее определенная использованием def_label()) для перехода, если значения равны.

    Сравнивая два значения столбца таблицы, требуемые параметры показывают здесь:

    • AttrId1: ID признака первого столбца таблицы, значение которого должно быть сравнено.

    • AttrId2: Признак ID второго столбца таблицы.

    • label: Местоположение, чтобы перейти, если сравненные колонки равны. Должно быть уже определено, используя def_label().

    Используя этот метод, чтобы сравнить две колонки, колонки должны иметь точно тот же самый тип.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.10. NdbInterpretedCode::branch_col_eq_null()

    Описание. Этот метод проверяет значение столбца таблицы и переходит на обозначенную этикетку программы, если значение столбца NULL.

    Сигнатура.

    int branch_col_eq_null
    (
      Uint32 attrId,
      Uint32 Label
    )
    

    Параметры.

    • Признак ID столбца таблицы.

    • Этикетка программы для перехода, если значение столбца NULL.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.11. NdbInterpretedCode::branch_col_ge()

    Описание. Этот метод сравнивает значение столбца таблицы с произвольной постоянной и переходит на указанную этикетку программы, если значение столбца соответствует. В NDB 8.0.18 и позже это может также использоваться, чтобы сравнить две колонки и выполнить переход, если значение первой колонки больше или равно второй.

    Сигнатура. Сравните значение с колонкой:

    int branch_col_ge
    (
      const void* val,
      Uint32 len,
      Uint32 attrId,
      Uint32 label
    )
    

    Сравните значения двух столбцов:

    int branch_col_ge
    (
      Uint32 attrId1,
      Uint32 attrId2,
      Uint32 label
    )
    

    Параметры. Когда используется сравнение значения с колонкой, этот метод берет эти четыре параметра:

    • Постоянная величина (val).

    • Длина значения (в байтах).

    • ID признака столбца таблицы, значение которого должно быть сравнено с val.

    • label (ранее определенная с использованием def_label()).

    Метод берет параметры, перечисленные здесь, когда используется, чтобы сравнить две колонки:

    • AttrId1: ID признака первого столбца таблицы, значение которого должно быть сравнено.

    • AttrId2: Признак ID второго столбца таблицы.

    • label: Этикетка для перехода.

    Сравнивая две колонки, типы столбцов должны быть точно теми же самыми во всех отношениях.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.12. NdbInterpretedCode::branch_col_gt()

    Описание. Этот метод сравнивает значение столбца таблицы с произвольной постоянной и переходит на указанную этикетку программы, если константа больше, чем значение столбца. В NDB 8.0.18 и позже этот метод перегружен таким образом, что это может использоваться, чтобы сравнить два значения столбцов и сделать переход, если первое больше, чем второе.

    Сигнатура. Сравните значение с колонкой:

    int branch_col_ge
    (
      const void* val,
      Uint32 len,
      Uint32 attrId,
      Uint32 label
    )
    

    Сравните значения двух столбцов:

    int branch_col_ge
    (
      Uint32 attrId1,
      Uint32 attrId2,
      Uint32 label
    )
    

    Параметры. Когда используется, чтобы сравнить значение со столбцом таблицы, этот метод берет следующие четыре параметра:

    • Постоянная величина (val).

    • Длина значения (в байтах).

    • ID признака столбца таблицы, значение которого должно быть сравнено val.

    • Label (ранее определенная с использованием def_label()).

    Метод берет эти три параметра, перечисленные здесь, когда используется, чтобы сравнить две колонки:

    • AttrId1: ID признака первого столбца таблицы, значение которого должно быть сравнено.

    • AttrId2: Признак ID второго столбца таблицы.

    • label: Этикетка для перехода.

    Сравнивая две колонки, типы столбцов должны быть точно теми же самыми во всех отношениях.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.13. NdbInterpretedCode::branch_col_le()

    Описание. Этот метод сравнивает значение столбца таблицы с произвольной постоянной и переходит на указанную этикетку программы, если константа меньше или равна значению столбца. Начиная с NDB 8.0.18 это может также использоваться, чтобы сравнить два значения столбца таблицы этим способом.

    Сигнатура. Сравните значение столбца таблицы с константой:

    int branch_col_le
    (
      const void* val,
      Uint32 len,
      Uint32 attrId,
      Uint32 Label
    )
    

    Сравните значения двух столбцов таблицы:

    int branch_col_ge
    (
      Uint32 attrId1,
      Uint32 attrId2,
      Uint32 label
    )
    

    Параметры. Сравнивая значение столбца таблицы с константой, этот метод берет эти четыре параметра:

    • Постоянная величина (val).

    • Длина значения (в байтах).

    • ID признака столбца таблицы, значение которого должно быть сравнено с val.

    • Label (ранее определенная с использованием def_label()).

    Метод берет эти три параметра, перечисленные здесь, когда используется, чтобы сравнить два значения столбца таблицы:

    • AttrId1: ID признака первого столбца таблицы, значение которого должна быть сравнено.

    • AttrId2: Признак ID второго столбца таблицы.

    • label: Этикетка для перехода.

    Сравнивая две колонки, типы столбцов должны быть точно теми же самыми во всех отношениях.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.14. NdbInterpretedCode::branch_col_like()

    Описание. Этот метод проверяет значение столбца таблицы на соответствие образцу регулярного выражения и переходит на обозначенную этикетку программы, если оно соответствует.

    Сигнатура.

    int branch_col_like
    (
      const void* val,
      Uint32 len,
      Uint32 attrId,
      Uint32 Label
    )
    

    Параметры.

    • Образец регулярного выражения (val), см. раздел 2.3.24.1.7 .

    • Длина образца (в байтах).

    • Признак ID для проверяемого столбца таблицы.

    • Этикетка программы, чтобы перейти.

    Возвращаемое значение. 0 при успехе, -1 при неудаче

    2.3.24.15. NdbInterpretedCode::branch_col_lt()

    Описание. Этот метод сравнивает значение столбца таблицы с произвольной постоянной и переходит на указанную этикетку программы, если константа меньше, чем значение столбца. В NDB 8.0.18 и позже два значения столбца таблицы могут быть сравнены вместо этого.

    Сигнатура. Сравните значение столбца таблицы с константой:

    int branch_col_lt
    (
      const void* val,
      Uint32 len,
      Uint32 attrId,
      Uint32 Label
    )
    

    Сравните два значения столбца таблицы:

    int branch_col_lt
    (
      Uint32 attrId1,
      Uint32 attrId2,
      Uint32 label
    )
    

    Параметры. Сравнивая значение столбца таблицы с константой, этот метод берет следующие четыре параметра:

    • Постоянная величина (val).

    • Длина значения (в байтах).

    • ID признака столбца таблицы, значение которого должно быть сравнено с val.

    • Label (ранее определенная с использованием def_label()).

    Когда используется, чтобьы сравнить два значения столбца таблицы, branch_col_lt() берет следующие три параметра:

    • AttrId1: ID признака первого столбца таблицы, значение которого должно быть сравнено.

    • AttrId2: Признак ID второго столбца таблицы.

    • label: Этикетка для перехода.

    Сравнивая два значения столбца таблицы, типы значений столбца таблицы должны быть точно теми же самыми. Это означает, что у них должны быть та же самая длина, точность и масштаб.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.16. NdbInterpretedCode::branch_col_ne()

    Описание. Этот метод сравнивает значение столбца таблицы с произвольной постоянной и переходит на указанную этикетку программы, если две значения не равны. В NDB 8.0.18 и позже это может также использоваться, чтобы сравнить значение столбца таблицы с другим значением столбца таблицы вместо этого.

    Сигнатура. Сравните значение столбца таблицы с константой:

    int branch_col_ne
    (
      const void* val,
      Uint32 len,
      Uint32 attrId,
      Uint32 Label
    )
    

    Сравните два значения столбца таблицы:

    int branch_col_ne
    (
      Uint32 attrId1,
      Uint32 attrId2,
      Uint32 label
    )
    

    Параметры. Сравнивая значение столбца таблицы с константой, этот метод берет эти четыре параметра:

    • Постоянная величина (val).

    • Длина значения (в байтах).

    • ID признака столбца таблицы, значение которого должно быть сравнено с val.

    • Label (ранее определенная с использованием def_label()).

    Сравнивая два значения столбца таблицы, требуемые параметры показывают здесь:

    • AttrId1: ID признака первого столбца таблицы, значение которого должно быть сравнено.

    • AttrId2: Признак ID второго столбца таблицы.

    • label: Местоположение, чтобы перейти, если сравненные колонки разные. Должно быть уже определено, используя def_label().

    Используя этот метод, чтобы сравнить два значения столбца таблицы, колонки должны иметь точно тот же самый тип.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.17. NdbInterpretedCode::branch_col_ne_null()

    Описание. Этот метод проверяет значение столбца таблицы и переходит на обозначенную этикетку программы, если значение столбца не NULL.

    Сигнатура.

    int branch_col_ne_null
    (
      Uint32 attrId,
      Uint32 Label
    )
    

    Параметры.

    • Признак ID столбца таблицы.

    • Этикетка для перехода.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.18. NdbInterpretedCode::branch_col_notlike()

    Описание. Этот метод подобен branch_col_like(), это проверяет значение столбца таблицы на соответствие образцу регулярного выражения, однако, это переходит на этикетку программы, только если образец и значение столбца разные.

    Сигнатура.

    int branch_col_notlike
    (
      const void* val,
      Uint32 len,
      Uint32 attrId,
      Uint32 Label
    )
    

    Параметры.

    • Образец регулярного выражения (val), см. раздел 2.3.24.1.7 .

    • Длина образца (в байтах).

    • Признак ID для проверяемого столбца таблицы.

    • Этикетка программы для перехода.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.19. NdbInterpretedCode::branch_eq()

    Описание. Этот метод сравнивает два значения регистра, если они равны, интерпретируемая программа переходит к указанной этикетке.

    Сигнатура.

    int branch_eq
    (
      Uint32 RegLvalue,
      Uint32 RegRvalue,
      Uint32 Label
    )
    

    Параметры. Этот метод берет три параметра, регистры, значения которых должны быть сравнены, это RegLvalue и RegRvalue, и этикетка Label для перехода. Она должна быть заранее задана через def_label() (см. раздел 2.3.24.30).

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.20. NdbInterpretedCode::branch_eq_null()

    Описание. Этот метод сравнивает значение регистра с NULL, если значение регистра null, программа переходит на указанную этикетку.

    Сигнатура.

    int branch_eq_null
    (
      Uint32 RegLvalue,
      Uint32 Label
    )
    

    Параметры. Этот метод берет два параметра: регистр, значение которого должно быть сравнено с NULL, (RegLvalue) и этикетка Label для перехода. Label должна быть определена def_label() (см. раздел 2.3.24.30).

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.21. NdbInterpretedCode::branch_ge()

    Описание. Этот метод сравнивает два значения регистра, если первое больше или равно второму, программа переходит на этикетку.

    Сигнатура.

    int branch_ge
    (
      Uint32 RegLvalue,
      Uint32 RegRvalue,
      Uint32 Label
    )
    

    Параметры. Этот метод берет три параметра: регистры, значения которых должны быть сравнены (RegLvalue и RegRvalue) и этикетка Label для перехода. Label должна быть задана с def_label() (см. раздел 2.3.24.30).

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.22. NdbInterpretedCode::branch_gt()

    Описание. Этот метод сравнивает два значения регистра, если первое больше, чем второе, программа переходит на этикетку.

    Сигнатура.

    int branch_gt
    (
      Uint32 RegLvalue,
      Uint32 RegRvalue,
      Uint32 Label
    )
    

    Параметры. Этот метод берет три параметра: регистры, значения которых должны быть сравнены (RegLvalue и RegRvalue) и метка Label для перехода. Label должна быть определена ранее, используя def_label() (см. раздел 2.3.24.30).

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.23. NdbInterpretedCode::branch_label()

    Описание. Этот метод выполняет безусловный переход к этикетке программы (см. раздел 2.3.24.30).

    Сигнатура.

    int branch_label
    (
      Uint32 Label
    )
    

    Параметры. Этот метод берет единственный параметр, этикетку Label, определенную с использованием def_label().

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.24. NdbInterpretedCode::branch_le()

    Описание. Этот метод сравнивает два значения регистра, если первое меньше или равно второму, переходит на этикетку.

    Сигнатура.

    int branch_le
    (
      Uint32 RegLvalue,
      Uint32 RegRvalue,
      Uint32 Label
    )
    

    Параметры. Этот метод берет три параметра: регистры, значения которых должны быть сравнены (RegLvalue и RegRvalue) и этикетку Label для перехода. Label должна быть определена через def_label() (см. раздел 2.3.24.30).

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.25. NdbInterpretedCode::branch_lt()

    Описание. Этот метод сравнивает два значения регистра, если первое меньше, чем второе, переходит на этикетку.

    Сигнатура.

    int branch_lt
    (
      Uint32 RegLvalue,
      Uint32 RegRvalue,
      Uint32 Label
    )
    

    Параметры. Этот метод берет три параметра: регистры, значения которых должны быть сравнены (RegLvalue и RegRvalue) и Label для перехода. Label должна быть задана через def_label() (см. раздел 2.3.24.30).

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.26. NdbInterpretedCode::branch_ne()

    Описание. Этот метод сравнивает два значения регистра, если они не равны, то переходит на этикетку.

    Сигнатура.

    int branch_ne
    (
      Uint32 RegLvalue,
      Uint32 RegRvalue,
      Uint32 Label
    )
    

    Параметры. Этот метод берет три параметра: регистры, значения которых должны быть сравнены (RegLvalue и RegRvalue) и этикетку Label, которая должна быть определена через def_label().

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.27. NdbInterpretedCode::branch_ne_null()

    Описание. Этот метод сравнивает значение регистра с NULL, если значение не null, переходит на этикетку.

    Сигнатура.

    int branch_ne_null
    (
      Uint32 RegLvalue,
      Uint32 Label
    )
    

    Параметры. Этот метод берет два параметра: регистр, значение которого должно быть сравнено с NULL (RegLvalue) и этикетку для перехода Label, определенную через def_label() (см. раздел 2.3.24.30).

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.28. NdbInterpretedCode::call_sub()

    Описание. Этот метод используется, чтобы вызвать подпрограмму.

    Сигнатура.

    int call_sub
    (
      Uint32 SubroutineNumber
    )
    

    Параметры. Этот метод берет единственный параметр, номер, определяющее подпрограмму, которую вызовут.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.29. NdbInterpretedCode::copy()

    Описание. Делает глубокую копию объекта NdbInterpretedCode.

    Сигнатура.

    int copy
    (
      const NdbInterpretedCode& src
    )
    

    Параметры. Ссылка на копию.

    Возвращаемое значение. 0 при успехе или код ошибки.

    2.3.24.30. NdbInterpretedCode::def_label()

    Описание. Этот метод определяет этикетку, которая будет использоваться в качестве цели одного или более переходов в программе.

    def_label() использует буфер с 2 словами и не требует никакого пространства для сообщений запроса.

    Сигнатура.

    int def_label
    (
      int LabelNum
    )
    

    Параметры. Этот метод берет единственный параметр LabelNum, чье значение должно быть уникально среди всех значений, используемых для этикеток в рамках интерпретируемой программы.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.31. NdbInterpretedCode::def_sub()

    Описание. Этот метод используется, чтобы отметить начало подпрограммы. Посмотрите раздел 2.3.24.1.11.

    Сигнатура.

    int def_sub
    (
      Uint32 SubroutineNumber
    )
    

    Параметры. Единственный параметр, номер определенной подпрограммы.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.32. NdbInterpretedCode::finalise()

    Описание. Этот метод готовит интерпретируемую программу, включая любые подпрограммы, решая все команды ветвления и обращения к подпрограммам. Это нужно вызвать перед использованием программы и можно вызвать только однажды для любого данного объекта NdbInterpretedCode.

    Если никакие инструкции не были определены, этот метод пытается вставить вызов метода interpret_exit_ok() до завершения.

    Сигнатура.

    int finalise
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.33. NdbInterpretedCode::getNdbError()

    Описание. Этот метод возвращает новую ошибку, связанную с этим объектом NdbInterpretedCode.

    Сигнатура.

    const class NdbError& getNdbError
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Ссылка на объект NdbError .

    2.3.24.34. NdbInterpretedCode::getTable()

    Описание. Этот метод может использоваться, чтобы получить ссылку на таблицу, для который определен объект NdbInterpretedCode.

    Сигнатура.

    const NdbDictionary::Table* getTable
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на объект Table. NULL, если никакой объект таблицы не задан, при создании NdbInterpretedCode.

    2.3.24.35. NdbInterpretedCode::getWordsUsed()

    Описание. Этот метод возвращает количество слов от буфера, которые использовались, является ли буфер тем, который создан пользователями или внутренне обеспеченный буфер.

    Сигнатура.

    Uint32 getWordsUsed
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 32-битное количество слов в буфере.

    2.3.24.36. NdbInterpretedCode::interpret_exit_last_row()

    Описание. Для операции по просмотру вызов этого метода указывает, что эта строка должна быть возвращена как часть просмотра, и что больше строк в этом фрагменте не должно быть просмотрено. Для других типов операций метод заставляет операцию быть прерванной.

    Сигнатура.

    int interpret_exit_last_row
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.37. NdbInterpretedCode::interpret_exit_nok()

    Описание. Для операций просмотра этот метод используется, чтобы указать, что текущая строка не должна быть возвращена как часть просмотра, и программа должна идти дальше к следующей строке. Это заставляет другие типы операций быть прерванными.

    Сигнатура.

    int interpret_exit_nok
    (
      Uint32 ErrorCode = 626
      // HA_ERR_KEY_NOT_FOUND
    )
    

    Параметры. Этот метод берет единственный (дополнительный) параметр ErrorCode. Для полного списка кодов ошибок NDB посмотрите раздел 2.4.2. Если не задано, умолчание 626 (HA_ERR_KEY_NOT_FOUND/Tuple did not exist . Приложения должны использовать код ошибки 626 или другой код в диапазоне 6000-6999 включительно.

    До NDB 7.2.1 ErrorCode по умолчанию был кодом ошибки NDB 899 (Rowid already allocated). Это значение все еще поддерживается для обратной совместимости (Bug #16176006). Для любых значений кроме упомянутых здесь, поведение этого метода не определено, и подвержено изменениям в любое время без предшествующего уведомления.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.38. NdbInterpretedCode::interpret_exit_ok()

    Описание. Для операции по просмотру этот метод указывает, что текущая строка должна быть возвращена как часть результатов просмотра и что программа должна идти дальше к следующей строке. Для других операций вызов этого метода заставляет интерпретируемую программу завершиться.

    Сигнатура.

    int interpret_exit_ok
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.39. NdbInterpretedCode::load_const_null()

    Описание. Этот метод используется, чтобы загрузить NULL в регистр.

    Сигнатура.

    int load_const_null
    (
      Uint32 RegDest
    )
    

    Параметры. Этот метод берет единственный параметр: регистр, в который нужно поместить NULL.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.40. NdbInterpretedCode::load_const_u16()

    Описание. Этот метод загружает 16-битовое значение в указанный регистр.

    Сигнатура.

    int load_const_u16
    (
      Uint32 RegDest,
      Uint32 Constant
    )
    

    Параметры.

    • RegDest: Регистр, в который должно быть загружено значение.

    • Constant значение, которое будет загружено.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.41. NdbInterpretedCode::load_const_u32()

    Описание. Этот метод загружает 32-битовое значение в указанный регистр.

    Сигнатура.

    int load_const_u32
    (
      Uint32 RegDest,
      Uint32 Constant
    )
    

    Параметры.

    • RegDest: Регистр, в который должно быть загружено значение.

    • Constant значение, которое будет загружено.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.42. NdbInterpretedCode::load_const_u64()

    Описание. Этот метод загружает 64-битовое значение в указанный регистр.

    Сигнатура.

    int load_const_u64
    (
      Uint32 RegDest,
      Uint64 Constant
    )
    

    Параметры.

    • RegDest: Регистр, в который должно быть загружено значение.

    • Constant значение, которое будет загружено.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.43. NdbInterpretedCode::read_attr()

    Описание. Метод read_attr() используется, чтобы прочитать значение столбца таблицы в регистр программы. Столбец может быть определен при помощи признака ID или как указатель на объект Column .

    Сигнатура. Этот метод можно вызвать любым из двух способов. Первый из них, ссылаясь на колонку по ее ID, как показано здесь:

    int read_attr
    (
      Uint32 RegDest,
      Uint32 attrId
    )
    

    Альтернативно, можно сослаться на колонку как на объект Column:

    int read_attr
    (
      Uint32 RegDest,
      const NdbDictionary::Column* column
    )
    

    Параметры.

    • Регистр, в который должно быть скопировано значение столбца (RegDest).

    • Любая из следующих ссылок на столбец таблицы, значение которого должно быть скопировано:

      • Признак столбца таблицы ID (attrId).

      • Указатель на объект column то есть, указатель на объект Column, ссылающийся на столбец таблицы.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.44. NdbInterpretedCode::ret_sub()

    Описание. Этот метод отмечает конец текущей подпрограммы.

    Сигнатура.

    int ret_sub
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.45. NdbInterpretedCode::sub_reg()

    Описание. Этот метод получает различие между значениями, сохраненными в любых двух данных регистрах, и хранит результат в третьем регистре.

    Сигнатура.

    int sub_reg
    (
      Uint32 RegDest,
      Uint32 RegSource1,
      Uint32 RegSource2
    )
    

    Параметры. Этот метод берет три параметра. Первым из них является регистр, в котором должен быть сохранен результат (RegDest). Второй и третий параметры (RegSource1 и RegSource2) это регистры, значения которых должны быть вычтены. Другими словами, значение регистра RegDest вычислено так:

    (значение в регистре RegSource1) -
    (значение в регистре RegSource2)
    

    Возможно снова использовать один из регистров, значения которых вычтены для хранения результата, то есть, RegDest может быть RegSource1 или RegSource2.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.24.46. NdbInterpretedCode::sub_val()

    Описание. Этот метод вычитает указанное значение из значения данного столбца таблицы и помещает оригинальные и измененные значения столбцов в регистры 6 и 7. Это эквивалентно следующей серии вызовов NdbInterpretedCode, где attrId это ID столбца таблицы, а aValue значение, которое будет вычтено:

    read_attr(6, attrId);
    load_const_u32(7, aValue);
    sub_reg(7,6,7);
    write_attr(attrId, 7);
    

    aValue может быть 32-bit или 64-bit integer.

    Сигнатура. Этот метод может быть вызван любым из двух способов, в зависимости от разрядности aValue.

    32-bit aValue:

    int sub_val
    (
      Uint32 attrId,
      Uint32 aValue
    )
    

    64-bit aValue:

    int sub_val
    (
      Uint32 attrId,
      Uint64 aValue
    )
    

    Параметры. ID признака столбца таблицы и 32-bit или 64-bit integer значение, которое будет вычтено из значения этого столбца.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.24.47. NdbInterpretedCode::write_attr()

    Описание. Этот метод используется, чтобы скопировать значение регистра к столбцу таблицы. Столбец может быть определен при помощи признака ID или как указатель на объект Column.

    Сигнатура. Этот метод может быть вызван любым из двух способов. Первый из них требует ссылки на колонку по признаку ID, как показано здесь:

    int read_attr
    (
      Uint32 attrId,
      Uint32 RegSource
    )
    

    Можно также сослаться на колонку как на объект Column:

    int read_attr
    (
      const NdbDictionary::Column* column,
      Uint32 RegSource
    )
    

    Параметры.

    • Ссылка на столбец таблицы, в который должно быть скопировано значение регистра. Это может иметь любое значение из следующего:

      • Признак столбца таблицы ID (attrId).

      • Указатель на объект column, ссылающийся на столбец таблицы.

    • Регистр, значение которого должно быть скопировано (RegSource).

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.25. Класс NdbOperation

    Резюме

    Эта секция обсуждает класс NdbOperation.

    Родительский класс. Нет.

    Дочерние классы. NdbIndexOperation, NdbScanOperation.

    Описание. NdbOperation представляет универсальную операцию с данными. Его подклассы представляют более определенные типы операций. Посмотрите раздел 2.3.25.18 для списка операционных типов и их соответствующих субклассов NdbOperation.

    Методы.

    Таблица 2.52.

    Имя Описание
    deleteTuple() Удаляет кортеж из таблицы
    equal() Определяет условие поиска, используя равенство
    getBlobHandle() Используется, чтобы получить доступ к признакам blob
    getLockHandle() Получает обработчик блокировки для операции
    getLockMode() Получает способ блокировки операции
    getNdbError() Получает последнюю ошибку
    getNdbErrorLine() Получает номер метода, где последняя ошибка произошла
    getTableName() Получает название таблицы, используемой для этой операции
    getTable() Получает объект таблицы для этой операции
    getNdbTransaction() Получает объект NdbTransaction для этой операции
    getType() Получает тип операции
    getValue() Ассигнует значение атрибута для более позднего доступа
    insertTuple() Добавляет новый кортеж к таблице
    readTuple() Читает кортеж от таблицы
    setValue() Определяет признак, чтобы установить или обновить
    updateTuple() Обновляет существующий кортеж в таблице
    writeTuple() Вставляет или обновляет кортеж

    У этого класса нет публичного конструктора. Чтобы создать экземпляр NdbOperation, необходимо использовать NdbTransaction::getNdbOperation().

    Типы. Класс NdbOperation определяет три публичных типа, показанные в следующей таблице:

    Таблица 2.53.

    Имя Описание
    AbortOption() Определяет, вызывает ли неудавшаяся операция неудачу транзакции
    LockMode() Тип блокировки, используемой, выполняя операцию чтения
    Type() Операционные типы доступа

    См. раздел 1.3.2.3.2.

    2.3.25.1. NdbOperation::AbortOption

    Описание. Этот тип используется, чтобы определить, должны ли неудавшиеся операции вынудить транзакцию быть прерванной. Это используется в качестве аргумента метода execute(), см. раздел 2.3.30.6.

    Возможные значения.

    Таблица 2.54.

    Имя Описание
    AbortOnError Неудавшаяся операция заставляет транзакцию прерываться.
    AO_IgnoreOnError Проигнорированы неудавшиеся операции, транзакция продолжает выполняться.
    DefaultAbortOption Значение AbortOption установлено согласно операционному типу:
    • Операции чтения: AO_IgnoreOnError.

    • Операции просмотра или DML: AbortOnError.


    См. раздел 2.3.30.6.

    2.3.25.2. NdbOperation::deleteTuple()

    Описание. Этот метод определяет NdbOperation как DELETE. Когда метод NdbTransaction::execute() вызван, операция удаляет кортеж из таблицы.

    Сигнатура.

    virtual int deleteTuple
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.25.3. NdbOperation::equal()

    Описание. Этот метод определяет условие поиска с равенством. Условие верно, если у признака есть данное значение. Чтобы установить условия поиска на многократных признаках, используйте несколько вызовов equal(), в таких случаях все они должны быть удовлетворены для кортежа, который будет отобран.

    Если признак имеет фиксированный размер, его значение должно включать все байты. В особенности значение Char должна быть дополнено пробелами. Если признак имеет переменный размер, его значение должно начаться с 1 или 2 байтов длины с прямым порядком байтов (2, если тип Long*).

    Используя insertTuple(), можно также определить ключ поиска с setValue(). См. раздел 2.3.25.17.

    Сигнатура. Есть 10 версий equal(), каждая имеет немного отличающиеся параметры. Все они перечисляются здесь:

    intequal
    (
      const char* name,
      const char* value
    )
    
    intequal
    (
      const char* name,
      Int32 value
    )
    
    intequal
    (
      const char* name,
      Uint32 value
    )
    
    intequal
    (
      const char* name,
      Int64 value
    )
    
    intequal
    (
      const char* name,
      Uint64 value
    )
    
    intequal
    (
      Uint32 id,
      const char* value
    )
    
    intequal
    (
      Uint32 id,
      Int32 value
    )
    
    intequal
    (
      Uint32 id,
      Uint32 value
    )
    
    intequal
    (
      Uint32 id,
      Int64 value
    )
    
    intequal
    (
      Uint32 id,
      Uint64 value
    )
    

    Параметры.

    • Первый параметр может иметь любое из следующего:

      1. Имя name признака (последовательность).

      2. id признака unsigned 32-bit integer).

    • Второй параметр это признак value для проверки. Это значение может быть любым из следующих 5 типов:

      1. String

      2. 32-bit integer

      3. Unsigned 32-bit integer

      4. 64-bit integer

      5. Unsigned 64-bit integer

    Возвращаемое значение. -1 в случае ошибки.

    2.3.25.4. NdbOperation::getBlobHandle()

    Описание. Этот метод используется вместо getValue() или setValue() для признаков blob. Это создает обработчик blob (объект NdbBlob). Второй вызов с тем же самым аргументом возвращает ранее созданный обработчик, связанный с операцией и сохраняется автоматически.

    Сигнатура. У этого метода есть две формы, в зависимости от того, вызывают ли это с именем или ID признака blob:

    virtual NdbBlob* getBlobHandle
    (
      const char* name
    )
    

    или

    virtual NdbBlob* getBlobHandle
    (
      Uint32 id
    )
    

    Параметры. Этот метод берет единственный параметр, который может быть любой одним из следующего:

    • name: имя признака

    • id признака

    Возвращаемое значение. Независимо от используемого типа параметра, это возвращает указатель на экземпляр NdbBlob.

    2.3.25.5. NdbOperation::getLockHandle

    Описание. Возвращает указатель на обработчик блокировки текущей операции. Когда используется с NdbRecord, обработчик блокировки нужно сначала вызвать с опцией OO_LOCKHANDLE. Для других операций этот метод может использоваться один. В любом случае объект NdbLockHandle возвращенный этим методом, не может использоваться, пока операция не была выполнена.

    Использование методов работы с блокировкой. Коллективные или монопольные блокировки, взятые операциями чтения в транзакции, обычно действуют, пока транзакция не передает или прерывается. Такие блокировки могут быть выпущены, прежде чем транзакция передает или прерывается, вызывая обработчик блокировки, определяя операцию чтения. Как только операция чтения была выполнена, NdbLockHandle может использоваться, чтобы создать новую операцию разблокировки (с NdbTransaction::unlock()). Когда операция разблокировки выполняется, блокировка строки, созданная операцией чтения, выпущена.

    Шаги, требуемые, чтобьы выпустить эти блокировки, перечисляются здесь:

    • Определите операцию чтения первичного ключа нормальным способом со способом блокировки LM_Read или LM_Exclusive.

    • Вызовите NdbOperation::getLockHandle() во время операционного определения или для Ndbrecord установите опцию OO_LOCKHANDLE при вызове NdbTransaction::readTuple().

    • Вызовите NdbTransaction::execute(), строка теперь блокирована с этого момента как нормальная.

    • Используйте данные, возможно сделав вызовы NdbTransaction::execute().

    • Вызовите NdbTransaction::unlock(), передав const NdbLockHandle, полученную ранее, чтобы создать операцию разблокировки.

    • Вызовите NdbTransaction::execute(), это разблокирует строку.

    Примечания:

    • Как с другими операционными типами, операции разблокировки могут быть скомплектованы пакет.

    • Каждый объект NdbLockHandle относится к блокировке, добавленной на строку единственной операцией чтения первичного ключа. У единственной строки в базе данных могут быть параллельные многократные блокировки (LM_Read) и она может иметь многократных ожидающих держателей блокировки (LM_Exclusive), так что выпуск одного держателя блокировки может не привести к изменению заметного статуса блокировки строки.

    • Обработчики блокировки поддерживаются для операций просмотра, обработчик блокировки нужно требовать, прежде чем блокировка выполняется.

    • Обработчики блокировки и операции разблокировки не поддерживаются для операций чтения уникального индекса.

    Сигнатура.

    const NdbLockHandle* getLockHandle
    (
      void
    ) const
    

    или

    const NdbLockHandle* getLockHandle
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на NdbLockHandle, который может использоваться методами NdbTransaction unlock() и releaseLockHandle().

    2.3.25.6. NdbOperation::getLockMode()

    Описание. Этот метод получает способ блокировки операции.

    Сигнатура.

    LockMode getLockMode
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Значение LockMode. См. раздел 2.3.25.15.

    2.3.25.7. NdbOperation::getNdbError()

    Описание. Этот метод получает новую ошибку (объект NdbError).

    Сигнатура.

    const NdbError& getNdbError
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Объект NdbError.

    2.3.25.8. NdbOperation::getNdbErrorLine()

    Описание. Этот метод получает номер метода, в котором произошла последняя ошибка.

    Сигнатура.

    int getNdbErrorLine
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Номер метода (integer).

    2.3.25.9. NdbOperation::getTable()

    Описание. Этот метод используется, чтобы получить объект таблицы, связанный с операцией.

    Сигнатура.

    const NdbDictionary::Table* getTable
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на экземпляр Table.

    2.3.25.10. NdbOperation::getTableName()

    Описание. Этот метод получает название таблицы, используемой для операции.

    Сигнатура.

    const char* getTableName
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Название таблицы.

    2.3.25.11. NdbOperation::getNdbTransaction()

    Описание. Получает объект NdbTransaction.

    Сигнатура.

    virtual NdbTransaction* getNdbTransaction
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на объект NdbTransaction.

    2.3.25.12. NdbOperation::getType()

    Описание. Этот метод используется, чтобы получить тип доступа для этой операции.

    Сигнатура.

    Type getType
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Значение Type.

    2.3.25.13. NdbOperation::getValue()

    Описание. Этот метод готовится к поиску значения атрибута. API NDB ассигнует память для объекта NdbRecAttr, который позже используется, чтобы получить значение атрибута. Это может быть сделано при помощи одного из многих методов NdbRecAttr, точный метод, который будет использоваться зависит от типа данных признака. Это включает общий метод NdbRecAttr::aRef(), который получает данные как char*, независимо от фактического типа. Однако, это не безопасно с точки зрения типов и требует внимания.

    Этот метод не получает значение атрибута из базы данных, объект NdbRecAttr, возвращенный этим методом, не удобочитаемый или пригодный для печатания перед запросом NdbTransaction::execute().

    Если определенный признак не изменился, соответствующий NdbRecAttr имеет состояние UNDEFINED. Это может быть проверено при помощи NdbRecAttr::isNULL(), который в такой ситуации вернет -1.

    См. разделы 2.3.30.6 и 2.3.26.13.

    Сигнатура. Есть три версии этого метода, каждая имеющая различные параметры:

    NdbRecAttr* getValue
    (
      const char* name,
      char* value = 0
    )
    
    NdbRecAttr* getValue
    (
      Uint32 id,
      char* value = 0
    )
    
    NdbRecAttr* getValue
    (
      const NdbDictionary::Column* col,
      char* value = 0
    )
    

    Параметры. У всех трех форм этого метода есть два параметра, второй параметр, является дополнительным (по умолчанию 0). Они отличаются только относительно типа первого параметра, который может быть любым из следующего:

    • Имя name атрибута.

    • id атрибута.

    • Столбец column таблицы, на котором определяется признак.

    Во всех трех случаях второй параметр это буфер символов в который не-NULL значение атрибута возвращено. Если признак NULL, только объект NdbRecAttr возвращен этим методом.

    Если value не указанано в вызове getValue() или оно равно 0, объект NdbRecAttr обеспечивает управление памятью для того, чтобы хранить полученные данные. Если максимальный размер полученных данных выше маленького фиксированного размера, malloc() используется, чтобы сохранить его: для небольших размеров обеспечивается маленький внутренний буфер (кратный 32 байтам). Это хранение организовано экземпляром NdbRecAttr, это освобождено, когда операция выпущена, любые данные, написанные здесь, которые вы хотите сохранить, должны быть скопированы в другом месте, прежде чем это освобождение памяти происходит.

    Если вы передаете указатель отличный от нуля для value, тогда предполагается, что это указывает на часть памяти, которая является достаточно большой, чтобы содержать максимальное значение колонки, любые возвращенные данные написаны именно там. Указатель должен быть выровнен по 32 битам.

    Столбцы индекса не могут использоваться вместо столбцов таблицы с этим методом. В случаях, где столбец таблицы недоступен, можно использовать название атрибута, полученное с getName().

    Возвращаемое значение. Указатель на объект NdbRecAttr, чтобы содержать значение признака или NULL в случае ошибки.

    Получение целых чисел. Значения Integer могут быть получены от буфера value, переданного как второй параметр этого метода, и от объекта NdbRecAttr . С другой стороны, символьные данные доступны от NdbRecAttr , если никакой буфер не был передан в getValue() (см. раздел 2.3.26.2). Однако, символьные данные написаны в буфер, только если он предоставлен, в этом случае это не может быть получено от объекта NdbRecAttr , который был возвращен. В последнем случае NdbRecAttr::aRef() возвращает буфер, указывающий на пустую строку.

    Доступ к битовым значениям. Следующий пример показывает, как проверить данный бит в буфере value. Здесь op это операция (объект NdbOperation ), name это название колонки, от которой можно получить битовое значение, а trans это объект NdbTransaction :

    Uint32 buf[];
    op->getValue(name, buf);   /* bit column */
    trans->execute();
    if (buf[X/32] & 1 << (X & 31))   /* check bit X */
    {
       /* bit X set */
    }
    

    2.3.25.14. NdbOperation::insertTuple()

    Описание. Этот метод определяет NdbOperation для опреации INSERT. Когда NdbTransaction::execute() вызван, эта операция добавляет новый кортеж к таблице.

    Сигнатура.

    virtual int insertTuple
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.25.15. NdbOperation::LockMode

    Описание. Этот тип описывает способ блокировки, используемый, выполняя операцию чтения.

    Возможные значения.

    Таблица 2.55.

    Имя Описание
    LM_Read Чтение с коллективной блокировкой
    LM_Exclusive Чтение с монопольной блокировкой
    LM_CommittedRead Проигнорируйте блокировку, чтение последней передачи
    LM_SimpleRead Чтение с коллективной блокировкой, но выпустите блокировку непосредственно

    Есть также поддержка грязных чтений (LM_Dirty), но это обычно только во внутренних целях и не должно использоваться для задач, развернутых в производственном режиме.

    2.3.25.16. NdbOperation::readTuple()

    Описание. Этот метод определяет операцию NdbOperation READ. Когда метод NdbTransaction::execute() вызван, операция читает кортеж.

    Сигнатура.

    virtual int readTuple
    (
      LockMode mode
    )
    

    Параметры. mode определяет способ блокировки, используемый операцией чтения. Посмотрите раздел 2.3.25.15.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.25.17. NdbOperation::setValue()

    Описание. Этот метод определяет признак, который будет установлен или обновлен.

    Есть много методов NdbOperation::setValue(), которые берут определенный тип в качестве входа (значение вместо того, чтобы передать указатель). Обязанность прикладного программиста использовать правильные типы.

    Однако API NDB действительно проверяет, что приложение посылает правильную длину в интерфейс, как дано в параметре длины. Значение char* может содержать любой тип данных или любой тип множества. Если длина не обеспечивается, или если она установлена в ноль, то API предполагает, что указатель правилен и не проверяет его.

    Чтобы установить значение NULL, используйте следующую конструкцию:

    setValue("ATTR_NAME", (char*)NULL);
    

    Когда вы используете insertTuple(), NDB API автоматически обнаруживает, что он, как предполагается, использует equal().

    Кроме того, необязательно, используя insertTuple(), применять setValue() на ключевых признаках перед другими признаками.

    Сигнатура. Есть 14 версий NdbOperation::setValue(), каждая с немного отличающимися параметрами, как перечислено здесь:

    int setValue
    (
      const char* name,
      const char* value
    )
    
    int setValue
    (
      const char* name,
      Int32 value
    )
    
    int setValue
    (
      const char* name,
      Uint32 value
    )
    
    int setValue
    (
      const char* name,
      Int64 value
    )
    
    int setValue
    (
      const char* name,
      Uint64 value
    )
    
    int setValue
    (
      const char* name,
      float value
    )
    
    int setValue
    (
      const char* name,
      double value
    )
    
    int setValue
    (
      Uint32 id,
      const char* value
    )
    
    int setValue
    (
      Uint32 id,
      Int32 value
    )
    
    int setValue
    (
      Uint32 id,
      Uint32 value
    )
    
    int setValue
    (
      Uint32 id,
      Int64 value
    )
    
    int setValue
    (
      Uint32 id,
      Uint64 value
    )
    
    int setValue
    (
      Uint32 id,
      float value
    )
    
    int setValue
    (
      Uint32 id,
      double value
    )
    

    Параметры. Этот метод требует следующих двух параметров:

    • Первый параметр определяет признак, который будет установлен и может быть одним любым из следующего:

      1. Имя name признака (string).

      2. id признака (unsigned 32-bit integer).

    • Второй параметр value это значение, в которое должен быть установлен признак, его тип может быть любым из следующих 7 типов:

      1. String (const char*)

      2. 32-bit integer

      3. Unsigned 32-bit integer

      4. 64-bit integer

      5. Unsigned 64-bit integer

      6. Double

      7. Float

    См. раздел 2.3.25.3.

    Возвращаемое значение. -1 при ошибке.

    2.3.25.18. NdbOperation::Type

    Описание. Type используется, чтобы описать операционный тип доступа. Каждый тип доступа поддерживается NdbOperation или один из его подклассов, как показано в следующей таблице:

    Возможные значения.

    Таблица 2.56.

    Имя Описание Применимый класс
    PrimaryKeyAccess Чтение, вставка, обновление или удаление, используя первичный ключ таблицы NdbOperation
    UniqueIndexAccess Чтение, обновление или удаление, используя уникальный индекс NdbIndexOperation
    TableScan Полное сканирование таблицы NdbScanOperation
    OrderedIndexScan Упорядоченный просмотр индекса NdbIndexScanOperation

    2.3.25.19. NdbOperation::writeTuple()

    Описание. Этот метод определяет операцию NdbOperation WRITE. Когда вызван метод NdbTransaction::execute() операция пишет кортеж в таблицу. Если кортеж уже существует, он обновляется, иначе вставка происходит.

    Сигнатура.

    virtual int writeTuple
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.25.20. NdbOperation::updateTuple()

    Описание. Этот метод определяет операцию NdbOperation UPDATE. Когда вызван метод NdbTransaction::execute(), операция обновляет кортеж, найденный в таблице.

    Сигнатура.

    virtual int updateTuple
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Returns 0 при успехе, -1 при ошибке.

    2.3.26. Класс NdbRecAttr

    Резюме

    Секция описывает класс NdbRecAttr и его публичные методы.

    Родительский класс. Нет.

    Дочерние классы. Нет.

    Описание. NdbRecAttr содержит значение признака. Объект NdbRecAttr используется, чтобы сохранить значение атрибута после того, как он был восстановлен, используя метод NdbOperation::getValue(). Этот объект ассигнуется API NDB. Краткий пример показывают здесь:

    MyRecAttr = MyOperation->getValue("ATTR2", NULL);
    if (MyRecAttr == NULL) goto error;
    if (MyTransaction->execute(Commit) == -1) goto error;
    ndbout << MyRecAttr->u_32_value();
    

    См. раздел 2.5.1.

    Объект NdbRecAttr создается с его значением только когда вызван NdbTransaction::execute(). До этого значение не определена. Используйте NdbRecAttr::isNULL(), чтобы проверить, определяется ли значение. Это означает, что у объекта NdbRecAttr есть действительная информация только между вызовами NdbTransaction::execute() и Ndb::closeTransaction(). Значение NULL указывает -1 до вызова NdbTransaction::execute().

    Методы. NdbRecAttr имеет много методов для получения значений различных простых типов непосредственно от экземпляра этого класса.

    Также возможно получить ссылку на значение независимо от ее фактического типа, при помощи NdbRecAttr::aRef(), но необходимо знать, что это небезопасно с точки зрения типов и требует аккуратности.

    Таблица 2.57.

    Имя Описание
    ~NdbRecAttr() Деструктор
    aRef() Получает указатель на значение атрибута
    char_value() Получает значение атрибута Char
    clone() Делает глубокую копию объекта RecAttr
    double_value() Получает значение атрибута Double как double (8 байт)
    float_value() Получает значение атрибута Float как float (4 байта)
    get_size_in_bytes() Получает размер признака в байтах
    getColumn() Получает колонку, которой принадлежит признак
    getType() Получает тип признака ( Column::Type)
    isNULL() Проверка, является ли признак NULL
    int8_value() Получает значение атрибута Tinyint как 8-bit integer
    int32_value() Получает значение атрибута Int как 32-bit integer
    int64_value() Получает значение атрибута Bigint как 64-bit integer
    medium_value() Получает значение атрибута Mediumint как 32-bit integer
    short_value() Получает значение атрибута Smallint как 16-bit integer
    u_8_value() Получает значение атрибута Tinyunsigned как unsigned 8-bit integer
    u_32_value() Получает значение атрибута Unsigned как unsigned 32-bit integer
    u_64_value() Получает значение атрибута Bigunsigned как unsigned 64-bit integer
    u_char_value() Получает значение атрибута Char как unsigned char
    u_medium_value() Получает значение атрибута Mediumunsigned как unsigned 32-bit integer
    u_short_value() Получает значение атрибута Smallunsigned как unsigned 16-bit integer

    У класса NdbRecAttr нет публичного конструктора, экземпляр этого объекта создается, используя NdbTransaction::execute(). См. раздел 2.3.26.1.

    Типы. Класс NdbRecAttr не определяет публичных типов.

    2.3.26.1. ~NdbRecAttr()

    Описание. Это деструктор класса NdbRecAttr.

    Необходимо удалить только копии объектов NdbRecAttr , которые были созданы в вашем приложении, используя метод clone().

    Сигнатура.

    ~NdbRecAttr
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Нет.

    2.3.26.2. NdbRecAttr::aRef()

    Описание. Этот метод используется, чтобы получить ссылку на значение атрибута, как указатель на char. Этот указатель выровнен соответственно для типа данных. Память освобождена API NDB, когда выполнен NdbTransaction::close() в транзакции, которая читают значение.

    Сигнатура.

    char* aRef
    (
      void
    ) const
    

    Параметры. Указатель на значение атрибута. Поскольку этот указатель постоянный, этот метод можно вызвать в любое время после NdbOperation::getValue().

    Возвращаемое значение. Нет.

    2.3.26.3. NdbRecAttr::char_value()

    Описание. Этот метод получает Char, сохраненный в объекте NdbRecAttr и возвращает его как char.

    Сигнатура.

    char char_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Значение char.

    2.3.26.4. NdbRecAttr::clone()

    Описание. Этот метод создает глубокую копию объекта NdbRecAttr.

    Копия, созданная этим методом, должна быть удалена приложением, когда больше не нужна.

    Сигнатура.

    NdbRecAttr* clone
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Объект NdbRecAttr. Это полная копия оригинала, включая все данные.

    2.3.26.5. NdbRecAttr::double_value()

    Описание. Этот метод получает значение Double, сохраненное в объекте NdbRecAttr и возвращает его как double.

    Сигнатура.

    double double_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Значение double (8 байт).

    2.3.26.6. NdbRecAttr::float_value()

    Описание. Этот метод получает значение Float, сохраненное в объекте NdbRecAttr и возвращает его как float.

    Сигнатура.

    float float_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Значение float (4 байта).

    2.3.26.7. NdbRecAttr::get_size_in_bytes()

    Описание. Можно использовать этот метод, чтобы получить размер признака (элемента).

    Сигнатура.

    Uint32 get_size_in_bytes
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Размер признака в байтах как unsigned 32-bit integer.

    2.3.26.8. NdbRecAttr::getColumn()

    Описание. Этот метод используется, чтобы получить колонку, которой принадлежит признак.

    Сигнатура.

    const NdbDictionary::Column* getColumn
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на объект Column.

    2.3.26.9. NdbRecAttr::getType()

    Описание. Этот метод используется, чтобы получить тип данных колонки.

    Сигнатура.

    NdbDictionary::Column::Type getType
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Значение Column::Type.

    2.3.26.10. NdbRecAttr::int8_value()

    Описание. Этот метод получает значение Small, сохраненное в объекте NdbRecAttr и возвращает как 8-bit signed integer.

    Сигнатура.

    int8 int8_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 8-bit signed integer.

    2.3.26.11. NdbRecAttr::int32_value()

    Описание. Этот метод получает значение Int, сохраненное в объекте NdbRecAttr и возвращает как 32-bit signed integer.

    Сигнатура.

    int32 int32_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 32-bit signed integer.

    2.3.26.12. NdbRecAttr::int64_value()

    Описание. Этот метод получает значение Bigint, сохраненное в объекте NdbRecAttr и возвращает как 64-bit signed integer.

    Сигнатура.

    int64 int64_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 64-bit signed integer.

    2.3.26.13. NdbRecAttr::isNULL()

    Описание. Этот метод проверяет, является ли значение атрибута NULL.

    Сигнатура.

    int isNULL
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Одно из следующих трех значений:

    • -1: Значение атрибута не определяется из-за ошибки.

    • 0: Значение атрибута определяется, но не NULL.

    • 1: Значение атрибута определяется и NULL.

    Если NdbTransaction::execute() еще не был вызван, значение, возвращенное isNULL() не определяется.

    2.3.26.14. NdbRecAttr::medium_value()

    Описание. Этот метод получает значение Mediumint, сохраненное в объекте NdbRecAttr и возвращает как 32-bit signed integer.

    Сигнатура.

    int32 medium_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 32-bit signed integer.

    2.3.26.15. NdbRecAttr::short_value()

    Описание. Этот метод получает значение Smallint, сохраненное в объекте NdbRecAttr и возвращает как 16-bit signed integer (short).

    Сигнатура.

    short short_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 16-bit signed integer.

    2.3.26.16. NdbRecAttr::u_8_value()

    Описание. Этот метод получает значение Smallunsigned, сохраненное в объекте NdbRecAttr и возвращает как 8-bit unsigned integer.

    Сигнатура.

    Uint8 u_8_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 8-bit unsigned integer.

    2.3.26.17. NdbRecAttr::u_32_value()

    Описание. Этот метод получает значение Unsigned, сохраненное в объекте NdbRecAttr и возвращает как 32-bit unsigned integer.

    Сигнатура.

    Uint32 u_32_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 32-bit unsigned integer.

    2.3.26.18. NdbRecAttr::u_64_value()

    Описание. Этот метод получает значение Bigunsigned, сохраненное в объекте NdbRecAttr и возвращает как 64-bit unsigned integer.

    Сигнатура.

    Uint64 u_64_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 64-bit unsigned integer.

    2.3.26.19. NdbRecAttr::u_char_value()

    Описание. Этот метод получает значение Char, сохраненное в объекте NdbRecAttr и возвращает как unsigned char.

    Сигнатура.

    Uint8 u_char_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 8-bit unsigned char.

    2.3.26.20. NdbRecAttr::u_medium_value()

    Описание. Этот метод получает значение Mediumunsigned, сохраненное в объекте NdbRecAttr и возвращает как 32-bit unsigned integer.

    Сигнатура.

    Uint32 u_medium_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 32-bit unsigned integer.

    2.3.26.21. NdbRecAttr::u_short_value()

    Описание. Этот метод получает значение Smallunsigned, сохраненное в объекте NdbRecAttr и возвращает как 16-bit (short) unsigned integer.

    Сигнатура.

    Uint16 u_short_value
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. short (16-bit) unsigned integer.

    2.3.27. Интерфейс NdbRecord

    NdbRecord это интерфейс, который предоставляет отображение полной или частичной записи, сохраненной в NDB. В последнем случае это может использоваться вместе с битовым массивом, чтобы помочь в доступе.

    NdbRecord не имеет никаких собственных методов API, скорее это действует как обработчик, который может быть передан между различными вызовами метода во многих различных видах операций, включая следующие операционные типы:

    • Чтение уникального и первичного ключей.

    • Сканирование таблицы и просмотры индекса.

    • Операции DML, включающие уникальные или первичные ключи.

    • Операции, включающие границы индекса.

    Тот же самый NdbRecord может использоваться одновременно в многократных операциях, транзакциях и потоках.

    NdbRecord может быть создан в программах API NDB, вызывая метод createRecord() класса Dictionary . Кроме того, у многих методов API NDB есть дополнительные декларации, которые позволяют программисту усилить NdbRecord:

    Следующие члены NdbIndexScanOperation и NdbDictionary могут также использоваться с просмотрами NdbRecord:

    • IndexBound структура, используемая, чтобы описать границы просмотра индекса.

    • RecordSpecification структура, используемая, чтобы определить смещения диапазона и колонки.

    Можно также использовать NdbRecord с новой структурой PartitionSpec, чтобы выполнить просмотры, которые используют в своих интересах сокращение разделения посредством варианта NdbIndexScanOperation::setBound(), это было добавлено в тех же самых выпусках NDB Cluster.

    2.3.28. Класс NdbScanFilter

    Резюме

    Эта секция обсуждает класс NdbScanFilter и его публичные члены.

    Родительский класс. Нет.

    Дочерние классы. Нет.

    Описание. NdbScanFilter обеспечивает альтернативное средство определения фильтров для операций по просмотру.

    До MySQL 5.1.14 методы сравнения этого класса не работали со значениями BIT (Bug #24503).

    Разработка этого интерфейса продолжается: особенности класса NdbScanFilter, вероятно, изменятся далее в будущих выпусках.

    Методы.

    Таблица 2.58.

    Имя Описание
    NdbScanFilter() Метод конструктора
    ~NdbScanFilter() Метод деструктора
    begin() Начинает комплекс (набор условий)
    cmp() Сравнивает значение столбца с произвольным значением
    end() Заканчивает комплекс
    eq() Тест на равенство
    ge() Тест на большее или равное условие
    getNdbError() Обеспечивает доступ к информации об ошибке
    getNdbOperation() Получает связанный NdbOperation
    gt() Тесты на условие больше чем
    isfalse() Определяет термин в комплексе как FALSE
    isnotnull() Тест, не является ли значение столбца NULL
    isnull() Тест, является ли значение столбца NULL
    istrue() Определяет термин в комплексе как TRUE
    le() Тест на меньше или равно
    lt() Тест на меньше
    ne() Тест на неравенство

    Методы сравнения целого числа NdbScanFilter. NdbScanFilter обеспечивает несколько удобных методов, которые могут использоваться вместо cmp() , когда произвольное значение, которое будет сравнено, является целым числом: eq(), ge(), gt(), le(), lt() и ne().

    Каждый из этих методов по существу обертка для cmp(), который включает соответствующее значение BinaryCondition для параметра condition нужного метода, например, NdbScanFilter::eq() определяется так:

    int eq(int columnId,
           Uint32 value)
    {
      return cmp(BinaryCondition::COND_EQ,
                 columnId,
                 &value, 4);
    }
    

    Типы. Класс NdbScanFilter определяет два публичных типа:

    • BinaryCondition: Тип условия, такой как нижняя или верхняя граница.

    • Group: Логический оператор группировки, такой как AND или OR.

    2.3.28.1. NdbScanFilter::begin()

    Описание. Этот метод используется, чтобы начать комплекс и определяет логический оператор для группировки условий, составляющих комплекс. По умолчанию AND.

    Сигнатура.

    int begin
    (
      Group group = AND
    )
    

    Параметры. Значение Group: одно из AND, OR, NAND или NOR. См. раздел 2.3.28.14.

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.28.2. NdbScanFilter::BinaryCondition

    Описание. Этот тип представляет условие на основе сравнения значения столбца с некоторым произвольным значением, то есть, связанное условие. значение этого типа используется в качестве первого аргумента NdbScanFilter::cmp().

    Возможные значения.

    Таблица 2.59.

    Имя Описание Тип столбца в сравнении
    COND_EQ Равенство (=) Любой
    COND_NE Неравенство (<> or !=) Любой
    COND_LE Нижняя граница (<=) Любой
    COND_LT Строгая нижняя граница (<) Любой
    COND_GE Верхняя граница (>=) Любой
    COND_GT Строгая верхняя граница (>) Любой
    COND_LIKE Выражение LIKE Строчный или двоичный
    COND_NOTLIKE Выражение NOT LIKE Строчный или двоичный
    COL_AND_MASK_EQ_MASK Значение столбца AND битовая маска равно битовой маске BIT
    COL_AND_MASK_NE_MASK Значение столбца AND битовая маска не равно битовой маске BIT
    COL_AND_MASK_EQ_ZERO Значение столбца AND битовая маска равно 0 BIT
    COL_AND_MASK_NE_ZERO Значение столбца AND битовая маска не равно 0 BIT

    Когда используется в сравнениях с COND_EQ, COND_NE, COND_LT, COND_LE, COND_GT или COND_GE, символы фиксированной длины и значения столбцов двоичных данных должны префикс с размером столбца и дополнены по длине. Это не надо для таких значений, когда используется в сравнениях COND_LIKE, COND_NOTLIKE, COL_AND_MASK_EQ_MASK, COL_AND_MASK_NE_MASK, COL_AND_MASK_EQ_ZERO или COL_AND_MASK_NE_ZERO.

    Сравнения строк. Последовательности сравниваются с использованием COND_LIKE и COND_NOTLIKE, это может использовать метасимволы образца % и _. См. раздел 2.3.28.3.

    Сравнение BIT. Сравнивающие BIT операторы это COL_AND_MASK_EQ_MASK, COL_AND_MASK_NE_MASK, COL_AND_MASK_EQ_ZERO и COL_AND_MASK_NE_ZERO. Соответствующие методы доступны для NdbInterpretedCode и NdbOperation, см. раздел 2.3.24.1.8.

    2.3.28.3. NdbScanFilter::cmp()

    Описание. Этот метод используется, чтобы определить сравнение между данным значением и значением колонки. Начиная с NDB 8.0.18, это может также использоваться, чтобы сравнить две колонки. Этот метод на самом деле не выполняет сравнение, которое сделано позже, выполняя просмотр для которого определен этот NdbScanFilter.

    Во многих случаях, где значение, которое будет сравнено, является целым числом, можно вместо этого использовать один из нескольких удобных методов, обеспеченных NdbScanFilter. См. здесь.

    Сигнатура.

    int cmp
    (
      BinaryCondition condition,
      int columnId,
      const void* value,
      Uint32 length = 0
    )
    

    Дополнительно в NDB 8.0.18 и позже:

    int cmp
    (
      BinaryCondition condition,
      int ColumnId1,
      int ColumnId2
    )
    

    Параметры. Когда используется, чтобы сравнить значение с колонкой, этот метод берет следующие параметры:

    • condition: Это представляет условие, которым будет сравнено значение колонки, имеющей идентификатор столбца ID columnID с некоторым произвольным значением. condition это значение BinaryCondition, см. раздел 2.3.28.2.

      Значения condition COND_LIKE или COND_NOTLIKE используются, чтобы сравнить значение столбца с образцом последовательности.

    • columnId: Это идентификатор колонки, который может быть получен, используя метод Column::getColumnNo().

    • value: значение, которое будет сравнено, дается как указатель на void.

      Используя COND_LIKE или COND_NOTLIKE, value рассматривается как образец последовательности. Эта последовательность не должна быть дополнена или использовать префикс. Последовательность value может включать метасимволы образца или wildcard % и _:

      Таблица 2.60.

      Метасимвол Описание
      % Ноль или больше знаков
      _ Точно один символ

      Чтобы соответствовать литералам % или _, используйте наклонную черту влево (\) как символ ESC. Чтобы соответствовать литералу \, используйте \\.

      Это те же самые подстановочные символы, которые поддерживаются SQL LIKE и NOT LIKE и интерпретируются таким же образом. Посмотрите String Comparison Functions and Operators.

    • length: Длина значения, которое будет сравнено. Значение по умолчанию 0. Использование 0 для length имеет тот же самый эффект как сравнение с NULL, это использует метод isnull().

    Когда используется, чтобы сравнить две колонки, cmp() берет следующие параметры:

    • condition: Условие, которое будет проверено, сравнивая колонки. Условие может быть любым из BinaryCondition EQ, NE, LT, LE, GT или GE. Другие значения не приняты.

    • columnID1: ID первого из этих двух столбцов, которые будут сравнены.

    • columnID1: ID второй колонки.

    Колонки, сравниваемые, используя этот метод, должны иметь точно тот же самый тип. Это включает длину, точность, масштаб и все другие подробные сведения.

    Возвращаемое значение. Этот метод возвращает integer: 0 при успехе, -1 при неудаче.

    2.3.28.4. Конструктор NdbScanFilter

    Описание. Это метод конструктора для NdbScanFilter и создает новый экземпляр класса.

    Сигнатура.

    NdbScanFilter
    (
      class NdbOperation* op
    )
    

    Параметры. Этот метод берет единственный параметр, указатель на NdbOperation, к которому применяется фильтр.

    Возвращаемое значение. Новый экземпляр NdbScanFilter.

    Деструктор. Деструктор не берет аргументов и не возвращает значение. Это нужно вызвать, чтобы удалить объект NdbScanFilter, когда это больше не нужно.

    2.3.28.5. NdbScanFilter::end()

    Описание. Этот метод заканчивает комплекс, сигнализируя, что больше нет условий, которые будут добавлены к нему.

    Сигнатура.

    int end
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе или -1 при неудаче.

    2.3.28.6. NdbScanFilter::eq()

    Описание. Этот метод используется, чтобы выполнить тест на равенство значения столбца и целого числа.

    Сигнатура.

    int eq
    (
      int ColId,
      Uint32 value
    )
    

    или

    int eq
    (
      int ColId,
      Uint64 value
    )
    

    Параметры.

    • ID (ColId) колонки, значение которой должно быть проверено

    • integer с которым нужно сравнить значение столбца, это целое число может быть 32 бита или 64 бита и в любом случае unsigned.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.28.7. NdbScanFilter::isfalse()

    Описание. Определяет термин текущей группы как FALSE.

    Сигнатура.

    int isfalse
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.28.8. NdbScanFilter::isnotnull()

    Описание. Этот метод используется, чтобы проверить, не является ли значение столбца NULL.

    Сигнатура.

    int isnotnull
    (
      int ColId
    )
    

    Параметры. ID колонки, значение которой должно быть проверено.

    Возвращаемое значение. 0, если столбец не NULL.

    2.3.28.9. NdbScanFilter::isnull()

    Описание. Этот метод используется, чтобы проверить, является ли значение столбца NULL.

    Сигнатура.

    int isnull
    (
      int ColId
    )
    

    Параметры. ID колонки, значение которой должно быть проверено.

    Возвращаемое значение. 0, если столбец NULL.

    2.3.28.10. NdbScanFilter::istrue()

    Описание. Определяет термин текущей группы как TRUE.

    Сигнатура.

    int istrue
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.28.11. NdbScanFilter::ge()

    Описание. Этот метод используется, чтобы выполнить тест больше чем или равно на значении столбца и целом числе.

    Сигнатура. Этот метод принимает 32-битные и 64-битные значения:

    int ge
    (
      int ColId,
      Uint32 value
    )
    
    int ge
    (
      int ColId,
      Uint64 value
    )
    

    Параметры. Аналогично eq(), lt(), le() и другим методам типа NdbScanFilter, этот метод берет два параметра:

    • ID (ColId) колонки, значение которой должно быть проверено

    • integer с которым нужно сравнить значение столбца, это целое число может составлять 32-bit или 64-bit и всегда unsigned.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.28.12. NdbScanFilter::getNdbError()

    Описание. Поскольку ошибки, с которыми сталкиваются, строя NdbScanFilter не распространяются на вовлеченный объект to any involved NdbOperation, необходимо использовать этот метод, чтобы получить доступ к информации об ошибке.

    Сигнатура.

    const NdbError& getNdbError
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Ссылка на NdbError.

    2.3.28.13. NdbScanFilter::getNdbOperation()

    Описание. Если NdbScanFilter был построен с NdbOperation, этот метод может использоваться, чтобы получить указатель на объект NdbOperation.

    Сигнатура.

    NdbOperation* getNdbOperation
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на NdbOperation, связанный с этим NdbScanFilter, если он есть, иначе NULL.

    2.3.28.14. NdbScanFilter::Group

    Описание. Этот тип используется, чтобы описать логические операторы и используется с методом begin(), см. раздел 2.3.28.1.

    Возможные значения.

    Таблица 2.61.

    Значение Описание
    AND Логический AND: A AND B AND C
    OR Логический OR: A OR B OR C
    NAND Логический NOT AND: NOT (A AND B AND C)
    NOR Логический NOT OR: NOT (A OR B OR C)

    2.3.28.15. NdbScanFilter::gt()

    Описание. Этот метод используется, чтобы выполнить тест больше чем (строгая верхняя граница) на значении столбца и целом числе.

    Сигнатура. Этот метод берет значения 32-bit и 64-bit:

    int gt
    (
      int ColId,
      Uint32 value
    )
    
    int gt
    (
      int ColId,
      Uint64 value
    )
    

    Параметры.

    • ID (ColId) колонки, значение которой должно быть проверено

    • integer с которым можно сравнить значение столбца, это целое число может составлять 32-bit или 64-bit и всегда unsigned.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.28.16. NdbScanFilter::le()

    Описание. Этот метод используется, чтобы выполнить тест меньше чем или равно на значении столбца и целом числе.

    Сигнатура. У этого метода есть два варианта, чтобы обработать 32-битные и 64-битные значения:

    int le
    (
      int ColId,
      Uint32 value
    )
    
    int le
    (
      int ColId,
      Uint64 value
    )
    

    Параметры.

    • ID (ColId) колонки, значение которой должно быть проверено

    • integer с которым нужно сравнить значение столбца, это целое число может составлять 32 бита или 64 бита, в любом случае unsigned.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.28.17. NdbScanFilter::lt()

    Описание. Этот метод используется, чтобы провести тест меньше (строгая нижняя граница) на значении столбца и целом числе.

    Сигнатура.

    int lt
    (
      int ColId,
      Uint32 value
    )
    
    int lt
    (
      int ColId,
      Uint64 value
    )
    

    Параметры.

    • ID (ColId) колонки, значение которой должно быть проверено

    • integer с которым можно сравнить значение столбца, это целое число может составлять 32-bit или 64-bit и unsigned.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.28.18. NdbScanFilter::ne()

    Описание. Этот метод используется, чтобы выполнить тест на неравенство на значении столбца и целом числе.

    Сигнатура.

    int ne
    (
      int ColId,
      Uint32 value
    )
    
    int ne
    (
      int ColId,
      Uint64 value
    )
    

    Параметры.

    • ID (ColId) колонки, значение которой должно быть проверено

    • integer с которым нужно сравнить значение столбца, это целое число может составлять 32 бита или 64 бита и unsigned.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.29. Класс NdbScanOperation

    Резюме

    Эта секция описывает класс NdbScanOperation и его члены класса.

    Родительский класс. NdbOperation.

    Дочерние классы. NdbIndexScanOperation.

    Описание. Класс NdbScanOperation представляет операцию по просмотру, используемую в транзакции. Этот класс наследует NdbOperation.

    Методы.

    Таблица 2.62.

    Имя Описание
    close() Закрывает просмотр
    deleteCurrentTuple() Удаляет текущий кортеж
    lockCurrentTuple() Блокирует текущий кортеж
    nextResult() Получает следующий кортеж
    getNdbTransaction() Получает объект NdbTransaction для этого просмотра
    getPruned() Используемый, чтобы узнать, сокращен ли этот просмотр к единственному разделению
    readTuples() Читает кортежи
    restart() Перезапускает просмотр
    updateCurrentTuple() Обновляет текущий кортеж

    У этого класса нет публичного конструктора. Чтобы создать экземпляр NdbScanOperation, необходимо использовать метод NdbTransaction::getNdbScanOperation().

    Типы. Этот класс определяет единственный публичный тип ScanFlag.

    См. разделы 1.3.2.3.3 и 1.3.2.3.4.

    2.3.29.1. NdbScanOperation::close()

    Описание. Запрос этого метода закрывает просмотр. Строки, возвращенные этим просмотром, больше недоступны после того, как просмотр был закрыт, используя этот метод.

    См. здесь для получения информации о многократных потоках, пытающихся выполнить тот же самый просмотр с монопольной блокировкой и как это может затронуть закрытие просмотров.

    Сигнатура.

    void close
    (
      bool forceSend = false,
      bool releaseOp = false
    )
    

    Параметры.

    • forceSend по умолчанию false, вызывает close() с этим параметром = true, чтобы вынудить транзакции быть посланными.

    • releaseOp по умолчанию false, установите это в true, чтобы выпустить операцию.

      До NDB 7.2.19 и NDB 7.3.8 буфер, ассигнованный NdbScanOperation для получения просмотренных строк не был освобожден до закрытия NdbTransaction, владеющего операцией по просмотру (Bug #75128, Bug #20166585). В этих и последующих версиях кластера NDB буфер освобожден каждый раз, когда курсор, работающий с набором результатов, закрывается, используя метод close(), независимо от значения releaseOp.

    Возвращаемое значение. Нет.

    2.3.29.2. NdbScanOperation::deleteCurrentTuple()

    Описание. Этот метод используется, чтобы удалить текущий кортеж.

    Сигнатура.

    const NdbOperation* deleteCurrentTuple
    (
      NdbTransaction* takeOverTrans,
      const NdbRecord* record,
      char* row = 0,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOpts = 0
    )
    

    См. раздел 2.3.27.

    Параметры. Когда используется с интерфейсом NdbRecord , этот метод берет параметры, перечисленные здесь:

    • Транзакция (takeOverTrans ), которая должна выполнить блокировку, используя NdbRecord с просмотрами, этот параметр не дополнительный.

    • NdbRecord , ссылающийся на просмотр. Это значение record требуется, даже если никакие записи не читаются.

    • Строка row из которой можно читать. Установите это в NULL, если чтение не планируется.

    • Дополнительный указатель mask . Если это присутствует, то просматриваются только колонки, для которых установлен соответствующий бит в маске.

    • OperationOptions (opts) может использоваться, чтобы обеспечить более точный контроль операционных определений. Структура OperationOptions передается с флагами, указывающими, какие операционные варианты определения присутствуют. Не все операционные типы поддерживают все операционные варианты. Опции, поддержанные для каждого типа операции, показываются в следующей таблице:

      Таблица 2.63.

      Операционный тип (метод) Поддержанные флаги OperationOptions
      readTuple() OO_ABORTOPTION, OO_GETVALUE, OO_PARTITION_ID, OO_INTERPRETED
      insertTuple() OO_ABORTOPTION, OO_SETVALUE, OO_PARTITION_ID, OO_ANYVALUE
      updateTuple() OO_ABORTOPTION, OO_SETVALUE, OO_PARTITION_ID, OO_INTERPRETED, OO_ANYVALUE
      writeTuple() OO_ABORTOPTION, OO_SETVALUE, OO_PARTITION_ID, OO_ANYVALUE
      deleteTuple() OO_ABORTOPTION, OO_GETVALUE, OO_PARTITION_ID, OO_INTERPRETED, OO_ANYVALUE

    • Дополнительный параметр sizeOfOptions используется, чтобы сохранить обратную совместимость этого взаимодействия с предыдущими определениями структуры OperationOptions. Если необычный размер обнаружен интерфейсным внедрением, он может использовать это, чтобы определить, как интерпретировать переданную структуру OperationOptions. Чтобы позволить эту функциональность, вызывающий должен передать sizeof(NdbOperation::OperationOptions) для значения этого аргумента.

    • Если варианты определяются, их длина (sizeOfOpts) должна быть определена также.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.29.3. NdbScanOperation::getNdbTransaction()

    Описание. Получает объект NdbTransaction для этого просмотра.

    Сигнатура.

    NdbTransaction* getNdbTransaction
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на объект NdbTransaction.

    2.3.29.4. NdbScanOperation::getPruned()

    Описание. Этот метод используется, чтобы определить, была ли данная операция по просмотру сокращена к единственному разделению. Для просмотров, определенных, используя NdbRecord, getPruned() действительно только после того, как просмотр был выполнен.

    Сигнатура.

    bool getPruned
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. true, если просмотр сокращен к единственному разделению таблицы.

    2.3.29.5. NdbScanOperation::lockCurrentTuple()

    Описание. Этот метод блокирует текущий кортеж.

    Сигнатура. В MySQL 5.1 и позже этот метод можно вызвать с дополнительным единственным параметром любым из этих двух способов:

    NdbOperation* lockCurrentTuple
    (
      void
    )
    
    NdbOperation* lockCurrentTuple
    (
      NdbTransaction* lockTrans
    )
    

    Следующая сигнатура также поддерживается для этого метода, используя NdbRecord :

    NdbOperation *lockCurrentTuple
    (
      NdbTransaction* takeOverTrans,
      const NdbRecord* record,
      char* row = 0,
      const unsigned char* mask = 0
    )
    

    Этот метод также поддерживает определение одного или более OperationOptions (также используя NdbRecord ):

    NdbOperation *lockCurrentTuple
    (
      NdbTransaction* takeOverTrans,
      const NdbRecord* record,
      char* row = 0,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )
    

    Параметры (старый стиль). Этот метод берет единственный дополнительный параметр: транзакцию, которая должна выполнить блокировку. Если это опущено, транзакция текущая.

    Параметры (используя NdbRecord). Используя интерфейс NdbRecord, этот метод берет эти параметры, как описано в следующем списке:

    • Транзакция (takeOverTrans ), которая должна выполнить блокировку, используя NdbRecord с просмотрами, этот параметр не дополнительный.

    • NdbRecord , ссылающийся на просмотр. Это требуется, даже если никакие записи не читаются.

    • Строка row из которой читать. Если чтение не планируется, установите в NULL.

    • Указатель mask дополнительный. Если это присутствует, то просматриваются только колонки, для которых установлен соответствующий бит в маске.

    • opts может взять любое значение из следующих OperationOptions: OO_ABORTOPTION, OO_GETVALUE и OO_ANYVALUE.

    • Если варианты определяются, их длина (sizeOfOptions) должна быть определена также.

    Возвращаемое значение. Этот метод возвращает указатель на объект NdbOperation или NULL.

    2.3.29.6. NdbScanOperation::nextResult()

    Описание. Этот метод используется, чтобы получить следующий кортеж в транзакции просмотра. После каждого вызова nextResult(), буферы и объекты NdbRecAttr , определенные в NdbOperation::getValue(), обновляются с значениями от просмотренного кортежа.

    До NDB 7.2.7: Когда приложение API NDB вызвало этот метод снова после того, как предыдущий вызов возвратил конец файла (код возврата 1), операционный объект был потерян и NDB возвращал -1 (неопределенный) (Bug #11748194). Теперь: Когда nextResult() выполняется после конца файла, NDB вернет код ошибки 4210 (Ndb sent more info than length specified) и дополнительный операционный объект освобожден, возвратив его к неработающему списку для правильного узла TC.

    Сигнатура. Этот метод может быть вызван одним из двух способов. Первый доступен с MySQL 5.1:

    int nextResult
    (
      bool fetchAllowed = true,
      bool forceSend = false
    )
    

    Также возможно использовать этот метод как показано здесь:

    int nextResult
    (
      const char*& outRow,
      bool fetchAllowed = true,
      bool forceSend = false
    )
    

    Параметры (версия с 2 параметрами). Этот метод берет следующие два параметра:

    • Обычно API NDB связывается с ядром NDB для большего количества кортежей каждый раз, когда это необходимо, установка fetchAllowed = false мешает этому происходить.

      Выключение fetchAllowed установкой в false предписывает NDB обработать любые записи, которые это уже имеет в своих кэшах. Ккогда там больше ничего нет, это возвращает 2. Необходимо тогда вызвать nextResult() с fetchAllowed = true, чтобы связаться с NDB для большего количества записей.

      Пока nextResult(false) возвращает 0, необходимо передать запись другой транзакции, используя execute(NdbTransaction::NoCommit). Когда nextResult(false) возвращает 2, необходимо обычно выполнять и передавать другую транзакцию. Это заставляет передать любые блокировки другой транзакции, сделать обновления или удаления, а затем снять блокировки. После этого можно вызвать nextResult(true), чтобы иметь больше записей, полученных и кэшированных в NDB API.

      Если вы не передадите записи другой транзакции, блокировки на них будут выпущены в следующий раз, когда с ядром NDB связываются для большего количества записей.

      Выключение fetchAllowed может быть полезным, когда вы хотите обновить или удалить все записи, полученные в данной транзакции, поскольку выполнение этого экономит время и ускоряет обновления или удаления отсканированных записей.

    • forceSend по умолчанию false и может обычно опускаться. Однако, установка этого параметра в true указывает, которые транзакции немедленно посылают. Посмотрите раздел 1.3.4.

    Параметры (версия с 3 параметрами). Этот метод можно также вызвать со следующими тремя параметрами:

    • Вызов nextResult() устанавливает указатель на следующую строку в outRow (если возвращает 0). Этот указатель действителен (только) до следующего вызова nextResult(), когда fetchAllowed = true. Объект NdbRecord , определяющий формат строки, должен быть определен заранее, используя NdbTransaction::scanTable() (или NdbTransaction::scanIndex().

    • Когда false, fetchAllowed предписывает NDB обработать любые записи, которые это уже имеет в его кэшах. См. описание для этого параметра в предыдущем подразделе.

    • Установка forceSend = true указывает, которые транзакции немедленно посылают, как описано в предыдущем подразделе раздела 1.3.4.

    Возвращаемое значение. Этот метод возвращает одно из следующих 4 integer, интерпретируемых как показано в следующем списке:

    • -1: Указывает, что ошибка произошла.

    • 0: Другой кортеж был получен.

    • 1: Больше нет кортежей, чтобы просмотреть.

    • 2: Больше нет кэшированных записей (вызовите nextResult(true), чтобы получить еще).

    Пример. См. раздел 2.5.4.

    2.3.29.7. NdbScanOperation::readTuples()

    Описание. Этот метод используется, чтобы выполнить просмотр.

    Сигнатура.

    virtual int readTuples
    (
      LockMode mode = LM_Read,
      Uint32 flags = 0,
      Uint32 parallel = 0,
      Uint32 batch = 0
    )
    

    Параметры.

    • Режим блокировки mode, это значение LockMode.

      Просмотры с монопольными блокировками. Просматривая с монопольной блокировкой, нужно соблюдать аккуратность вследствие того, что, если два потока выполняют этот просмотр одновременно в том же самом диапазоне, то есть значительная вероятность порождения мертвой блокировки. Вероятность мертвой блокировки увеличена, если просмотр также упорядочен (то есть, используя SF_OrderBy или SF_Descending).

      Метод NdbScanOperation::close() также затронут этой мертвой блокировкой, так как все выдающиеся запросы обслуживаются, прежде чем просмотр на самом деле закрывается.

    • Одно или более значений ScanFlag. Многократные значения соединяются OR.

    • Количество фрагментов, чтобы просмотреть в parallel, 0 означает максимальное возможное число, которое будет использоваться.

    • Параметр batch определяет, сколько записей будет возвращено клиенту от сервера следующим NdbScanOperation::nextResult(true). 0 предписывает определить максимум автоматически.

      Этот параметр был проигнорирован до MySQL 5.1.12, использовался максимум (Bug #20252).

    Возвращаемое значение. 0 при успехе, -1 при ошибке.

    2.3.29.8. NdbScanOperation::restart()

    Описание. Используйте этот метод, чтобы перезапустить просмотр, не изменяя ни одного из вызовов getValue() или условий поиска.

    Сигнатура.

    int restart
    (
      bool forceSend = false
    )
    

    Параметры. Вызовите этот метод с forceSend = true, чтобы вынудить транзакцию быть посланной.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.29.9. NdbScanOperation::ScanFlag

    Описание. Значения этого типа флаги просмотра, используемые с методом readTuples(). Больше чем один может использоваться, в этом случае, они объединены OR как второй аргумент метода. Посмотрите раздел 2.3.29.7.

    Возможные значения.

    Таблица 2.64.

    Значение Описание
    SF_TupScan Просмотр в порядке TUP (то есть, в порядке строк в памяти). Относится только к сканированию таблицы.
    SF_DiskScan Просмотр в дисковом порядке (порядок строк на диске). Относится только к сканированию таблицы.
    SF_OrderBy

    Упорядоченный просмотр индекса (возрастание), строки, возвращенные из просмотра индекса, сортированы по ключу индекса. Просмотры в порядке по возрастанию или в порядке по убыванию затронуты этим флагом, который заставляет API выполнять сортировку слиянием среди упорядоченных просмотров каждого фрагмента, чтобы получить единственный сортированный набор результатов.

    Примечания:

    • Упорядоченные индексы распределяются с одним упорядоченным индексом для каждого фрагмента таблицы.

    • Просмотры диапазона часто параллельны через все фрагменты индекса. Иногда они могут быть сокращены к одному фрагменту индекса.

    • Каждый просмотр диапазона фрагмента индекса может возвратить результаты в порядке по возрастанию или в порядке по убыванию. Возрастание это умолчание, чтобы выбрать порядок по убыванию, установите флаг SF_Descending.

    • Когда многократные фрагменты индекса просматриваются параллельно, результаты передают обратно в NDB, где они могут произвольно быть сортированы слиянием прежде чем быть возвращенным пользователю. Этой сортировкой слияния управляют, используя флаги SF_OrderBy и SF_OrderByFull.

    • Если не используются SF_OrderBy или SF_OrderByFull, результаты каждого фрагмента индекса в определенном порядке (возрастание или убывание), но результаты различных фрагментов могут быть чередованы.

    • Используя SF_OrderBy или SF_OrderByFull, некоторые дополнительные ограничения наложены внутренне, они перечисляются здесь:

      1. Если просмотр диапазона не сокращен к одному фрагменту индекса, все фрагменты индекса должны быть просмотрены параллельно. Неупорядоченный просмотр может быть выполнен с менее чем полным параллелизмом.

      2. Следствия каждого фрагмента индекса должны быть доступными прежде, чем возвратить любые строки, чтобы гарантировать правильную сортировку слиянием. Это преобразовывает в последовательную форму прокуртку просмотра, потенциально приводящую к более низкой пропускной способности строки.

      3. Неупорядоченные просмотры могут возвратить строки клиенту API, прежде чем все фрагменты индекса возвратили любые пакеты и могут наложиться на запросы следующего пакета с обработкой строки.

    SF_OrderByFull Аналог SF_OrderBy за исключением того, что все столбцы ключа добавляются автоматически к битовой маске чтения.
    SF_Descending Заставляет упорядоченный просмотр индекса быть выполненным в порядке убывания.
    SF_ReadRangeNo Для просмотров индекса, когда этот флаг установлен, NdbIndexScanOperation::get_range_no() может быть вызван, чтобы читать назад range_no, определенный в NdbIndexScanOperation::setBound(). Кроме того, когда этот флаг установлен, и SF_OrderBy или SF_OrderByFull также установлен, результаты из диапазонов, возвращены в их полноте, прежде чем любые результаты будут возвращены из поддиапазонов.
    SF_MultiRange Указывает, что этот просмотр это часть просмотра мультидиапазона, каждый диапазон просматривается отдельно.
    SF_KeyInfo Предписывает передать обратно KeyInfo. Это позволяет опции принять блокировку строки, взятую просмотром, используя lockCurrentTuple(), удостоверяясь то, что ядро передает информацию обратно, чтобы определить строку и блоикировку. Этот флаг позволен по умолчанию для использования просмотров LM_Exclusive, но должен быть явно определен, чтобы позволить блокировки LM_Read. См. LockMode.

    2.3.29.10. NdbScanOperation::updateCurrentTuple()

    Описание. Этот метод используется, чтобы обновить текущий кортеж.

    Сигнатура. Первоначально, этот метод можно было вызвать с одним дополнительным параметром, любым из способов, показанных здесь:

    NdbOperation* updateCurrentTuple
    (
      void
    )
    
    NdbOperation* updateCurrentTuple
    (
      NdbTransaction* updateTrans
    )
    

    Также возможно использовать этот метод, используя NdbRecord с просмотрами:

    NdbOperation* updateCurrentTuple
    (
      NdbTransaction* takeOverTrans,
      const NdbRecord* record,
      const char* row,
      const unsigned char* mask = 0
    )
    

    См. раздел 2.3.27.

    (Оригинальные) параметры. Этот метод берет единственный дополнительный параметр: транзакцию, которая должна выполнить блокировку. Если это опущено, транзакция текущая.

    Параметры (используя NdbRecord). Используя интерфейс NdbRecord, этот метод берет следующие параметры, как описано в следующем списке:

    • Транзакция (takeOverTrans ).

    • Запись record (объект NdbRecord ), ссылка на колонку используется для просмотра.

    • Строка для чтения row. Если никакие признаки не должны быть прочитаны, установите это в NULL.

    • Указатель mask дополнительный. Если это присутствует, то читаются только колонки, для которых установлен соответствующий бит в маске.

    Возвращаемое значение. Этот метод возвращает объект NdbOperation или NULL.

    2.3.30. Класс NdbTransaction

    Резюме

    Эта секция описывает класс NdbTransaction и его публичные члены.

    Родительский класс. Нет.

    Дочерние классы. Нет.

    Описание. Транзакция представляется в API NDB объектом NdbTransaction, который принадлежит объекту Ndb и создается, используя Ndb::startTransaction(). Транзакция состоит из списка операций, представленных классом NdbOperation или одним из его подклассов: NdbScanOperation, NdbIndexOperation или NdbIndexScanOperation. Каждый операционный доступ обрабатывает точно одну таблицу.

    Используя транзакции. После получения объекта NdbTransaction это используется следующим образом:

    1. Операция ассигнуется транзакцией, используя любой из следующих методов:

      • getNdbOperation()

      • getNdbScanOperation()

      • getNdbIndexOperation()

      • getNdbIndexScanOperation()

      Запрос одного из этих методов определяет операцию. Несколько операций могут быть определены на том же самом объекте NdbTransaction, в этом случае они выполняются параллельно. Когда все операции определяются, метод execute() посылает их в ядро NDB на выполнение.

    2. Метод execute() возвращается когда ядро NDB закончило выполнение всех ранее определенных операций.

      Все ассигнованные операции должны быть правильно определены до вызова метода execute().

    3. execute() работает в одном из этих трех режимов:

      • NdbTransaction::NoCommit: Выполняет операции, не передавая их.

      • NdbTransaction::Commit: Выполняет любую остающуюся операцию и затем передает завершенную транзакцию.

      • NdbTransaction::Rollback: Отменяет всю транзакцию.

      execute() также оборудован дополнительным параметром обработки ошибок, который обеспечивает эти две альтернативы:

      • NdbOperation::AbortOnError: Любая ошибка заставляет транзакцию быть прерванной. Это поведение по умолчанию.

      • NdbOperation::AO_IgnoreError: Транзакция продолжает выполняться, даже если одна или больше операций, определенных для той транзакции, терпит неудачу.

      В MySQL 5.1.15 и ранее, эти значения были NdbTransaction::AbortOnError и NdbTransaction::AO_IgnoreError.

    Методы.

    Таблица 2.65.

    Имя Описание
    close() Закрывает транзакцию
    commitStatus() Получает статус передачи транзакции
    deleteTuple() Удалите кортеж, используя NdbRecord
    execute() Выполняет транзакцию
    executePendingBlobOps() Выполняет транзакцию в режиме NoCommit, если это включает какие-либо операции по части blob указанных типов, которые еще не выполняются
    getGCI() Получает ID глобальной контрольной точки (GCI) транзакции
    getMaxPendingBlobReadBytes() Получает текущий пакетный размер чтения BLOB
    getMaxPendingBlobWriteBytes() Получает текущий пакетный размер записи BLOB
    getNdbError() Получает новую ошибку
    getNdbErrorLine() Получает номер строки, где новая ошибка произошла
    getNdbErrorOperation() Получает новую операцию, которая вызвала ошибку
    getNextCompletedOperation() Получает операции, которые были выполнены, используется для нахождения ошибок
    getNdbOperation() Получает NdbOperation
    getNdbScanOperation() Получает NdbScanOperation
    getNdbIndexOperation() Получает NdbIndexOperation
    getNdbIndexScanOperation() Получает NdbIndexScanOperation
    getTransactionId() Получает ID транзакции
    insertTuple() Вставьте кортеж, используя NdbRecord
    readTuple() Прочитайте кортеж, используя NdbRecord
    refresh() Защищает транзакцию от тайм-аута
    releaseLockHandle() Освободите объект NdbLockHandle как только это больше не нужно
    scanIndex() Выполните просмотр индекса, используя NdbRecord
    scanTable() Выполните просмотр таблицы, используя NdbRecord
    setMaxPendingBlobReadBytes() Установить размер пакета чтения BLOB
    setMaxPendingBlobWriteBytes() Установить размер пакета записи BLOB
    setSchemaObjectOwnerChecks() Включить или отключить проверку собственности объекта схемы
    unlock() Создайте операцию разблокировки на текущей транзакции
    updateTuple() Обновите кортеж, используя NdbRecord
    writeTuple() Записать кортеж, используя NdbRecord

    Методы readTuple(), insertTuple(), updateTuple(), writeTuple(), deleteTuple(), scanTable() и scanIndex() требуют использования NdbRecord .

    Типы. NdbTransaction определяет 2 публичных типа:

    Таблица 2.66.

    Имя Описание
    CommitStatusType() Описывает статус передачи транзакции
    ExecType() Определяет, должна ли транзакция быть передана или отменена

    2.3.30.1. NdbTransaction::close()

    Описание. Этот метод закрывает транзакцию. Это эквивалентно запросу Ndb::closeTransaction().

    Если транзакция еще не была передана, она прерывается, когда этот метод вызывают. Посмотрите раздел 2.3.16.35.

    Сигнатура.

    void close
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Нет.

    2.3.30.2. NdbTransaction::commitStatus()

    Описание. Этот метод получает статус передачи транзакции.

    Сигнатура.

    CommitStatusType commitStatus
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Значение CommitStatusType, см. раздел 2.3.30.3.

    2.3.30.3. NdbTransaction::CommitStatusType

    Описание. Этот тип используется, чтобы описать статус передачи транзакции.

    Возможные значения.

    Таблица 2.67.

    Имя Описание
    NotStarted Транзакция еще не была начата.
    Started Транзакция началась, но еще не передается.
    Committed Транзакция закончилась и была передана.
    Aborted Транзакция была прервана.
    NeedAbort Транзакция столкнулась с ошибкой, но еще не была прервана.

    Статус передачи транзакции можно прочитать с помощью метода commitStatus(), см. раздел 2.3.30.2.

    2.3.30.4. NdbTransaction::deleteTuple()

    Описание. Удаляет кортеж с использованием NdbRecord .

    Сигнатура.

    const NdbOperation* deleteTuple
    (
      const NdbRecord* key_rec,
      const char* key_row,
      const NdbRecord* result_rec,
      char* result_row,
      const unsigned char* result_mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )
    

    Параметры.

    • key_rec указатель на NdbRecord для таблицы или для индекса. Если на таблицу, то операция использует первичный ключ, если на индекс, то операция использует уникальный ключ. В любом случае key_rec должен включать все колонки ключа.

    • key_row переданный к этому методу определяет первичный или уникальный ключ кортежа, который будет удален и должен остаться действительным до вызова execute().

    • result_rec это используемый NdbRecord .

    • result_row может быть NULL, если никакие признаки не должны быть возвращены.

    • result_mask, если не NULL, определяет подмножество признаков, которые будут прочитаны и возвращены клиенту. Маска копируется и не должна оставаться действительной после вызова этого метода.

    • OperationOptions (opts) может использоваться, чтобы обеспечить более точный контроль операционных определений. Структура OperationOptions передается с флагами, указывающими, какие операционные варианты определения присутствуют. Не все операционные типы поддерживают все операционные варианты, для перечня вариантов, поддержанных каждым типом операции, посмотрите раздел 2.3.30.21.

    • Дополнительный параметр sizeOfOptions предоставляет обратную совместимость этого взаимодействия с предыдущими определениями структуры OperationOptions. Если необычный размер обнаружен интерфейсным внедрением, он может использовать это, чтобы определить, как интерпретировать переданную структуру OperationOptions. Чтобы позволить эту функциональность, вызывающий должен передать sizeof(NdbOperation::OperationOptions) для значения этого аргумента.

    Возвращаемое значение. const указатель на NdbOperation представление этой операции записи. Операция может быть проверена при необходимости.

    2.3.30.5. NdbTransaction::ExecType

    Описание. Этот тип устанавливает тип выполнения транзакции, то есть, должно ли это выполнить, выполнить и передать или аварийно завершить работу. Это применяется в качестве параметра метода execute(), см. раздел 2.3.30.6.

    Возможные значения.

    Таблица 2.68.

    Имя Описание
    NoCommit Транзакция должна выполнить, но не передать.
    Commit Транзакция должна выполнить и быть передана.
    Rollback Транзакция должна быть отменена.

    2.3.30.6. NdbTransaction::execute()

    Описание. Этот метод используется, чтобы выполнить транзакцию.

    Сигнатура.

    int execute
    (
      ExecType execType,
      NdbOperation::AbortOption abortOption = NdbOperation::DefaultAbortOption,
      int force = 0
    )
    

    Параметры.

    • Тип выполнения (ExecType), см. раздел 2.3.30.5.

    • Выбор аварийного прекращения работы ( NdbOperation::AbortOption).

      Ошибки, являющиеся результатом этого метода, найдены с NdbOperation::getNdbError(), а не с NdbTransaction::getNdbError().

    • Параметр force, который определяет, когда операции нужно послать в ядро NDB. Возможные значения:

      • 0: Обнаружить адаптивным алгоритмом.

      • 1: Принудительно, определить адаптивным алгоритмом.

      • 2: Не принудительно, не определять адаптивным алгоритмом.

      См. раздел 1.3.4.

    Возвращаемое значение. 0 при успехе, -1 при неудаче. То, что транзакция не прерывалась, не обязательно означает, что каждая операция была успешна, необходимо проверить каждую операцию индивидуально на ошибки.

    В MySQL 5.1.15 и более ранних версиях этот метод вернет -1 для некоторых ошибок, даже когда сама транзакция не была прервана. Начиная с MySQL 5.1.16, этот метод сообщает о неудаче если и только если транзакция была прервана. Это изменение было внесено из-за того, что было возможно построить случаи, где не было никакого способа определить, была ли транзакция на самом деле прервана. Однако, информация об ошибке транзакции все еще пытается в таких случаях отразить фактический код ошибки и категорию.

    Это означает в случае, где ошибка NoDataFound возможна, необходимо теперь проверить на нее явно, как показано в этом примере:

    Ndb_cluster_connection myConnection;
    if (myConnection.connect(4, 5, 1))
    {
       cout << "Unable to connect to cluster within 30 secs." << endl;
       exit(-1);
    }
    
    Ndb myNdb(&myConnection, "test");
    //define operations...
    myTransaction = myNdb->startTransaction();
    if (myTransaction->getNdbError().classification == NdbError:NoDataFound)
    {
       cout << "No records found." << endl;
       //...
    }
    myNdb->closeTransaction(myTransaction);
    

    2.3.30.7. NdbTransaction::executePendingBlobOps()

    Описание. Этот метод выполняет транзакцию с ExecType=NoCommit , если там остаются какими-либо операциями по части blob данных типов, которые еще не были выполнены.

    Сигнатура.

    int executePendingBlobOps
    (
      Uint8 flags = 0xFF
    )
    

    Параметры. flags результат побитового OR, равный 1 << optype, где optype это NdbOperation::Type. Умолчание соответствует PrimaryKeyAccess.

    Возвращаемое значение. 0 при успехе, -1 при неудаче. То, что транзакция не прерывалась, не обязательно означает, что каждая операция была успешна, необходимо проверить каждую операцию индивидуально на ошибки.

    2.3.30.8. NdbTransaction::getGCI()

    Описание. Этот метод получает ID глобальной контрольной точки (GCI) транзакции.

    Каждая переданная транзакция принадлежит GCI. Регистрация для переданной транзакции сохранена яна диске, когда глобальная контрольная точка происходит.

    Сравнивая GCI транзакции с значением последнего GCI в перезапущенном NDB Cluster, можно определить, была ли транзакция восстановлена.

    Была ли глобальная контрольная точка с этим GCI сохранена на диске, не может быть определено этим методом.

    GCI для транзакции просмотра не определен, так как никакие обновления не выполняются в транзакциях просмотра.

    Сигнатура.

    int getGCI
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. GCI транзакции или -1, если ни один недоступен.

    Никакой GCI не доступен до execute() с ExecType::Commit.

    2.3.30.9. NdbTransaction::getMaxPendingBlobReadBytes()

    Описание. Получает текущий пакетный размер в байтах для операций чтения BLOB. Когда объем данных volume of BLOB, которые будут прочитаны в данной транзакции, превышает этот размер, все операции чтения в транзакции выполняются.

    Сигнатура.

    Uint32 getMaxPendingBlobReadBytes
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Текущий пакетный размер в байтах. См. раздел 2.3.30.26.

    2.3.30.10. NdbTransaction::getMaxPendingBlobWriteBytes()

    Описание. Получает текущий пакетный размер в байтах для операции записи BLOB. Когда объем данных BLOB, которые будут написаны в данной транзакции, превышает это значение, все операции записи в транзакции выполняются.

    Сигнатура.

    Uint32 getMaxPendingBlobWriteBytes
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Текущий пакетный размер в байтах. Посмотрите раздел 2.3.30.27.

    2.3.30.11. NdbTransaction::getNdbError()

    Описание. Этот метод используется, чтобы получить новую ошибку (NdbError ).

    Сигнатура.

    const NdbError& getNdbError
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Ссылка на объект NdbError.

    См. раздел 1.3.2.3.6.

    2.3.30.12. NdbTransaction::getNdbErrorLine()

    Описание. Этот метод возвращает номер строки, где новая ошибка произошла.

    Сигнатура.

    int getNdbErrorLine
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Номер строки новой ошибки.

    Для получения дополнительной информации об ошибках из-за неправильного обращения в транзакциях посмотрите раздел 1.3.2.3.6.

    2.3.30.13. NdbTransaction::getNdbErrorOperation()

    Описание. Этот метод получает операцию, которая вызвала ошибку.

    Чтобы получить больше информации о фактической ошибке, используйте метод NdbOperation::getNdbError() объекта NdbOperation, возвращенного getNdbErrorOperation().

    Сигнатура.

    NdbOperation* getNdbErrorOperation
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на NdbOperation.

    Для получения дополнительной информации об ошибках из-за неправильного обращения в транзакциях посмотрите раздел 1.3.2.3.6.

    2.3.30.14. NdbTransaction::getNdbIndexOperation()

    Описание. Этот метод используется, чтобы создать NdbIndexOperation, связанный с данной таблицей.

    Все операции по индексу в той же самой транзакции должны быть инициализированы с этим методом. Операции должны быть определены, прежде чем они будут выполнены.

    Сигнатура.

    NdbIndexOperation* getNdbIndexOperation
    (
      const NdbDictionary::Index* index
    )
    

    Параметры. Объект Index, на котором должна быть выполнена операция.

    Возвращаемое значение. Указатель на новый NdbIndexOperation.

    2.3.30.15. NdbTransaction::getNdbIndexScanOperation()

    Описание. Этот метод используется, чтобы создать NdbIndexScanOperation, связанный с данной таблицей.

    Все операции по просмотру индекса в той же самой транзакции должны быть инициализированы с этим методом. Операции должны быть определены, прежде чем они будут выполнены.

    Сигнатура.

    NdbIndexScanOperation* getNdbIndexScanOperation
    (
      const NdbDictionary::Index* index
    )
    

    Параметры. Объект Index, на котором должна быть выполнена операция.

    Возвращаемое значение. Указатель на новый NdbIndexScanOperation.

    2.3.30.16. NdbTransaction::getNdbOperation()

    Описание. Этот метод используется, чтобы создать NdbOperation, связанный с данной таблицей.

    Все операции в той же самой транзакции должны быть инициализированы с этим методом. Операции должны быть определены, прежде чем они будут выполнены.

    Сигнатура.

    NdbOperation* getNdbOperation
    (
      const NdbDictionary::Table* table
    )
    

    Параметры. Объект Table, на котором должна быть выполнена операция.

    Возвращаемое значение. Указатель на новый NdbOperation.

    2.3.30.17. NdbTransaction::getNdbScanOperation()

    Описание. Этот метод используется, чтобы создать NdbScanOperation, связанный с данной таблицей.

    Все операции по просмотру в той же самой транзакции должны быть инициализированы с этим методом. Операции должны быть определены, прежде чем они будут выполнены.

    Сигнатура.

    NdbScanOperation* getNdbScanOperation
    (
      const NdbDictionary::Table* table
    )
    

    Параметры. Объект Table, на котором должна быть выполнена операция.

    Возвращаемое значение. Указатель на новый NdbScanOperation.

    2.3.30.18. NdbTransaction::getNextCompletedOperation()

    Описание. Этот метод используется, чтобы получить законченные действия транзакции. Это, как правило, используется, чтобы получить все операции, принадлежащие данной транзакции, чтобы проверить ошибки.

    NdbTransaction::getNextCompletedOperation(NULL) возвращает транзакции первого объекта NdbOperation, NdbTransaction::getNextCompletedOperation( myOp) возвращает объект NdbOperation, определенный после NdbOperation myOp.

    Этот метод должен использоваться только после того, как транзакция была выполнена, но прежде чем транзакция была закрыта.

    Сигнатура.

    const NdbOperation* getNextCompletedOperation
    (
      const NdbOperation* op
    ) const
    

    Параметры. Этот метод требует единственный параметр op, который является операцией (объект NdbOperation) или NULL.

    Возвращаемое значение. Операция после op или первая операция, определенная для транзакции, если getNextCompletedOperation() был вызван, используя NULL.

    2.3.30.19. NdbTransaction::getTransactionId()

    Описание. Этот метод используется, чтобы получить ID транзакции.

    Сигнатура.

    Uint64 getTransactionId
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. ID транзакции как unsigned 64-bit integer.

    2.3.30.20. NdbTransaction::insertTuple()

    Описание. Вставляет кортеж с использованием NdbRecord.

    Сигнатура.

    const NdbOperation* insertTuple
    (
      const NdbRecord* key_rec,
      const char* key_row,
      const NdbRecord* attr_rec,
      const char* attr_row,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )
    
    const NdbOperation* insertTuple
    (
      const NdbRecord* combined_rec,
      const char* combined_row,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )
    

    Параметры.

    • Указатель на NdbRecord, показывающий запись (key_rec) для вставки.

    • Строка (key_row) данных, которые будут вставлены.

    • Указатель на NdbRecord с признаком (attr_rec) для вставки.

    • Строка (attr_row) данных, которые будут вставлены как признак.

    • Маска mask, которая может использоваться, чтобы отфильтровать колонки, которые будут вставлены.

    • OperationOptions (opts) может использоваться, чтобы обеспечить более точный контроль операционных определений. Структура OperationOptions передается с флагами, указывающими, какие операционные варианты определения присутствуют. Не все операционные типы поддерживают все операционные варианты, для перечня вариантов, поддержанных каждым типом операции, посмотрите раздел 2.3.30.21.

    • Дополнительный параметр sizeOfOptions используется, чтобы сохранить обратную совместимость этого взаимодействия с предыдущими определениями структуры OperationOptions. Если необычный размер обнаружен интерфейсным внедрением, он может использовать это, чтобы определить, как интерпретировать переданную структуру OperationOptions. Чтобы позволить эту функциональность, вызывающий должен передать sizeof(NdbOperation::OperationOptions) для значения этого аргумента.

    Этот метод можно также вызвать, используя одиночный указатель NdbRecord и одиночный char (combined_rec, combined_row), где NdbRecord представляет признак и данные.

    Возвращаемое значение. const указатель на NdbOperation представление этой операции по вставке.

    2.3.30.21. NdbTransaction::readTuple()

    Описание. Этот метод читает кортеж с использованием объектов NdbRecord .

    Сигнатура.

    const NdbOperation* readTuple
    (
      const NdbRecord* key_rec,
      const char* key_row,
      const NdbRecord* result_rec,
      char* result_row,
      NdbOperation::LockMode lock_mode = NdbOperation::LM_Read,
      const unsigned char* result_mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )
    

    Параметры.

    • key_rec указатель на NdbRecord для таблицы или для индекса. Если на таблицу, то операция использует первичный ключ, если на индекс, то операция использует уникальный ключ. В любом случае key_rec должен включать все колонки ключа.

    • key_row переданный этому методу определяет первичный или уникальный ключ затронутого кортежа и должен остаться действительным до execute().

      Маска, если не NULL, определяет подмножество признаков, чтобы прочитать, обновить или вставить. Только если (mask[attrId >> 3] & (1<<( attrId & 7))) установлена, обрабатывается столбец. Маска копируется методами, так что не должна оставаться действительной после вызова.

    • result_rec указатель на NdbRecord используемый, чтобы хранить результат.

    • result_row определяет буфер для данных о результате.

    • lock_mode определяет способ блокировки для операции. Посмотрите раздел 2.3.25.15.

    • result_mask определяет подмножество признаков, чтобы читать. Только если mask[attrId >> 3] & (1<<(attrId & 7)) установлены читается весь столбец. Маска копируется и не должна оставаться действительной после вызова метода.

    • OperationOptions (opts) может использоваться, чтобы обеспечить более точный контроль операционных определений. Структура OperationOptions передается с флагами, указывающими, какие операционные варианты определения присутствуют. Не все операционные типы поддерживают все операционные варианты, опции, поддержанные для каждого типа операции, показываются в следующей таблице:

      Таблица 2.69.

      Операционный тип (метод) Поддержанные флаги OperationOptions
      readTuple() OO_ABORTOPTION, OO_GETVALUE, OO_PARTITION_ID, OO_INTERPRETED
      insertTuple() OO_ABORTOPTION, OO_SETVALUE, OO_PARTITION_ID, OO_ANYVALUE
      updateTuple() OO_ABORTOPTION, OO_SETVALUE, OO_PARTITION_ID, OO_INTERPRETED, OO_ANYVALUE
      writeTuple() OO_ABORTOPTION, OO_SETVALUE, OO_PARTITION_ID, OO_ANYVALUE
      deleteTuple() OO_ABORTOPTION, OO_GETVALUE, OO_PARTITION_ID, OO_INTERPRETED, OO_ANYVALUE

    • Дополнительный параметр sizeOfOptions используется, чтобы сохранить обратную совместимость этого взаимодействия с предыдущими определениями структуры OperationOptions. Если необычный размер обнаружен интерфейсным внедрением, он может использовать это, чтобы определить, как интерпретировать переданную структуру OperationOptions. Чтобы позволить эту функциональность, надо передать sizeof(NdbOperation::OperationOptions) для значения этого аргумента.

    Возвращаемое значение. Указатель на NdbOperation представление этой операции чтения (это может использоваться, чтобы проверить ошибки).

    2.3.30.22. NdbTransaction::refresh()

    Описание. Этот метод обновляет тайм-аут транзакции и таким образом избегает прерывания из-за тайм-аута транзакции.

    Нежелательно взять блокировку на записи и поддержать ее в течение расширенного времени, так как это может повлиять на другие транзакции.

    Сигнатура.

    int refresh
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. 0 при успехе, -1 при неудаче.

    2.3.30.23. NdbTransaction::releaseLockHandle()

    Описание. Этот метод используется, чтобы выпустить обработчик блокировки (см. раздел 2.3.25.5), когда это больше не требуется. Для NdbRecord операции чтения первичного ключа это нельзя вызвать, пока связанная операция чтения не была выполнена.

    Все обработчики блокировки, связанные с данной транзакцией, сняты, когда транзакция закрыта.

    Сигнатура.

    int releaseLockHandle
    (
      const NdbLockHandle* lockHandle
    )
    

    Параметры. Объект NdbLockHandle для освобождения.

    Возвращаемое значение. 0 при успехе.

    2.3.30.24. NdbTransaction::scanIndex()

    Описание. Выполните просмотр диапазона индекса таблицы с необязательным упорядочиванием.

    Сигнатура.

    NdbIndexScanOperation* scanIndex
    (
      const NdbRecord* key_record,
      const NdbRecord* result_record,
      NdbOperation::LockMode lock_mode = NdbOperation::LM_Read,
      const unsigned char* result_mask = 0,
      const NdbIndexScanOperation::IndexBound* bound = 0,
      const NdbScanOperation::ScanOptions* options = 0,
      Uint32 sizeOfOptions = 0
    )
    

    Параметры. key_record описывает индекс, который будет просмотрен. Это должна быть запись ключа для индекса, то есть, это должно определить, как минимум, все столбцы ключа индекса. key_record должен быть создан из индекса, который будет просмотрен (а не из базовой таблицы).

    result_record описывает строки, которые будут возвращены из просмотра. Для упорядоченного просмотра индекса result_record должна быть записью ключа для индекса, который будет просмотрен, то есть это должно включать (как минимум) все колонки в индексе (полный ключ индекса необходим API NDB для сортировки упорядоченных строк, возвращенных из каждого фрагмента).

    Подобно key_record, result_record должен быть создан из базовой таблицы, а не из индекса, который будет просмотрен. Оба key_record и result_record структуры NdbRecord должны остаться на месте, пока операция по просмотру не закрывается.

    IndexBound может быть определен или в этом запросе или в отдельном запросе NdbIndexScanOperation::setBound(). Чтобы выполнить мультидиапазонное чтение, scan_flags в структуре ScanOptions должно включать SF_MULTIRANGE. Дополнительные границы могут быть добавлены, используя последовательные вызовы NdbIndexScanOperation::setBound().

    Чтобы определить равенство связанному, используйте тот же самый указатель строки для low_key и high_key с установленными низким и высоким битами.

    Чтобы определить дополнительные опции, передайте структуру ScanOptions.

    sizeOfOptions существует, чтобы позволить обратную совместимость для этого интерфейса. Этот параметр указывает на размер структуры ScanOptions во время сборки клиента и позволяет обнаружение использования в старинном стиле структуры ScanOptions. Если эта функциональность не требуется, этот аргумент можно оставить установленным в 0.

    Для просмотров мультидиапазона указатели low_key и high_key должны быть уникальными. Другими словами, недопустимо снова использовать тот же самый буфер строк для нескольких различных границ диапазона в рамках единственного просмотра. Однако допустимо использовать тот же самый указатель строки как low_key и high_key, чтобы определить равенство границ, также допустимо снова использовать строки после вызова scanIndex() то есть, они не должны оставаться действительными до execute() (в отличие от указателей NdbRecord).

    Возвращаемое значение. Текущий NdbIndexScanOperation, который может использоваться для проверки на ошибки.

    2.3.30.25. NdbTransaction::scanTable()

    Описание. Этот метод выполняет сканирование таблицы, используя объект NdbRecord, чтобы читать данные столбца.

    Сигнатура.

    NdbScanOperation* scanTable
    (
      const NdbRecord* result_record,
      NdbOperation::LockMode lock_mode = NdbOperation::LM_Read,
      const unsigned char* result_mask = 0,
      Uint32 scan_flags = 0,
      Uint32 parallel = 0,
      Uint32 batch = 0
    )
    

    Параметры.

    • Указатель на NdbRecord для хранения результата. Этот result_record должен остаться действительным до окончания execute().

    • lock_mode для операции. Посмотрите раздел 2.3.25.15.

    • Опциональный указатель result_mask . Если это существует, только колонки для которых соответствующий бит (в порядке признаков ID order) в result_mask установлен, применяются в просмотре. result_mask копируется внутренне, таким образом, в отличие от result_record не должен быть действительным, когда вызывается execute().

    • scan_flags может использоваться, чтобы определить порядок и условия сортировки для просмотров. Посмотрите раздел 2.3.29.9.

    • parallel желаемый параллелизм или 0 для максимального параллелизма (получающий строки от всех фрагментов параллельно), который является умолчанием.

    • batch определяет, используется ли пакетированием. По умолчанию 0 (нет).

    Возвращаемое значение. Указатель на NdbScanOperation представление этого просмотра. Операция может быть проверена при необходимости.

    2.3.30.26. NdbTransaction::setMaxPendingBlobReadBytes()

    Описание. Устанавливает пакетный размер в байтах для операции чтения BLOB. Когда объем данных BLOB, которые будут прочитаны в данной транзакции, превышает этот размер, все операции чтения в транзакции выполняются.

    Сигнатура.

    void setMaxPendingBlobReadBytes
    (
      Uint32 bytes
    )
    

    Параметры. Пакетный размер, как количество байт bytes. Используя 0 можно выключить пакетное чтение BLOB, что является поведением по умолчанию (для обратной совместимости).

    Возвращаемое значение. Нет.

    Пакетным чтением BLOB можно также управлять в клиенте mysql и другом клиентском приложении MySQL, используя опцию MySQL Server --ndb-blob-read-batch-bytes и связанные системные переменные MySQL Server.

    2.3.30.27. NdbTransaction::setMaxPendingBlobWriteBytes()

    Описание. Устанавливает пакетный размер в байтах для операции записи BLOB. Когда объем данных volume of BLOB, которые будут записаны в данной транзакции, превышает этот размер, все операции записи в транзакции выполняются.

    Сигнатура.

    void setMaxPendingBlobWriteBytes
    (
      Uint32 bytes
    )
    

    Параметры. Пакетный размер, как количество байт bytes. Используя 0 можно выключить пакетную запись BLOB, что является поведением по умолчанию (для обратной совместимости).

    Возвращаемое значение. Нет.

    Пакетной записью BLOB можно также управлять в клиенте mysql и другом клиентском приложении MySQL, используя опцию MySQL Server --ndb-blob-write-batch-bytes и связанные системные переменные MySQL Server.

    2.3.30.28. NdbTransaction::setSchemaObjectOwnerChecks()

    Описание. Включает или отключает проверку собственности объекта схемы, когда многократные объекты Ndb_cluster_connection используются. Когда эта проверка позволена, объекты, используемые этой транзакцией, проверяются, чтобы удостовериться, что они принадлежат NdbDictionary, принадлежащему этой связи. Это сделано, приобретя объекты схемы тех же самых имен от связи и сравнив их с объектами схемы, переданными к транзакции. Если они не соответствуют, ошибка возвращена.

    Этот метод доступен для целей отладки, начиная с NDB 7.2.0, NDB 7.3.9 и NDB 7.4.4 (Bug #19875977). Необходимо знать, что предоставление возможности этой проверки несет потерю производительности, и поэтому необходимо избегать делать ее в производственном применении.

    Сигнатура.

    void setSchemaObjOwnerChecks
    (
      bool runChecks
    )
    

    Параметры. Единственный параметр runChecks. true позволяет проверки собственности, false запрещает.

    Возвращаемое значение. Нет.

    2.3.30.29. NdbTransaction::unlock()

    Описание. Этот метод создает операцию разблокировки на текущей транзакции, когда выполнено, операция удаляет блокировку, на которую ссылаются NdbLockHandle (см. раздел 2.3.25.5), переданный этому методу.

    Сигнатура.

    const NdbOperation* unlock
    (
      const NdbLockHandle* lockHandle,
      NdbOperation::AbortOption ao = NdbOperation::DefaultAbortOption
    )
    

    Параметры. Указатель на обработчик блокировки, кроме того, произвольно, AbortOption значение ao.

    Если операция терпит неудачу, AbortOption определяет, как это обработано, по умолчанию ошибки заставляют транзакции прерываться.

    Возвращаемое значение. Указатель на NdbOperation (созданная операция).

    2.3.30.30. NdbTransaction::updateTuple()

    Описание. Обновляет кортеж, используя объект NdbRecord .

    Сигнатура.

    const NdbOperation* updateTuple
    (
      const NdbRecord* key_rec,
      const char* key_row,
      const NdbRecord* attr_rec,
      const char* attr_row,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )
    

    Параметры.

    • key_rec указатель на NdbRecord для таблицы или индекса. Если на таблицу, то операция использует первичный ключ, если на индексе, то операция использует уникальный ключ. В любом случае key_rec должен включать все колонки ключа.

    • key_row переданный к этому методу определяет первичный или уникальный ключ затронутого кортежа и должен остаться действительным до вызова execute().

    • attr_rec это NdbRecord , ссылающийся на признак, который будет обновлен.

      Для операций по уникальному индексу, attr_rec должен обратиться к базовой таблице индекса, а не к самому индексу.

    • attr_row это буфер, содержащий новые данные для обновления.

    • mask, если не NULL, определяет подмножество признаков, которые будут обновлены. Маска копируется и не должна оставаться действительной после обращения к этому методу.

    • OperationOptions (opts) может использоваться, чтобы обеспечить более точный контроль операционных определений. Структура OperationOptions передается с флагами, указывающими, какие операционные варианты определения присутствуют. Не все операционные типы поддерживают все операционные варианты, для перечня вариантов, поддержанных каждым типом операции, посмотрите раздел 2.3.30.21.

    • Дополнительный параметр sizeOfOptions используется, чтобы сохранить обратную совместимость этого взаимодействия с предыдущими определениями структуры OperationOptions. Если необычный размер обнаружен интерфейсным внедрением, он может использовать это, чтобы определить, как интерпретировать переданную структуру OperationOptions. Чтобы позволить эту функциональность, вызывающий должен передать sizeof(NdbOperation::OperationOptions) для значения этого аргумента.

    Возвращаемое значение. NdbOperation представление этой операции (может использоваться, чтобы проверить ошибки).

    2.3.30.31. NdbTransaction::writeTuple()

    Описание. Этот метод используется с NdbRecord , чтобы написать кортеж данных.

    Сигнатура.

    const NdbOperation* writeTuple
    (
      const NdbRecord* key_rec,
      const char* key_row,
      const NdbRecord* attr_rec,
      const char* attr_row,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )
    

    Параметры.

    • key_rec указатель на NdbRecord для таблицы или индекса. Если на таблице, то операция использует первичный ключ, если на индексе, то операция использует уникальный ключ. В любом случае key_rec должен включать все колонки ключа.

    • key_row переданный к этому методу определяет первичный или уникальный ключ кортежа, который будет написан и должен остаться действительным до execute().

    • attr_rec это NdbRecord , ссылающийся на признак, который будет написан.

      Для операций по уникальному индексу attr_rec должен обратиться к базовой таблице индекса, не к самому индексу.

    • attr_row буфер, содержащий новые данные.

    • mask, если не NULL, определяет подмножество признаков, которые будут написаны. Маска копируется и не должна оставаться действительной после обращения к этому методу.

    • OperationOptions (opts) может использоваться, чтобы обеспечить более точный контроль операционных определений. Структура OperationOptions передается с флагами, указывающими, какие операционные варианты определения присутствуют. Не все операционные типы поддерживают все операционные варианты, для списка вариантов, поддержанных каждым типом операции, посмотрите раздел 2.3.30.21 .

    • Дополнительный параметр sizeOfOptions используется, чтобы предоставить обратную совместимость этого взаимодействия с предыдущими определениями структуры OperationOptions. Если необычный размер обнаружен интерфейсным внедрением, он может использовать это, чтобы определить, как интерпретировать переданную структуру OperationOptions. Чтобы позволить эту функциональность, вызывающий должен передать sizeof(NdbOperation::OperationOptions) для значения этого аргумента.

    Возвращаемое значение. const указатель на NdbOperation представление этой операции записи. Операция может быть проверена по мере необходимости.

    2.3.31. Класс Object

    Резюме

    Этот класс обеспечивает метаинформацию об объектах базы данных, таких как таблицы и индексы. Подклассы Object моделируют эти и другие объекты базы данных.

    Родительский класс. NdbDictionary.

    Дочерние классы. Datafile, Event, Index, LogfileGroup, Table, Tablespace , undofile , HashMap , ForeignKey .

    Методы.

    Таблица 2.70.

    Имя Описание
    getObjectId() Получает ID объекта
    getObjectStatus() Получает статус объекта
    getObjectVersion() Получает версию объекта

    Все 3 метода чистые виртуальные методы и повторно осуществляются в подклассах Table , Index и Event.

    Типы.

    Таблица 2.71.

    Имя Описание
    FragmentType Тип фрагментации, используемый объектом (таблица или индекс)
    State Состояние объекта (если применимо)
    Status Состояние объекта (если доступно)
    Store Хранится объект постоянно или временно
    Type Тип объекта (таблица, индекс или другой объект базы данных, представленный Object)

    2.3.31.1. Object::FragmentType

    Резюме

    Этот тип описывает тип фрагментации Object.

    Описание. Этот параметр определяет, как данные в таблице или индексе распределяются среди узлов хранения кластера, то есть, количество фрагментов на узел. Чем больше таблица, тем больше количество фрагментов, которые должны использоваться. Обратите внимание на то, что все точные копии считаются единственным фрагментом. Для таблицы умолчание FragAllMedium. Для уникального хэш-индекса умолчание взято из базовой таблицы и не может в настоящее время изменяться.

    Возможные значения.

    Таблица 2.72.

    Имя Описание
    FragUndefined Тип фрагментации не определен или умолчание
    FragAllMedium Два фрагмента на узел
    FragAllLarge Четыре фрагмента на узел
    DistrKeyHash Распределенный хэш-ключ
    DistrKeyLin Распределенный линейный хэш-ключ
    UserDefined Определено пользователем
    HashMapPartition Разделение хэш-карты

    2.3.31.2. Object::PartitionBalance

    Описание. Этот тип обеспечивает параметры настройки баланса разделения (типы количества фрагмента), из которого можно выбрать, используя setPartitionBalance(). Это также тип, возвращенный getPartitionBalance().

    Возможные значения.

    Таблица 2.73.

    Имя Описание
    PartitionBalance_ForRPByLDM Используйте один фрагмент на LDM на узел
    PartitionBalance_ForRAByLDM Используйте один фрагмент на LDM на группу узлов
    PartitionBalance_ForRPByNode Используйте один фрагмент на узел
    PartitionBalance_ForRAByNode Используйте один фрагмент на группу узлов
    PartitionBalance_Specific Используйте настройки, заданные setPartitionBalance()

    До NDB 7.5.4 это было известно как FragmentCountType и мог взять одно из значений FragmentCount_OnePerLDMPerNode, FragmentCount_OnePerLDMPerNodeGroup, FragmentCount_OnePerNode, FragmentCount_OnePerNodeGroup или FragmentCount_Specific. Эти значения соответствуют показанным в предыдущей таблице в показанном порядке.

    2.3.31.3. Object::State

    Резюме

    Этот тип описывает состояние Object.

    Описание. Этот параметр предоставляет нам состояние объекта. По state определяется, создан ли объект и находится ли в применимом состоянии.

    Возможные значения.

    Таблица 2.74.

    Имя Описание
    StateUndefined Неопределенный
    StateOffline Офлайн, не применимый
    StateBuilding Создается, не применимый (?)
    StateDropping Переход в офлайн или удаление, не применимый
    StateOnline Онлайн, применимый
    StateBackup Онлайн, резервируется, применимый
    StateBroken Поврежден, должен быть удален и воссоздан

    2.3.31.4. Object::Status

    Резюме

    Этот тип описывает статус Object.

    Описание. Чтение объекта Status говорит, доступно ли это в ядре NDB.

    Возможные значения.

    Таблица 2.75.

    Имя Описание
    New Объект существует только в памяти и еще не был создан в ядре NDB
    Changed Объект был изменен в памяти и должен быть передан в ядро NDB для вступления в силу изменений
    Retrieved Объект существует и был прочитан в оперативную память из ядра NDB
    Invalid Объект был лишен законной силы и больше не должен использоваться
    Altered Таблица была изменена в ядре NDB, но все еще доступна для использования

    2.3.31.5. Object::Store

    Резюме

    Этот тип описывает постоянство Object.

    Описание. Чтение этой значения говорит нам, временный или постоянный объект.

    Возможные значения.

    Таблица 2.76.

    Имя Описание
    StoreUndefined Объект не определен
    StoreTemporary Временное хранение, объект или данные будут удалены при системном перезапуске
    StorePermanent Объект или данные постоянные, это было сохранено на диск

    2.3.31.6. Object::Type

    Резюме

    Этот тип описывает тип Object.

    Описание. Type объекта может быть один из нескольких различных видов индекса, триггера, табличного пространства и так далее.

    Возможные значения.

    Таблица 2.77.

    Имя Описание
    TypeUndefined Неопределенный
    SystemTable Системная таблица
    UserTable Пользовательский таблица (может быть временной)
    UniqueHashIndex Уникальный (но неупорядоченный) хэш-индекс
    OrderedIndex Упорядоченный (но не уникальный) индекс
    HashIndexTrigger Индекс обслуживается (внутреннее )
    IndexTrigger Индекс обслуживается (внутреннее )
    SubscriptionTrigger Резервирование или репликация (внутреннее )
    ReadOnlyConstraint Триггер (внутреннее)
    Tablespace Табличное пространство
    LogfileGroup Группа файла журнала
    Datafile Файл данных
    undofile Файл отмен
    ReorgTrigger Триггер
    HashMap Хэш-карта
    ForeignKey Внешний ключ
    FKParentTrigger Триггер на родительской таблице внешнего ключа
    FKChildTrigger Триггер на дочерней таблице внешнего ключа

    HashMap добавлено в NDB 7.2.7.

    ForeignKey, FKParentTrigger и FKChildTrigger добавлены в NDB Cluster 7.3. См. раздел 2.3.8.

    2.3.31.7. Object::getObjectId()

    Описание. Этот метод получает ID объекта.

    Сигнатура.

    virtual int getObjectId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. ID объекта как integer.

    2.3.31.8. Object::getObjectStatus()

    Описание. Этот метод получает статус объекта, для которого это вызвано.

    Сигнатура.

    virtual Status getObjectStatus
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Возвращает текущий Status для Object.

    2.3.31.9. Object::getObjectVersion()

    Описание. Метод получает текущую версию объекта.

    Сигнатура.

    virtual int getObjectVersion
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Номер версии объекта как integer.

    2.3.32. Структура OperationOptions

    Родительский класс. NdbOperation .

    Описание. Эти варианты передаются к основанному на NdbRecord первичному ключу и методам просмотра, определенным в классах NdbTransaction и NdbScanOperation.

    Большинство методов NdbTransaction::*Tuple() (см. раздел 2.3.30) берут дополнительный параметр sizeOfOptions . Это дополнительно и предназначается, чтобы разрешить интерфейсному внедрению оставаться обратно совместимым с не собранными повторно клиентами старшего возраста, которые могут передать более старую версию структуры OperationOptions. Этот эффект достигается, передавая sizeof(OperationOptions) в этот параметр.

    Каждый тип выбора отмечен как существующий, установив соответствующий бит в optionsPresent. Только типы выбора, отмеченные в optionsPresent, имеют разумные данные. Все данные копируются из структуры OperationOptions в операционное время определения. Если никакие варианты не требуются, то NULL может быть передан вместо этого.

    Члены.

    Таблица 2.78.

    Имя Тип Описание
    optionsPresent Uint64 Какие флаги присутствуют.
    [...] Flags:

    Принятые имена и значения показывают в следующем списке:

    • OO_ABORTOPTION: 0x01

    • OO_GETVALUE: 0x02

    • OO_SETVALUE: 0x04

    • OO_PARTITION_ID: 0x08

    • OO_INTERPRETED: 0x10

    • OO_ANYVALUE: 0x20

    • OO_CUSTOMDATA: 0x40

    • OO_LOCKHANDLE: 0x80

    • OO_QUEUABLE

      0x100

    • OO_NOT_QUEUABLE

      0x200

    • OO_DEFERRED_CONSTAINTS

      0x400

    • OO_DISABLE_FK

      0x800

    • OO_NOWAIT

      0x1000

    Тип флагов.
    abortOption AbortOption Определенный для операции выбор аварийного прекращения работы, необходимый, только если поведение по умолчанию abortoption не устраивает.
    extraGetValues GetValueSpec Дополнительный столбец значений для чтения.
    numExtraGetValues Uint32 Количество значений дополнительного столбца.
    extraSetValues SetValueSpec Дополнительный столбец значений для установки.
    numExtraSetValues Uint32 Количество значений дополнительного столбца.
    partitionId Uint32 Ограничьте просмотр разделением, имеющим этот ID, альтернативно, можно поставлять PartitionSpec. Для просмотров индекса информацию о разделении может поставляться для каждого диапазона.
    interpretedCode NdbInterpretedCode Интерпретируемый код, чтобы выполнить как часть просмотра.
    anyValue Uint32 anyValue, используемый с этой операцией. Это используется NDB Cluster Replication, чтобы сохранить ID сервера узла SQL. Начиная узел SQL с опцией --server-id-bits (которая вызывает использование только части бит из server_id для однозначного его определения), установленной в менее, чем 32, остающиеся биты могут использоваться, чтобы хранить пользовательские данные.
    customData void* Указатель данных, чтобы связаться с этой операцией.
    partitionInfo PartitionSpec Информация о разделении для ограничения этого просмотра.
    sizeOfPartInfo Uint32 Размер информации о разделении ограничения.

    См. раздел 2.3.27.

    2.3.33. Структура PartitionSpec

    Резюме

    Эта секция описывает структуру PartitionSpec.

    Родительский класс. Ndb.

    Описание. PartitionSpec используется для описания разделения таблицы с точки зрения любого из следующих критериев:

    • Определенное разделение ID для таблицы с определенным пользователями разделением.

    • Множество составлено из значений ключа распределения таблицы для таблицы с родным разделением.

    • Строка в формате NdbRecord, содержащая значения ключа распределения разделенной таблицы.

    Атрибуты. PartitionSpec имеет два признака, SpecType и Spec, которые являются структурой данных, соответствующей этому SpecType:

    Таблица 2.79.

    Перечисление SpecType Значение SpecType (Uint32) Структура данных Описание
    PS_NONE 0 Нет Никакая информация о разделении не предоставляется.
    PS_USER_DEFINED 1 UserDefined Для таблицы, имеющей определеное пользователем разделение, нужный раздел определяется его ID.
    PS_DISTR_KEY_PART_PTR 2 KeyPartPtr Для таблицы, имеющей родное разделение, множество, содержащее значения ключа распределения таблицы, используется, чтобы определить раздел.
    PS_DISTR_KEY_RECORD 3 KeyRecord Разделение определяется, используя значения ключа распределения родного разделения таблицы, как содержится в строках, данных в формате NdbRecord .

    Структура UserDefined. Структура используется, когда SpecType = PS_USER_DEFINED.

    Таблица 2.80.

    Атрибут Тип Описание
    partitionId Uint32 Разделение ID для желаемой таблицы.

    Структура KeyPartPtr. Структура используется, когда SpecType = PS_DISTR_KEY_PART_PTR.

    Таблица 2.81.

    Атрибут Тип Описание
    tableKeyParts Key_part_ptr Указатель на значения ключа распределения для таблицы, имеющей родное разделение.
    xfrmbuf void* Указатель на временный буфер используется для выполнения вычислений.
    xfrmbuflen Uint32 Длина временного буфера.

    Структура KeyRecord. Структура используется, когда SpecType = PS_DISTR_KEY_RECORD.

    Таблица 2.82.

    Атрибут Тип Описание
    keyRecord NdbRecord Строка в формате NdbRecord содержит ключи распределения таблицы.
    keyRow const char* Данные о ключе распределения.
    xfrmbuf void* Указатель на временный буфер для выполнения вычислений.
    xfrmbuflen Uint32 Длина временного буфера.

    Определения из Ndb.hpp. Поскольку это довольно сложная структура, мы здесь предоставляем оригинальное определение исходного кода PartitionSpec , как дано в storage/ndb/include/ndbapi/Ndb.hpp:

    struct PartitionSpec
    {
      enum SpecType
      {
        PS_NONE= 0,
        PS_USER_DEFINED= 1,
        PS_DISTR_KEY_PART_PTR= 2,
        PS_DISTR_KEY_RECORD= 3
      };
      Uint32 type;
      union
      {
        struct {
          Uint32 partitionId;
        } UserDefined;
        struct {
          const Key_part_ptr* tableKeyParts;
          void* xfrmbuf;
          Uint32 xfrmbuflen;
        } KeyPartPtr;
        struct {
          const NdbRecord* keyRecord;
          const char* keyRow;
          void* xfrmbuf;
          Uint32 xfrmbuflen;
        } KeyRecord;
      };
    };
    

    2.3.34. Структура RecordSpecification

    Родительский класс. NdbDictionary .

    Описание. Эта структура используется, чтобы определить колонки и смещения диапазона, создавая объекты NdbRecord.

    Члены.

    Таблица 2.83.

    Имя Тип Описание
    column Column Столбец, описанный этой записью (максимальный размер колонки определяет размер поля для строки). Создавая NdbRecord для индекса, это должно указать на колонку, полученную из базовой таблицы, а не из самого индекса.
    offset Uint32 Смещение данных с начала строки. Для чтения blob обработчик (NdbBlob), а не фактические данные blob, написан в строку. Это означает, что должно быть доступно, по крайней мере, sizeof(NdbBlob*) в строке.
    nullbit_byte_offset Uint32 Смещение с начала строки байта, содержащего бит NULL.
    nullbit_bit_in_byte Uint32 Бит NULL (0-7).

    nullbit_byte_offset и nullbit_bit_in_byte не используются для столбцов, которые не могут быть NULL.

    См. раздел 2.3.27.

    2.3.35. Структура ScanOptions

    Родительский класс. NdbScanOperation.

    Описание. Эта структура данных используется, чтобы передать варианты к NdbRecord-методам scanTable() и scanIndex() класса NdbTransaction . Каждый тип выбора отмечен как существующий, установив соответствующий бит в поле optionsPresent. Только типы выбора, отмеченные в optionsPresent, обработаны.

    Все данные копируются из структуры ScanOptions в операционное время определения. Если никакие варианты не требуются, то NULL может быть передан как указатель ScanOptions.

    Члены.

    Таблица 2.84.

    Имя Тип Описание
    optionsPresent Uint64 Какие варианты присутствуют.
    [...] Type:
    • SO_SCANFLAGS: 0x01

    • SO_PARALLEL: 0x02

    • SO_BATCH: 0x04

    • SO_GETVALUE: 0x08

    • SO_PARTITION_ID: 0x10

    • SO_INTERPRETED: 0x20

    • SO_CUSTOMDATA: 0x40

    • SO_PARTINFO: 0x80

    Тип опций.
    scan_flags Uint32 Флаги, управляющие поведением просмотра, посмотрите раздел 2.3.29.9 .
    parallel Uint32 Параллелизм просмотра, 0 (умолчание) устанавливает максимальный параллелизм.
    batch Uint32 Пакетный размер для передач от узлов данных до узлов API, 0 (умолчание) позволяет этому быть выбранным автоматически.
    extraGetValues GetValueSpec Дополнительные значения, которые будут прочитаны для каждой строки, соответствующей критериям просмотра.
    numExtraGetValues Uint32 Количество дополнительных значений, которые будут прочитаны.
    partitionId Uint32 Ограничьте просмотр разделением, имеющим этот ID, альтернативно, можно поставлять PartitionSpec. Для просмотров индекса информация разделения может поставляться для каждого диапазона.
    interpretedCode NdbInterpretedCode Интерпретируемый код, чтобы выполнить как часть просмотра.
    customData void* Указатель данных, чтобы связаться с этой операцией по просмотру.
    partitionInfo PartitionSpec Информация о разделении для ограничения этого просмотра.
    sizeOfPartInfo Uint32 Размер информации о разделении ограничения.

    См. раздел 2.3.27.

    2.3.36. Структура SetValueSpec

    Родительский класс. NdbOperation.

    Описание. Эта структура используется, чтобы определить дополнительное значение, чтобы установить как часть операции в NdbRecord .

    Члены.

    Таблица 2.85.

    Имя Тип Описание
    column Column Чтобы определить дополнительное значение, чтобы читать, вызывающий должен обеспечить это, а также указатель (возможно NULL) appStorage.
    value void* Это должно указать на значение, которое будет установлено, или NULL, если признак должен быть установлен в NULL. Ззначение копируется, когда операция определяется и не должно оставаться прежним во время выполнения.

    В настоящее время значения blob не могут быть установлены, используя SetValueSpec.

    См. раздел 2.3.27.

    2.3.37. Класс Table

    Резюме

    Эта секция описывает класс Table, который моделирует таблицу базы данных в API NDB.

    Родительский класс. NdbDictionary.

    Дочерние классы. Нет.

    Описание. Класс Table представляет таблицу в базе данных NDB Cluster. Этот класс расширяет класс Object, который в свою очередь является внутренним классом для класса NdbDictionary .

    Возможное использование API NDB, чтобы составить таблицы независимо от сервера MySQL. Однако обычно нежелательно это делать, так как таблицы, составленные этим способом, не могут быть замечены сервером MySQL. Точно так же возможно использовать методы Table, чтобы изменить существующие таблицы, но эти изменения (за исключением переименования) невидимы MySQL.

    Вычисление размеров таблицы. Вычисляя хранение данных нужно добавить размер всех признаков (каждый признак потребляет минимум 4 байта) и дополнительно 12 байт. У признаков переменного размера есть размер 12 байтов плюс фактические части хранения данных с дополнительными издержками на основе размера переменной части. Например, рассмотрите таблицу с 5 признаками: один 64-битный признак, один 32-битный признак, два 16-битных признака и одно множество из 64 8-битных признаков. Объем памяти, потребляемый на запись таблицы, является суммой следующего:

    • 8 байтов для 64-битного признака

    • 4 байта для 32-битного признака

    • 8 байтов для двух 16-битных признаков, каждый из них добавляет 4 байта из-за выравнивания по правому краю

    • 64 байта для множества (64 * 1 байт на элемент матрицы)

    • 12 байтов дополнительно

    Это составляет 96 байтов на запись. Кроме того, необходимо принять издержки приблизительно из 2% для распределения заголовков страницы и потраченного впустую пространства. Таким образом 1 миллион записей должен потреблять 96 МБ, дополнительный заголовок страницы и другие издежки достигают приблизительно 2 МБ. Примерно 100 МБ.

    Методы.

    Таблица 2.86.

    Имя Описание
    Table() Конструктор класса
    ~Table() Деструктор
    addColumn() Добавляет столбец к таблице
    aggregate() Вычисляет агрегированные данные для таблицы
    equal() Сравнивает таблицу с другой
    getColumn() Достает колонку (по имени) из таблицы
    getDefaultNoPartitionsFlag() Проверки, используется ли номер разделения по умолчанию
    getFragmentCount() Получает количество фрагментов для этой таблицы
    getExtraMetadata() Получает дополнительные метаданные для этой таблицы
    getFragmentData() Получает данные о фрагменте таблицы (ID, состояние и узел)
    getFragmentDataLen() Получает длину данных о фрагменте таблицы
    getFragmentNodes() Получает ID узлов данных, на которых расположены фрагменты
    getFragmentType() Получает FragmentType таблицы
    getFrmData() Получает данные из файла .FRM таблицы
    getFrmLength() Получает длину файла .FRM таблицы
    getHashMap() Получает хэш-карту таблицы
    getKValue() Получает KValue
    getLinearFlag() Получает текущее значение линейного флага хеширования таблицы
    getLogging() Проверка, позволена ли регистрация на диск для этой таблицы
    getMaxLoadFactor() Получает фактор максимальной нагрузки таблицы
    getMaxRows() Получает максимальное количество строк, которые может содержать эта таблица
    getMinLoadFactor() Получает минимальный коэффициент загрузки таблицы
    getName() Получает название таблицы
    getNoOfColumns() Получает количество столбцов в таблице
    getNoOfPrimaryKeys() Получает количество столбцов в первичном ключе таблицы
    getObjectId() Получает идентификатор объекта таблицы
    getObjectStatus() Получает статус объекта таблицы
    getObjectType() Удалено в NDB 7.5.0 (Bug #47960, Bug #11756088)
    getObjectVersion() Получает версию объекта таблицы
    getPartitionBalance() Получает баланс разделения (тип количества фрагментов), используемый для этой таблицы (NDB 7.5.4 и позже)
    getPartitionBalanceString() Используемый баланс разделения для этого таблицы как последовательность (NDB 7.5.4 и позже)
    getPartitionId() Получает ID разделения из значения хэш-функции
    getPrimaryKey() Получает название первичного ключа таблицы
    getRangeListData() Получает RANGE или LIST
    getRangeListDataLen() Получает длину RANGE или LIST
    getRowChecksumIndicator() Проверка, был ли индикатор контрольной суммы строки установлен
    getRowGCIIndicator() Проверка, был ли индикатор GCI строки установлен
    getSingleUserMode() Получает SingleUserMode
    getTableId() Получает ID таблицы
    getTablespace() Получает табличное пространство, содержащее эту таблицу
    getTablespaceData() Получает ID и версию табличного пространства, содержащего таблицу
    getTablespaceDataLen() Получает длину данных о табличном пространстве таблицы
    getTablespaceNames() Получает названия табличных пространств, используемых во фрагментах таблицы
    hasDefaultValues() Определите, есть ли у таблицы какие-либо колонки, используя значения по умолчанию
    setDefaultNoPartitionsFlag() Указывает, должен ли номер разделения по умолчанию использоваться для таблицы
    setExtraMetadata() Устанавливает дополнительные метаданные для этой таблицы
    getFragmentCount() Получает количество фрагментов для этой таблицы
    setFragmentData() Устанавливает ID фрагмента, ID узла и состояние фрагмента
    setFragmentType() Устанавливает FragmentType
    setFrm() Устанавливает файл .FRM, который будет использоваться для этой таблицы
    setHashMap() Устанавливает хэш-карту таблицы
    setKValue() Устанавливает KValue
    setLinearFlag() Устанавливает линейный флаг хеширования таблицы
    setLogging() Переключает регистрацию таблицы на диск
    setMaxLoadFactor() Установит фактор максимальной нагрузки таблицы (MaxLoadFactor)
    setMaxRows() Определяет максимальное число строк в таблице
    setMinLoadFactor() Установит минимальный коэффициент загрузки таблицы (MinLoadFactor)
    setPartitionBalance() Устанавливает баланс разделения (тип количества фрагментов) для этой таблицы (NDB 7.5.4 и позже)
    setName() Определяет имя таблицы
    setObjectType() Удалено в NDB 7.5.0 (Bug #47960, Bug #11756088)
    setRangeListData() Устанавливает данные разделения LIST и RANGE
    setRowChecksumIndicator() Устанавливает индикатор контрольной суммы строки
    setRowGCIIndicator() Устанавливает индикатор GCI строки
    setSingleUserMode() Устанавливает SingleUserMode
    setStatusInvalid()
    setTablespace() Установит табличное пространство для этой таблицы
    setTablespaceData() Устанавливает ID и версию табличного пространства
    setTablespaceNames() Определяет имена табличного пространства для фрагментов
    validate() Утверждает определение для новой таблицы до ее создания

    Оператор присваивания (=) перегружен для этого класса, так, чтобы он всегда выполнял глубокую копию.

    Как с другими объектами базы данных, создание объекта Table и изменения признака существующих таблиц, сделанные, используя API NDB, невидимы из MySQL. Например, если вы добавляете новую колонку к таблице, используя Table::addColumn(), MySQL MySQL не видит новую колонку. Единственное исключение из этого правила относительно таблиц то, что изменение названия существующей таьблицы NDB, используя Table::setName(), видимо в MySQL.

    Типы. Класс Table определяет единственный публичный тип SingleUserMode.

    2.3.37.1. Table::addColumn()

    Описание. Добавляет столбец к таблице.

    Сигнатура.

    void addColumn
    (
      const Column& column
    )
    

    Параметры. Ссылка на колонку, которая должна быть добавлена к таблице.

    Возвращаемое значение. Нет, но это действительно создает копию оригинального объекта Column.

    2.3.37.2. Table::aggregate()

    Описание. Этот метод вычисляет агрегированные данные для таблицы. Это требуется для таких совокупных методов, как getNoOfPrimaryKeys(), чтобы работать правильно перед тем, как таблица была составлена и получена через getTableId().

    Добавлено в MySQL 5.1.12 (Bug #21690).

    Сигнатура.

    int aggregate
    (
      struct NdbError& error
    )
    

    Параметры. Ссылка на объект NdbError.

    Возвращаемое значение. integer, значение которого 0 при успехе и -1, если таблица находится в непоследовательном статусе. В последнем случае также установлен error.

    2.3.37.3. Конструктор

    Описание. Создает экземпляр Table. Есть две версии конструктора, одна для создания нового экземпляра и вторая для конструктора копии.

    Таблицы, составленные в API NDB, используя этот метод, недоступны из MySQL.

    Сигнатура. Новый экземпляр:

    Table
    (
      const char* name = ""
    )
    

    Конструктор копии:

    Table
    (
      const Table& table
    )
    

    Параметры. Для нового экземпляра, название таблицы, которая будет создана. Для копии ссылки на таблицу, которая будет скопирована.

    Возвращаемое значение. Объект Table.

    Деструктор.

    virtual ~Table()
    

    2.3.37.4. Table::equal()

    Описание. Этот метод используется, чтобы сравнить один экземпляр Table с другим.

    Сигнатура.

    bool equal
    (
      const Table& table
    ) const
    

    Параметры. Ссылка на объект Table, с которым должен быть сравнен текущий экземпляр.

    Возвращаемое значение. true, если эти две таблицы одинаковы, иначе false.

    2.3.37.5. Table::getColumn()

    Описание. Этот метод используется, чтобы получить определение столбца, учитывая индекс или название колонки.

    Сигнатура. Этот метод может быть вызван, используя идентификатор или имя столбца, как показано здесь:

    Column* getColumn
    (
      const int AttributeId
    )
    
    Column* getColumn
    (
      const char* name
    )
    

    Параметры. Любой из: индекс колонки в таблице (когда это было бы возвращено методом колонки getColumnNo()) или название колонки.

    Возвращаемое значение. Указатель на колонку с указанным индексом или именем. Если нет такой колонки, то этот метод возвращает NULL.

    2.3.37.6. Table::getDefaultNoPartitionsFlag()

    Описание. Этот метод используется, чтобы узнать, используется ли номер разделения по умолчанию для таблицы.

    Сигнатура.

    Uint32 getDefaultNoPartitionsFlag
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. 32-bit unsigned integer.

    2.3.37.7. Table::getExtraMetadata()

    Описание. Получите и распакуйте дополнительные метаданные для этой Table.

    Сигнатура.

    int getExtraMetadata
    (
      Uint32& version,
      void** data,
      Uint32* length
    ) const
    

    Параметры.

    • version: В соответствии с соглашением, как используется в коде кластера NDB, 1 означает, что дополнительные метаданные содержатся в файле .frm file (BLOB) как в NDB 7.6 и ранее, 2 означает, что это преобразованная в последовательную форму информация о словаре как в NDB 8.0.

    • data: Сохраненные полученные данные как метаданные.

    • length: Длина хранииых данных (метаданных).

    Возвращаемое значение. 0 при успехе, любое другое значение при ошибке. Ненулевое значение должно интерпретироваться как код ошибки для типа ошибки.

    Добавлено в NDB 8.0.13.

    2.3.37.8. Table::getFragmentCount()

    Описание. Этот метод получает количество фрагментов в таблице.

    Сигнатура.

    Uint32 getFragmentCount
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Количество фрагментов таблицы как 32-bit unsigned integer.

    2.3.37.9. Table::getFragmentData()

    Описание. Этот метод получает данные о фрагменте таблицы (ID, состояние и узел).

    Сигнатура.

    const void* getFragmentData
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на данные, которые будут прочитаны.

    2.3.37.10. Table::getFragmentDataLen()

    Описание. Получает длину данных о фрагменте таблицы в байтах.

    Сигнатура.

    Uint32 getFragmentDataLen
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Число байтов, которые будут прочитаны как unsigned 32-bit integer.

    2.3.37.11. Table::getFragmentNodes()

    Описание. Этот метод получает список узлов, хранящих данный фрагмент.

    Сигнатура.

    Uint32 getFragmentNodes
    (
      Uint32 fragmentId,
      Uint32* nodeIdArrayPtr,
      Uint32 arraySize
    ) const
    

    Параметры.

    • fragmentId: ID желаемого фрагмента.

    • nodeIdArrayPtr: Указатель на множество ID узлов, содержащих этот фрагмент.

      Обычно основной фрагмент это запись 0 в этом множестве.

    • arraySize: Размер множества, содержащего ID узлов. Если это меньше, чем количество фрагментов, то только первые записи arraySize написаны в это множество.

    Возвращаемое значение. Возвращаемое значение 0 указывает на ошибку, иначе это количество фрагментов таблицы как 32-bit unsigned integer.

    2.3.37.12. Table::getFragmentType()

    Описание. Этот метод получает тип фрагментации таблицы.

    Сигнатура.

    FragmentType getFragmentType
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Значение FragmentType как определено в разделе 2.3.31.1.

    2.3.37.13. Table::getFrmData()

    Описание. Данные из файла .FRM, связанного с таблицей.

    Сигнатура.

    const void* getFrmData
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на данные .FRM.

    2.3.37.14. Table::getFrmLength()

    Описание. Получает длину файла .FRM таблицы в байтах.

    Сигнатура.

    Uint32 getFrmLength
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Длина файла .FRM в байтах (unsigned 32-bit integer).

    2.3.37.15. Table::getHashMap()

    Описание. Получает используемую хэш-карту для этой таблицы. Введено в NDB 7.2.7.

    Сигнатура.

    bool getHashMap
    (
      Uint32* id = 0,
      Uint32* version = 0
    ) const
    

    Параметры. ID и версия таблицы.

    Возвращаемое значение. True, если у таблицы есть хэш-карта, иначе false.

    2.3.37.16. Table::getKValue()

    Описание. Этот метод получает KValue, параметр хеширования, который в настоящее время ограничивается значением 6. В будущем выпуске может стать выполнимо установить этот параметр на другие значения.

    Сигнатура.

    int getKValue
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. integer (сейчас всегда 6).

    2.3.37.17. Table::getLinearFlag()

    Описание. Этот метод получает значение линейного флага хеширования таблицы.

    Сигнатура.

    bool getLinearFlag
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. true, если флаг установлен, false, если нет.

    2.3.37.18. Table::getLogging()

    Описание. Этот класс используется, чтобы проверить, зарегистрирована ли таблица на диске, то есть, постоянная она или временная.

    Сигнатура.

    bool getLogging
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Если true, тогда таблица полностью сохранена на диск. Если false, таблица временная и не зарегистрирована на диске, в случае системного перезапуска таблица все еще существует и сохраняет свое определение, но будет пустой. Значение регистрации по умолчанию true.

    2.3.37.19. Table::getMaxLoadFactor()

    Описание. Этот метод возвращает коэффициент загрузки (параметр хеширования), когда начинается разделение контейнеров в местных хэш-таблицах.

    Сигнатура.

    int getMaxLoadFactor
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. integer, максимальное значение которого равняется 100. Когда максимальное значение возвращено, это означает, что использование памяти оптимизировано. Меньшие значения указывают, что меньше данных хранится в каждом контейнере, что означает, что ключи найдены более быстро, однако, это также потребляет больше памяти.

    2.3.37.20. Table::getMaxRows()

    Описание. Этот метод получает максимальное количество строк, которые может вместить таблица. Это используется для вычисления количества разделения.

    Сигнатура.

    Uint64 getMaxRows
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Максимальное количество строк таблицы как 64-bit unsigned integer.

    2.3.37.21. Table::getMinLoadFactor()

    Описание. Этот метод получает значение коэффициента загрузки, когда сокращение хэш-таблицы начинается. Это должно всегда быть меньше, чем значение, возвращенное getMaxLoadFactor().

    Сигнатура.

    int getMinLoadFactor
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. integer (на самом деле процент, выраженный как целое число, посмотрите раздел 2.3.37.19).

    2.3.37.22. Table:getName()

    Описание. Получает название таблицы.

    Сигнатура.

    const char* getName
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Название таблицы (последовательность).

    2.3.37.23. Table::getNoOfColumns()

    Описание. Этот метод используется, чтобы получить количество столбцов в таблице.

    Сигнатура.

    int getNoOfColumns
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. integer, представляющий количество столбцов в таблице.

    2.3.37.24. Table::getNoOfPrimaryKeys()

    Описание. Этот метод находит количество столбцов первичного ключа в таблице.

    Сигнатура.

    int getNoOfPrimaryKeys
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. integer, представляющий количество столбцов первичного ключа в таблице.

    2.3.37.25. Table::getObjectId()

    Описание. Этот метод получает идентификатор объекта таблицы.

    Сигнатура.

    virtual int getObjectId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Идентификатор объекта возвращен как integer.

    2.3.37.26. Table::getObjectStatus()

    Описание. Этот метод получает статус таблицы, то есть, Object::Status.

    Сигнатура.

    virtual Object::Status getObjectStatus
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. A Status. См. раздел 2.3.31.4.

    2.3.37.27. Table::getObjectType()

    Описание. Этот метод не работал, как предназначено и был удален в NDB 7.5.0 (Bug #47960, Bug #11756088).

    Сигнатура.

    Object::Type getObjectType
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Значение Type. См. раздел 2.3.31.6.

    2.3.37.28. Table::getObjectVersion()

    Описание. Этот метод получает версию объекта таблицы (см. NDB Schema Object Versions).

    Сигнатура.

    virtual int getObjectVersion
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Версия объекта таблицы как integer.

    2.3.37.29. Table::getPartitionBalance()

    Описание. Этот метод получает схему баланса разделения (тип количества фрагментов).

    Сигнатура.

    Object::PartitionBalance getPartitionBalance
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Схема балансирования разделения как значение типа Object::PartitionBalance.

    До NDB 7.5.4 этот метод был известен как getFragmentCountType().

    2.3.37.30. Table::getPartitionBalanceString()

    Описание. Этот метод получает схему баланса разделения (тип количества фрагментов) и возвращает его как последовательность.

    Сигнатура.

    const char* getPartitionBalanceString
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Схема балансирования разделения, как значение последовательности.

    До NDB 7.5.4 этот метод был известен как getFragmentCountTypeString().

    2.3.37.31. Table::getPartitionId()

    Описание. Получает ID разделения таблицы, данный его значением хэш-функции.

    Сигнатура.

    Uint32 getPartitionId
    (
      Uint32 hashvalue
    ) const
    

    Параметры. hashvalue. Отметьте, что если таблица не была на самом деле получена (например, через getTableId()), результат, вероятно, не будет точным или полезным.

    Возвращаемое значение. Идентификатор разделения, соответствующего hashvalue.

    2.3.37.32. Table::getPrimaryKey()

    Описание. Этот метод используется, чтобы получить название первичного ключа таблицы.

    Сигнатура.

    const char* getPrimaryKey
    (
      int no
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Название первичного ключа, последовательность (указатель на символ).

    2.3.37.33. Table::getRangeListData()

    Описание. Этот метод получает диапазон или данные о списке, связанные с таблицей.

    Сигнатура.

    const void* getRangeListData
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на данные.

    2.3.37.34. Table::getRangeListDataLen()

    Описание. Этот метод получает размер диапазона таблицы или множества списка.

    Сигнатура.

    Uint32 getRangeListDataLen
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Длина списка или множества диапазона как integer.

    2.3.37.35. Table::getRowChecksumIndicator()

    Описание. Проверка, был ли индикатор контрольной суммы строки установлен.

    Сигнатура.

    bool getRowChecksumIndicator
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. true или false.

    2.3.37.36. Table::getRowGCIIndicator()

    Описание. Проверка, был ли индикатор GCI строки установлен.

    Сигнатура.

    bool getRowGCIIndicator
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. true or false.

    2.3.37.37. Table::getSingleUserMode()

    Описание. Получает однопользовательский режим таблицы.

    Сигнатура.

    enum SingleUserMode getSingleUserMode
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. SingleUserMode.

    2.3.37.38. Table::getTableId()

    Описание. Этот метод получает ID таблицы.

    Сигнатура.

    int getTableId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. integer.

    2.3.37.39. Table::getTablespace()

    Описание. Этот метод используется двумя способами: чтобы получить название табличного пространства, на которое назначена эта таблица, и чтобы проверить, что данное табличное пространство это то, которое используется этой таблицей.

    Сигнатуры. Чтобы получить название табличного пространства, вызовите без любых аргументов:

    const char* getTablespace
    (
      void
    ) const
    

    Чтобы определить, является ли табличное пространство тем, которое обозначено данным ID и версией, поставляйте их как аргументы, как показано здесь:

    bool getTablespace
    (
      Uint32* id= 0,
      Uint32* version = 0
    ) const
    

    Параметры. Число и типы параметров зависят от того, как этот метод используется:

    1. Когда используется, чтобы получить название табличного пространства в использовании таблицей, это вызывают без любых аргументов.

    2. Когда используется, чтобы определить, является ли данное табличное пространство используемым этой таблицей, тогда getTablespace() берет два параметра:

      • Табличное пространство id как указатель на 32-bit unsigned integer.

      • Табличное пространство version как указатель на 32-bit unsigned integer.

      Значение по умолчанию для обоих id и version это 0.

    Возвращаемое значение. Тип возвращения зависит от того, как метод вызывают.

    1. Когда getTablespace() вызван без любых аргументов, это возвращает экземпляр объекта Tablespace .

    2. Когда вызвано с двумя аргументами, это возвращает true, если табличное пространство совпадает с имеющим заданный ID и обозначенную версию, иначе это возвращает false.

    2.3.37.40. Table::getTablespaceData()

    Описание. Этот метод получает данные о табличном пространстве таблицы (ID и версия).

    Сигнатура.

    const void* getTablespaceData
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Указатель на данные.

    2.3.37.41. Table::getTablespaceDataLen()

    Описание. Этот метод используется, чтобы получить длину данных о табличном пространстве таблицы.

    Сигнатура.

    Uint32 getTablespaceDataLen
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Длина данных как 32-bit unsigned integer.

    2.3.37.42. Table::getTablespaceNames()

    Описание. Этот метод получает указатель на названия табличных пространств, используемых во фрагментах таблицы.

    Сигнатура.

    const void* getTablespaceNames
    (
      void
    )
    

    Параметры. Нет.

    Возвращаемое значение. Возвращает указатель на данные об имени табличного пространства.

    2.3.37.43. Table::getTablespaceNamesLen()

    Описание. Этот метод получает длину данных об имени табличного пространства, возвращенных getTablespaceNames(). См. раздел 2.3.37.42.

    Сигнатура.

    Uint32 getTablespaceNamesLen
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Возвращает длину данных об имени в байтах как 32-бит unsigned integer.

    2.3.37.44. Table::hasDefaultValues()

    Описание. Используется, чтобы определить, есть ли у таблицы какие-либо колонки, которые определяются с не-NULL по умолчанию.

    Чтобы прочитать и написать значения столбцов по умолчанию, надо использовать Column::getDefaultValue() и Column::setDefaultValue().

    Сигнатура.

    bool hasDefaultValues
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. true, если у таблицы есть какие-либо не-NULL колонки со значениями по умолчанию, иначе false.

    2.3.37.45. Table::setDefaultNoPartitionsFlag()

    Описание. Этот метод устанавливает индикатор, который определяет, используется ли номер разделения по умолчанию для таблицы.

    Сигнатура.

    void setDefaultNoPartitionsFlag
    (
      Uint32 indicator
    ) const
    

    Параметры. Этот метод берет отдельный аргумент indicator, 32-bit unsigned integer.

    Возвращаемое значение. Нет.

    2.3.37.46. Table::setExtraMetadata()

    Описание. Сохраните упакованные дополнительные метаданные для этой таблицы. Данные упакованы без любой модификации в буфер данного объекта Table.

    Сигнатура.

    int setExtraMetadata
    (
      Uint32 version,
      const void* data,
      Uint32 length
    )
    

    Параметры.

    • version: Как используется в коде NDB Cluster, 1 значит, что дополнительные метаданные содержат файл .frm (BLOB) как в NDB 7.6 и ранее, 2 значит, что это преобразованная в последовательную форму информация о словаре как в NDB 8.0. Необходимо знать, что это просто соглашение, и значения могут быть специализированы, как надо.

    • data: Фактические данные, которые будут сохранены как метаданные.

    • length: Длина данных, которые будут сохранены.

    Возвращаемое значение. 0 при успехе. Любое другое значение указывает на неудачу, в этом случае значение это код ошибки, указывающее на тип ошибки.

    Добавлено в NDB 8.0.13.

    2.3.37.47. Table::setFragmentCount()

    Описание. Определяет число фрагментов таблицы.

    Сигнатура.

    void setFragmentCount
    (
      Uint32 count
    )
    

    Параметры. count количество фрагментов, которые будут использоваться для таблицы.

    Возвращаемое значение. Нет.

    2.3.37.48. Table::setFragmentData()

    Описание. Этот метод пишет множество, содержащее следующую информацию о фрагменте:

    • Fragment ID

    • Node group ID

    • Fragment State

    Сигнатура.

    void setFragmentData
    (
      const void* data,
      Uint32 len
    )
    

    Параметры.

    • Указатель на фрагмент data для записи.

    • Длина (len) этих данных в байтах как 32-bit unsigned integer.

    Возвращаемое значение. Нет.

    2.3.37.49. Table::setFragmentType()

    Описание. Этот метод устанавливает тип фрагментации таблицы.

    Сигнатура.

    void setFragmentType
    (
      FragmentType fragmentType
    )
    

    Параметры. Этот метод берет один аргумент, значение FragmentType, см. раздел 2.3.31.1.

    Возвращаемое значение. Нет.

    2.3.37.50. Table::setFrm()

    Описание. Этот метод используется, чтобы написать данные файла .FRM этой таблицы.

    Сигнатура.

    void setFrm
    (
      const void* data,
      Uint32 len
    )
    

    Параметры.

    • Указатель на data для записи.

    • Длина (len) данных.

    Возвращаемое значение. Нет.

    2.3.37.51. Table::setHashMap()

    Описание. Установите хэш-карту для таблицы. Введено в NDB 7.2.7.

    Сигнатура.

    int setHashMap
    (
      const class HashMap &
    )
    

    Параметры. Ссылка на хэш-карту.

    Возвращаемое значение. 0 при успехе, при ошибке -1 и установит ошибку.

    2.3.37.52. Table::setKValue()

    Описание. Это устанавливает параметр хеширования KValue.

    Сигнатура.

    void setKValue
    (
      int kValue
    )
    

    Параметры. kValue это integer. В настоящее время единственное разрешенное значение 6. В будущей версии это может стать переменным параметром.

    Возвращаемое значение. Нет.

    2.3.37.53. Table::setLinearFlag()

    Сигнатура.

    void setLinearFlag
    (
      Uint32 flag
    )
    

    Параметры. flag это 32-bit unsigned integer.

    Возвращаемое значение. Нет.

    2.3.37.54. Table::setLogging()

    Описание. Переключает состояние регистрации таблицы. Посмотрите раздел 2.3.37.18.

    Сигнатура.

    void setLogging
    (
      bool enable
    )
    

    Параметры. Если enable = true, тогда регистрация для этой таблицы позволена, если это false, она выключена.

    Возвращаемое значение. Нет.

    2.3.37.55. Table::setMaxLoadFactor()

    Описание. Этот метод устанавливает фактор максимальной нагрузки, разделяя контейнеры в местных хэш-таблицах.

    Сигнатура.

    void setMaxLoadFactor
    (
      int max
    )
    

    Параметры. Этот метод берет единственный параметр max, integer, представляющий процент (например, 45 задает 45%). См. раздел 2.3.37.19.

    Это никогда не должно быть больше, чем минимальный коэффициент загрузки.

    Возвращаемое значение. Нет.

    2.3.37.56. Table::setMaxRows()

    Описание. Этот метод определяет максимальное число строк, которые могут быть обработаны таблицей.

    Сигнатура.

    void setMaxRows
    (
      Uint64 maxRows
    )
    

    Параметры. maxRows это 64-bit unsigned integer, который представляет максимальное количество строк, которые будут храниться в таблице.

    Возвращаемое значение. Нет.

    2.3.37.57. Table::setMinLoadFactor()

    Описание. Этот метод устанавливает минимальный коэффициент загрузки, когда сокращение хэш-таблицы начинается.

    Сигнатура.

    void setMinLoadFactor
    (
      int min
    )
    

    Параметры. Этот метод берет единственный параметр min, integer, задающий процент (например, 45 значит 45%). См. раздел 2.3.37.21.

    Возвращаемое значение. Нет.

    2.3.37.58. Table::setName()

    Описание. Этот метод определяет имя таблицы.

    Это единственный метод set*() Table, чьи эффекты видимы MySQL.

    Сигнатура.

    void setName
    (
      const char* name
    )
    

    Параметры. name новое название таблицы.

    Возвращаемое значение. Нет.

    2.3.37.59. Table::setObjectType()

    Описание. Этот метод не работал, как предназначено и был удален в NDB 7.5.0 (Bug #47960, Bug #11756088).

    Сигнатура.

    void setObjectType
    (
      Object::Type type
    )
    

    Параметры. Требуемый объект type . Это должно быть одним из значений Type , перечисленных в раздел 2.3.31.6 .

    Возвращаемое значение. Нет.

    2.3.37.60. Table::setPartitionBalance()

    Описание. Устанавливает схему балансирования разделения таблицы.

    Сигнатура.

    void setPartitionBalance
    (
      Object::PartitionBalance scheme
    )
    

    Параметры. scheme это схема балансирования разделения, которая будет использоваться для таблицы. Это значение типа PartitionBalance.

    Возвращаемое значение. Нет.

    До NDB 7.5.4 этот метод был известен как setFragmentCountType().

    2.3.37.61. Table::setRangeListData()

    Описание. Этот метод устанавливает множество, содержащее информацию, которая отображает значения диапазона и список значений к фрагментам. Это по существу сортированная карта, состоящая из пар fragment-ID/value. Для разделения диапазона есть одна пара на фрагмент. Для разделения списка это могло быть любое число пар, но по крайней мере столько же пар, сколько есть фрагментов.

    Сигнатура.

    void setRangeListData
    (
      const void* data,
      Uint32 len
    )
    

    Параметры.

    • Указатель на диапазон или список data, содержащий пары ID/значения.

    • Длина (len) этих данных как 32-bit unsigned integer.

    Возвращаемое значение. Нет.

    2.3.37.62. Table::setRowChecksumIndicator()

    Описание. Установить индикатор контрольной суммы строки.

    Сигнатура.

    void setRowChecksumIndicator
    (
      bool value
    ) const
    

    Параметры. true/false value.

    Возвращаемое значение. Нет.

    2.3.37.63. Table::setRowGCIIndicator()

    Описание. Устанавливает индикатор GCI строки.

    Сигнатура.

    void setRowGCIIndicator
    (
      bool value
    ) const
    

    Параметры. true/false value.

    Возвращаемое значение. Нет.

    2.3.37.64. Table::setSingleUserMode()

    Описание. Задает для таблицы SingleUserMode.

    Сигнатура.

    void setSingleUserMode
    (
      enum SingleUserMode
    )
    

    Параметры. Знаяение SingleUserMode.

    Возвращаемое значение. Нет.

    2.3.37.65. Table::setStatusInvalid()

    Описание. Вынуждает статус таблицы быть лишенным законной силы.

    Сигнатура.

    void setStatusInvalid
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Нет.

    2.3.37.66. Table::setTablespace()

    Описание. Этот метод устанавливает табличное пространство для таблицы.

    Сигнатуры. Используя название табличного пространства:

    void setTablespace
    (
      const char* name
    )
    

    Используя объект Tablespace:

    void setTablespace
    (
      const class Tablespace& tablespace
    )
    

    Параметры. Этот метод можно вызвать с отдельным аргументом, который может иметь любой из этих двух типов:

    1. Имя name табличного пространства (последовательность).

    2. Ссылка на существующий экземпляр Tablespace .

    См. раздел 2.3.38.

    Возвращаемое значение. Нет.

    2.3.37.67. Table::setTablespaceData()

    Описание. Этот метод устанавливает информацию о табличном пространстве для каждого фрагмента и включает ID и версию табличного пространства.

    Сигнатура.

    void setTablespaceData
    (
      const void* data,
      Uint32 len
    )
    

    Параметры.

    • Указатель на data, содержащие ID и версию табличного пространства

    • Длина (len) этих данных как 32-bit unsigned integer.

    Возвращаемое значение. Нет.

    2.3.37.68. Table::setTablespaceNames()

    Описание. Определяет имена табличных пространств, используемых фрагментами таблицы.

    Сигнатура.

    void setTablespaceNames
    (
      const void* data
      Uint32 len
    )
    

    Параметры.

    • Указатель на имена табличных пространств data

    • Длина (len) данных об именах как 32-bit unsigned integer.

    Возвращаемое значение. Нет.

    2.3.37.69. Table::SingleUserMode

    Описание. Однопользовательский режим определяет права доступа к таблице.

    Возможные значения.

    Таблица 2.87.

    Имя Описание
    SingleUserModeLocked Таблица блокирована (недоступна).
    SingleUserModeReadOnly Таблица доступна в режиме только для чтения.
    SingleUserModeReadWrite Таблица доступна в режиме чтения и записи.

    2.3.37.70. Table::validate()

    Описание. Этот метод утверждает определение для новой таблицы до того, как это создано и выполняет метод Table::aggregate(), а также дополнительные проверки. validate() вызван автоматически, когда таблица составлена или получена. Поэтому обычно не надо явно вызывать aggregate() или validate().

    Даже после вызова validate() там могут все еще существовать ошибки, которые могут быть обнаружены только ядром NDB, когда таблица на самом деле составлена.

    Добавлено в MySQL 5.1.12 (Bug #21690).

    Сигнатура.

    int validate
    (
      struct NdbError& error
    )
    

    Параметры. Ссылка на объект NdbError.

    Возвращаемое значение. integer, значение которого 0 при успехе, -1, если таблица находится в непоследовательном статусе. В последнем случае также установлен error.

    2.3.38. Класс Tablespace

    Резюме

    Эта секция обсуждает класс Tablespace и его публичные члены.

    Родительский класс. NdbDictionary.

    Дочерние классы. Нет.

    Описание. Класс Tablespace моделирует табличное пространство NDB Cluster Disk Data, которое содержит файлы данных, используемые, чтобы хранить Cluster Disk Data. Для обзора Cluster Disk Data см. CREATE TABLESPACE Statement в MySQL Manual.

    В настоящее время только неиндексируемые данные столбца могут храниться на диске. Индексы и колонки индексов всегда хранятся в памяти.

    NDB Cluster до MySQL 5.1 не поддерживает хранение Disk Data и табличные пространства, таким образом класс Tablespace недоступен приложениям API NDB, написанным для этих старых выпусков.

    Методы.

    Таблица 2.88.

    Имя Описание
    Tablespace() Конструктор класса
    ~Tablespace() Виртуальный метод деструктора
    getAutoGrowSpecification() Используемый, чтобы получить структуру AutoGrowSpecification, связанную с табличным пространством
    getDefaultLogfileGroup() Получает имя группы файла журнала табличного пространства по умолчанию
    getDefaultLogfileGroupId() Получает ID группы файла журнала табличного пространства по умолчанию
    getExtentSize() Получает размер экстента табличного пространства
    getName() Получает название табличного пространства
    getObjectId() Получает идентификатор объекта экземпляра Tablespace
    getObjectStatus() Используемый, чтобы получить Object::Status экземпляра Tablespace, для которого это вызывают
    getObjectVersion() Получает версию объекта Tablespace, для которого это вызвано
    setAutoGrowSpecification() Используемый, чтобы установить особенности табличного пространства
    setDefaultLogfileGroup() Устанавливает группу файла журнала табличного пространства по умолчанию
    setExtentSize() Устанавливает размер экстентов, используемых табличным пространством
    setName() Определяет имя для табличного пространства

    Типы. Класс Tablespace не определяет собственных публичных типов, однако, два из его методов используют структуру данных AutoGrowSpecification.

    2.3.38.1. Конструктор Tablespace

    Описание. Эти методы используются, чтобы создать новый экземпляр Tablespace или скопировать существующий.

    Класс Dictionary также поставляет методы для создания и удаления табличных пространств.

    Сигнатуры. Новый экземпляр:

    Tablespace
    (
      void
    )
    

    Конструктор копии:

    Tablespace
    (
      const Tablespace& tablespace
    )
    

    Параметры. Новый экземпляр: Нет. Конструктор копии: ссылка на существующий экземпляр Tablespace.

    Возвращаемое значение. Объект Tablespace.

    Деструктор. Класс определяет виртуальный деструктор ~Tablespace(), который не берет аргументов и не возвращает значения.

    2.3.38.2. Tablespace::getAutoGrowSpecification()

    Сигнатура.

    const AutoGrowSpecification& getAutoGrowSpecification
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Ссылка на структуру, которая описывает табличное пространство, см. раздел 2.3.1.

    2.3.38.3. Tablespace::getDefaultLogfileGroup()

    Описание. Этот метод получает имя группы файла журнала табличного пространства по умолчанию.

    Альтернативно, можно хотеть получить ID группы файла журнала по умолчанию, посмотрите раздел 2.3.38.4.

    Сигнатура.

    const char* getDefaultLogfileGroup
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Имя группы файла журнала (указатель на символ).

    2.3.38.4. Tablespace::getDefaultLogfileGroupId()

    Описание. Этот метод получает ID группы файла журнала табличного пространства по умолчанию.

    Можно также получить непосредственно имя группы файла журнала по умолчанию, а не ее ID, посмотрите раздел 2.3.38.3.

    Сигнатура.

    Uint32 getDefaultLogfileGroupId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. ID группы файла журнала как unsigned 32-bit integer.

    2.3.38.5. Tablespace::getExtentSize()

    Описание. Этот метод используется, чтобы получить extent size, который является размером единиц выделения памяти, используемый табличным пространством.

    Тот же самый размер используется для всех файлов данных, содержащихся в данном табличном пространстве.

    Сигнатура.

    Uint32 getExtentSize
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Размер экстента табличного пространства в байтах как unsigned 32-bit integer.

    2.3.38.6. Tablespace::getObjectId()

    Описание. Этот метод получает идентификатор объекта табличного пространства.

    Сигнатура.

    virtual int getObjectId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Идентификатор объекта как integer.

    2.3.38.7. Tablespace::getName()

    Описание. Этот метод получает название табличного пространства.

    Сигнатура.

    const char* getName
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Название табличного пространства, значение последовательности (как указатель на символ).

    2.3.38.8. Tablespace::getObjectStatus()

    Описание. Этот метод используется, чтобы получить статус объекта табличного пространства.

    Сигнатура.

    virtual Object::Status getObjectStatus
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Значение Object::Status.

    2.3.38.9. Tablespace::getObjectVersion()

    Описание. Этот метод получает версию объекта табличного пространства (см. NDB Schema Object Versions).

    Сигнатура.

    virtual int getObjectVersion
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Версия объекта как integer.

    2.3.38.10. Tablespace::setAutoGrowSpecification()

    Описание. Этот метод используется, чтобы установить особенности табличного пространства.

    Сигнатура.

    void setAutoGrowSpecification
    (
      const AutoGrowSpecification& autoGrowSpec
    )
    

    Параметры. Этот метод берет единственный параметр, структуру данных AutoGrowSpecification.

    Возвращаемое значение. Нет.

    2.3.38.11. Tablespace::setDefaultLogfileGroup()

    Описание. Этот метод используется, чтобы установить группу файла журнала табличного пространства по умолчанию.

    Сигнатура. Этот метод можно назвать двумя различными способами. Первый использует имя группы файла журнала, как показано здесь:

    void setDefaultLogfileGroup
    (
      const char* name
    )
    

    Этот метод можно также вызвать, передав ему ссылку на объект LogfileGroup:

    void setDefaultLogfileGroup
    (
      const class LogfileGroup& lGroup
    )
    

    Нет никакого метода для установки группы файла журнала как умолчание для табличного пространства, ссылаясь на ID группы файла журнала. Другими словами, нет метода set*() , соответствующего getDefaultLogfileGroupId() .

    Параметры. name группы файла журнала, которая будет назначена на табличное пространство или ссылка lGroup на группу файла журнала.

    Возвращаемое значение. Нет.

    2.3.38.12. Tablespace::setExtentSize()

    Описание. Этот метод устанавливает размер экстента табличного пространства.

    Сигнатура.

    void setExtentSize
    (
      Uint32 size
    )
    

    Параметры. size для экстентов этого табличного пространства в байтах.

    Возвращаемое значение. Нет.

    2.3.38.13. Tablespace::setName()

    Описание. Этот метод определяет имя табличного пространства.

    Сигнатура.

    void setName
    (
      const char* name
    ) const
    

    Параметры. Имя name табличного пространства, последовательность (указатель на символ).

    Возвращаемое значение. Нет.

    2.3.39. Класс undofile

    Резюме

    Секция обсуждает класс undofile и его пбуличные методы.

    Родительский класс. NdbDictionary .

    Дочерние классы. Нет.

    Описание. Класс undofile моделирует файл отмен NDB Cluster Disk Data, который хранит данные, используемые для того, чтобы отменить транзакции.

    В настоящее время только неиндексируемые данные столбца могут храниться на диске. Индексы и колонки индексов всегда хранятся в памяти.

    NDB Cluster до MySQL 5.1 не поддерживает хранение Disk Data и файлы отмен, поэтому класс undofile недоступен приложениям API NDB, написанным для этих версий.

    Методы.

    Таблица 2.89.

    Имя Описание
    undofile() Конструктор класса
    ~undofile() Виртуальный деструктор
    getFileNo() Удалено в NDB 7.5.0 (Bug #47960, Bug #11756088)
    getLogfileGroup() Получает имя группы файла журнала, которой принадлежит файл отмен
    getLogfileGroupId() Получает ID группы файла журнала, которой принадлежит файл отмен
    getNode() Удалено в NDB 7.5.0 (Bug #47960, Bug #11756088)
    getObjectId() Получает идентификатор объекта файла отмен
    getObjectStatus() Получает Status файла отмен
    getObjectVersion() Получает версию объекта файла отмен
    getPath() Получает путь файловой системы файла отмен
    getSize() Получает размер файла отмен
    setLogfileGroup() Устанавливает группу файла журнала файла отмен, используя имя группы файла журнала или ссылку на объект LogfileGroup
    setNode() Удалено в NDB 7.5.0 (Bug #47960, Bug #11756088)
    setPath() Устанавливает путь файловой системы для файла отмен
    setSize() Устанавливает размер файла отмен

    Типы. Класс undofile не определяет публичных типов.

    2.3.39.1. Конструктор undofile

    Описание. Конструктор класса может использоваться, чтобы создать новый экземпляр undofile или скопировать существующий.

    Сигнатуры. Создает новый экземпляр:

    undofile
    (
      void
    )
    

    Конструктор копии:

    undofile
    (
      const undofile& undofile
    )
    

    Параметры. Новый экземпляр: Нет . Конструктор копии: берет отдельный аргумент, ссылку на копируемый undofile.

    Возвращаемое значение. Объект undofile.

    Деструктор. Класс определяет виртуальный деструктор, который не берет аргументов и имеет тип возвращения void.

    2.3.39.2. undofile::getFileNo()

    Описание. Этот метод не работал, как предназначено и был удален в NDB 7.5.0 (Bug #47960, Bug #11756088).

    Сигнатура.

    Uint32 getFileNo
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Количество файлов отмен как unsigned 32-bit integer.

    2.3.39.3. undofile::getLogfileGroup()

    Описание. Этот метод получает имя группы файла журнала, которой принадлежит файл отмен.

    Сигнатура.

    const char* getLogfileGroup
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Имя группы файла журнала, значение последовательности (как указатель на символ).

    2.3.39.4. undofile::getLogfileGroupId()

    Описание. Этот метод получает ID группы файла журнала, которой принадлежит файл отмен.

    Также возможно получить имя группы файла журнала непосредственно. Посмотрите раздел 2.3.39.3

    Сигнатура.

    Uint32 getLogfileGroupId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. ID группы файла журнала как unsigned 32-bit integer.

    2.3.39.5. undofile::getNode()

    Описание. Этот метод не работал, как предназначено и был удален в NDB 7.5.0 (Bug #47960, Bug #11756088).

    Сигнатура.

    Uint32 getNode
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. ID узла как unsigned 32-bit integer.

    2.3.39.6. undofile::getObjectId()

    Описание. Этот метод получает идентификатор объекта файла отмен.

    Сигнатура.

    virtual int getObjectId
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Идентификатор объекта как integer.

    2.3.39.7. undofile::getObjectStatus()

    Описание. Этот метод используется, чтобы получить статус объекта файла отмен.

    Сигнатура.

    virtual Object::Status getObjectStatus
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Значение Object::Status.

    2.3.39.8. undofile::getObjectVersion()

    Описание. Этот метод получает версию объекта файла отмен (см. NDB Schema Object Versions).

    Сигнатура.

    virtual int getObjectVersion
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Версия объекта как integer.

    2.3.39.9. undofile::getPath()

    Описание. Этот метод получает путь, соответствующий местоположению файла отмен в файловой системе узла данных.

    Сигнатура.

    const char* getPath
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Путь файловой системы (как указатель на символ).

    2.3.39.10. undofile::getSize()

    Описание. Этот метод получает размер файла отмен в байтах.

    Сигнатура.

    Uint64 getSize
    (
      void
    ) const
    

    Параметры. Нет.

    Возвращаемое значение. Размер в байтах файла отмен как unsigned 64-bit integer.

    2.3.39.11. undofile::setLogfileGroup()

    Описание. Учитывая имя или ссылку на объект группы файла журнала метод setLogfileGroup() назначает файл отмен на эту группу файла журнала.

    Сигнатура. Используя название группы файла журнала:

    void setLogfileGroup
    (
      const char* name
    )
    

    Используя ссылку на экземпляр LogfileGroup:

    void setLogfileGroup
    (
      const class LogfileGroup & logfileGroup
    )
    

    Параметры. Имя name группы файла журнала (указатель на символ) или ссылка на экземпляр LogfileGroup.

    Возвращаемое значение. Нет.

    2.3.39.12. undofile::setNode()

    Описание. Этот метод не работал, как предназначено и был удален в NDB 7.5.0 (Bug #47960, Bug #11756088).

    Сигнатура.

    void setNode
    (
      Uint32 nodeId
    )
    

    Параметры. nodeId узла данных, куда файл отмен должен быть помещен, unsigned 32-bit integer.

    Возвращаемое значение. Нет.

    2.3.39.13. undofile::setPath()

    Описание. Этот метод используется, чтобы установить путь файловой системы файла отмен на узле данных, где это находится.

    Сигнатура.

    void setPath
    (
      const char* path
    )
    

    Параметры. Желаемый путь path к файлу отмен.

    Возвращаемое значение. Нет.

    2.3.39.14. undofile::setSize()

    Описание. Устанавливает размер файла отмен в байтах.

    Сигнатура.

    void setSize
    (
    Uint64 size
    )
    

    Параметры. Намеченный размер size файла отмен в байтах, unsigned 64-bit integer.

    Возвращаемое значение. Нет.

    2.4. Ошибки NDB API и обработка ошибок

    Резюме

    Эта секция содержит обсуждение обработки ошибок в приложениях NDB API а также списки листингов наиболее распространенных кодов ошибок и сообщений NDB с их классификациями и вероятными причинами, для которого они могли бы быть подняты.

    Для получения информации о структуре NdbError, которая используется, чтобы передать информацию об ошибке приложениям API NDB, см. раздел 2.3.20.

    Сильно рекомендуется, чтобы вы НЕ зависели от определенных кодов ошибок в вашем приложении NDB API, поскольку они подвержены изменениям со временем. Вместо этого необходимо использовать NdbError::Status и классификация ошибок в вашем исходном коде или работать с выводом perror --ndb error_code, чтобы получить информацию об определенном коде ошибки.

    Если вы находите ситуацию, в которой необходимо использовать определенный код ошибки, пожалуйста, подайте отчет об ошибках на http://bugs.mysql.com/, чтобы мы могли обновить соответствующий статус и классификацию.

    2.4.1. Обработка ошибки NDB API

    Резюме

    Эта секция описывает, как ошибки API NDB могут быть обнаружены и отображены на конкретные операции.

    NDB API можно получить любым из двух способов:

    • Когда операция определяется

    • Когда операция выполняется

    Ошибки во время операционного определения. Ошибки, произведенные во время операционного определения, приводят к коду возврата неудачи из названного метода. Фактическая ошибка может быть определена, исследовав соответствующий объект NdbOperation или объект NdbTransaction.

    Ошибки во время операционного выполнения. Ошибки, происходящие во время операционного выполнения, вызывают прерывание транзакции, если опция AO_IgnoreError установлена для операции.

    По умолчанию операции чтения работают с AO_IgnoreError, а операции записи с AbortOnError, но это может быть отвергнуто пользователем. Когда ошибка во время выполнения заставляет транзакцию быть прерванной, метод execute() вернет код возврата неудачи. Если ошибка проигнорирована из-за AO_IgnoreError, метод execute() возвращает код успеха, и пользователь должен исследовать все операции на неудачу с использованием NdbOperation::getNdbError(). Поэтому возвращаемое значение getNdbError() обычно должно проверяться, даже если execute() возвращает успех. Если клиентское приложение не отслеживает объекты NdbOperation во время выполнения, тогда NdbTransaction::getNextCompletedOperation() может использоваться для итерации по ним.

    Необходимо также знать, что использование NdbBlob может привести к дополнительным операциям, добавляемым к выполненным пакетам. Это означает что, итерируя законченную операцию с использованием getNextCompletedOperation(), можно столкнуться с операциями, связанными с объектами NdbBlob, которые не были определены вашим запросом.

    Чтение с LockMode = CommittedRead не может быть AbortOnError. В этом случае это всегда IgnoreError.

    Во всех экземплярах, где определенные для операции ошибки возникают, ошибка выполнения с операцией отмечена для операции и связанного операционного объекта. Где есть многократные операционные ошибки на одном вызове NdbTransaction::execute(), из-за операционного группирования и использования AO_IgnoreError, только первый отмечен для объекта NdbTransaction. Остающиеся ошибки зарегистрированы только для соответствующего объекта NdbOperation.

    Также возможно для ошибок произойти во время выполнения, например, неудача узла данных, такие ситуации отмечены для операционного объекта, но не для основных объектов операции. Это вызвано тем, что эти ошибки относятся к транзакции в целом, а не к отдельным операциям в транзакции.

    Поэтому приложения должны использовать NdbTransaction::getNdbError() как первый способ определить успех NdbTransaction::execute(). Если пакет выполняемых операций включает операции с опцией AO_IgnoreError, возможно, что были многократные отказы, и законченные операции должны быть проверены индивидуально на ошибки использованием NdbOperation::getNdbError().

    Неявный вызов NdbTransaction::execute() в методах BLOB и просмотре. Операции по просмотру выполняются таким же образом как другие операции, и также имеют неявный вызов execute() в рамках NdbScanOperation::nextResult(). Когда NdbScanOperation::nextResult() указывает на неудачу (то есть, если метод возвращает -1), операционный объект должен быть проверен на ошибку. NdbScanOperation может также содержать ошибку, но только если ошибка не определенная для операции.

    Некоторые методы обработки BLOB также имеют неявный внутренний вызов execute() и могут испытать операционные неудачи выполнения в этих пунктах. Следующие методы NdbBlob могут произвести неявный вызов execute(), это означает, что они также требуют проверки объекта NdbTransaction на ошибки через NdbTransaction::getNdbError(), если они возвращают код ошибки:

    • setNull()

    • truncate()

    • readData()

    • writeData()

    Резюме. В целом для ошибки возможно произойти во время выполнения (приводя к коду возврата неудачи), вызывая любой из следующих методов:

    Если это происходит, метод NdbTransaction::getNdbError() нужно вызвать, чтобы определить первую ошибку, которая произошла. Когда операции собраны в пакет и есть операции с IgnoreError в пакете, могут быть многократные операции с ошибками в транзакции. Они могут быть найдены при помощи NdbTransaction::getNextCompletedOperation(), чтобы итерировать по набору законченных операций, вызывая для каждой NdbOperation::getNdbError().

    Когда IgnoreError установлена на любой операции в пакете, метод NdbTransaction::execute() указывает на успех даже там, где ошибки на самом деле произошли, пока ни одна из этих ошибок не заставила транзакцию быть прерванной. Чтобы определить, были ли какие-либо проигнорированные ошибки, операционный ошибочный статус должен быть проверен, используя NdbTransaction::getNdbError(). Только если это указывает на успех, вы можете быть уверены, что никакие ошибки не произошли. Если код ошибки возвращен этим методом, и операции были собраны в пакет, то необходимо пройти по всем законченным операциям, чтобы найти все операции с проигнорированными ошибками.

    Пример (pseudocode). Мы начинаем, выполняя транзакцию, которая, возможно, скомплектовала операции установила опции AO_IgnoreError и AbortOnError:

    int execResult= NdbTransaction.execute(args);
    

    Для числа и разрешенных значений args см. раздел 2.3.30.6.

    Затем, потому что ошибки в операциях с AO_IgnoreError не затрагивают execResult, то есть, значение, возвращенное execute(), мы проверяем ошибки в транзакции:

    NdbError err= NdbTransaction.getNdbError();
    if (err.code != 0)
    {
    

    Ненулевое значение для кода ошибки означает, что ошибка была поднята в транзакции. Это могло произойти из-за любого из следующих условий:

    • Ошибка всей транзакции, такая как неудача узла данных, которая заставила транзакцию быть прерванной

    • Единственная определенная для операции ошибка, такая как ограничительное нарушение, которое заставило транзакцию быть прерванной

    • Единственная определенная для операции проигнорированная ошибка, такая как ек найденные данные, которая не заставила транзакцию быть прерванной

    • Первая из многих определенных для операции проигнорированных ошибок, таких как данные не найдены, которая не заставила транзакцию быть прерванной

    • Первая из многих определенных для операции проигнорированных ошибок, таких как не найденные данные перед операционной ошибкой прерывания (прерванная транзакция)

    if (execResult != 0)
    {
    

    Транзакция была прервана. Рекомендуемая стратегия обработки ошибки в этом случае состоит в том, чтобы проверить операционный ошибочный статус и принять соответствующие меры на основе его значения:

    switch (err.status)
    {
      case value1:
      //statement block handling value1 ...
      case value2:
      //statement block handling value2 ...
      //(etc. ...)
      case valueN:
      //statement block handling valueN ...
    }
    

    Так как транзакция была прервана, вообще необходимо пройти по законченным операциям (если таковые имеются) и учесть ошибки, поднятые каждой операцией, только если вы хотите сделать так для сообщения о причинах.

    } else {
    

    Сама транзакция не была прервана, но должна быть одна или несколько проигнорированных ошибок. В этом случае необходимо пройти по операциям, чтобы определить, что произошло и обращаться с причиной соответственно.

      }
    }
    

    Чтобы обработать NdbScanOperation::nextResult(), который возвращает -1, указывая, что операция потерпела неудачу:

    int nextrc= NdbScanOperation.nextResult(args);
    

    Для числа и разрешенных значений args см. раздел 2.3.29.6.

    if (nextrc == -1)
    {
    

    Во-первых, необходимо проверить объект NdbScanOperation для любых ошибок:

    NdbError err= NdbScanOperation.getNdbError();
    if (err.code == 0)
    {
    

    Если никакая ошибка не была найдена в операции по просмотру, ошибка должна принадлежать всей транзакции.

    }
    err= NdbTransaction.getNdbError();
    

    Теперь можно обработать ошибку на основе ошибочного статуса:

    switch (err.status)
    {
      case value1:
      //statement block handling value1 ...
      case value2:
      //statement block handling value2 ...
      //(etc. ...)
      case valueN:
      //statement block handling valueN ...
      }
    }
    

    Для получения информации об ошибочных классификационных кодах API NDB и кодах статусов посмотрите раздел 2.4.4. В то время как вы не должны полагаться на определенный код ошибки или текст сообщения в ваших приложениях API NDB, коды ошибок и сообщения подлежат изменению со временем, может быть полезно проверить коды ошибок и сообщения, чтобы помочь определить, почему произошла конкретная неудача. Для получения дополнительной информации о них, посмотрите раздел 2.4.2. Для подробностей о NdbError и типах информации, которая может быть получена из объектов NdbError см. раздел 2.3.20.

    2.4.2. Коды ошибок NDB: типы

    Эта секция содержит много списков кодов ошибок, один для каждого типа ошибки API NDB. Ошибочные типы включают следующее:

    • Нет ошибки

    • Ошибка приложения

    • Ошибка приложения просмотра

    • Конфигурация или ошибка приложения

    • Никакие данные не найдены

    • Ограничительное нарушение

    • Ошибка схемы

    • Пользователь определил ошибку

    • Недостаточно места

    • Временная ошибка ресурса

    • Ошибка восстановления узла

    • Ошибка перегрузки

    • Тайм-аут кончился

    • Закрытие узла

    • Внутренний временный сбой

    • Неизвестная ошибка результата

    • Неизвестный (в настоящее время неиспользованный) код ошибки

    • Внутренняя ошибка

    • Функция не реализована

    Информация в каждом списке включает для каждой ошибки:

    • Код ошибки NDB

    • Соответствующий код ошибки MySQL

    • Классификационный код NDB

      См. раздел 2.4.4 для значений этих классификационных кодов.

    • Текст сообщения об ошибке

    Подобные ошибки сгруппированы в каждом списке. Каждый список упорядочен в алфавитном порядке.

    Можно всегда получать последние коды ошибок и информацию от файла storage/ndb/src/ndbapi/ndberror.cpp. (в предыдущих выпусках NDB Cluster этот файл был ndberror.c).

    Эти типы также показывают в столбце error_status таблицы ndbinfo.error_messages.

    2.4.2.1. Нет ошибки

    0

    Ошибка MySQL. 0

    Сообщение об ошибке. No error

    2.4.2.2. Ошибка приложения

    1233

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Table read-only

    1302

    Ошибка MySQL. DMEC

    Сообщение об ошибке. A backup is already running

    1306

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Backup not supported in diskless mode (change Diskless)

    1329

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Backup during software upgrade not supported

    1342

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Backup failed to allocate buffers (check configuration)

    1343

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Backup failed to setup fs buffers (check configuration)

    1344

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Backup failed to allocate tables (check configuration)

    1345

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Backup failed to insert file header (check configuration)

    1346

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Backup failed to insert table list (check configuration)

    1347

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Backup failed to allocate table memory (check configuration)

    1348

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Backup failed to allocate file record (check configuration)

    1349

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Backup failed to allocate attribute record (check configuration)

    1701

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Node already reserved

    1702

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Node already connected

    1704

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Node type mismatch

    21000

    Ошибка MySQL. HA_ERR_CANNOT_ADD_FOREIGN

    Сообщение об ошибке. Create foreign key failed - parent key is primary key and on-update-cascade is not allowed

    21026

    Ошибка MySQL. HA_ERR_CANNOT_ADD_FOREIGN

    Сообщение об ошибке. Create foreign key failed in NDB - parent index is not unique index

    21033

    Ошибка MySQL. HA_ERR_CANNOT_ADD_FOREIGN

    Сообщение об ошибке. Create foreign key failed in NDB - No parent row found

    21034

    Ошибка MySQL. HA_ERR_CANNOT_ADD_FOREIGN

    Сообщение об ошибке. Create foreign key failed - child table has Blob or Text column and on-delete-cascade is not allowed

    21040

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Drop foreign key failed in NDB - foreign key not found

    21060

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Build foreign key failed in NDB - foreign key not found

    21080

    Ошибка MySQL. HA_ERR_ROW_IS_REFERENCED

    Сообщение об ошибке. Drop table not allowed in NDB - referenced by foreign key on another table

    21081

    Ошибка MySQL. HA_ERR_DROP_INDEX_FK

    Сообщение об ошибке. Drop index not allowed in NDB - used as parent index of a foreign key

    21082

    Ошибка MySQL. HA_ERR_DROP_INDEX_FK

    Сообщение об ошибке. Drop index not allowed in NDB - used as child index of a foreign key

    21090

    Ошибка MySQL. HA_ERR_CANNOT_ADD_FOREIGN

    Сообщение об ошибке. Create foreign key failed in NDB - name contains invalid character (/)

    242

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Zero concurrency in scan

    244

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too high concurrency in scan

    261

    Ошибка MySQL. DMEC

    Сообщение об ошибке. DML count in transaction exceeds config parameter MaxDMLOperationsPerTransaction/MaxNoOfConcurrentOperations

    269

    Ошибка MySQL. DMEC

    Сообщение об ошибке. No condition and attributes to read in scan

    281

    Ошибка MySQL. HA_ERR_NO_CONNECTION

    Сообщение об ошибке. Operation not allowed due to cluster shutdown in progress

    299

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Operation not allowed or aborted due to single user mode

    311

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Undefined partition used in setPartitionId

    320

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid no of nodes specified for new nodegroup

    321

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid nodegroup id

    322

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid node(s) specified for new nodegroup, node already in nodegroup

    323

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid nodegroup id, nodegroup already existing

    324

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid node(s) specified for new nodegroup, no node in nodegroup is started

    325

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid node(s) specified for new nodegroup, node ID invalid or undefined

    4004

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Attribute name or id not found in the table

    4100

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Status Error in NDB

    4101

    Ошибка MySQL. DMEC

    Сообщение об ошибке. No connections to NDB available and connect failed

    4102

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Type in NdbTamper not correct

    4103

    Ошибка MySQL. DMEC

    Сообщение об ошибке. No schema connections to NDB available and connect failed

    4104

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Ndb Init in wrong state, destroy Ndb object and create a new

    4105

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too many Ndb objects

    4106

    Ошибка MySQL. DMEC

    Сообщение об ошибке. All Not NULL attribute have not been defined

    4114

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Transaction is already completed

    4116

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Operation was not defined correctly, probably missing a key

    4117

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Could not start transporter, configuration error

    4118

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Parameter error in API call

    4120

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Scan already complete

    4121

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Cannot set name twice for an Ndb object

    4122

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Cannot set name after Ndb object is initialised

    4123

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Free percent out of range. Allowed range is 1-99

    417

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Bad operation reference - double unlock

    4200

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Status Error when defining an operation

    4201

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Variable Arrays not yet supported

    4202

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Set value on tuple key attribute is not allowed

    4203

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Trying to set a NOT NULL attribute to NULL

    4204

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Set value and Read/Delete Tuple is incompatible

    4205

    Ошибка MySQL. DMEC

    Сообщение об ошибке. No Key attribute used to define tuple

    4206

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Not allowed to equal key attribute twice

    4207

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Key size is limited to 4092 bytes

    4208

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Trying to read a non-stored attribute

    4209

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Length parameter in equal/setValue is incorrect

    4210

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Ndb sent more info than the length he specified

    4211

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Inconsistency in list of NdbRecAttr-objects

    4212

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Ndb reports NULL value on Not NULL attribute

    4213

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Not all data of an attribute has been received

    4214

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Not all attributes have been received

    4215

    Ошибка MySQL. DMEC

    Сообщение об ошибке. More data received than reported in TCKEYCONF message

    4216

    Ошибка MySQL. DMEC

    Сообщение об ошибке. More than 8052 bytes in setValue cannot be handled

    4217

    Ошибка MySQL. DMEC

    Сообщение об ошибке. It is not allowed to increment any other than unsigned ints

    4218

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Currently not allowed to increment NULL-able attributes

    4219

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Maximum size of interpretative attributes are 64 bits

    4220

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Maximum size of interpretative attributes are 64 bits

    4221

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Trying to jump to a non-defined label

    4222

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Label was not found, internal error

    4223

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Not allowed to create jumps to yourself

    4224

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Not allowed to jump to a label in a different subroutine

    4225

    Ошибка MySQL. DMEC

    Сообщение об ошибке. All primary keys defined, call setValue/getValue

    4226

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Bad number when defining a label

    4227

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Bad number when defining a subroutine

    4228

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Illegal interpreter function in scan definition

    4229

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Illegal register in interpreter function definition

    4230

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Illegal state when calling getValue, probably not a read

    4231

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Illegal state when calling interpreter routine

    4232

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Parallelism can only be between 1 and 240

    4233

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Calling execute (synchronous) when already prepared asynchronous transaction exists

    4234

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Illegal to call setValue in this state

    4235

    Ошибка MySQL. DMEC

    Сообщение об ошибке. No callback from execute

    4236

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Trigger name too long

    4237

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too many triggers

    4238

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Trigger not found

    4239

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Trigger with given name already exists

    4240

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Unsupported trigger type

    4241

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index name too long

    4242

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too many indexes

    4243

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index not found

    4247

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Illegal index/trigger create/drop/alter request

    4248

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Trigger/index name invalid

    4249

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid table

    4250

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid index type or index logging option

    4251

    Ошибка MySQL. HA_ERR_FOUND_DUPP_UNIQUE

    Сообщение об ошибке. Cannot create unique index, duplicate keys found

    4252

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Failed to allocate space for index

    4253

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Failed to create index table

    4254

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Table not an index table

    4255

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Hash index attributes must be specified in same order as table attributes

    4256

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Must call Ndb::init() before this function

    4257

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Tried to read too much - too many getValue calls

    4258

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Cannot create unique index, duplicate attributes found in definition

    4259

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid set of range scan bounds

    4264

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid usage of blob attribute

    4265

    Ошибка MySQL. DMEC

    Сообщение об ошибке. The method is not valid in current blob state

    4266

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid blob seek position

    4271

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid index object, not retrieved via getIndex()

    4272

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Table definition has undefined column

    4275

    Ошибка MySQL. DMEC

    Сообщение об ошибке. The blob method is incompatible with operation type or lock mode

    4276

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Missing NULL ptr in end of keyData list

    4277

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Key part len is to small for column

    4278

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Supplied buffer to small

    4279

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Malformed string

    4280

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Inconsistent key part length

    4281

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too many keys specified for key bound in scanIndex

    4282

    Ошибка MySQL. DMEC

    Сообщение об ошибке. range_no not strictly increasing in ordered multi-range index scan

    4283

    Ошибка MySQL. DMEC

    Сообщение об ошибке. key_record in index scan is not an index ndbrecord

    4284

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Cannot mix NdbRecAttr and NdbRecord methods in one operation

    4285

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NULL NdbRecord pointer

    4286

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid range_no (must be < 4096)

    4287

    Ошибка MySQL. DMEC

    Сообщение об ошибке. The key_record and attribute_record in primary key operation do not belong to the same table

    4288

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Blob handle for column not available

    4289

    Ошибка MySQL. DMEC

    Сообщение об ошибке. API version mismatch or wrong sizeof(NdbDictionary::RecordSpecification)

    4290

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Missing column specification in NdbDictionary::RecordSpecification

    4291

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Duplicate column specification in NdbDictionary::RecordSpecification

    4292

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NdbRecord for tuple access is not an index key NdbRecord

    4293

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Error returned from application scanIndex() callback

    4294

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Scan filter is too large, discarded

    4295

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Column is NULL in Get/SetValueSpec structure

    4296

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid AbortOption

    4297

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid or unsupported OperationOptions structure

    4298

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid or unsupported ScanOptions structure

    4299

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Incorrect combination of ScanOption flags, extraGetValues ptr and numExtraGetValues

    4300

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Tuple Key Type not correct

    4301

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Fragment Type not correct

    4302

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Minimum Load Factor not correct

    4303

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Maximum Load Factor not correct

    4304

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Maximum Load Factor smaller than Minimum

    4305

    Ошибка MySQL. DMEC

    Сообщение об ошибке. K value must currently be set to 6

    4306

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Memory Type not correct

    4307

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid table name

    4308

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Attribute Size not correct

    4309

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Fixed array too large, maximum 64000 bytes

    4310

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Attribute Type not correct

    4311

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Storage Mode not correct

    4312

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Null Attribute Type not correct

    4313

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index only storage for non-key attribute

    4314

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Storage Type of attribute not correct

    4315

    Ошибка MySQL. DMEC

    Сообщение об ошибке. No more key attributes allowed after defining variable length key attribute

    4316

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Key attributes are not allowed to be NULL attributes

    4317

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too many primary keys defined in table

    4318

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid attribute name or number

    4319

    Ошибка MySQL. DMEC

    Сообщение об ошибке. createAttribute called at erroneus place

    4322

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Attempt to define distribution key when not prepared to

    4323

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Distribution Key set on table but not defined on first attribute

    4324

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Attempt to define distribution group when not prepared to

    4325

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Distribution Group set on table but not defined on first attribute

    4326

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Distribution Group with erroneus number of bits

    4327

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Distribution key is only supported on part of primary key

    4328

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Disk memory attributes not yet supported

    4329

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Variable stored attributes not yet supported

    4335

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Only one autoincrement column allowed per table. Having a table without primary key uses an autoincremented hidden key, i.e. a table without a primary key can not have an autoincremented column

    4340

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Result or attribute record must be a base table ndbrecord, not an index ndbrecord

    4341

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Not all keys read when using option SF_OrderBy

    4342

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Scan defined but not prepared

    4343

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Table with blobs does not support refresh

    4400

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Status Error in NdbSchemaCon

    4401

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Only one schema operation per schema transaction

    4402

    Ошибка MySQL. DMEC

    Сообщение об ошибке. No schema operation defined before calling execute

    4410

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Schema transaction is already started

    4411

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Schema transaction not possible until upgrade complete

    4412

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Schema transaction is not started

    4501

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Insert in hash table failed when getting table information from Ndb

    4502

    Ошибка MySQL. DMEC

    Сообщение об ошибке. GetValue not allowed in Update operation

    4503

    Ошибка MySQL. DMEC

    Сообщение об ошибке. GetValue not allowed in Insert operation

    4504

    Ошибка MySQL. DMEC

    Сообщение об ошибке. SetValue not allowed in Read operation

    4505

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NULL value not allowed in primary key search

    4506

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Missing getValue/setValue when calling execute

    4507

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Missing operation request when calling execute

    4508

    Ошибка MySQL. DMEC

    Сообщение об ошибке. GetValue not allowed for NdbRecord defined operation

    4509

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Non SF_MultiRange scan cannot have more than one bound

    4510

    Ошибка MySQL. DMEC

    Сообщение об ошибке. User specified partition id not allowed for scan takeover operation

    4511

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Blobs not allowed in NdbRecord delete result record

    4512

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Incorrect combination of OperationOptions optionsPresent, extraGet/SetValues ptr and numExtraGet/SetValues

    4513

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Only one scan bound allowed for non-NdbRecord setBound() API

    4514

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Can only call setBound/equal() for an NdbIndexScanOperation

    4515

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Method not allowed for NdbRecord, use OperationOptions or ScanOptions structure instead

    4516

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Illegal instruction in interpreted program

    4517

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Bad label in branch instruction

    4518

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too many instructions in interpreted program

    4519

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NdbInterpretedCode::finalise() not called

    4520

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Call to undefined subroutine

    4521

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Call to undefined subroutine, internal error

    4522

    Ошибка MySQL. DMEC

    Сообщение об ошибке. setBound() called twice for same key

    4523

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Pseudo columns not supported by NdbRecord

    4524

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NdbInterpretedCode is for different table

    4535

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Attempt to set bound on non key column

    4536

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NdbScanFilter constructor taking NdbOperation is not supported for NdbRecord

    4537

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Wrong API. Use NdbInterpretedCode for NdbRecord operations

    4538

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NdbInterpretedCode instruction requires that table is set

    4539

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NdbInterpretedCode not supported for operation type

    4540

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Attempt to pass an Index column to createRecord. Use base table columns only

    4542

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Unknown partition information type

    4543

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Duplicate partitioning information supplied

    4544

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Wrong partitionInfo type for table

    4545

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid or Unsupported PartitionInfo structure

    4546

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Explicit partitioning info not allowed for table and operation

    4547

    Ошибка MySQL. DMEC

    Сообщение об ошибке. RecordSpecification has overlapping offsets

    4548

    Ошибка MySQL. DMEC

    Сообщение об ошибке. RecordSpecification has too many elements

    4549

    Ошибка MySQL. DMEC

    Сообщение об ошибке. getLockHandle only supported for primary key read with a lock

    4550

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Cannot releaseLockHandle until operation executed

    4551

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NdbLockHandle already released

    4552

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NdbLockHandle does not belong to transaction

    4553

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NdbLockHandle original operation not executed successfully

    4554

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NdbBlob can only be closed from Active state

    4555

    Ошибка MySQL. DMEC

    Сообщение об ошибке. NdbBlob cannot be closed with pending operations

    4556

    Ошибка MySQL. DMEC

    Сообщение об ошибке. RecordSpecification has illegal value in column_flags

    4557

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Column types must be identical when comparing two columns

    4600

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Transaction is already started

    4601

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Transaction is not started

    4602

    Ошибка MySQL. DMEC

    Сообщение об ошибке. You must call getNdbOperation before executeScan

    4603

    Ошибка MySQL. DMEC

    Сообщение об ошибке. There can only be ONE operation in a scan transaction

    4604

    Ошибка MySQL. DMEC

    Сообщение об ошибке. takeOverScanOp, to take over a scanned row one must explicitly request keyinfo on readTuples call

    4605

    Ошибка MySQL. DMEC

    Сообщение об ошибке. You may only call readTuples() once for each operation

    4607

    Ошибка MySQL. DMEC

    Сообщение об ошибке. There may only be one operation in a scan transaction

    4608

    Ошибка MySQL. DMEC

    Сообщение об ошибке. You can not takeOverScan unless you have used openScanExclusive

    4609

    Ошибка MySQL. DMEC

    Сообщение об ошибке. You must call nextScanResult before trying to takeOverScan

    4707

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too many event have been defined

    4708

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Event name is too long

    4709

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Can't accept more subscribers

    4710

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Event not found

    4711

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Creation of event failed

    4712

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Stopped event operation does not exist. Already stopped?

    4714

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index stats sys tables NDB_INDEX_STAT_PREFIX do not exist

    4715

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index stats for specified index do not exist

    4716

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index stats methods usage error

    4717

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index stats cannot allocate memory

    4720

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index stats sys tables NDB_INDEX_STAT_PREFIX partly missing or invalid

    4723

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Mysqld: index stats request ignored due to recent error

    4724

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Mysqld: index stats request aborted by stats thread

    4725

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index stats were deleted by another process

    720

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Attribute name reused in table definition

    763

    Ошибка MySQL. DMEC

    Сообщение об ошибке. DDL is not supported with mixed data-node versions

    771

    Ошибка MySQL. HA_WRONG_CREATE_OPTION

    Сообщение об ошибке. Given NODEGROUP doesn't exist in this cluster

    776

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index created on temporary table must itself be temporary

    777

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Cannot create a temporary index on a non-temporary table

    778

    Ошибка MySQL. DMEC

    Сообщение об ошибке. A temporary table or index must be specified as not logging

    789

    Ошибка MySQL. HA_WRONG_CREATE_OPTION

    Сообщение об ошибке. Logfile group not found

    793

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Object definition too big

    794

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Schema feature requires data node upgrade

    798

    Ошибка MySQL. DMEC

    Сообщение об ошибке. A disk table must not be specified as no logging

    823

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too much attrinfo from application in tuple manager

    829

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Corrupt data received for insert/update

    831

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too many nullable/bitfields in table definition

    850

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too long or too short default value

    851

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Fixed-size column offset exceeded max. Use VARCHAR or COLUMN_FORMAT DYNAMIC for memory-stored columns

    874

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too much attrinfo (e.g. scan filter) for scan in tuple manager

    876

    Ошибка MySQL. DMEC

    Сообщение об ошибке. 876

    877

    Ошибка MySQL. DMEC

    Сообщение об ошибке. 877

    878

    Ошибка MySQL. DMEC

    Сообщение об ошибке. 878

    879

    Ошибка MySQL. DMEC

    Сообщение об ошибке. 879

    880

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Tried to read too much - too many getValue calls

    884

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Stack overflow in interpreter

    885

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Stack underflow in interpreter

    886

    Ошибка MySQL. DMEC

    Сообщение об ошибке. More than 65535 instructions executed in interpreter

    892

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Unsupported type in scan filter

    897

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Update attempt of primary key via ndbcluster internal api (if this occurs via the MySQL server it is a bug, please report)

    912

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index stat scan requested with wrong lock mode

    913

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid index for index stats update

    920

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Row operation defined after refreshTuple()

    INVALID_BLOCK_NAME

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid block name

    INVALID_ERROR_NUMBER

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid error number. Should be >= 0.

    INVALID_TRACE_NUMBER

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Invalid trace number.

    NODE_NOT_API_NODE

    Ошибка MySQL. DMEC

    Сообщение об ошибке. The specified node is not an API node.

    NODE_SHUTDOWN_IN_PROGESS

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Node shutdown in progress

    NODE_SHUTDOWN_WOULD_CAUSE_SYSTEM_CRASH

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Node shutdown would cause system crash

    NO_CONTACT_WITH_DB_NODES

    Ошибка MySQL. DMEC

    Сообщение об ошибке. No contact with database nodes }

    NO_CONTACT_WITH_PROCESS

    Ошибка MySQL. DMEC

    Сообщение об ошибке. No contact with the process (dead ?).

    OPERATION_NOT_ALLOWED_START_STOP

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Operation not allowed while nodes are starting or stopping.

    QRY_BATCH_SIZE_TOO_SMALL

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Batch size for sub scan cannot be smaller than number of fragments.

    QRY_CHAR_OPERAND_TRUNCATED

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Character operand was right truncated

    QRY_CHAR_PARAMETER_TRUNCATED

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Character Parameter was right truncated

    QRY_DEFINITION_TOO_LARGE

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Query definition too large.

    QRY_EMPTY_PROJECTION

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Query has operation with empty projection.

    QRY_HAS_ZERO_OPERATIONS

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Query defintion should have at least one operation.

    QRY_ILLEGAL_STATE

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Query is in illegal state for this operation.

    QRY_IN_ERROR_STATE

    Ошибка MySQL. DMEC

    Сообщение об ошибке. A previous query operation failed, which you missed to catch.

    QRY_MULTIPLE_PARENTS

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Multiple 'parents' specified in linkedValues for this operation

    QRY_MULTIPLE_SCAN_SORTED

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Query with multiple scans may not be sorted.

    QRY_NUM_OPERAND_RANGE

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Numeric operand out of range

    QRY_OPERAND_ALREADY_BOUND

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Can't use same operand value to specify different column values

    QRY_OPERAND_HAS_WRONG_TYPE

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Incompatible datatype specified in operand argument

    QRY_PARAMETER_HAS_WRONG_TYPE

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Parameter value has an incompatible datatype

    QRY_REQ_ARG_IS_NULL

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Required argument is NULL

    QRY_RESULT_ROW_ALREADY_DEFINED

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Result row already defined for NdbQueryOperation.

    QRY_SCAN_ORDER_ALREADY_SET

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Index scan order was already set in query definition.

    QRY_SEQUENTIAL_SCAN_SORTED

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Parallelism cannot be restricted for sorted scans.

    QRY_TOO_FEW_KEY_VALUES

    Ошибка MySQL. DMEC

    Сообщение об ошибке. All required 'key' values was not specified

    QRY_TOO_MANY_KEY_VALUES

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Too many 'key' or 'bound' values was specified

    QRY_UNKNOWN_PARENT

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Unknown 'parent' specified in linkedValue

    QRY_UNRELATED_INDEX

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Specified 'index' does not belong to specified 'table'

    QRY_WRONG_INDEX_TYPE

    Ошибка MySQL. DMEC

    Сообщение об ошибке. Wrong type of index specified for this operation