clickhouse-js-node-troubleshooting/BB-SKILLS-ADAPTATION.json

Version 356a8c1b9a73.bb1 · Apache-2.0. This preview displays packaged text and does not execute code. Treat the contents as untrusted instructions.

← Return to resource and package checksum

{
  "format": 1,
  "adapted_at": "2026-10-03",
  "source": "https://github.com/ClickHouse/agent-skills/tree/356a8c1b9a7392adb389a132f5ad3fec38532a03/skills/clickhouse-js-node-troubleshooting",
  "runtime_tested": false,
  "changes": [
    {
      "file": "clickhouse-js-node-troubleshooting/reference/compression.md",
      "original_file": "clickhouse-js-node-troubleshooting/upstream-original/reference/compression.md",
      "original_sha256": "e0be751c9846578405157a7fa0e197910ad3a6dc14418d0a65e6f0763ed96cfe",
      "adapted_sha256": "b4f0dd41390bbcd3df3f1bacb3e63196f85418b08c07e54ddab763e33cbf10f6",
      "changes": [
        {
          "from": "Only **GZIP** is supported (via zlib).",
          "to": "Boolean compression uses gzip. Node client >=1.22.0 also supports the\nexplicit codec object form for gzip, zstd and Brotli. zstd requires Node >=22.15.0;\nBrotli works on supported Node versions. Check the installed client/runtime."
        },
        {
          "from": "Check that the ClickHouse server has HTTP compression enabled (`enable_http_compression = 1` in server config). By default this is enabled on ClickHouse Cloud and most self-hosted setups.",
          "to": "Check the effective session/profile `enable_http_compression` setting and\n  whether this account may change it. A default does not grant permission."
        }
      ]
    },
    {
      "file": "clickhouse-js-node-troubleshooting/reference/data-types.md",
      "original_file": "clickhouse-js-node-troubleshooting/upstream-original/reference/data-types.md",
      "original_sha256": "dc9a6718714f4bb067a5df3b24f1a2915fc420f71f3fc5fd34f2ba29c384bd04",
      "adapted_sha256": "fe4c8645967c2870eba9c8fb461f2c1dcdb7d0f1a0c48b773e49dbf2bb512470",
      "changes": [
        {
          "from": "are serialized as **strings** in `JSON*` formats to prevent overflow (they exceed `Number.MAX_SAFE_INTEGER`).",
          "to": "are serialized as **strings** when `output_format_json_quote_64bit_integers=1`.\nThe default changed to 0 in ClickHouse 25.8, subject to profile and compatibility\nsettings. Set 1 explicitly for ordinary JSON.parse when exact integers matter;\nunquoted values can exceed Number.MAX_SAFE_INTEGER."
        }
      ]
    },
    {
      "file": "clickhouse-js-node-troubleshooting/reference/socket-hangup.md",
      "original_file": "clickhouse-js-node-troubleshooting/upstream-original/reference/socket-hangup.md",
      "original_sha256": "412ed944f506689e9e9cdd08d57abed807095672a9f8e5d851d407e2b4d14b1a",
      "adapted_sha256": "1a97cdd27819528385ca7b252ab56db9caa3c755268c9b812e7f01cb3398d73f",
      "changes": [
        {
          "from": "// stay ~500ms below the server's timeout",
          "to": "// stay 1000ms below a measured 10-second timeout"
        },
        {
          "from": "**Maximum safe query duration formula:**",
          "to": "**Approximate header-budget formula (not a safe-duration guarantee):**"
        },
        {
          "from": "**Alternatively \u2014 fire-and-forget (mutations only):** Mutations (`INSERT ... SELECT`, `OPTIMIZE`, `ALTER`) are not cancelled on the server when the client connection is lost. You can send the mutation and immediately close the connection, then poll `system.query_log` or `system.mutations` for status. This bypasses both the load balancer idle timeout and the Node.js header limit. See the [client repo examples](https://github.com/ClickHouse/clickhouse-js/tree/main/examples) for a concrete implementation.",
          "to": "**For long writes:** Running HTTP queries may continue after disconnect, but\nimmediately closing the client is not a delivery or success guarantee. Confirm\nacceptance with the documented operation, retain a unique query_id, and monitor\nthe appropriate query/mutation or asynchronous-insert status. INSERT SELECT,\nALTER mutations and OPTIMIZE have different lifecycles. Review retries for\nduplicate writes; do not treat disconnect as cancellation or completion."
        }
      ]
    }
  ],
  "references": [
    "https://github.com/ClickHouse/clickhouse-js/blob/main/CHANGELOG.md",
    "https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp",
    "https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/FormatFactorySettings.h",
    "https://clickhouse.com/docs/interfaces/http#response-buffering"
  ]
}