thevar1able/ClickHouse
1
0
Fork 0
mirror of https://github.com/ClickHouse/ClickHouse.git synced 2024-11-30 11:32:03 +00:00
Code Issues Packages Projects Releases Wiki Activity
aac5b0386a
ClickHouse/docs/en/operations/utilities/clickhouse-keeper-client.md
pufit 30700996f0 Merge branch 'master' into pufit/keeper-client-improvements 
# Conflicts:
#	docs/en/operations/utilities/clickhouse-keeper-client.md
#	programs/keeper-client/Commands.cpp
#	programs/keeper-client/Commands.h
#	programs/keeper-client/KeeperClient.cpp
#	tests/integration/test_keeper_client/test.py
2023-08-07 12:26:08 -04:00

2.6 KiB
Raw Blame History

slug sidebar_label
/en/operations/utilities/clickhouse-keeper-client clickhouse-keeper-client

clickhouse-keeper-client

A client application to interact with clickhouse-keeper by its native protocol.

Keys

  • -q QUERY, --query=QUERY — Query to execute. If this parameter is not passed, clickhouse-keeper-client will start in interactive mode.
  • -h HOST, --host=HOST — Server host. Default value: localhost.
  • -p N, --port=N — Server port. Default value: 9181
  • --connection-timeout=TIMEOUT — Set connection timeout in seconds. Default value: 10s.
  • --session-timeout=TIMEOUT — Set session timeout in seconds. Default value: 10s.
  • --operation-timeout=TIMEOUT — Set operation timeout in seconds. Default value: 10s.
  • --history-file=FILE_PATH — Set path of history file. Default value: ~/.keeper-client-history.
  • --help — Shows the help message.

Example

./clickhouse-keeper-client -h localhost:9181 --connection-timeout 30 --session-timeout 30 --operation-timeout 30
Connected to ZooKeeper at [::1]:9181 with session_id 137
/ :) ls
keeper foo bar
/ :) cd keeper
/keeper :) ls
api_version
/keeper :) cd api_version
/keeper/api_version :) ls

/keeper/api_version :) cd xyz
Path /keeper/api_version/xyz does not exists
/keeper/api_version :) cd ../../
/ :) ls
keeper foo bar
/ :) get keeper/api_version
2

Commands

  • ls [path] -- Lists the nodes for the given path (default: cwd)
  • cd [path] -- Change the working path (default .)
  • set <path> <value> [version] -- Updates the node's value. Only update if version matches (default: -1)
  • create <path> <value> [mode] -- Creates new node with the set value
  • touch <path> -- Creates new node with an empty string as value. Doesn't throw an exception if the node already exists
  • get <path> -- Returns the node's value
  • remove <path> -- Remove the node
  • rmr <path> -- Recursively deletes path. Confirmation required
  • flwc <command> -- Executes four-letter-word command
  • help -- Prints this message
  • get_stat [path] -- Returns the node's stat (default .)
  • find_super_nodes <threshold> [path] -- Finds nodes with number of children larger than some threshold for the given path (default .)
  • delete_stale_backups -- Deletes ClickHouse nodes used for backups that are now inactive
  • find_big_family [path] [n] -- Returns the top n nodes with the biggest family in the subtree (default path = . and n = 10)