{"action":"created","comment":{"url":"https://api.github.com/repos/confluentinc/ksql/pulls/comments/232055197","pull_request_review_id":173164937,"id":232055197,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDIzMjA1NTE5Nw==","diff_hunk":"@@ -0,0 +1,122 @@\n+.. _time-and-windows:\r\n+\r\n+Time and Windows\r\n+################\r\n+\r\n+During the life cycle of a record, it experiences a number of events\r\n+which occur at particular times. Three important times in a record's \r\n+life cycle are *Event-time*, *Ingestion-time*, and *Processing-time*. \r\n+\r\n+Representing time consistently enables aggregation operations o streams,\r\n+like SUM, that have time boundaries.\r\n+\r\n+KSQL and Kafka Streams support the following notions of time:\r\n+\r\n+Event-time\r\n+    The time when a record is created by the data source. Achieving event-time\r\n+    semantics requires embedding timestamps in records when an event occurs and\r\n+    the record is produced.\r\n+\r\n+    For example, if the event is a geo-location change reported by a GPS sensor\r\n+    in a car, the associated event-time is the time when the GPS sensor captured\r\n+    the location change.\r\n+\r\n+Ingestion-time\r\n+    The time when a record is stored in a topic partition by a Kafka broker.\r\n+    Ingestion-time is similar to event-time, as a timestamp gets embedded in the\r\n+    record, but the ingestion timestamp is generated when the Kafka broker appends\r\n+    the record to the target topic.\r\n+    \r\n+    Ingestion-time may approximate event-time reasonably well if the time\r\n+    difference between creation of the record and its ingestion into Kafka\r\n+    is sufficiently small. This means that ingestion-time may be an alternative\r\n+    for use cases where event-time semantics aren't possible.\r\n+    \r\n+    You may face this situation when data producers don't embed timestamps in\r\n+    records, as in older versions of Kafka’s Java producer client, or when the\r\n+    producer can't assign timestamps directly, like when it doesn't have access\r\n+    to a local clock.\r\n+\r\n+Processing-time\r\n+    The time when the record is consumed by a stream processing application.\r\n+    The processing-time happen immediately after Ingestion-time, or it may\r\n+    happen much later, in milliseconds, hours, or days.\r\n+\r\n+    For example: imagine an analytics application that reads and processes the\r\n+    geo-location data reported from car sensors, and presents it to a\r\n+    fleet-management dashboard. In this case, processing-time in the analytics\r\n+    application might be milliseconds or seconds after event-time, like for\r\n+    real-time pipelines based on Apache Kafka and Kafka Streams) or it might be\r\n+    hours, like for batch pipelines based on Apache Hadoop or Apache Spark.\r\n+\r\n+Kafka Streams assigns a timestamp to every data record by using\r\n+*timestamp extractors*, which are per-record timestamps that describe the\r\n+progress of a stream over time. Timestamps are used by time-dependent\r\n+operations, like joins.\r\n+\r\n+We call it the *application event-time* to differentiate\r","path":"docs/concepts/time-and-windows.rst","position":57,"original_position":57,"commit_id":"4991c5524e5d359d1e87491f285f19648afcc69d","original_commit_id":"4991c5524e5d359d1e87491f285f19648afcc69d","user":{"login":"mjsax","id":8959638,"node_id":"MDQ6VXNlcjg5NTk2Mzg=","avatar_url":"https://avatars1.githubusercontent.com/u/8959638?v=4","gravatar_id":"","url":"https://api.github.com/users/mjsax","html_url":"https://github.com/mjsax","followers_url":"https://api.github.com/users/mjsax/followers","following_url":"https://api.github.com/users/mjsax/following{/other_user}","gists_url":"https://api.github.com/users/mjsax/gists{/gist_id}","starred_url":"https://api.github.com/users/mjsax/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mjsax/subscriptions","organizations_url":"https://api.github.com/users/mjsax/orgs","repos_url":"https://api.github.com/users/mjsax/repos","events_url":"https://api.github.com/users/mjsax/events{/privacy}","received_events_url":"https://api.github.com/users/mjsax/received_events","type":"User","site_admin":false},"body":"\\cc @miguno Can you help out here? IMHO, it's important that we standardize our language.","created_at":"2018-11-08T20:48:25Z","updated_at":"2018-11-08T20:48:25Z","html_url":"https://github.com/confluentinc/ksql/pull/2134#discussion_r232055197","pull_request_url":"https://api.github.com/repos/confluentinc/ksql/pulls/2134","author_association":"MEMBER","_links":{"self":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/comments/232055197"},"html":{"href":"https://github.com/confluentinc/ksql/pull/2134#discussion_r232055197"},"pull_request":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/2134"}},"in_reply_to_id":231753906},"pull_request":{"url":"https://api.github.com/repos/confluentinc/ksql/pulls/2134","id":229206054,"node_id":"MDExOlB1bGxSZXF1ZXN0MjI5MjA2MDU0","html_url":"https://github.com/confluentinc/ksql/pull/2134","diff_url":"https://github.com/confluentinc/ksql/pull/2134.diff","patch_url":"https://github.com/confluentinc/ksql/pull/2134.patch","issue_url":"https://api.github.com/repos/confluentinc/ksql/issues/2134","number":2134,"state":"open","locked":false,"title":"KSQL-1787: First draft of Time and Windows topic [WIP]","user":{"login":"JimGalasyn","id":12521043,"node_id":"MDQ6VXNlcjEyNTIxMDQz","avatar_url":"https://avatars0.githubusercontent.com/u/12521043?v=4","gravatar_id":"","url":"https://api.github.com/users/JimGalasyn","html_url":"https://github.com/JimGalasyn","followers_url":"https://api.github.com/users/JimGalasyn/followers","following_url":"https://api.github.com/users/JimGalasyn/following{/other_user}","gists_url":"https://api.github.com/users/JimGalasyn/gists{/gist_id}","starred_url":"https://api.github.com/users/JimGalasyn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JimGalasyn/subscriptions","organizations_url":"https://api.github.com/users/JimGalasyn/orgs","repos_url":"https://api.github.com/users/JimGalasyn/repos","events_url":"https://api.github.com/users/JimGalasyn/events{/privacy}","received_events_url":"https://api.github.com/users/JimGalasyn/received_events","type":"User","site_admin":false},"body":"","created_at":"2018-11-07T23:46:00Z","updated_at":"2018-11-08T20:48:25Z","closed_at":null,"merged_at":null,"merge_commit_sha":"f078c2fbe8461770bd8750788bed5da5bd8b24a6","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/confluentinc/ksql/pulls/2134/commits","review_comments_url":"https://api.github.com/repos/confluentinc/ksql/pulls/2134/comments","review_comment_url":"https://api.github.com/repos/confluentinc/ksql/pulls/comments{/number}","comments_url":"https://api.github.com/repos/confluentinc/ksql/issues/2134/comments","statuses_url":"https://api.github.com/repos/confluentinc/ksql/statuses/4991c5524e5d359d1e87491f285f19648afcc69d","head":{"label":"JimGalasyn:ksql-1787","ref":"ksql-1787","sha":"4991c5524e5d359d1e87491f285f19648afcc69d","user":{"login":"JimGalasyn","id":12521043,"node_id":"MDQ6VXNlcjEyNTIxMDQz","avatar_url":"https://avatars0.githubusercontent.com/u/12521043?v=4","gravatar_id":"","url":"https://api.github.com/users/JimGalasyn","html_url":"https://github.com/JimGalasyn","followers_url":"https://api.github.com/users/JimGalasyn/followers","following_url":"https://api.github.com/users/JimGalasyn/following{/other_user}","gists_url":"https://api.github.com/users/JimGalasyn/gists{/gist_id}","starred_url":"https://api.github.com/users/JimGalasyn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JimGalasyn/subscriptions","organizations_url":"https://api.github.com/users/JimGalasyn/orgs","repos_url":"https://api.github.com/users/JimGalasyn/repos","events_url":"https://api.github.com/users/JimGalasyn/events{/privacy}","received_events_url":"https://api.github.com/users/JimGalasyn/received_events","type":"User","site_admin":false},"repo":{"id":135502361,"node_id":"MDEwOlJlcG9zaXRvcnkxMzU1MDIzNjE=","name":"ksql","full_name":"JimGalasyn/ksql","private":false,"owner":{"login":"JimGalasyn","id":12521043,"node_id":"MDQ6VXNlcjEyNTIxMDQz","avatar_url":"https://avatars0.githubusercontent.com/u/12521043?v=4","gravatar_id":"","url":"https://api.github.com/users/JimGalasyn","html_url":"https://github.com/JimGalasyn","followers_url":"https://api.github.com/users/JimGalasyn/followers","following_url":"https://api.github.com/users/JimGalasyn/following{/other_user}","gists_url":"https://api.github.com/users/JimGalasyn/gists{/gist_id}","starred_url":"https://api.github.com/users/JimGalasyn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JimGalasyn/subscriptions","organizations_url":"https://api.github.com/users/JimGalasyn/orgs","repos_url":"https://api.github.com/users/JimGalasyn/repos","events_url":"https://api.github.com/users/JimGalasyn/events{/privacy}","received_events_url":"https://api.github.com/users/JimGalasyn/received_events","type":"User","site_admin":false},"html_url":"https://github.com/JimGalasyn/ksql","description":"KSQL - the Streaming SQL Engine for Apache Kafka ","fork":true,"url":"https://api.github.com/repos/JimGalasyn/ksql","forks_url":"https://api.github.com/repos/JimGalasyn/ksql/forks","keys_url":"https://api.github.com/repos/JimGalasyn/ksql/keys{/key_id}","collaborators_url":"https://api.github.com/repos/JimGalasyn/ksql/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/JimGalasyn/ksql/teams","hooks_url":"https://api.github.com/repos/JimGalasyn/ksql/hooks","issue_events_url":"https://api.github.com/repos/JimGalasyn/ksql/issues/events{/number}","events_url":"https://api.github.com/repos/JimGalasyn/ksql/events","assignees_url":"https://api.github.com/repos/JimGalasyn/ksql/assignees{/user}","branches_url":"https://api.github.com/repos/JimGalasyn/ksql/branches{/branch}","tags_url":"https://api.github.com/repos/JimGalasyn/ksql/tags","blobs_url":"https://api.github.com/repos/JimGalasyn/ksql/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/JimGalasyn/ksql/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/JimGalasyn/ksql/git/refs{/sha}","trees_url":"https://api.github.com/repos/JimGalasyn/ksql/git/trees{/sha}","statuses_url":"https://api.github.com/repos/JimGalasyn/ksql/statuses/{sha}","languages_url":"https://api.github.com/repos/JimGalasyn/ksql/languages","stargazers_url":"https://api.github.com/repos/JimGalasyn/ksql/stargazers","contributors_url":"https://api.github.com/repos/JimGalasyn/ksql/contributors","subscribers_url":"https://api.github.com/repos/JimGalasyn/ksql/subscribers","subscription_url":"https://api.github.com/repos/JimGalasyn/ksql/subscription","commits_url":"https://api.github.com/repos/JimGalasyn/ksql/commits{/sha}","git_commits_url":"https://api.github.com/repos/JimGalasyn/ksql/git/commits{/sha}","comments_url":"https://api.github.com/repos/JimGalasyn/ksql/comments{/number}","issue_comment_url":"https://api.github.com/repos/JimGalasyn/ksql/issues/comments{/number}","contents_url":"https://api.github.com/repos/JimGalasyn/ksql/contents/{+path}","compare_url":"https://api.github.com/repos/JimGalasyn/ksql/compare/{base}...{head}","merges_url":"https://api.github.com/repos/JimGalasyn/ksql/merges","archive_url":"https://api.github.com/repos/JimGalasyn/ksql/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/JimGalasyn/ksql/downloads","issues_url":"https://api.github.com/repos/JimGalasyn/ksql/issues{/number}","pulls_url":"https://api.github.com/repos/JimGalasyn/ksql/pulls{/number}","milestones_url":"https://api.github.com/repos/JimGalasyn/ksql/milestones{/number}","notifications_url":"https://api.github.com/repos/JimGalasyn/ksql/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/JimGalasyn/ksql/labels{/name}","releases_url":"https://api.github.com/repos/JimGalasyn/ksql/releases{/id}","deployments_url":"https://api.github.com/repos/JimGalasyn/ksql/deployments","created_at":"2018-05-30T22:07:59Z","updated_at":"2018-11-07T16:33:06Z","pushed_at":"2018-11-08T01:26:37Z","git_url":"git://github.com/JimGalasyn/ksql.git","ssh_url":"git@github.com:JimGalasyn/ksql.git","clone_url":"https://github.com/JimGalasyn/ksql.git","svn_url":"https://github.com/JimGalasyn/ksql","homepage":"","size":11787,"stargazers_count":0,"watchers_count":0,"language":"Java","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0","node_id":"MDc6TGljZW5zZTI="},"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"confluentinc:5.0.0-post","ref":"5.0.0-post","sha":"952401ef310668bea3c4ad4f859cec4812e6c4d8","user":{"login":"confluentinc","id":9439498,"node_id":"MDEyOk9yZ2FuaXphdGlvbjk0Mzk0OTg=","avatar_url":"https://avatars0.githubusercontent.com/u/9439498?v=4","gravatar_id":"","url":"https://api.github.com/users/confluentinc","html_url":"https://github.com/confluentinc","followers_url":"https://api.github.com/users/confluentinc/followers","following_url":"https://api.github.com/users/confluentinc/following{/other_user}","gists_url":"https://api.github.com/users/confluentinc/gists{/gist_id}","starred_url":"https://api.github.com/users/confluentinc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/confluentinc/subscriptions","organizations_url":"https://api.github.com/users/confluentinc/orgs","repos_url":"https://api.github.com/users/confluentinc/repos","events_url":"https://api.github.com/users/confluentinc/events{/privacy}","received_events_url":"https://api.github.com/users/confluentinc/received_events","type":"Organization","site_admin":false},"repo":{"id":69400326,"node_id":"MDEwOlJlcG9zaXRvcnk2OTQwMDMyNg==","name":"ksql","full_name":"confluentinc/ksql","private":false,"owner":{"login":"confluentinc","id":9439498,"node_id":"MDEyOk9yZ2FuaXphdGlvbjk0Mzk0OTg=","avatar_url":"https://avatars0.githubusercontent.com/u/9439498?v=4","gravatar_id":"","url":"https://api.github.com/users/confluentinc","html_url":"https://github.com/confluentinc","followers_url":"https://api.github.com/users/confluentinc/followers","following_url":"https://api.github.com/users/confluentinc/following{/other_user}","gists_url":"https://api.github.com/users/confluentinc/gists{/gist_id}","starred_url":"https://api.github.com/users/confluentinc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/confluentinc/subscriptions","organizations_url":"https://api.github.com/users/confluentinc/orgs","repos_url":"https://api.github.com/users/confluentinc/repos","events_url":"https://api.github.com/users/confluentinc/events{/privacy}","received_events_url":"https://api.github.com/users/confluentinc/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/confluentinc/ksql","description":"KSQL - the Streaming SQL Engine for Apache Kafka ","fork":false,"url":"https://api.github.com/repos/confluentinc/ksql","forks_url":"https://api.github.com/repos/confluentinc/ksql/forks","keys_url":"https://api.github.com/repos/confluentinc/ksql/keys{/key_id}","collaborators_url":"https://api.github.com/repos/confluentinc/ksql/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/confluentinc/ksql/teams","hooks_url":"https://api.github.com/repos/confluentinc/ksql/hooks","issue_events_url":"https://api.github.com/repos/confluentinc/ksql/issues/events{/number}","events_url":"https://api.github.com/repos/confluentinc/ksql/events","assignees_url":"https://api.github.com/repos/confluentinc/ksql/assignees{/user}","branches_url":"https://api.github.com/repos/confluentinc/ksql/branches{/branch}","tags_url":"https://api.github.com/repos/confluentinc/ksql/tags","blobs_url":"https://api.github.com/repos/confluentinc/ksql/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/confluentinc/ksql/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/confluentinc/ksql/git/refs{/sha}","trees_url":"https://api.github.com/repos/confluentinc/ksql/git/trees{/sha}","statuses_url":"https://api.github.com/repos/confluentinc/ksql/statuses/{sha}","languages_url":"https://api.github.com/repos/confluentinc/ksql/languages","stargazers_url":"https://api.github.com/repos/confluentinc/ksql/stargazers","contributors_url":"https://api.github.com/repos/confluentinc/ksql/contributors","subscribers_url":"https://api.github.com/repos/confluentinc/ksql/subscribers","subscription_url":"https://api.github.com/repos/confluentinc/ksql/subscription","commits_url":"https://api.github.com/repos/confluentinc/ksql/commits{/sha}","git_commits_url":"https://api.github.com/repos/confluentinc/ksql/git/commits{/sha}","comments_url":"https://api.github.com/repos/confluentinc/ksql/comments{/number}","issue_comment_url":"https://api.github.com/repos/confluentinc/ksql/issues/comments{/number}","contents_url":"https://api.github.com/repos/confluentinc/ksql/contents/{+path}","compare_url":"https://api.github.com/repos/confluentinc/ksql/compare/{base}...{head}","merges_url":"https://api.github.com/repos/confluentinc/ksql/merges","archive_url":"https://api.github.com/repos/confluentinc/ksql/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/confluentinc/ksql/downloads","issues_url":"https://api.github.com/repos/confluentinc/ksql/issues{/number}","pulls_url":"https://api.github.com/repos/confluentinc/ksql/pulls{/number}","milestones_url":"https://api.github.com/repos/confluentinc/ksql/milestones{/number}","notifications_url":"https://api.github.com/repos/confluentinc/ksql/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/confluentinc/ksql/labels{/name}","releases_url":"https://api.github.com/repos/confluentinc/ksql/releases{/id}","deployments_url":"https://api.github.com/repos/confluentinc/ksql/deployments","created_at":"2016-09-27T21:30:15Z","updated_at":"2018-11-08T18:01:00Z","pushed_at":"2018-11-08T18:00:55Z","git_url":"git://github.com/confluentinc/ksql.git","ssh_url":"git@github.com:confluentinc/ksql.git","clone_url":"https://github.com/confluentinc/ksql.git","svn_url":"https://github.com/confluentinc/ksql","homepage":"","size":12010,"stargazers_count":2001,"watchers_count":2001,"language":"Java","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":373,"mirror_url":null,"archived":false,"open_issues_count":394,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0","node_id":"MDc6TGljZW5zZTI="},"forks":373,"open_issues":394,"watchers":2001,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/2134"},"html":{"href":"https://github.com/confluentinc/ksql/pull/2134"},"issue":{"href":"https://api.github.com/repos/confluentinc/ksql/issues/2134"},"comments":{"href":"https://api.github.com/repos/confluentinc/ksql/issues/2134/comments"},"review_comments":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/2134/comments"},"review_comment":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/2134/commits"},"statuses":{"href":"https://api.github.com/repos/confluentinc/ksql/statuses/4991c5524e5d359d1e87491f285f19648afcc69d"}},"author_association":"MEMBER"}}
{"actor":{"display_login":"mjsax"}}