thevar1able/ClickHouse
1
0
Fork 0
mirror of https://github.com/ClickHouse/ClickHouse.git synced 2024-12-14 02:12:21 +00:00
Code Issues Packages Projects Releases Wiki Activity
6d9a45eff1
ClickHouse/docs/ja/guides/troubleshooting.md
Miki Matsumoto 1e15312729 add translated Japanese docs
2024-11-18 11:58:58 +09:00

9.4 KiB
Raw Blame History

title
トラブルシューティング

インストール

apt-keyでkeyserver.ubuntu.comからGPGキーをインポートできない

Advanced package tool (APT)のapt-key機能は廃止されています。代わりにgpgコマンドを使用する必要があります。インストールガイドの記事を参照してください。

gpgでkeyserver.ubuntu.comからGPGキーをインポートできない

  1. gpgがインストールされているか確認します:
sudo apt-get install gnupg

apt-getでClickHouseリポジトリからdebパッケージを取得できない

  1. ファイアウォールの設定を確認します。
  2. 何らかの理由でリポジトリにアクセスできない場合は、インストールガイドの記事で説明されているようにパッケージをダウンロードし、sudo dpkg -i <packages>コマンドを使って手動でインストールします。また、tzdataパッケージも必要です。

apt-getでClickHouseリポジトリからdebパッケージを更新できない

この問題はGPGキーが変更されたときに発生する可能性があります。

リポジトリ設定を更新するには、設定ページのマニュアルを使用してください。

apt-get updateで異なる警告が出る

警告メッセージの例は次のいずれかです:

N: Skipping acquire of configured file 'main/binary-i386/Packages' as repository 'https://packages.clickhouse.com/deb stable InRelease' doesn't support architecture 'i386'

E: Failed to fetch https://packages.clickhouse.com/deb/dists/stable/main/binary-amd64/Packages.gz  File has unexpected size (30451 != 28154). Mirror sync in progress?

E: Repository 'https://packages.clickhouse.com/deb stable InRelease' changed its 'Origin' value from 'Artifactory' to 'ClickHouse'
E: Repository 'https://packages.clickhouse.com/deb stable InRelease' changed its 'Label' value from 'Artifactory' to 'ClickHouse'
N: Repository 'https://packages.clickhouse.com/deb stable InRelease' changed its 'Suite' value from 'stable' to ''
N: This must be accepted explicitly before updates for this repository can be applied. See apt-secure(8) manpage for details.

Err:11 https://packages.clickhouse.com/deb stable InRelease
400  Bad Request [IP: 172.66.40.249 443]

上記の問題を解決するには、以下のスクリプトを使用してください:

sudo rm /var/lib/apt/lists/packages.clickhouse.com_* /var/lib/dpkg/arch /var/lib/apt/lists/partial/packages.clickhouse.com_*
sudo apt-get clean
sudo apt-get autoclean

不正な署名のためにYumでパッケージを取得できない

可能性のある問題: キャッシュが間違っている、または2022-09に更新されたGPGキー後に破損した可能性があります。

解決方法は、Yumのキャッシュとlibディレクトリをクリアすることです:

sudo find /var/lib/yum/repos/ /var/cache/yum/ -name 'clickhouse-*' -type d -exec rm -rf {} +
sudo rm -f /etc/yum.repos.d/clickhouse.repo

その後、インストールガイドに従ってください。

サーバーへの接続

可能性のある問題:

  • サーバーが稼働していない。
  • 予期せぬ、または間違った構成パラメータ。

サーバーが稼働していない

サーバーが稼働しているか確認

sudo service clickhouse-server status

サーバーが稼働していない場合は、次のコマンドで開始してください:

sudo service clickhouse-server start

ログを確認

clickhouse-serverのメインログはデフォルトで/var/log/clickhouse-server/clickhouse-server.logにあります。

サーバーが正常に開始した場合、次の文字列が表示されます:

  • <Information> Application: starting up. — サーバーが開始されました。
  • <Information> Application: Ready for connections. — サーバーが稼働中で接続可能です。

構成エラーでclickhouse-serverの開始が失敗した場合、<Error>文字列とエラーの説明が表示されます。例:

