clickhouse-js-node-troubleshooting

ClickHouse Node.js クライアントのトラブルシューティング

参考：https://clickhouse.com/docs/integrations/javascript

⚠️ Node.js ランタイム専用です。 このスキルの対象は、Node.js ランタイムで実行される @clickhouse/client パッケージのみです。これには、Next.js Node ランタイムの API ルート、React Server Components、Server Actions、標準的な Node.js プロセスが含まれます。ブラウザーのクライアントコンポーネント、Web Workers、Next.js Edge ランタイム、Cloudflare Workers、または @clickhouse/client-web の使用には、このスキルを適用しないでください。ブラウザー／エッジ環境では、正しいパッケージは @clickhouse/client-web です。

---

このスキルの使い方

1. 問題を特定する — 症状を以下の問題インデックスと照合し、該当するリファレンスファイルを確認します。
2. 診断を最初に伝える — 修正方法を示す前に、問題の原因として考えられることを説明します。
3. バージョン要件を確認する — 修正に必要なクライアントの最低バージョンがあれば伝え、ユーザーが提示したバージョンと照合します。
4. 不足している情報だけを尋ねる — 修正がバージョンに依存し、ユーザーのバージョンが不明な場合は尋ねます。それ以外の場合は、すぐにサポートします。

---

問題のインデックス

以下のリストからユーザーの問題を特定し、該当するリファレンスファイルを読んで詳しいトラブルシューティング手順を確認してください。

問題	症状	リファレンスファイル
ソケット切断／ECONNRESET	socket hang up、ECONNRESET、断続的な接続切断、長時間実行されるクエリのタイムアウト	reference/socket-hangup.md
データ型の不一致	大きな整数が文字列として返される、小数精度の損失、Date／DateTime の挿入エラー、UUID を UInt128 カラムに挿入した際の CANNOT_PARSE_INPUT_ASSERTION_FAILED	reference/data-types.md
読み取り専用ユーザーのエラー	readonly=1 のユーザーでレスポンス圧縮を使用した際のエラー	reference/readonly-users.md
プロキシ／パス名 URL の混同	データベースが誤って選択される、パスプレフィックスのあるプロキシ経由でリクエストが失敗する	reference/proxy-pathname.md
TLS／証明書エラー	TLS ハンドシェイクの失敗、証明書の検証に関する問題、相互 TLS の設定	reference/tls.md
圧縮が機能しない	リクエストまたはレスポンスで GZIP 圧縮が有効にならない	reference/compression.md
ログが何も表示されない	ログ出力がない、カスタムロガーとの統合が必要	reference/logging.md
クエリパラメーターが補間されない	パラメーター化クエリが機能しない、SQL インジェクションへの懸念	reference/query-params.md
FORMAT 句／SHOW POLICIES のエラー	FORMAT の重複による構文エラー、またはフォーマットを指定しても SHOW [ROW] POLICIES が失敗する	reference/query-format-clause.md

---

まだ解決しませんか？

• JS クライアントのソースコードと全サンプル
• ClickHouse JS クライアントのドキュメント
• ClickHouse がサポートするフォーマット