[databricks-lakebase] DABs now support Lakebase synced tables via postgres_synced_table — skill still says DAB support "not yet available"

Read databricks-lakebase/SKILL.md and databricks-lakebase/references/synced-tables.md, then compare their guidance with the linked DAB resources documentation. Update both files to distinguish deprecated synced_database_tables from the postgres_synced_table resource, correct the singular name, and document the CLI version and alternatives; an optional YAML example is suggested.

Summary

The databricks-lakebase skill tells users that Databricks Asset Bundles (DABs) cannot create Lakebase synced tables and to use the databricks postgres create-synced-table CLI instead. This guidance is now stale: DABs support a dedicated postgres_synced_table bundle resource, documented at dev-tools/bundles/resources.

Where the stale guidance lives

databricks-lakebase/SKILL.md

• Troubleshooting table (last row):

  | DABs synced_database_tables | Deprecated — maps to a legacy API and fails on current Lakebase. Use databricks postgres create-synced-table CLI instead. DAB support via postgres_synced_tables is not yet available. |

• Provisioned→Autoscaling callout near the top:

  For the legacy DAB synced_database_tables resource, use the databricks postgres create-synced-table CLI flow instead (see the Common Issues row and references/synced-tables.md).

databricks-lakebase/references/synced-tables.md

DABs: The bundle schema includes synced_database_tables, but it maps to a deprecated Terraform resource (databricks_database_synced_database_table) that fails on current Lakebase. Do not use synced_database_tables in DABs. DAB support via postgres_synced_tables is blocked on Terraform provider work and not yet available — use the CLI commands above instead.

What's actually true now

The DABs resources docs document a first-class resource for this:

• Resource key: postgres_synced_table (singular) — "Postgres synced table object"
• Supported fields include database_instance_name, logical_database_name, source_table_full_name, and spec
• Added in Databricks CLI v1.0.0; type_overrides added in v1.5.0 and extra_columns in v1.10.0 — so it has been present and actively extended across several releases

Two naming points worth fixing while here:

1. The skill refers to postgres_synced_tables (plural). The actual resource key is postgres_synced_table (singular).
2. This is a different resource from the genuinely-deprecated synced_database_tables / synced_database_table. The skill is right that the old key is deprecated, but wrong that there is no bundle-native replacement — postgres_synced_table is that replacement.

Suggested fix

• Update the troubleshooting row and references/synced-tables.md to state that DABs support Lakebase synced tables via the postgres_synced_table resource (CLI ≥ v1.0.0), rather than "not yet available."
• Keep the note that the legacy synced_database_tables key is deprecated, but point users to postgres_synced_table as the bundle-native path, alongside the databricks postgres create-synced-table CLI as the imperative alternative.
• Correct the plural postgres_synced_tables → singular postgres_synced_table.
• Consider a short example YAML in references/synced-tables.md.

References

• DAB resources docs: https://docs.databricks.com/aws/en/dev-tools/bundles/resources#postgres_synced_table