You are viewing a plain text version of this content. The canonical link for it is here.
Posted to pr@cassandra.apache.org by "bbotella (via GitHub)" <gi...@apache.org> on 2025/02/03 22:25:19 UTC
[PR] Constraints blog post [cassandra-website]
bbotella opened a new pull request, #286:
URL: https://github.com/apache/cassandra-website/pull/286
(no comment)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
Re: [PR] Constraints blog post [cassandra-website]
Posted by "himanshujindal (via GitHub)" <gi...@apache.org>.
himanshujindal commented on code in PR #286:
URL: https://github.com/apache/cassandra-website/pull/286#discussion_r1946911590
##########
site-content/source/modules/ROOT/pages/blog/Introducing-constraints-framework.adoc:
##########
@@ -0,0 +1,71 @@
+= Upcoming Features: Constraints Framework
+:page-layout: single-post
+:page-role: blog-post
+:page-post-date: February 3, 2025
+:page-post-author: Bernardo Botella Corbi
+:description: The Apache Cassandra Community
+:keywords:
+
+Casandra has had limited tools to handle value limits and rules at the time of writing data to a table. Constraints Framework positions itself as the center piece to provide an easy approach to be able to define those rules that gives such flexibility to both Cassandra users and operators by adding a framework to define generic checks at write time.
+
+Up until now, Cassandra users have relied on limited tools to manage value limits and enforce rules during data writing. Now, with the introduction of the Constraints Framework, Cassandra is able to offer users and operators unprecedented flexibility and control. Here’s everything you need to know about this groundbreaking feature.
+
+== What is the Constraints Framework?
+
+The Constraints Framework, introduced through https://cwiki.apache.org/confluence/display/CASSANDRA/CEP-42:+Constraints+Framework[CEP-42,window=_blank], is designed to allow Cassandra users to define rules that validate data at write time. By incorporating these checks, operators can gain:
+
+* Improved Data Governance: Better control and reasoning about data quality.
+* Predictable Performance: Easier tuning for performance and maintenance due to predictable partition sizes.
+* Future-Ready Extensibility: The framework lays the groundwork for advanced validations in the future.
+* Enhanced Storage Efficiency: Potential for smarter decisions in the storage engine based on data size.
+
+If you want to know more details, please follow the https://lists.apache.org/thread/xc2phmxgsc7t3y9b23079vbflrhyyywj[dev thread,window=_blank].
+
+== What's new?
+
+Cassandra Query Language (CQL) now includes syntax for defining, altering, and dropping constraints directly within column definitions. Here are some examples:
+
+----
+CREATE TABLE keyspace.table (
+ name text,
+ i int CHECK (condition)
+ ...,
+);
+----
+
+Altering Existing Constraints:
+----
+ALTER TABLE [IF EXISTS] <table> ALTER [IF EXISTS] <column> CHECK <condition>;
+----
+Dropping Constraints:
+----
+ALTER TABLE [IF EXISTS] <table> ALTER [IF EXISTS] <column> DROP CHECK;
+----
Review Comment:
It would be nice if these were actual examples. If we only want to show syntax, we should change the sentence to "Here is the syntax on how to use constraints in CQL:". IMO I would prefer an actual example here, with a link to a CQL doc showing syntax.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
Re: [PR] Constraints blog post [cassandra-website]
Posted by "michaelsembwever (via GitHub)" <gi...@apache.org>.
michaelsembwever commented on PR #286:
URL: https://github.com/apache/cassandra-website/pull/286#issuecomment-3615625774
@bbotella wanna squash your commits and get this merged ?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
Re: [PR] Constraints blog post [cassandra-website]
Posted by "himanshujindal (via GitHub)" <gi...@apache.org>.
himanshujindal commented on code in PR #286:
URL: https://github.com/apache/cassandra-website/pull/286#discussion_r1946906377
##########
site-content/source/modules/ROOT/pages/blog/Introducing-constraints-framework.adoc:
##########
@@ -0,0 +1,71 @@
+= Upcoming Features: Constraints Framework
+:page-layout: single-post
+:page-role: blog-post
+:page-post-date: February 3, 2025
+:page-post-author: Bernardo Botella Corbi
+:description: The Apache Cassandra Community
+:keywords:
+
+Casandra has had limited tools to handle value limits and rules at the time of writing data to a table. Constraints Framework positions itself as the center piece to provide an easy approach to be able to define those rules that gives such flexibility to both Cassandra users and operators by adding a framework to define generic checks at write time.
Review Comment:
The paragraph seems hard to read. I used a LLM to simplify this - "Cassandra has had limited tools to handle value limits and rules when writing data to tables. The Constraints Framework positions itself as a centerpiece, providing an easy approach to define rules that give flexibility to both Cassandra users and operators by adding a framework for generic checks at write time." It made the following changes:
- Fixed spelling of "Cassandra"
- Changed "at the time of writing" to "when writing"
- Added "The" before "Constraints Framework"
- Changed "center piece" to "centerpiece"
- Improved flow by restructuring parts of the sentence
- Fixed subject-verb agreement ("gives" to "give")
- Minor phrasing improvements for clarity
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
Re: [PR] Constraints blog post [cassandra-website]
Posted by "himanshujindal (via GitHub)" <gi...@apache.org>.
himanshujindal commented on code in PR #286:
URL: https://github.com/apache/cassandra-website/pull/286#discussion_r1946911590
##########
site-content/source/modules/ROOT/pages/blog/Introducing-constraints-framework.adoc:
##########
@@ -0,0 +1,71 @@
+= Upcoming Features: Constraints Framework
+:page-layout: single-post
+:page-role: blog-post
+:page-post-date: February 3, 2025
+:page-post-author: Bernardo Botella Corbi
+:description: The Apache Cassandra Community
+:keywords:
+
+Casandra has had limited tools to handle value limits and rules at the time of writing data to a table. Constraints Framework positions itself as the center piece to provide an easy approach to be able to define those rules that gives such flexibility to both Cassandra users and operators by adding a framework to define generic checks at write time.
+
+Up until now, Cassandra users have relied on limited tools to manage value limits and enforce rules during data writing. Now, with the introduction of the Constraints Framework, Cassandra is able to offer users and operators unprecedented flexibility and control. Here’s everything you need to know about this groundbreaking feature.
+
+== What is the Constraints Framework?
+
+The Constraints Framework, introduced through https://cwiki.apache.org/confluence/display/CASSANDRA/CEP-42:+Constraints+Framework[CEP-42,window=_blank], is designed to allow Cassandra users to define rules that validate data at write time. By incorporating these checks, operators can gain:
+
+* Improved Data Governance: Better control and reasoning about data quality.
+* Predictable Performance: Easier tuning for performance and maintenance due to predictable partition sizes.
+* Future-Ready Extensibility: The framework lays the groundwork for advanced validations in the future.
+* Enhanced Storage Efficiency: Potential for smarter decisions in the storage engine based on data size.
+
+If you want to know more details, please follow the https://lists.apache.org/thread/xc2phmxgsc7t3y9b23079vbflrhyyywj[dev thread,window=_blank].
+
+== What's new?
+
+Cassandra Query Language (CQL) now includes syntax for defining, altering, and dropping constraints directly within column definitions. Here are some examples:
+
+----
+CREATE TABLE keyspace.table (
+ name text,
+ i int CHECK (condition)
+ ...,
+);
+----
+
+Altering Existing Constraints:
+----
+ALTER TABLE [IF EXISTS] <table> ALTER [IF EXISTS] <column> CHECK <condition>;
+----
+Dropping Constraints:
+----
+ALTER TABLE [IF EXISTS] <table> ALTER [IF EXISTS] <column> DROP CHECK;
+----
Review Comment:
It would be nice if these were actual examples. If we only want to show syntax, we should change the sentence to "Here is the syntax on how to use constraints in CQL:". I would prefer an actual example here, with a link to a CQL doc showing syntax.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
Re: [PR] Constraints blog post [cassandra-website]
Posted by "himanshujindal (via GitHub)" <gi...@apache.org>.
himanshujindal commented on code in PR #286:
URL: https://github.com/apache/cassandra-website/pull/286#discussion_r1946902858
##########
site-content/source/modules/ROOT/pages/blog.adoc:
##########
@@ -8,6 +8,29 @@ NOTES FOR CONTENT CREATORS
- Replace post tile, date, description and link to you post.
////
+//start card
+[openblock,card shadow relative test]
+----
+[openblock,card-header]
+------
+[discrete]
+=== Upcoming Features: Constraints Framework
+[discrete]
+==== February 3, 2025
+------
+[openblock,card-content]
+------
+Introducting the Cassandra Constraints Framework, a new feature that allows users to define data validation rules at write time.
Review Comment:
Typo: Introducting -> Introducing
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
Re: [PR] Constraints blog post [cassandra-website]
Posted by "himanshujindal (via GitHub)" <gi...@apache.org>.
himanshujindal commented on code in PR #286:
URL: https://github.com/apache/cassandra-website/pull/286#discussion_r1946903276
##########
site-content/source/modules/ROOT/pages/blog/Introducing-constraints-framework.adoc:
##########
@@ -0,0 +1,71 @@
+= Upcoming Features: Constraints Framework
+:page-layout: single-post
+:page-role: blog-post
+:page-post-date: February 3, 2025
+:page-post-author: Bernardo Botella Corbi
+:description: The Apache Cassandra Community
+:keywords:
+
+Casandra has had limited tools to handle value limits and rules at the time of writing data to a table. Constraints Framework positions itself as the center piece to provide an easy approach to be able to define those rules that gives such flexibility to both Cassandra users and operators by adding a framework to define generic checks at write time.
Review Comment:
Typo: Casandra -> Cassandra
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
Re: [PR] Constraints blog post [cassandra-website]
Posted by "himanshujindal (via GitHub)" <gi...@apache.org>.
himanshujindal commented on code in PR #286:
URL: https://github.com/apache/cassandra-website/pull/286#discussion_r1946906377
##########
site-content/source/modules/ROOT/pages/blog/Introducing-constraints-framework.adoc:
##########
@@ -0,0 +1,71 @@
+= Upcoming Features: Constraints Framework
+:page-layout: single-post
+:page-role: blog-post
+:page-post-date: February 3, 2025
+:page-post-author: Bernardo Botella Corbi
+:description: The Apache Cassandra Community
+:keywords:
+
+Casandra has had limited tools to handle value limits and rules at the time of writing data to a table. Constraints Framework positions itself as the center piece to provide an easy approach to be able to define those rules that gives such flexibility to both Cassandra users and operators by adding a framework to define generic checks at write time.
Review Comment:
The paragraph seems hard to read. I used a LLM to simplify this - "Cassandra has had limited tools to handle value limits and rules when writing data to tables. The Constraints Framework positions itself as a centerpiece, providing an easy approach to define rules that give flexibility to both Cassandra users and operators by adding a framework for generic checks at write time." It made the following changes:
- Fixed spelling of "Cassandra"
- Changed "at the time of writing" to "when writing"
- Added "The" before "Constraints Framework"
- Changed "center piece" to "centerpiece"
- Improved flow by restructuring parts of the sentence
- Fixed subject-verb agreement ("gives" to "give")
- Minor phrasing improvements for clarity
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org