{"action":"created","comment":{"url":"https://api.github.com/repos/caskdata/cdap/pulls/comments/46750490","id":46750490,"diff_hunk":"@@ -0,0 +1,219 @@\n+.. meta::\n+    :author: Cask Data, Inc.\n+    :copyright: Copyright © 2015 Cask Data, Inc.\n+\n+.. _views:\n+\n+=====\n+Views\n+=====\n+\n+*Views* are a read-only source from where data can be read. They are similar to a\n+:ref:`stream <streams>` or :ref:`dataset <datasets-index>`. They provide a way to\n+read from the same source using different schemas.\n+\n+Without views, you would need to begin your data application by deciding how you wanted to\n+use your data, create appropriate schemas, and then fit the data to those schemas.\n+\n+Now, with views, you start with your data and add schema to fit your needs. If you decide\n+to add a column to your schema, CDAP simply reconfigures the code that reads your data\n+instead of rewriting all of it. Changing the way you use your data no longer changes the\n+way you write it. This flexible approach is much better when you have lots of data that\n+you can use in many different ways, or when you are still trying to understand the data\n+you have.\n+\n+For example:\n+\n+- An admin wants to expose different parts of the same data to different stakeholders;\n+- A user wants to only consume a small part of a data stream for performance reasons, to\n+  avoid parsing entire rows of data; or\n+- A user has loaded in data without yet knowing or understanding how it will or can be\n+  used, and now wants to look at it in different ways.\n+\n+Currently, views are only supported for streams. Support for datasets will be added in a\n+later version of CDAP.\n+\n+\n+Views and CDAP Explore\n+======================\n+:ref:`CDAP Explore <data-exploration>` needs to be :ref:`enabled <hadoop-configuration-explore-service>` \n+before any streams and stream views are created so that a Hive table can be created for\n+each view. (See the :ref:`CDAP installation instructions <installation-index>` for your\n+particular Hadoop distribution for details.)\n+\n+Stream View\n+===========\n+A stream view is a read-only, schema-based, view of a stream. This feature is intended to\n+replace the single schema associated with a stream, effectively allowing for multiple","path":"cdap-docs/developers-manual/source/building-blocks/views.rst","position":47,"original_position":47,"commit_id":"9b962220091c67a87ff4c2c2e2d0559e77ddee67","original_commit_id":"9b962220091c67a87ff4c2c2e2d0559e77ddee67","user":{"login":"jwang47","id":1084704,"avatar_url":"https://avatars.githubusercontent.com/u/1084704?v=3","gravatar_id":"","url":"https://api.github.com/users/jwang47","html_url":"https://github.com/jwang47","followers_url":"https://api.github.com/users/jwang47/followers","following_url":"https://api.github.com/users/jwang47/following{/other_user}","gists_url":"https://api.github.com/users/jwang47/gists{/gist_id}","starred_url":"https://api.github.com/users/jwang47/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jwang47/subscriptions","organizations_url":"https://api.github.com/users/jwang47/orgs","repos_url":"https://api.github.com/users/jwang47/repos","events_url":"https://api.github.com/users/jwang47/events{/privacy}","received_events_url":"https://api.github.com/users/jwang47/received_events","type":"User","site_admin":false},"body":"remove `effectively`","created_at":"2015-12-05T01:11:49Z","updated_at":"2015-12-05T01:11:49Z","html_url":"https://github.com/caskdata/cdap/pull/4608#discussion_r46750490","pull_request_url":"https://api.github.com/repos/caskdata/cdap/pulls/4608","_links":{"self":{"href":"https://api.github.com/repos/caskdata/cdap/pulls/comments/46750490"},"html":{"href":"https://github.com/caskdata/cdap/pull/4608#discussion_r46750490"},"pull_request":{"href":"https://api.github.com/repos/caskdata/cdap/pulls/4608"}}},"pull_request":{"url":"https://api.github.com/repos/caskdata/cdap/pulls/4608","id":51434215,"html_url":"https://github.com/caskdata/cdap/pull/4608","diff_url":"https://github.com/caskdata/cdap/pull/4608.diff","patch_url":"https://github.com/caskdata/cdap/pull/4608.patch","issue_url":"https://api.github.com/repos/caskdata/cdap/issues/4608","number":4608,"state":"open","locked":false,"title":"CDAP-4145 Improve Stream Views Documentation","user":{"login":"awholegunch","id":6394794,"avatar_url":"https://avatars.githubusercontent.com/u/6394794?v=3","gravatar_id":"","url":"https://api.github.com/users/awholegunch","html_url":"https://github.com/awholegunch","followers_url":"https://api.github.com/users/awholegunch/followers","following_url":"https://api.github.com/users/awholegunch/following{/other_user}","gists_url":"https://api.github.com/users/awholegunch/gists{/gist_id}","starred_url":"https://api.github.com/users/awholegunch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/awholegunch/subscriptions","organizations_url":"https://api.github.com/users/awholegunch/orgs","repos_url":"https://api.github.com/users/awholegunch/repos","events_url":"https://api.github.com/users/awholegunch/events{/privacy}","received_events_url":"https://api.github.com/users/awholegunch/received_events","type":"User","site_admin":false},"body":"- Adds a Developers' Manual \"Views\" building block (revised)\r\n- Corrects errors and adds material to the Views HTTP RESTful API\r\n- Adds more entries in the left side-bar Developers' Manual Table of Contents under each *Building Block* section\r\n- Adds entries, under each *Building Block*, for that page's examples in the left side-bar Table of Contents\r\n- Adjusts the Developers' Manual main index page to improve readability\r\n\r\nBuilding [Quick Build](http://builds.cask.co/browse/CDAP-DOB53-5) *(Updated for Build 5)* (as develop build is currently broken, so is this...)\r\n\r\n**Pages of Interest**\r\n- [Developers' Manual](http://builds.cask.co/artifact/CDAP-DOB53/shared/build-5/Docs-HTML/3.3.0-SNAPSHOT/en/developers-manual/index.html)\r\n- [Developers' Manual \"Building Blocks\"](http://builds.cask.co/artifact/CDAP-DOB53/shared/build-5/Docs-HTML/3.3.0-SNAPSHOT/en/developers-manual/building-blocks/index.html)\r\n- [Views](http://builds.cask.co/artifact/CDAP-DOB53/shared/build-5/Docs-HTML/3.3.0-SNAPSHOT/en/developers-manual/building-blocks/views.html)\r\n- [Views RESTful API](http://builds.cask.co/artifact/CDAP-DOB53/shared/build-5/Docs-HTML/3.3.0-SNAPSHOT/en/reference-manual/http-restful-api/views.html)\r\n\r\nFix for https://issues.cask.co/browse/CDAP-4145 and https://issues.cask.co/browse/CDAP-4327","created_at":"2015-11-21T05:20:38Z","updated_at":"2015-12-05T01:11:49Z","closed_at":null,"merged_at":null,"merge_commit_sha":"578f81d3a3bc90e48ddd336d112f1ac39fd0daeb","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/caskdata/cdap/pulls/4608/commits","review_comments_url":"https://api.github.com/repos/caskdata/cdap/pulls/4608/comments","review_comment_url":"https://api.github.com/repos/caskdata/cdap/pulls/comments{/number}","comments_url":"https://api.github.com/repos/caskdata/cdap/issues/4608/comments","statuses_url":"https://api.github.com/repos/caskdata/cdap/statuses/9b962220091c67a87ff4c2c2e2d0559e77ddee67","head":{"label":"caskdata:feature/3.3_4145_Views","ref":"feature/3.3_4145_Views","sha":"9b962220091c67a87ff4c2c2e2d0559e77ddee67","user":{"login":"caskdata","id":8123023,"avatar_url":"https://avatars.githubusercontent.com/u/8123023?v=3","gravatar_id":"","url":"https://api.github.com/users/caskdata","html_url":"https://github.com/caskdata","followers_url":"https://api.github.com/users/caskdata/followers","following_url":"https://api.github.com/users/caskdata/following{/other_user}","gists_url":"https://api.github.com/users/caskdata/gists{/gist_id}","starred_url":"https://api.github.com/users/caskdata/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/caskdata/subscriptions","organizations_url":"https://api.github.com/users/caskdata/orgs","repos_url":"https://api.github.com/users/caskdata/repos","events_url":"https://api.github.com/users/caskdata/events{/privacy}","received_events_url":"https://api.github.com/users/caskdata/received_events","type":"Organization","site_admin":false},"repo":{"id":22542759,"name":"cdap","full_name":"caskdata/cdap","owner":{"login":"caskdata","id":8123023,"avatar_url":"https://avatars.githubusercontent.com/u/8123023?v=3","gravatar_id":"","url":"https://api.github.com/users/caskdata","html_url":"https://github.com/caskdata","followers_url":"https://api.github.com/users/caskdata/followers","following_url":"https://api.github.com/users/caskdata/following{/other_user}","gists_url":"https://api.github.com/users/caskdata/gists{/gist_id}","starred_url":"https://api.github.com/users/caskdata/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/caskdata/subscriptions","organizations_url":"https://api.github.com/users/caskdata/orgs","repos_url":"https://api.github.com/users/caskdata/repos","events_url":"https://api.github.com/users/caskdata/events{/privacy}","received_events_url":"https://api.github.com/users/caskdata/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/caskdata/cdap","description":"Cask Data Application Platform (CDAP)","fork":false,"url":"https://api.github.com/repos/caskdata/cdap","forks_url":"https://api.github.com/repos/caskdata/cdap/forks","keys_url":"https://api.github.com/repos/caskdata/cdap/keys{/key_id}","collaborators_url":"https://api.github.com/repos/caskdata/cdap/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/caskdata/cdap/teams","hooks_url":"https://api.github.com/repos/caskdata/cdap/hooks","issue_events_url":"https://api.github.com/repos/caskdata/cdap/issues/events{/number}","events_url":"https://api.github.com/repos/caskdata/cdap/events","assignees_url":"https://api.github.com/repos/caskdata/cdap/assignees{/user}","branches_url":"https://api.github.com/repos/caskdata/cdap/branches{/branch}","tags_url":"https://api.github.com/repos/caskdata/cdap/tags","blobs_url":"https://api.github.com/repos/caskdata/cdap/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/caskdata/cdap/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/caskdata/cdap/git/refs{/sha}","trees_url":"https://api.github.com/repos/caskdata/cdap/git/trees{/sha}","statuses_url":"https://api.github.com/repos/caskdata/cdap/statuses/{sha}","languages_url":"https://api.github.com/repos/caskdata/cdap/languages","stargazers_url":"https://api.github.com/repos/caskdata/cdap/stargazers","contributors_url":"https://api.github.com/repos/caskdata/cdap/contributors","subscribers_url":"https://api.github.com/repos/caskdata/cdap/subscribers","subscription_url":"https://api.github.com/repos/caskdata/cdap/subscription","commits_url":"https://api.github.com/repos/caskdata/cdap/commits{/sha}","git_commits_url":"https://api.github.com/repos/caskdata/cdap/git/commits{/sha}","comments_url":"https://api.github.com/repos/caskdata/cdap/comments{/number}","issue_comment_url":"https://api.github.com/repos/caskdata/cdap/issues/comments{/number}","contents_url":"https://api.github.com/repos/caskdata/cdap/contents/{+path}","compare_url":"https://api.github.com/repos/caskdata/cdap/compare/{base}...{head}","merges_url":"https://api.github.com/repos/caskdata/cdap/merges","archive_url":"https://api.github.com/repos/caskdata/cdap/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/caskdata/cdap/downloads","issues_url":"https://api.github.com/repos/caskdata/cdap/issues{/number}","pulls_url":"https://api.github.com/repos/caskdata/cdap/pulls{/number}","milestones_url":"https://api.github.com/repos/caskdata/cdap/milestones{/number}","notifications_url":"https://api.github.com/repos/caskdata/cdap/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/caskdata/cdap/labels{/name}","releases_url":"https://api.github.com/repos/caskdata/cdap/releases{/id}","created_at":"2014-08-02T09:00:10Z","updated_at":"2015-12-04T23:50:35Z","pushed_at":"2015-12-05T01:01:45Z","git_url":"git://github.com/caskdata/cdap.git","ssh_url":"git@github.com:caskdata/cdap.git","clone_url":"https://github.com/caskdata/cdap.git","svn_url":"https://github.com/caskdata/cdap","homepage":"http://cdap.io","size":517683,"stargazers_count":85,"watchers_count":85,"language":"Java","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":27,"mirror_url":null,"open_issues_count":19,"forks":27,"open_issues":19,"watchers":85,"default_branch":"develop"}},"base":{"label":"caskdata:develop","ref":"develop","sha":"9a0d410efb6254126aa1171e7e679219cddef773","user":{"login":"caskdata","id":8123023,"avatar_url":"https://avatars.githubusercontent.com/u/8123023?v=3","gravatar_id":"","url":"https://api.github.com/users/caskdata","html_url":"https://github.com/caskdata","followers_url":"https://api.github.com/users/caskdata/followers","following_url":"https://api.github.com/users/caskdata/following{/other_user}","gists_url":"https://api.github.com/users/caskdata/gists{/gist_id}","starred_url":"https://api.github.com/users/caskdata/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/caskdata/subscriptions","organizations_url":"https://api.github.com/users/caskdata/orgs","repos_url":"https://api.github.com/users/caskdata/repos","events_url":"https://api.github.com/users/caskdata/events{/privacy}","received_events_url":"https://api.github.com/users/caskdata/received_events","type":"Organization","site_admin":false},"repo":{"id":22542759,"name":"cdap","full_name":"caskdata/cdap","owner":{"login":"caskdata","id":8123023,"avatar_url":"https://avatars.githubusercontent.com/u/8123023?v=3","gravatar_id":"","url":"https://api.github.com/users/caskdata","html_url":"https://github.com/caskdata","followers_url":"https://api.github.com/users/caskdata/followers","following_url":"https://api.github.com/users/caskdata/following{/other_user}","gists_url":"https://api.github.com/users/caskdata/gists{/gist_id}","starred_url":"https://api.github.com/users/caskdata/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/caskdata/subscriptions","organizations_url":"https://api.github.com/users/caskdata/orgs","repos_url":"https://api.github.com/users/caskdata/repos","events_url":"https://api.github.com/users/caskdata/events{/privacy}","received_events_url":"https://api.github.com/users/caskdata/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/caskdata/cdap","description":"Cask Data Application Platform (CDAP)","fork":false,"url":"https://api.github.com/repos/caskdata/cdap","forks_url":"https://api.github.com/repos/caskdata/cdap/forks","keys_url":"https://api.github.com/repos/caskdata/cdap/keys{/key_id}","collaborators_url":"https://api.github.com/repos/caskdata/cdap/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/caskdata/cdap/teams","hooks_url":"https://api.github.com/repos/caskdata/cdap/hooks","issue_events_url":"https://api.github.com/repos/caskdata/cdap/issues/events{/number}","events_url":"https://api.github.com/repos/caskdata/cdap/events","assignees_url":"https://api.github.com/repos/caskdata/cdap/assignees{/user}","branches_url":"https://api.github.com/repos/caskdata/cdap/branches{/branch}","tags_url":"https://api.github.com/repos/caskdata/cdap/tags","blobs_url":"https://api.github.com/repos/caskdata/cdap/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/caskdata/cdap/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/caskdata/cdap/git/refs{/sha}","trees_url":"https://api.github.com/repos/caskdata/cdap/git/trees{/sha}","statuses_url":"https://api.github.com/repos/caskdata/cdap/statuses/{sha}","languages_url":"https://api.github.com/repos/caskdata/cdap/languages","stargazers_url":"https://api.github.com/repos/caskdata/cdap/stargazers","contributors_url":"https://api.github.com/repos/caskdata/cdap/contributors","subscribers_url":"https://api.github.com/repos/caskdata/cdap/subscribers","subscription_url":"https://api.github.com/repos/caskdata/cdap/subscription","commits_url":"https://api.github.com/repos/caskdata/cdap/commits{/sha}","git_commits_url":"https://api.github.com/repos/caskdata/cdap/git/commits{/sha}","comments_url":"https://api.github.com/repos/caskdata/cdap/comments{/number}","issue_comment_url":"https://api.github.com/repos/caskdata/cdap/issues/comments{/number}","contents_url":"https://api.github.com/repos/caskdata/cdap/contents/{+path}","compare_url":"https://api.github.com/repos/caskdata/cdap/compare/{base}...{head}","merges_url":"https://api.github.com/repos/caskdata/cdap/merges","archive_url":"https://api.github.com/repos/caskdata/cdap/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/caskdata/cdap/downloads","issues_url":"https://api.github.com/repos/caskdata/cdap/issues{/number}","pulls_url":"https://api.github.com/repos/caskdata/cdap/pulls{/number}","milestones_url":"https://api.github.com/repos/caskdata/cdap/milestones{/number}","notifications_url":"https://api.github.com/repos/caskdata/cdap/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/caskdata/cdap/labels{/name}","releases_url":"https://api.github.com/repos/caskdata/cdap/releases{/id}","created_at":"2014-08-02T09:00:10Z","updated_at":"2015-12-04T23:50:35Z","pushed_at":"2015-12-05T01:01:45Z","git_url":"git://github.com/caskdata/cdap.git","ssh_url":"git@github.com:caskdata/cdap.git","clone_url":"https://github.com/caskdata/cdap.git","svn_url":"https://github.com/caskdata/cdap","homepage":"http://cdap.io","size":517683,"stargazers_count":85,"watchers_count":85,"language":"Java","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":27,"mirror_url":null,"open_issues_count":19,"forks":27,"open_issues":19,"watchers":85,"default_branch":"develop"}},"_links":{"self":{"href":"https://api.github.com/repos/caskdata/cdap/pulls/4608"},"html":{"href":"https://github.com/caskdata/cdap/pull/4608"},"issue":{"href":"https://api.github.com/repos/caskdata/cdap/issues/4608"},"comments":{"href":"https://api.github.com/repos/caskdata/cdap/issues/4608/comments"},"review_comments":{"href":"https://api.github.com/repos/caskdata/cdap/pulls/4608/comments"},"review_comment":{"href":"https://api.github.com/repos/caskdata/cdap/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/caskdata/cdap/pulls/4608/commits"},"statuses":{"href":"https://api.github.com/repos/caskdata/cdap/statuses/9b962220091c67a87ff4c2c2e2d0559e77ddee67"}}}}