2019.01.11 15:23:25.549505 [ 45 ] {} <Error> ExternalDictionaries: Failed reloading 'event2id' external dictionary: Poco::Exception. Code: 1000, e.code() = 111, e.displayText() = Connection refused, e.what() = Connection refused

ファイルの末尾にエラーが表示されない場合は、次の文字列からファイル全体を確認してください:

<Information> Application: starting up.

サーバーにclickhouse-serverの2番目のインスタンスを開始しようとすると、次のログが表示されます:

2019.01.11 15:25:11.151730 [ 1 ] {} <Information> : Starting ClickHouse 19.1.0 with revision 54413
2019.01.11 15:25:11.154578 [ 1 ] {} <Information> Application: starting up
2019.01.11 15:25:11.156361 [ 1 ] {} <Information> StatusFile: Status file ./status already exists - unclean restart. Contents:
PID: 8510
Started at: 2019-01-11 15:24:23
Revision: 54413

2019.01.11 15:25:11.156673 [ 1 ] {} <Error> Application: DB::Exception: Cannot lock file ./status. Another server instance in same directory is already running.
2019.01.11 15:25:11.156682 [ 1 ] {} <Information> Application: shutting down
2019.01.11 15:25:11.156686 [ 1 ] {} <Debug> Application: Uninitializing subsystem: Logging Subsystem
2019.01.11 15:25:11.156716 [ 2 ] {} <Information> BaseDaemon: Stop SignalListener thread

system.dログを確認

clickhouse-serverログに有用な情報が見つからない場合、またはログがない場合は、次のコマンドを使用してsystem.dログを確認できます:

sudo journalctl -u clickhouse-server

インタラクティブモードでclickhouse-serverを起動

sudo -u clickhouse /usr/bin/clickhouse-server --config-file /etc/clickhouse-server/config.xml

このコマンドは、autostartスクリプトの標準パラメータを使用してサーバーをインタラクティブアプリとして起動します。このモードでは、clickhouse-serverはすべてのイベントメッセージをコンソールに表示します。

構成パラメータ

確認事項:

  1. Dockerの設定:

    • DockerでClickHouseを実行する際にIPv6ネットワークを使用する場合、network=hostが設定されていることを確認してください。

  2. エンドポイントの設定。

    • listen_hostとtcp_portの設定を確認してください。
    • ClickHouseサーバーはデフォルトでlocalhost接続のみ受け入れます。

  3. HTTPプロトコルの設定:

    • HTTP APIのプロトコル設定を確認します。

  4. セキュア接続の設定。

    • 次を確認してください:
    • 接続する際には適切なパラメータを使用してください。例えば、clickhouse_clientにはport_secureパラメータを使用します。

  5. ユーザー設定:

    • 間違ったユーザー名またはパスワードを使用している可能性があります。

クエリ処理

ClickHouseがクエリを処理できない場合、クライアントにエラーの説明を送信します。clickhouse-clientでは、コンソールにエラーの説明が表示されます。HTTPインターフェースを使用している場合、ClickHouseは応答ボディにエラーの説明を送信します。例えば:

$ curl 'http://localhost:8123/' --data-binary "SELECT a"
Code: 47, e.displayText() = DB::Exception: Unknown identifier: a. Note that there are no tables (FROM clause) in your query, context: required_names: 'a' source_tables: table_aliases: private_aliases: column_aliases: public_columns: 'a' masked_columns: array_join_columns: source_columns: , e.what() = DB::Exception

stack-traceパラメータでclickhouse-clientを起動すると、エラーの説明と共にサーバーのスタックトレースが返されます。

接続が切断されたというメッセージを見ることがあります。この場合、クエリを再実行することができます。クエリを実行するたびに接続が切断される場合は、サーバーログでエラーを確認してください。

クエリ処理の効率

ClickHouseが非常に遅く動作している場合、クエリに対するサーバーのリソースとネットワーク負荷をプロファイルする必要があります。

clickhouse-benchmarkユーティリティを使用してクエリをプロファイルできます。これは、1秒あたりに処理されるクエリの数、1秒あたりに処理される行の数、およびクエリ処理時間のパーセンタイルを表示します。