Skip to content

fix(clickpipes): document that SQS queues / Pub/Sub subscriptions must not be shared across pipes#6519

Open
whites11 wants to merge 1 commit into
mainfrom
docs-clickpipes-sqs-one-queue-per-pipe
Open

fix(clickpipes): document that SQS queues / Pub/Sub subscriptions must not be shared across pipes#6519
whites11 wants to merge 1 commit into
mainfrom
docs-clickpipes-sqs-one-queue-per-pipe

Conversation

@whites11

@whites11 whites11 commented Jul 9, 2026

Copy link
Copy Markdown
Member

Summary

Prompted by support-escalation #8195: a customer pointed two S3 ClickPipes (different path patterns) at the same SQS queue. SQS delivers each message to exactly one consumer, so each ObjectCreated event was received by only one of the two pipes — and a pipe receiving an event for a file outside its path pattern silently discards (and deletes) the message. Result: random, silent file loss on both pipes, with no error signal anywhere. The same failure mode exists for GCS pipes sharing a single Pub/Sub subscription.

Changes

S3 unordered-mode guide:

  • Add a :::warning in the Create an Amazon SQS queue step: one dedicated queue per ClickPipe; sharing a queue across pipes (or any other consumer) loses files, even with different path patterns; use EventBridge fan-out (one rule per queue) to feed multiple pipes from the same bucket.
  • Reinforce at the Create a ClickPipe step where the queue URL is entered.
  • Make the direct S3 → SQS instructions explicit about selecting All object create events (s3:ObjectCreated:*): selecting individual event types (e.g. only Put) silently misses files uploaded via other methods such as multipart uploads (CompleteMultipartUpload).

GCS unordered-mode guide:

  • Equivalent :::warning for Pub/Sub: one dedicated subscription per ClickPipe; fan out with one subscription per pipe on the same topic.
  • Reinforce at the Create a ClickPipe step.

Spell dictionary: add multipart.

🤖 Generated with Claude Code

SQS queues and Pub/Sub subscriptions deliver each message to a single
consumer, so sharing one across multiple ClickPipes causes silent,
random file loss: a pipe that receives an event for a file outside its
path pattern discards it and no other pipe ever sees it. Add explicit
warnings to both the S3 and GCS unordered-mode guides.

Also make the direct S3->SQS instructions explicit about selecting
"All object create events" (s3:ObjectCreated:*), since subsets like
Put-only silently miss multipart uploads.

Prompted by support-escalation #8195.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@whites11 whites11 requested review from a team as code owners July 9, 2026 16:23
@whites11 whites11 self-assigned this Jul 9, 2026
@vercel

vercel Bot commented Jul 9, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview, Comment Jul 9, 2026 4:37pm
clickhouse-docs-jp Building Building Preview, Comment Jul 9, 2026 4:37pm
3 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-ko Ignored Ignored Preview Jul 9, 2026 4:37pm
clickhouse-docs-ru Ignored Ignored Preview Jul 9, 2026 4:37pm
clickhouse-docs-zh Ignored Ignored Preview Jul 9, 2026 4:37pm

Request Review

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

Labels

None yet

1 participant