Кластер

​

Создание базы данных

CREATE DATABASE cluster_db
ENGINE = Cluster('cluster_name', 'database');

• cluster_name — имя кластера из конфигурации сервера (см. Кластеры), как в движке таблицы Distributed. Поддерживаются макросы, например {cluster}: они раскрываются при каждом обращении.
• database — имя базы данных в кластере.

• Доступ к таблице сейчас осуществляется через описанное выше переключение на удалённую реплику (на локальной реплике сегмента нет базы данных или таблицы). Таблица Distributed для всего кластера не выполняет такого переключения, а используемое при переключении подмножество кластера не имеет собственного имени.
• Имя кластера базы данных содержит макросы. Cluster раскрывает их при каждом обращении, а Distributed — только при создании таблицы. Поэтому после изменения конфигурации ни выражение с макросом, ни его текущее раскрытое значение не воспроизведут прежнее поведение.
• После повторной загрузки конфигурации кластер с одним сегментом может стать кластером с несколькими сегментами. Тогда действующая прокси-таблица получает неявный ключ rand() для распределения вставляемых строк, а в определении таблицы, сохранённом до повторной загрузки, этого ключа нет. Безусловное включение ключа в определение тоже не даёт эквивалентного результата: отдельная таблица Distributed использовала бы его для исключения сегментов при чтении, тогда как CREATE TABLE не позволяет задать ключ сегментирования только для вставки.

​

Примечания

• Движок предоставляет представление кластера только для чтения: CREATE TABLE, DROP TABLE, ALTER и аналогичные DDL-операторы для базы данных Cluster не поддерживаются. Управляйте схемой непосредственно в кластере, например с помощью DDL-запросов с предложением ON CLUSTER.
• Права доступа проверяются на удалённых серверах для пользователей, указанных в определении кластера (или для текущего пользователя, если кластер использует секрет для межсерверного взаимодействия), а локально — с учётом обычных привилегий для базы данных и её таблиц.
• Особенности работы движка баз данных Remote — правила видимости таблиц локального сегмента, полнота списка таблиц, сообщения об ошибках при недоступности кластера и цепочки прокси-баз данных — также относятся к движку Cluster; см. примечания к нему.

​

Пример

CREATE DATABASE cluster_db
ENGINE = Cluster('test_shard_localhost', 'default');

SHOW TABLES FROM cluster_db;

┌─name─┐
│ t    │
└──────┘

SELECT * FROM cluster_db.t;