Skip to content

rewrite intro to materialize#335

Merged
vroldanbet merged 1 commit intomainfrom
rewrite-intro-materialize
Apr 15, 2025
Merged

rewrite intro to materialize#335
vroldanbet merged 1 commit intomainfrom
rewrite-intro-materialize

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

@vercel
Copy link
Contributor

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

- [.all]

## 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
Collaborator

@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

- [.all]

## 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
Collaborator

@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.

4 participants