トラブルシューティング
インストール
apt-keyでkeyserver.ubuntu.comからGPGキーをインポートできない
apt-key
の機能は、Advanced package tool (APT)が非推奨になりました。ユーザーは代わりにgpg
コマンドを使用する必要があります。詳細については、インストールガイドの記事を参照してください。
gpgでkeyserver.ubuntu.comからGPGキーをインポートできない
gpg
がインストールされているか確認してください:
apt-getでClickHouseリポジトリからdebパッケージを取得できない
- ファイアウォール設定を確認してください。
- 何らかの理由でリポジトリにアクセスできない場合は、インストールガイドの記事に従ってパッケージをダウンロードし、
sudo dpkg -i <packages>
コマンドを使用して手動でインストールしてください。tzdata
パッケージも必要です。
apt-getでClickHouseリポジトリからdebパッケージを更新できない
GPGキーが変更された場合にこの問題が発生する可能性があります。
リポジトリの構成を更新するには、セットアップページのマニュアルを使用してください。
apt-get update
で異なる警告が表示される
完了した警告メッセージは以下のいずれかです:
上記の問題を解決するには、以下のスクリプトを使用してください:
Yumでパッケージが取得できないのは署名が無効だから
考えられる問題:キャッシュが無効です。2022年9月のGPGキー更新後に壊れた可能性があります。
解決策は、Yumのキャッシュとlibディレクトリをクリーンアップすることです:
その後、インストールガイドに従ってください。
サーバーへの接続
考えられる問題:
- サーバーが稼働していない。
- 予期しないまたは間違った構成パラメータ。
サーバーが稼働していない
サーバーが稼働しているか確認する
サーバーが稼働していない場合は、以下のコマンドで起動してください:
ログを確認する
clickhouse-server
の主なログは、デフォルトで/var/log/clickhouse-server/clickhouse-server.log
にあります。
サーバーが正常に起動した場合は、次の文字列が表示されます:
<Information> Application: starting up.
— サーバーが起動しました。<Information> Application: Ready for connections.
— サーバーが稼働中で接続の準備が整いました。
clickhouse-server
が構成エラーで起動に失敗した場合は、エラー記述が含まれた<Error>
文字列が表示されます。例:
ファイルの最後にエラーが表示されない場合は、次の文字列から始まるファイル全体を確認してください:
サーバー上でclickhouse-server
の2番目のインスタンスを起動しようとすると、次のログが表示されます:
system.dログを確認する
clickhouse-server
のログに有用な情報が見つからなかった場合、またはログが存在しない場合は、次のコマンドを使用してsystem.d
ログを表示できます:
インタラクティブモードでclickhouse-serverを起動する
このコマンドは、オートスタートスクリプトの標準パラメータを使用して、インタラクティブアプリとしてサーバーを起動します。このモードでは、clickhouse-server
はコンソールにすべてのイベントメッセージを印刷します。
構成パラメータ
確認してください:
-
Docker設定:
- Docker内でClickHouseをIPv6ネットワークで実行している場合は、
network=host
が設定されていることを確認してください。
- Docker内でClickHouseをIPv6ネットワークで実行している場合は、
-
エンドポイント設定。
- listen_hostおよびtcp_portの設定を確認してください。
- ClickHouseサーバーは、デフォルトではlocalhost接続のみを受け入れます。
-
HTTPプロトコル設定:
- HTTP APIのためのプロトコル設定を確認してください。
-
セキュア接続設定。
- 次を確認してください:
- tcp_port_secure設定。
- SSL証明書の設定。
- 接続時に適切なパラメータを使用してください。例えば、
clickhouse_client
でport_secure
パラメータを使用します。
- 次を確認してください:
-
ユーザー設定:
- 間違ったユーザー名またはパスワードを使用している可能性があります。
クエリ処理
ClickHouseがクエリを処理できない場合、クライアントにエラー記述を送信します。clickhouse-client
では、コンソールにエラーの説明が表示されます。HTTPインターフェイスを使用している場合、ClickHouseは応答ボディ内にエラー記述を送信します。例えば:
clickhouse-client
をstack-trace
パラメータで起動すると、ClickHouseはエラーの説明を含むサーバースタックトレースを返します。
接続が切断されたとのメッセージが表示されることがあります。この場合、クエリを繰り返すことができます。クエリを実行するたびに接続が切断される場合は、サーバーログにエラーがないか確認してください。
クエリ処理の効率
ClickHouseが非常に遅く動作していることがわかった場合、サーバーリソースとネットワークへの負荷をプロファイリングする必要があります。
クエリをプロファイリングするには、clickhouse-benchmarkユーティリティを使用できます。これにより、1秒あたりに処理されるクエリの数、1秒あたりに処理される行の数、およびクエリ処理時間のパーセンタイルが表示されます。