Skip to content

rewrite intro to materialize #335

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Apr 15, 2025
Merged

rewrite intro to materialize #335

merged 1 commit into from
Apr 15, 2025

Conversation

miparnisari
Copy link
Contributor

@miparnisari miparnisari commented Mar 19, 2025

My goal was to make the text flow better. So I structured it like so:

  • what it is
  • what it is good for
  • limitations

Copy link

vercel bot commented Mar 19, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Apr 15, 2025 4:58pm


## Current Limitations
on the path of permissions computed by Materialize, it will error out. However, your schema can still include them.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

To be confirmed: does it error out? It is just my assumption

Copy link
Contributor

Choose a reason for hiding this comment

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

correct, so long it's not in the reachability path of a watched permission, Materialize will not complain. If it does, the hydrator will fail

Copy link
Contributor Author

Choose a reason for hiding this comment

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

can I mention "hydrator" here or is that too much information?

Copy link
Contributor

Choose a reason for hiding this comment

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

Let's skip if for simplicity

Copy link
Contributor

@tstirrat15 tstirrat15 left a comment

Choose a reason for hiding this comment

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

See comments, otherwise LGTM

Updates occur after a relationship is written that affects a subject's membership in a permission set or a set’s permission on a specific resource.
The intent is for users to process these updates and store them to form a precomputed and denormalized view of SpiceDB permissions.
AuthZed Materialize is inspired by the Leopard index component described in the [Zanzibar paper](https://zanzibar.tech/2IoYDUFMAE:0:T).
Much like the concept of a materialized view in relational databases, AuthZed Materialize is a service that computes how permissions change after relationships

Choose a reason for hiding this comment

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

Suggested change
Much like the concept of a materialized view in relational databases, AuthZed Materialize is a service that computes how permissions change after relationships
Much like the concept of a materialized view in relational databases, AuthZed Materialize precomputes specified permissions defined in your SpiceDB schema.

[Dedicated]: ../guides/picking-a-product#dedicated
AuthZed Materialize is inspired by the Leopard index component described in the [Zanzibar paper](https://zanzibar.tech/2IoYDUFMAE:0:T).
Much like the concept of a materialized view in relational databases, AuthZed Materialize is a service that computes how permissions change after relationships
are written, when those relationships affect a subject's membership in a permission set or a set’s permission on a specific resource.
Copy link
Contributor

Choose a reason for hiding this comment

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

not only relationships - but also schemas


## Current Limitations
on the path of permissions computed by Materialize, it will error out. However, your schema can still include them.
Copy link
Contributor

Choose a reason for hiding this comment

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

correct, so long it's not in the reachability path of a watched permission, Materialize will not complain. If it does, the hydrator will fail

Copy link
Contributor

@tstirrat15 tstirrat15 left a comment

Choose a reason for hiding this comment

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

LGTM!

@miparnisari miparnisari enabled auto-merge April 14, 2025 21:42
@miparnisari
Copy link
Contributor Author

Blocked by #340

@vroldanbet vroldanbet disabled auto-merge April 15, 2025 16:53
@vroldanbet vroldanbet enabled auto-merge April 15, 2025 16:54
@miparnisari miparnisari force-pushed the rewrite-intro-materialize branch from 9697381 to 2f56d0c Compare April 15, 2025 16:58
@vroldanbet vroldanbet merged commit 50cfc97 into main Apr 15, 2025
7 checks passed
@vroldanbet vroldanbet deleted the rewrite-intro-materialize branch April 15, 2025 16:58
@github-actions github-actions bot locked and limited conversation to collaborators Apr 15, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants