Skip to content

docs: alias tables now accessible via read-only storage (persisted alias views)#915

Merged
zajca merged 1 commit into
mainfrom
aliases
May 28, 2026
Merged

docs: alias tables now accessible via read-only storage (persisted alias views)#915
zajca merged 1 commit into
mainfrom
aliases

Conversation

@MonikaFeigler
Copy link
Copy Markdown
Contributor

Summary

  • storage/tables/index.md — Added explanation that alias tables are automatically materialized as database VIEWs, making them accessible in workspaces and transformations via read-only storage access without any input mapping configuration. Notes that filtered aliases are supported (WHERE clause enforced in the VIEW) and that alias VIEWs are mirrored to linked bucket projects.
  • transformations/mappings/index.md — Removed the limitation stating read-only input mappings cannot access alias tables; replaced with positive statement that aliases (including filtered and linked-bucket aliases) are fully accessible.
  • workspace/index.md — Same update as mappings — alias tables including filtered ones are accessible via read-only input mappings in workspaces.
  • transformations/snowflake-plain/index.md — Updated the Bucket Objects for Read-Only Input Mapping section accordingly.
  • catalog/index.md — Updated two places: (1) the sharing constraint now correctly states filtered aliases are shared as VIEWs with the WHERE clause enforced; (2) removed the "no filter" requirement from the "Adding new tables to an existing shared bucket" instructions.

Context

Previously, alias tables were metadata-only — no physical database object existed, so they were invisible to workspaces, transformations using read-only input mapping, and linked bucket projects. With the Persisted Alias Views feature, every qualifying alias is automatically materialized as a database VIEW, making aliases first-class citizens in storage.

Test plan

  • Verify alias table is visible and queryable in a workspace via read-only storage access
  • Verify filtered alias (e.g. WHERE status = 'active') is accessible via read-only input mapping in a transformation
  • Verify alias from a linked bucket is accessible in the destination project

🤖 Generated with Claude Code

@matyas-jirat-keboola
Copy link
Copy Markdown
Contributor

@keboola-pr-reviewer review

keboola-pr-reviewer[bot]

This comment was marked as outdated.

@matyas-jirat-keboola
Copy link
Copy Markdown
Contributor

@keboola-pr-reviewer review

keboola-pr-reviewer[bot]

This comment was marked as outdated.

@keboola-pr-reviewer keboola-pr-reviewer Bot dismissed their stale review May 14, 2026 13:48

Dismissing prior approval — superseded by a fresh review on this PR.

@matyas-jirat-keboola
Copy link
Copy Markdown
Contributor

@keboola-pr-reviewer review

Copy link
Copy Markdown

@keboola-pr-reviewer keboola-pr-reviewer Bot left a comment

Choose a reason for hiding this comment

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

Verdict: needs_human (risk 2/5) · profile docs

This PR introduces substantive product-behaviour claims that require human confirmation per policy section 2.

Concerns:

  • storage/tables/index.md: New paragraph asserts alias-materialisation and mirroring product behaviour — needs product-team confirmation.
  • catalog/index.md: Constraint rewritten to claim filtered aliases share as VIEWs — factual claim requires verification.
  • storage/tables/index.md: New link to /transformations/mappings/#read-only-input-mapping anchor cannot be verified from the diff alone.

Suggested reviewers: @keboola/docs

@jirkasemmler jirkasemmler requested a review from zajca May 27, 2026 07:34
@jirkasemmler
Copy link
Copy Markdown
Contributor

@zajca pls az pujde ven changelog, tak nezapomen i tady tu dokumentaci. thx

@zajca zajca enabled auto-merge May 28, 2026 12:00
@zajca zajca merged commit 0b1a3ab into main May 28, 2026
1 check passed
@zajca zajca deleted the aliases branch May 28, 2026 12:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants