Table API Connectors#
Use these pages for DDL, SQL type mappings, metadata columns, and planner-specific restrictions. Each Table connector maps onto the DataStream connector with the same name rather than providing a separate implementation. The corresponding DataStream connector page documents runtime behavior and builder-only features. The connector overview explains how to choose between the two APIs.
Capability map#
Pushdown describes bounded scans; the lookup column separately describes point-read behavior.
Metadata stays with the direction that reads or writes it.
Not applicable means that the capability does not fit the service’s role; it is not an
implementation-status claim.
| Connector pages | Primary role | Scan and pushdown | Sink changelog | Lookup | CDC composition | Metadata |
|---|---|---|---|---|---|---|
| BigQuery: Quickstart, Table examples source, sink, and CDC, Table reference source, sink, and CDC, DataStream reference source and sink | Analytics warehouse | Bounded; projection and filter pushdown | Insert or keyed CDC upsert/delete; Experimental (#706) | Not supported by the bounded Storage Read source | Consumes an upsert/delete changelog | Sink-writable CDC sequence inputs; no readable metadata |
| Cloud Pub/Sub: Quickstart, Examples, DataStream (source, sink), Table (source, sink) | Messaging | Unbounded | Insert | Not applicable | Carries a format-provided source changelog | Readable and writable message metadata |
| Cloud Tasks: Quickstart, Examples, DataStream, Table | Task delivery | Not applicable; sink only | Insert; opt-in checkpointed creation within its recovery window | Not applicable | Not applicable | Writable task and request metadata |
| Bigtable: Quickstart, Examples, DataStream source, sink, and Change Streams, Table source, sink, lookup, and Change Streams | Wide-column store | Bounded; projection and row-key filter pushdown | Upsert and atomic keep-latest; insert-only compatibility mode; atomic insert-if-absent and DDL-defined conditional commands with INSERT-only input | Sync or async with partial cache; synchronous full cache; projected families | Envelope for transformation, or keyed upsert/delete directly to an upsert sink | Readable CDC and writable cell-timestamp metadata |
| Spanner: Quickstart, Examples, DataStream, Table | Relational database | Bounded; projection and primary-key filter pushdown | Insert or upsert | Sync or async; primary-key filter pushdown; partial cache | Full retract or keyed upsert/delete source to keyed sink | Readable CDC transaction metadata |
The Bigtable and Spanner keyed source-to-sink paths describe compatible changelog shapes, not a
stronger replication guarantee.
For example, a Spanner Change Streams table in upsert mode can feed a separate primary-key
Spanner sink table, but that sink remains at-least-once and does not guarantee the application
order of successive writes to one key.