You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cassandra.apache.org by "DeepakVohra (Jira)" <ji...@apache.org> on 2020/02/22 00:21:00 UTC
[jira] [Comment Edited] (CASSANDRA-15481) Data Modeling
[ https://issues.apache.org/jira/browse/CASSANDRA-15481?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17042280#comment-17042280 ]
DeepakVohra edited comment on CASSANDRA-15481 at 2/22/20 12:20 AM:
-------------------------------------------------------------------
[~rustyrazorblade] I would suggest keeping the index.rst page (https://github.com/Deepak-Vohra/cassandra/blob/data_modeling/doc/source/data_modeling/index.rst) I added as the first page of the documentation. And keep the *elaborate example* (http://cassandra.apache.org/doc/latest/data_modeling/index.html) from O'Reilly book as subsequent pages. I have discussed the important concepts though the example is not real-world and not too detailed. I would like to get opinion of other reviewers including from [~zznate] and [~djoshi] before you resolve the ticket. Could you reopen the ticket?
The O'Reilly book chapter posted as documentation makes use of a *great example*, which I would suggest keeping, but has several issues:
1. It starts right-away with an example from the first statement, "First, let’s create a simple domain model that is easy to understand in the relational world, and then see how you might map it from a relational to a distributed hashtable model in Cassandra.", without discussing concepts.
1. Does not define what data modeling is. I have defined data modeling in "What is Data Modeling?".
2. Does not discuss some important concepts such as
_Single table-single query_ approach, which I have discussed in
"How does Apache Cassandra Model Data?"
3. Does not discuss how queries are selected, which I have discussed in "Selecting Queries to Support".
4. Does not compare with relational model, which I have in section "Comparing with Relational Data Model".
5. Does not discuss data model analysis such as _Data redundancies_, which I have discussed in "Data Model Analysis".
6. Does not discuss materialized views albeit as an experimental feature.
was (Author: dvohra):
[~rustyrazorblade] I would suggest keeping the index.rst page (https://github.com/Deepak-Vohra/cassandra/blob/data_modeling/doc/source/data_modeling/index.rst) I added as the first page of the documentation. And keep the *elaborate example* (http://cassandra.apache.org/doc/latest/data_modeling/index.html) from O'Reilly book as subsequent pages. I have discussed the important concepts though the example is not real-world and not too detailed. I would like to get opinion of other reviewers including from [~zznate]and [~djoshi] before you resolve the ticket. Could you reopen the ticket?
The O'Reilly book chapter posted as documentation makes use of a *great example*, which I would suggest keeping, but has several issues:
1. It starts right-away with an example from the first statement, "First, let’s create a simple domain model that is easy to understand in the relational world, and then see how you might map it from a relational to a distributed hashtable model in Cassandra.", without discussing concepts.
1. Does not define what data modeling is. I have defined data modeling in "What is Data Modeling?".
2. Does not discuss some important concepts such as
_Single table-single query_ approach, which I have discussed in
"How does Apache Cassandra Model Data?"
3. Does not discuss how queries are selected, which I have discussed in "Selecting Queries to Support".
4. Does not compare with relational model, which I have in section "Comparing with Relational Data Model".
5. Does not discuss data model analysis such as _Data redundancies_, which I have discussed in "Data Model Analysis".
6. Does not discuss materialized views albeit as an experimental feature.
> Data Modeling
> -------------
>
> Key: CASSANDRA-15481
> URL: https://issues.apache.org/jira/browse/CASSANDRA-15481
> Project: Cassandra
> Issue Type: Sub-task
> Components: Documentation/Website
> Reporter: DeepakVohra
> Assignee: DeepakVohra
> Priority: Normal
> Fix For: 4.0
>
>
> Added a page on data modeling.
> https://github.com/apache/cassandra/pull/410
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org