Re: [PR] KAKFA-15629: Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery [kafka]

2023-12-06 Thread via GitHub


mjsax merged PR #14898:
URL: https://github.com/apache/kafka/pull/14898


-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] KAKFA-15629: Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery [kafka]

2023-12-06 Thread via GitHub


mjsax commented on code in PR #14898:
URL: https://github.com/apache/kafka/pull/14898#discussion_r1418202440


##
docs/streams/upgrade-guide.html:
##
@@ -139,6 +139,10 @@ Streams API
 https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
 
 
+
+https://cwiki.apache.org/confluence/display/KAFKA/KIP-992%3A+Proposal+to+introduce+IQv2+Query+Types%3A+TimestampedKeyQuery+and+TimestampedRangeQuery;>KIP-992
 add two new query types, namely TimestampedKeyQuery and 
TimestampedRangeQuery. Both should be used to query a timestamped 
key-value store, to retrieve a ValueAndTimestamp result. The 
existing KeyQuery and RangeQuery are changes to 
always return the value only, also for timestamped key-value stores.

Review Comment:
   ```suggestion
   https://cwiki.apache.org/confluence/display/KAFKA/KIP-992%3A+Proposal+to+introduce+IQv2+Query+Types%3A+TimestampedKeyQuery+and+TimestampedRangeQuery;>KIP-992
 adds two new query types,
   namely TimestampedKeyQuery and 
TimestampedRangeQuery. Both should be used to query a timestamped 
key-value store, to retrieve a ValueAndTimestamp result.
   The existing KeyQuery and RangeQuery are 
changed to always return the value only for timestamped key-value stores.
   ```



-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] KAKFA-15629: Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery [kafka]

2023-12-05 Thread via GitHub


hanyuzheng7 commented on PR #14898:
URL: https://github.com/apache/kafka/pull/14898#issuecomment-1842028444

   > This PR shows merge conflict. Can you rebase it on `trunk`?
   
   ok
   


-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] KAKFA-15629: Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery [kafka]

2023-12-05 Thread via GitHub


mjsax commented on PR #14898:
URL: https://github.com/apache/kafka/pull/14898#issuecomment-1841932981

   This PR shows merge conflict. Can you rebase it on `trunk`?


-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] KAKFA-15629: Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery [kafka]

2023-12-05 Thread via GitHub


hanyuzheng7 commented on code in PR #14898:
URL: https://github.com/apache/kafka/pull/14898#discussion_r1416268185


##
docs/streams/upgrade-guide.html:
##
@@ -136,7 +136,12 @@ <
 Streams API changes in 3.7.0
 
 IQv2 supports RangeQuery that allows to specify 
unbounded, bounded, or half-open key-ranges, which return data in ascending 
(byte[]-lexicographical) order (per partition).
-https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
+https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
+
+
+
+KIP-992 add two new query types, namely 
TimestampedKeyQuery and TimestampedRangeQuery. Both 
should be used to query a timestamped key-value store, to retrieve a 
ValueAndTimestamp result. The existing KeyQuery and 
RangeQuery are changes to always return the value only, also for 
timestamped key-value stores.

Review Comment:
   ok



-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] KAKFA-15629: Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery [kafka]

2023-12-05 Thread via GitHub


mjsax commented on code in PR #14898:
URL: https://github.com/apache/kafka/pull/14898#discussion_r1416203067


##
docs/streams/upgrade-guide.html:
##
@@ -136,7 +136,12 @@ <
 Streams API changes in 3.7.0
 
 IQv2 supports RangeQuery that allows to specify 
unbounded, bounded, or half-open key-ranges, which return data in ascending 
(byte[]-lexicographical) order (per partition).
-https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
+https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
+
+
+
+KIP-992 add two new query types, namely 
TimestampedKeyQuery and TimestampedRangeQuery. Both 
should be used to query a timestamped key-value store, to retrieve a 
ValueAndTimestamp result. The existing KeyQuery and 
RangeQuery are changes to always return the value only, also for 
timestamped key-value stores.

Review Comment:
   Make `KIP-992` here the link directly and remove it from the end of the 
paragraph



-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] KAKFA-15629: Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery [kafka]

2023-12-05 Thread via GitHub


hanyuzheng7 commented on code in PR #14898:
URL: https://github.com/apache/kafka/pull/14898#discussion_r1416130187


##
docs/streams/upgrade-guide.html:
##
@@ -136,9 +136,16 @@ <
 Streams API changes in 3.7.0
 
 IQv2 supports RangeQuery that allows to specify 
