Skip to content

proto(sql): add catalog_namespace to table RPCs#2498

Open
r-vasquez wants to merge 2 commits into
masterfrom
sql-protos-v2
Open

proto(sql): add catalog_namespace to table RPCs#2498
r-vasquez wants to merge 2 commits into
masterfrom
sql-protos-v2

Conversation

@r-vasquez

Copy link
Copy Markdown
Contributor

Catalog names are only unique within a
namespace, so resolving a catalog by name alone
is ambiguous when the same name exists in more
than one namespace. Add an optional
catalog_namespace field to ListTablesRequest and
DescribeTableRequest to disambiguate. When unset,
ListTables returns tables from all matching
catalogs (rows carry Table.namespace_name) while
DescribeTable fails with INVALID_ARGUMENT and a
documented 400 response.

Also reword Column.type docs to the
engine-reported names (e.g. "integer", "text[]")
instead of Postgres driver names.

@r-vasquez r-vasquez requested a review from c-julin June 11, 2026 23:15
@github-actions

github-actions Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

The latest Buf updates on your PR. Results from workflow Buf CI / validate (pull_request).

BuildFormatLintBreakingUpdated (UTC)
✅ passed✅ passed✅ passed✅ passedJun 15, 2026, 4:48 PM

Comment on lines 151 to 154
// Namespace of the catalog that owns this table. Namespaces attach to
// catalogs (connections), not to tables; tables of same-named catalogs in
// different namespaces are distinguished by this field.
string namespace_name = 2;

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wondering if this should be called catalog_namespace_name @c-julin, wdyt? Are breaking changes allowed in alphav3, or will the CI break?

@r-vasquez

Copy link
Copy Markdown
Contributor Author

Commit: 3b440b2 includes the breaking changes. It's an alpha version so we should be fine as there are no current users of this one.

Catalog names are only unique within a
namespace, so resolving a catalog by name alone
is ambiguous when the same name exists in more
than one namespace. Add an optional
catalog_namespace field to ListTablesRequest and
DescribeTableRequest to disambiguate. When unset,
ListTables returns tables from all matching
catalogs (rows carry Table.namespace_name) while
DescribeTable fails with INVALID_ARGUMENT and a
documented 400 response.

Also reword Column.type docs to the
engine-reported names (e.g. "integer", "text[]")
instead of Postgres driver names.
Table and Catalog fields carried a redundant
_name suffix, and connection_name still used the
old "connection" term for what the API now calls
a catalog. namespace_name on Table also read as
if the namespace belonged to the table rather
than the catalog that owns it. Rename the fields
to catalog, catalog_namespace, topic, subject,
and output_schema_full_message so names match
the resource terminology. The renumbering is
safe while the v1alpha3 SQL API is unstable.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant