add_peer
Определение
Добавляет новре отношение репликации (peer) между текущим кластером HBase и либо другим кластером HBase, либо настраиваемой конечной точкой репликации на основе предопределенного класса.
Следует помнить о следующих особенностях и ограничениях:
-
Чтобы настроить репликацию между двумя кластерами, обозначьте второй кластер, используя входной параметр
CLUSTER_KEY
. В противном случае используйте параметрENDPOINT_CLASSNAME
, чтобы определить кастомную replication endpoint. Следует указать либоCLUSTER_KEY
, либоENDPOINT_CLASSNAME
. ЕслиENDPOINT_CLASSNAME
задан, тоCLUSTER_KEY
является необязательным и должен указываться только в том случае, если этого требует конкретная настраиваемая replication endpoint. -
По умолчанию реплицируются только выбранные пространства имен и таблицы. Они должны быть определены параметрами
NAMESPACES
иTABLE_CFS
. Но также можно настроить репликацию для всех таблиц, установив флагREPLICATE_ALL
с помощью команды set_peer_replicate_all. -
Независимо от значения флага
REPLICATE_ALL
, реплицируются только таблицы с установленным флагомREPLICATION_SCOPE
. Чтобы установить этот флаг и сделать таблицу реплицируемой, используйте команду enable_table_replication. Чтобы сбросить флаг и отключить репликацию для таблицы, используйте команду disable_table_replication. Обратите внимание, что процесс репликации не может быть запущен для таблиц с отключенной репликацией, даже если эти таблицы выбраны в конфигурации узла. -
Входные параметры
NAMESPACES
иTABLE_CFS
связаны между собой. Нельзя устанавливать таблицы из пространств имен, которые уже определены параметромNAMESPACES
. -
Вы можете установить пространства имен репликации для peer позже с помощью команд append_peer_namespaces или set_peer_namespaces. Чтобы удалить пространства имен, выполните команду remove_peer_namespaces.
-
Вы можете установить таблицы/семейства столбцов репликации для peer позже с помощью команд append_peer_tableCFs или set_peer_tableCFs. Чтобы удалить таблицы/семейства столбцов, используется команда remove_peer_tableCFs.
ПРИМЕЧАНИЕ
Больше информации о настройке репликации доступно в документации HBase.
|
Использование
-
Репликация между кластерами HBase:
add_peer '<peer_id>', CLUSTER_KEY => '<cluster_key>'[, STATE => '<state>'][, NAMESPACES => <namespaces_array[]>][, TABLE_CFS => {'[<namespace_name>:]<table_name>' => <column_families_array[]>[,...]}]
-
Кастомная replication endpoint:
add_peer '<peer_id>', ENDPOINT_CLASSNAME => '<class_name>'[, CLUSTER_KEY => '<cluster_key>'][, STATE => '<state>'][, DATA => {'<key_name>' => <key_value>, [...]}][, CONFIG => {'<config_name>' => '<config_value>', [...]}][, NAMESPACES => <namespaces_array[]>][, TABLE_CFS => {'[<namespace_name>:]<table_name>' => <column_families_array[]>[,...]}]
Параметр | Описание |
---|---|
peer_id |
Уникальный идентификатор отношения репликации (peer). Значение не должно содержать дефисов |
cluster_key |
Полный адрес второго кластера HBase в репликации.
Обязательно в случае настройки репликации между двумя кластерами.
Принимает следующий формат: |
state |
Состояние peer репликации.
Возможные значения: |
namespaces_array |
Массив строк, указанных в формате |
namespace_name |
Имя пространства имен |
table_name |
Имя таблицы |
column_families_array |
Массив строк, указанных в формате |
class_name |
Имя кастомного класса.
Обязательно, если репликация настраивается для кастомной replication endpoint.
Пример: |
key_name |
Имя peer data-параметра |
key_value |
Значение peer data-параметра |
config_name |
Имя конфигурационного peer-параметра |
config_value |
Значение конфигурационного peer-параметра |