Skip to content

docs(clickhouse): add Int64 and Array to supported data types - #232

Open
heywalter wants to merge 1 commit into
mainfrom
docsloop/T-1-clickhouse-datatypes
Open

docs(clickhouse): add Int64 and Array to supported data types#232
heywalter wants to merge 1 commit into
mainfrom
docsloop/T-1-clickhouse-datatypes

Conversation

@heywalter

@heywalter heywalter commented Jul 23, 2026

Copy link
Copy Markdown
Collaborator

What

Add two data types to the ClickHouse Supported Data Types table:

Category Before After
Integer …UInt32, UInt64 …UInt32, Int64, UInt64
Composite Tuple Array, Tuple

Both types are declared in the connector spec but were missing from the doc table.

Why here / why this order

Insertion positions are not chosen by hand — they follow the spec's own declaration order:
Int64 sits between UInt32 and UInt64 in the spec, which matches the table's existing ordering.

Evidence

Every claim below is pinned to a commit sha, so these links keep pointing at the
exact lines that were read — even after main moves on.

Type Declared at
Int64[($zerofill)] spec_clickhouse.json:579
Array($type) spec_clickhouse.json:729

tapdata-connectors @ 76fbafd

One deliberate omission

Array carries queryOnly: true in the spec. No boundary note is added, on purpose:

  • 7 of the 8 queryOnly types already in this table (including Tuple, on the same row) are listed without any note — annotating only Array would imply a distinction that does not exist in the code.
  • queryOnly has no consumer in the connector repos (it appears only in spec.json), so its exact semantics can't be derived from code here.
  • In the PostgreSQL docs, 16 queryOnly types are not described as target-unsupported; the real unsupported list there is drawn by CDC plugin, not by queryOnly.

If a "type boundary annotation" editorial standard is wanted, it affects ~45 connectors and needs the engine-side semantics of queryOnly first — that's a separate initiative, not this PR.

Validation

  • Link check (incremental): 0 new warnings vs origin/main (baseline already carries 83 pre-existing warnings; absolute count is not a gate — the delta is).

🤖 Proposed by Docs Loop · DocsLoop-Task: T-1
Every claim above traces to file:line@sha. Reply on any line if a call is wrong — we tighten the rule, not just this PR.

Both types are declared in the connector spec but missing from the table.
Insertion positions follow the spec's own declaration order: Int64 sits
between UInt32 and UInt64, matching the table's existing ordering.

Array carries queryOnly: true in the spec. No boundary note is added here:
7 of the 8 queryOnly types in this table (including Tuple, on the same row)
are already listed without any note, so annotating only Array would imply a
distinction that does not exist in the code.

Evidence:
  connectors/clickhouse-connector/src/main/resources/spec_clickhouse.json:579  Int64
  connectors/clickhouse-connector/src/main/resources/spec_clickhouse.json:729  Array
  tapdata-connectors @ 76fbafd39a2739ab847eb12fb0c38511eade112f

DocsLoop-Task: T-1
@heywalter heywalter added the docs-loop Documentation change proposed by Docs Loop (evidence-pinned, code-derived) label Jul 23, 2026
@netlify

netlify Bot commented Jul 23, 2026

Copy link
Copy Markdown

Deploy Preview for tapdata-en ready!

Name Link
🔨 Latest commit 3b11e17
🔍 Latest deploy log https://app.netlify.com/projects/tapdata-en/deploys/6a615c1b0d1a810008364603
😎 Deploy Preview https://deploy-preview-232--tapdata-en.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-loop Documentation change proposed by Docs Loop (evidence-pinned, code-derived)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant