mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-10-03 23:20:48 +00:00
67c2e50331
* update presentations * CLICKHOUSE-2936: redirect from clickhouse.yandex.ru and clickhouse.yandex.com * update submodule * lost files * CLICKHOUSE-2981: prefer sphinx docs over original reference * CLICKHOUSE-2981: docs styles more similar to main website + add flags to switch language links * update presentations * Less confusing directory structure (docs -> doc/reference/) * Minify sphinx docs too * Website release script: fail fast + pass docker hash on deploy * Do not underline links in docs * shorter * cleanup docker images * tune nginx config * CLICKHOUSE-3043: get rid of habrastorage links * Lost translation * CLICKHOUSE-2936: temporary client-side redirect * behaves weird in test * put redirect back * CLICKHOUSE-3047: copy docs txts to public too * move to proper file * remove old pages to avoid confusion * Remove reference redirect warning for now * Refresh README.md * Yellow buttons in docs * Use svg flags instead of unicode ones in docs * fix test website instance * Put flags to separate files * wrong flag * Copy Yandex.Metrica introduction from main page to docs * Yet another home page structure change, couple new blocks (CLICKHOUSE-3045) * Update Contacts section * CLICKHOUSE-2849: more detailed legal information * CLICKHOUSE-2978 preparation - split by files * More changes in Contacts block * Tune texts on index page * update presentations * One more benchmark * Add usage sections to index page, adapted from slides * Get the roadmap started, based on slides from last ClickHouse Meetup * CLICKHOUSE-2977: some rendering tuning * Get rid of excessive section in the end of getting started * Make headers linkable * CLICKHOUSE-2981: links to editing reference - https://github.com/yandex/ClickHouse/issues/849 * CLICKHOUSE-2981: fix mobile styles in docs * Ban crawling of duplicating docs * Open some external links in new tab * Ban old docs too * Lots of trivial fixes in english docs * Lots of trivial fixes in russian docs * Remove getting started copies in markdown * Add Yandex.Webmaster * Fix some sphinx warnings * More warnings fixed in english docs * More sphinx warnings fixed * Add code-block:: text * More code-block:: text * These headers look not that well * Better switch between documentation languages * merge use_case.rst into ya_metrika_task.rst * Edit the agg_functions.rst texts * Add lost empty lines * Lost blank lines * Add new logo sizes * update presentations * Next step in migrating to new documentation * Fix all warnings in en reference * Fix all warnings in ru reference * Re-arrange existing reference * Move operation tips to main reference * Fix typos noticed by milovidov@ * Get rid of zookeeper.md * Looks like duplicate of tutorial.html * Fix some mess with html tags in tutorial * No idea why nobody noticed this before, but it was completely not clear whet to get the data * Match code block styling between main and tutorial pages (in favor of the latter) * Get rid of some copypaste in tutorial * Normalize header styles * Move example_datasets to sphinx * Move presentations submodule to website * Move and update README.md * No point in duplicating articles from habrahabr here * Move development-related docs as is for now * doc/reference/ -> docs/ (to match the URL on website) * Adapt links to match the previous commit * Adapt development docs to rst (still lacks translation and strikethrough support) * clean on release * blacklist presentations in gulp * strikethrough support in sphinx * just copy development folder for now * fix weird introduction in style article * Style guide translation (WIP) * Finish style guide translation to English * gulp clean separately * Update year in LICENSE * Initial CONTRIBUTING.md * Fix remaining links to old docs in tutorial * Some tutorial fixes * Typo * Another typo * Update list of authors from yandex-team accoding to git log
117 lines
4.6 KiB
ReStructuredText
117 lines
4.6 KiB
ReStructuredText
system.replicas
|
|
---------------
|
|
|
|
Contains information and status for replicated tables residing on the local server. This table can be used for monitoring. The table contains a row for every Replicated* table.
|
|
|
|
Example:
|
|
|
|
.. code-block:: text
|
|
|
|
SELECT *
|
|
FROM system.replicas
|
|
WHERE table = 'visits'
|
|
FORMAT Vertical
|
|
|
|
Row 1:
|
|
──────
|
|
database: merge
|
|
table: visits
|
|
engine: ReplicatedCollapsingMergeTree
|
|
is_leader: 1
|
|
is_readonly: 0
|
|
is_session_expired: 0
|
|
future_parts: 1
|
|
parts_to_check: 0
|
|
zookeeper_path: /clickhouse/tables/01-06/visits
|
|
replica_name: example01-06-1.yandex.ru
|
|
replica_path: /clickhouse/tables/01-06/visits/replicas/example01-06-1.yandex.ru
|
|
columns_version: 9
|
|
queue_size: 1
|
|
inserts_in_queue: 0
|
|
merges_in_queue: 1
|
|
log_max_index: 596273
|
|
log_pointer: 596274
|
|
total_replicas: 2
|
|
active_replicas: 2
|
|
|
|
Columns:
|
|
|
|
.. code-block:: text
|
|
|
|
database: Database name.
|
|
table: Table name.
|
|
engine: Table engine name.
|
|
|
|
is_leader: Whether the replica is the leader.
|
|
Only one replica can be the leader at a time. The leader is responsible for selecting background merges to perform.
|
|
Note that writes can be performed to any replica that is available and has a session in ZK, regardless of whether it is a leader.
|
|
|
|
is_readonly: Whether the replica is in read-only mode.
|
|
This mode is turned on if the config doesn't have sections with ZK, if an unknown error occurred when reinitializing sessions in ZK, and during session reinitialization in ZK.
|
|
|
|
is_session_expired: Whether the session with ZK has expired.
|
|
Basically the same as 'is_readonly'.
|
|
|
|
future_parts: The number of data parts that will appear as the result of INSERTs or merges that haven't been done yet.
|
|
|
|
parts_to_check: The number of data parts in the queue for verification.
|
|
A part is put in the verification queue if there is suspicion that it might be damaged.
|
|
|
|
zookeeper_path: Path to table data in ZK.
|
|
replica_name: Replica name in ZK. Different replicas of the same table have different names.
|
|
replica_path: Path to replica data in ZK. The same as concatenating 'zookeeper_path/replicas/replica_path'.
|
|
|
|
columns_version: Version number of the table structure. Indicates how many times ALTER was performed. If replicas have different versions, it means some replicas haven't made all of the ALTERs yet.
|
|
|
|
queue_size: Size of the queue for operations waiting to be performed. Operations include inserting blocks of data, merges, and certain other actions. It usually coincides with 'future_parts'.
|
|
|
|
inserts_in_queue: Number of inserts of blocks of data that need to be made. Insertions are usually replicated fairly quickly. If this number is large, it means something is wrong.
|
|
|
|
merges_in_queue: The number of merges waiting to be made. Sometimes merges are lengthy, so this value may be greater than one for a long time.
|
|
|
|
The next 4 columns have a non-zero value only where there is an active session with ZK.
|
|
|
|
log_max_index: Maximum entry number in the log of general activity.
|
|
log_pointer: Maximum entry number from the log of general activity that the replica copied to its queue for execution, plus one.
|
|
If log_pointer is much smaller than log_max_index, something is wrong.
|
|
|
|
total_replicas: The total number of known replicas of this table.
|
|
active_replicas: The number of replicas of this table that have a session in ZK (i.e., the number of functioning replicas).к
|
|
|
|
If you request all the columns, the table may work a bit slowly, since several reads from ZK are made for each row.
|
|
If you don't request the last 4 columns (log_max_index, log_pointer, total_replicas, active_replicas), the table works quickly.
|
|
|
|
For example, you can check that everything is working correctly like this:
|
|
|
|
.. code-block:: sql
|
|
|
|
SELECT
|
|
database,
|
|
table,
|
|
is_leader,
|
|
is_readonly,
|
|
is_session_expired,
|
|
future_parts,
|
|
parts_to_check,
|
|
columns_version,
|
|
queue_size,
|
|
inserts_in_queue,
|
|
merges_in_queue,
|
|
log_max_index,
|
|
log_pointer,
|
|
total_replicas,
|
|
active_replicas
|
|
FROM system.replicas
|
|
WHERE
|
|
is_readonly
|
|
OR is_session_expired
|
|
OR future_parts > 20
|
|
OR parts_to_check > 10
|
|
OR queue_size > 20
|
|
OR inserts_in_queue > 10
|
|
OR log_max_index - log_pointer > 10
|
|
OR total_replicas < 2
|
|
OR active_replicas < total_replicas
|
|
|
|
If this query doesn't return anything, it means that everything is fine.
|