Обзор тонких клиентов#

Тонкий клиент — легковесный клиент DataGrid, который подключается к кластеру по стандартному сокетному соединению. Он не является частью топологии кластера, не хранит данные и не используется в качестве пункта назначения для вычислений при использовании DataGrid в качестве Compute Grid. Тонкий клиент устанавливает сокетное соединение с серверным узлом DataGrid и выполняет все операции через него. Тонкие клиенты основаны на протоколе Binary Client, который позволяет поддерживать подключение DataGrid с любого языка программирования. Подробнее о протоколе написано в разделе «Обзор бинарного протокола клиента».

DataGrid поставляется со следующими тонкими клиентами:

• Тонкий клиент Java

• Тонкий клиент .NET/C#

• Тонкий клиент C++

• Тонкий клиент Python

• Тонкий клиент PHP

• Тонкий клиент Node.js

Функции тонких клиентов#

В таблице ниже описаны функции, которые поддерживает каждый клиент:

Отказоустойчивость клиентского соединения#

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

Partition Awareness#

Данные в кластере равномерно распределяются между узлами по соображениям масштабируемости и производительности. В каждом узле кластера сохранены подмножество данных и карта распределения партиций. Она используется для определения узла, в котором хранятся основная (primary) и резервная (backup) копии нужных записей. Подробнее о партицировании написано в подразделе «Партиционирование данных» раздела «Моделирование данных».

Функция Partition Awareness позволяет тонкому клиенту отправлять запросы напрямую узлу, который содержит нужные данные. Без этой функции приложение, которое подключено к кластеру с помощью тонкого клиента, выполняет все запросы и операции на одном серверном узле (он служит прокси-сервером для входящих запросов). Затем эти операции перенаправляются на узел, где хранятся нужные данные. Это приводит к возникновению узкого места, которое может помешать линейному масштабированию приложения.

Запросы должны проходить через прокси-сервер, откуда они перенаправляются на корректный узел:

С функцией Partition Awareness тонкий клиент может напрямую отправлять запросы основным узлам, где хранятся нужные данные. Функция устраняет узкое место и позволяет приложению проще масштабироваться:

Функция Partition Awareness доступна для тонких клиентов:

• Java

• .NET

• C++

• Python

• Node.js

Аутентификация#

Все тонкие клиенты поддерживают аутентификацию на стороне кластера. Она настраивается в конфигурации кластера, а клиент предоставляет учетные данные пользователя. Подробности настройки описаны в разделе каждого тонкого клиента.

Конфигурация кластера#

Параметры подключения тонкого клиента настраиваются в конфигурации клиентского коннектора. По умолчанию DataGrid принимает клиентские соединения через порт 10800. Можно изменить порт, размер буфера соединения и тайм-аут, включить TLS версии 1.2 и выше и так далее.

Конфигурация коннектора тонкого клиента#

Ниже описан пример настройки параметров подключения тонкого клиента:

<bean class="org.apache.ignite.configuration.IgniteConfiguration" id="ignite.cfg">
    <property name="clientConnectorConfiguration">
        <bean class="org.apache.ignite.configuration.ClientConnectorConfiguration">
            <property name="port" value="10000"/>
        </bean>
    </property>
</bean>

ClientConnectorConfiguration clientConnectorCfg = new ClientConnectorConfiguration();
// Установите диапазон портов от 10000 до 10005.
clientConnectorCfg.setPort(10000);
clientConnectorCfg.setPortRange(5);

IgniteConfiguration cfg = new IgniteConfiguration().setClientConnectorConfiguration(clientConnectorCfg);

// Запустите узел.
Ignite ignite = Ignition.start(cfg);

var cfg = new IgniteConfiguration
{
    ClientConnectorConfiguration = new ClientConnectorConfiguration
    {
        // Установите диапазон портов от 10000 до 10005.
        Port = 10000,
        PortRange = 5
    }
};

var ignite = Ignition.Start(cfg);

В таблице описаны параметры, которые можно изменить при настройке:

Полный список параметров находится в официальной документации Apache Ignite.

Переподключение тонкого клиента к кластеру и механизм троттлинга#

Политики переподключения#

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

• Клиент успешно переподключился к кластеру, продолжил работу и выполнил поставленные задачи.

• Клиент не смог переподключиться к кластеру и выполнить свои задачи. В этом случае необходимо перезапустить клиент вручную.

ClientConfiguration cfg = new ClientConfiguration(); // Создать объект конфигурации тонкого клиента (политика переподключения выбрана по умолчанию — `ClientRetryAllPolicy`).

cfg.setRetryPolicy(null); // Запретить переподключения (первый способ).
cfg.setRetryPolicy(new ClientRetryNonePolicy()); // Запретить переподключения (второй способ).
cfg.setRetryPolicy(new ClientRetryReadPolicy()); // Разрешить переподключения только для операций чтения.
cfg.setRetryPolicy(new ClientRetryAllPolicy()); // Разрешить переподключения для всех операций.

Троттлинг#

Троттлинг — механизм ограничения количества попыток совершить какую-либо операцию. Цель троттлинга тонких клиентов — ограничить попытки переподключения клиента к кластеру, чтобы его производительность не упала от большого количества запросов. Троттлинг в данном случае — дополнительная настройка клиента, которая устанавливает, как ему вести себя в рамках выбранной политики переподключения.

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

У параметров троттлинга меньший приоритет относительно настроек политики переподключения. Параметр reconnectThrottlingRetries определяет максимальное количество попыток переподключения в течение времени, которое задано в параметре reconnectThrottlingPeriod (только в рамках выбранной политики). Если количество попыток переподключения в течение тайм-аута исчерпано, можно дождаться его окончания и повторить попытки снова.

Значения параметров троттлнинга по умолчанию:

• reconnectThrottlingPeriod — 30 секунд;

• reconnectThrottlingRetries — 3 попытки.

Пример конфигурации тонкого клиента#

В примере ниже тонкий клиент настроен так, что попытки переподключения к кластеру будут производиться только для операций чтения. Общее количество таких попыток — 20. По параметрам троттлинга в течение 10 секунд клиент сможет попытаться переподключиться к кластеру не более 5 раз.

ClientConfiguration clientConfiguration = new ClientConfiguration();

clientConfiguration
    .setRetryPolicy(new ClientRetryReadPolicy())
    .setRetryLimit(20)
    .setReconnectThrottlingRetries(5)
    .setReconnectThrottlingPeriod(10_000);