トラブルシューティング
インストール
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-09 に 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 を起動
このコマンドは、autostart スクリプトの標準パラメータでサーバーをインタラクティブアプリとして起動します。このモードでは clickhouse-server
がコンソールにすべてのイベントメッセージを出力します。
設定パラメータ
確認してください:
-
Docker 設定:
- IPv6 ネットワークで Docker 内で ClickHouse を実行している場合は、
network=host
が設定されていることを確認してください。
- IPv6 ネットワークで Docker 内で ClickHouse を実行している場合は、
-
エンドポイント設定。
- listen_host と tcp_port の設定を確認します。
- デフォルトでは、ClickHouse サーバーはローカルホスト接続のみを受け入れます。
-
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秒あたりに処理された行の数、クエリ処理時間のパーセンタイルが表示されます。