unbounded, bounded, or half-open key-ranges, which return data in ascending 
(byte[]-lexicographical) order (per partition).
-https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
+https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
 
 
+
+IQv2 supports TimestampedKeyQuery that allows to retrieve 
a single record(ValueAndTimestamp) based on its key.
+https://cwiki.apache.org/confluence/display/KAFKA/KIP-992%3A+Proposal+to+introduce+IQv2+Query+Types%3A+TimestampedKeyQuery+and+TimestampedRangeQuery;>KIP-992
+IQv2 supports TimestampedRangeQuery that allows to 
retrieve a set of records(ValueAndTimestamp), specified using an upper and/or 
lower bound on the keys.
+https://cwiki.apache.org/confluence/display/KAFKA/KIP-992%3A+Proposal+to+introduce+IQv2+Query+Types%3A+TimestampedKeyQuery+and+TimestampedRangeQuery;>KIP-992

Review Comment:
   ok, fixed it.



-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] KAKFA-15629: Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery [kafka]

2023-12-05 Thread via GitHub


hanyuzheng7 commented on code in PR #14898:
URL: https://github.com/apache/kafka/pull/14898#discussion_r1416115869


##
docs/streams/upgrade-guide.html:
##
@@ -136,9 +136,16 @@ <
 Streams API changes in 3.7.0
 
 IQv2 supports RangeQuery that allows to specify 
unbounded, bounded, or half-open key-ranges, which return data in ascending 
(byte[]-lexicographical) order (per partition).
-https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
+https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
 
 
+

Review Comment:
   ok, fixed it.



-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] KAKFA-15629: Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery [kafka]

2023-12-04 Thread via GitHub


mjsax commented on code in PR #14898:
URL: https://github.com/apache/kafka/pull/14898#discussion_r1414431907


##
docs/streams/upgrade-guide.html:
##
@@ -136,9 +136,16 @@ <
 Streams API changes in 3.7.0
 
 IQv2 supports RangeQuery that allows to specify 
unbounded, bounded, or half-open key-ranges, which return data in ascending 
(byte[]-lexicographical) order (per partition).
-https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
+https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
 
 
+
+IQv2 supports TimestampedKeyQuery that allows to retrieve 
a single record(ValueAndTimestamp) based on its key.
+https://cwiki.apache.org/confluence/display/KAFKA/KIP-992%3A+Proposal+to+introduce+IQv2+Query+Types%3A+TimestampedKeyQuery+and+TimestampedRangeQuery;>KIP-992
+IQv2 supports TimestampedRangeQuery that allows to 
retrieve a set of records(ValueAndTimestamp), specified using an upper and/or 
lower bound on the keys.
+https://cwiki.apache.org/confluence/display/KAFKA/KIP-992%3A+Proposal+to+introduce+IQv2+Query+Types%3A+TimestampedKeyQuery+and+TimestampedRangeQuery;>KIP-992

Review Comment:
   I think we need to reword this, because `Timestamped[Key/Range]Query` are 
new.
   
   ```
   KIP-992 add two new query types, namely TimestampedKeyQuery and 
TimestampedRangeQuery. Both should be used to query a timestamped key-value 
store, to retrieve a ValueAndTimestampe result. The existing KeyQuery and 
RangeQuery are changes to always return the value only, also for timestamped 
key-value stores.
   ```
   
   Of course, please add the proper markup for the KIP link and `` styles.



-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] KAKFA-15629: Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery [kafka]

2023-12-04 Thread via GitHub


mjsax commented on code in PR #14898:
URL: https://github.com/apache/kafka/pull/14898#discussion_r1414428584


##
docs/streams/upgrade-guide.html:
##
@@ -136,9 +136,16 @@ <
 Streams API changes in 3.7.0
 
 IQv2 supports RangeQuery that allows to specify 
unbounded, bounded, or half-open key-ranges, which return data in ascending 
(byte[]-lexicographical) order (per partition).
-https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
+https://cwiki.apache.org/confluence/display/KAFKA/KIP-985%3A+Add+reverseRange+and+reverseAll+query+over+kv-store+in+IQv2;>KIP-985
 extends this functionality by adding .withDescendingKeys() to 
allow user to receive data in descending order.
 
 
+

Review Comment:
   should be lower case `` (same for `` below)



-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



[PR] KAKFA-15629: Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery [kafka]

2023-12-01 Thread via GitHub


hanyuzheng7 opened a new pull request, #14898:
URL: https://github.com/apache/kafka/pull/14898

   Update upgrade-guide.html for TimestampedKeyQuery and TimestampedRangeQuery
   
   ### Committer Checklist (excluded from commit message)
   - [ ] Verify design and implementation 
   - [ ] Verify test coverage and CI build status
   - [ ] Verify documentation (including upgrade notes)
   


-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org