トラブルシューティング

インストール

keyserver.ubuntu.com から apt-key を使用して GPG キーをインポートできません

apt-key 機能は Advanced package tool (APT) で非推奨となりました。ユーザーは代わりに gpg コマンドを使用する必要があります。詳細については、インストールガイド を参照してください。

keyserver.ubuntu.com から gpg を使用して GPG キーをインポートできません

1. gpg がインストールされているか確認します:

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

1. ファイアウォールの設定を確認します。
2. リポジトリにアクセスできない場合は、インストールガイド に記載されている方法でパッケージをダウンロードし、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 の別のインスタンスを起動しようとすると、次のログが表示されます:

system.d ログを確認

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

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

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

設定パラメータ

次を確認してください:

1. Docker 設定:

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

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

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

3. HTTP プロトコル設定:

   • HTTP API のプロトコル設定を確認してください。

4. セキュア接続設定。

   • 次を確認してください:
     • tcp_port_secure 設定。
     • SSL証明書 の設定。
   • 接続時に適切なパラメータを使用してください。たとえば、clickhouse_client では port_secure パラメータを使用します。

5. ユーザー設定:

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

クエリ処理

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

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

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

クエリ処理の効率

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

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