Skip to content

enhancement(clickhouse sink): add UUID type support for ArrowStream#24856

Open
benjamin-awd wants to merge 2 commits intovectordotdev:masterfrom
benjamin-awd:arrow-uuid
Open

enhancement(clickhouse sink): add UUID type support for ArrowStream#24856
benjamin-awd wants to merge 2 commits intovectordotdev:masterfrom
benjamin-awd:arrow-uuid

Conversation

@benjamin-awd
Copy link
Contributor

Summary

This PR adds explicit support for UUID type when sending data via the Clickhouse ArrowStream format. Currently, this type causes a hard error which causes schema fetching to fail.

Note: ClickHouse handles the StringUUID cast implicitly on insert.

Vector configuration

How did you test this PR?

Unit + integration tests

Change Type

  • Bug fix
  • New feature
  • Dependencies
  • Non-functional (chore, refactoring, docs)
  • Performance

Is this a breaking change?

  • Yes
  • No

Does this PR include user facing changes?

  • Yes. Please add a changelog fragment based on our guidelines.
  • No. A maintainer will apply the no-changelog label to this PR.

References

Relates to #24661

Notes

  • Please read our Vector contributor resources.
  • Do not hesitate to use @vectordotdev/vector to reach out to us regarding this PR.
  • Some CI checks run only after we manually approve them.
    • We recommend adding a pre-push hook, please see this template.
    • Alternatively, we recommend running the following locally before pushing to the remote branch:
      • make fmt
      • make check-clippy (if there are failures it's possible some of them can be fixed with make clippy-fix)
      • make test
  • After a review is requested, please avoid force pushes to help us review incrementally.
    • Feel free to push as many commits as you want. They will be squashed into one before merging.
    • For example, you can run git merge origin master and git push.
  • If this PR introduces changes Vector dependencies (modifies Cargo.lock), please
    run make build-licenses to regenerate the license inventory and commit the changes (if any). More details here.

…ormat

Map ClickHouse `UUID` columns to Arrow `Utf8`, letting ClickHouse
handle the String→UUID cast on insert. Removes UUID from the
unsupported types list in documentation.
@benjamin-awd benjamin-awd requested review from a team as code owners March 6, 2026 10:33
@github-actions github-actions bot added domain: sinks Anything related to the Vector's sinks domain: external docs Anything related to Vector's external, public documentation labels Mar 6, 2026
@pront pront added the sink: clickhouse Anything `clickhouse` sink related label Mar 9, 2026
@pront pront enabled auto-merge March 9, 2026 15:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

domain: external docs Anything related to Vector's external, public documentation domain: sinks Anything related to the Vector's sinks sink: clickhouse Anything `clickhouse` sink related

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants