http://git-wip-us.apache.org/repos/asf/carbondata-site/blob/db7be789/content/data-management.html ---------------------------------------------------------------------- diff --git a/content/data-management.html b/content/data-management.html deleted file mode 100644 index 93528d8..0000000 --- a/content/data-management.html +++ /dev/null @@ -1,413 +0,0 @@ -<!DOCTYPE html> -<html lang="en"> -<head> - <meta charset="utf-8"> - <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"> - <link href='images/favicon.ico' rel='shortcut icon' type='image/x-icon'> - <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags --> - <title>CarbonData</title> - <style> - - </style> - <!-- Bootstrap --> - - <link rel="stylesheet" href="css/bootstrap.min.css"> - <link href="css/style.css" rel="stylesheet"> - <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries --> - <!-- WARNING: Respond.js doesn't work if you view the page via file:// --> - <!--[if lt IE 9]> - <script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js";></script> - <script src="https://oss.maxcdn.scom/respond/1.4.2/respond.min.js";></script> - <![endif]--> - <script src="js/jquery.min.js"></script> - <script src="js/bootstrap.min.js"></script> - - -</head> -<body> -<header> - <nav class="navbar navbar-default navbar-custom cd-navbar-wrapper"> - <div class="container"> - <div class="navbar-header"> - <button aria-controls="navbar" aria-expanded="false" data-target="#navbar" data-toggle="collapse" - class="navbar-toggle collapsed" type="button"> - <span class="sr-only">Toggle navigation</span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </button> - <a href="index.html" class="logo"> - <img src="images/CarbonDataLogo.png" alt="CarbonData logo" title="CarbocnData logo"/> - </a> - </div> - <div class="navbar-collapse collapse cd_navcontnt" id="navbar"> - <ul class="nav navbar-nav navbar-right navlist-custom"> - <li><a href="index.html" class="hidden-xs"><i class="fa fa-home" aria-hidden="true"></i> </a> - </li> - <li><a href="index.html" class="hidden-lg hidden-md hidden-sm">Home</a></li> - <li class="dropdown"> - <a href="#" class="dropdown-toggle " data-toggle="dropdown" role="button" aria-haspopup="true" - aria-expanded="false"> Download <span class="caret"></span></a> - <ul class="dropdown-menu"> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.2.0/"; - target="_blank">Apache CarbonData 1.2.0</a></li> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.1.1/"; - target="_blank">Apache CarbonData 1.1.1</a></li> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.1.0/"; - target="_blank">Apache CarbonData 1.1.0</a></li> - <li> - <a href="http://archive.apache.org/dist/incubator/carbondata/1.0.0-incubating/"; - target="_blank">Apache CarbonData 1.0.0</a></li> - <li> - <a href="http://archive.apache.org/dist/incubator/carbondata/0.2.0-incubating/"; - target="_blank">Apache CarbonData 0.2.0</a></li> - <li> - <a href="http://archive.apache.org/dist/incubator/carbondata/0.1.1-incubating/"; - target="_blank">Apache CarbonData 0.1.1</a></li> - <li> - <a href="http://archive.apache.org/dist/incubator/carbondata/0.1.0-incubating/"; - target="_blank">Apache CarbonData 0.1.0</a></li> - <li> - <a href="https://cwiki.apache.org/confluence/display/CARBONDATA/Releases"; - target="_blank">Release Archive</a></li> - </ul> - </li> - <li><a href="mainpage.html" class="active">Documentation</a></li> - <li class="dropdown"> - <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" - aria-expanded="false">Community <span class="caret"></span></a> - <ul class="dropdown-menu"> - <li> - <a href="https://github.com/apache/carbondata/blob/master/docs/How-to-contribute-to-Apache-CarbonData.md"; - target="_blank">Contributing to CarbonData</a></li> - <li> - <a href="https://github.com/apache/carbondata/blob/master/docs/release-guide.md"; - target="_blank">Release Guide</a></li> - <li> - <a href="https://cwiki.apache.org/confluence/display/CARBONDATA/PMC+and+Committers+member+list"; - target="_blank">Project PMC and Committers</a></li> - <li> - <a href="https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=66850609"; - target="_blank">CarbonData Meetups</a></li> - <li><a href="security.html">Apache CarbonData Security</a></li> - <li><a href="https://issues.apache.org/jira/browse/CARBONDATA"; target="_blank">Apache - Jira</a></li> - <li><a href="videogallery.html">CarbonData Videos </a></li> - </ul> - </li> - <li class="dropdown"> - <a href="http://www.apache.org/"; class="apache_link hidden-xs dropdown-toggle" - data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Apache</a> - <ul class="dropdown-menu"> - <li><a href="http://www.apache.org/"; target="_blank">Apache Homepage</a></li> - <li><a href="http://www.apache.org/licenses/"; target="_blank">License</a></li> - <li><a href="http://www.apache.org/foundation/sponsorship.html"; - target="_blank">Sponsorship</a></li> - <li><a href="http://www.apache.org/foundation/thanks.html"; target="_blank">Thanks</a></li> - </ul> - </li> - - <li class="dropdown"> - <a href="http://www.apache.org/"; class="hidden-lg hidden-md hidden-sm dropdown-toggle" - data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Apache</a> - <ul class="dropdown-menu"> - <li><a href="http://www.apache.org/"; target="_blank">Apache Homepage</a></li> - <li><a href="http://www.apache.org/licenses/"; target="_blank">License</a></li> - <li><a href="http://www.apache.org/foundation/sponsorship.html"; - target="_blank">Sponsorship</a></li> - <li><a href="http://www.apache.org/foundation/thanks.html"; target="_blank">Thanks</a></li> - </ul> - </li> - - <li> - <a href="#" id="search-icon"><i class="fa fa-search" aria-hidden="true"></i></a> - - </li> - - </ul> - </div><!--/.nav-collapse --> - <div id="search-box"> - <form method="get" action="http://www.google.com/search"; target="_blank"> - <div class="search-block"> - <table border="0" cellpadding="0" width="100%"> - <tr> - <td style="width:80%"> - <input type="text" name="q" size=" 5" maxlength="255" value="" - class="search-input" placeholder="Search...." required/> - </td> - <td style="width:20%"> - <input type="submit" value="Search"/></td> - </tr> - <tr> - <td align="left" style="font-size:75%" colspan="2"> - <input type="checkbox" name="sitesearch" value="carbondata.apache.org" checked/> - <span style=" position: relative; top: -3px;"> Only search for CarbonData</span> - </td> - </tr> - </table> - </div> - </form> - </div> - </div> - </nav> -</header> <!-- end Header part --> - -<div class="fixed-padding"></div> <!-- top padding with fixde header --> - -<section><!-- Dashboard nav --> - <div class="container-fluid q"> - <div class="col-sm-12 col-md-12 maindashboard"> - <div class="row"> - <section> - <div style="padding:10px 15px;"> - <div id="viewpage" name="viewpage"> - <div class="row"> - <div class="col-sm-12 col-md-12"> - <div> -<h1> -<a id="data-management" class="anchor" href="#data-management" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Data Management</h1> -<p>This tutorial is going to introduce you to the conceptual details of data management like:</p> -<ul> -<li><a href="#loading-data">Loading Data</a></li> -<li><a href="#deleting-data">Deleting Data</a></li> -<li><a href="#compacting-data">Compacting Data</a></li> -<li><a href="#updating-data">Updating Data</a></li> -</ul> -<h2> -<a id="loading-data" class="anchor" href="#loading-data" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Loading Data</h2> -<ul> -<li> -<p><strong>Scenario</strong></p> -<p>After creating a table, you can load data to the table using the <a href="dml-operation-on-carbondata.html">LOAD DATA</a> command. The loaded data is available for querying. -When data load is triggered, the data is encoded in CarbonData format and copied into HDFS CarbonData store path (specified in carbon.properties file) -in compressed, multi dimensional columnar format for quick analysis queries. The same command can be used to load new data or to -update the existing data. Only one data load can be triggered for one table. The high cardinality columns of the dictionary encoding are -automatically recognized and these columns will not be used for dictionary encoding.</p> -</li> -<li> -<p><strong>Procedure</strong></p> -<p>Data loading is a process that involves execution of multiple steps to read, sort and encode the data in CarbonData store format. -Each step is executed on different threads. After data loading process is complete, the status (success/partial success) is updated to -CarbonData store metadata. The table below lists the possible load status.</p> -</li> -</ul> -<table> -<thead> -<tr> -<th>Status</th> -<th>Description</th> -</tr> -</thead> -<tbody> -<tr> -<td>Success</td> -<td>All the data is loaded into table and no bad records found.</td> -</tr> -<tr> -<td>Partial Success</td> -<td>Data is loaded into table and bad records are found. Bad records are stored at carbon.badrecords.location.</td> -</tr> -</tbody> -</table> -<p>In case of failure, the error will be logged in error log. Details of loads can be seen with <a href="dml-operation-on-carbondata.html#show-segments">SHOW SEGMENTS</a> command. The show segment command output consists of :</p> -<ul> -<li>SegmentSequenceId</li> -<li>Status</li> -<li>Load Start Time</li> -<li>Load End Time</li> -</ul> -<p>The latest load will be displayed first in the output.</p> -<p>Refer to <a href="dml-operation-on-carbondata.html">DML operations on CarbonData</a> for load commands.</p> -<h2> -<a id="deleting-data" class="anchor" href="#deleting-data" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Deleting Data</h2> -<ul> -<li> -<p><strong>Scenario</strong></p> -<p>If you have loaded wrong data into the table, or too many bad records are present and you want to modify and reload the data, you can delete required data loads. -The load can be deleted using the Segment Sequence Id or if the table contains date field then the data can be deleted using the date field. -If there are some specific records that need to be deleted based on some filter condition(s) we can delete by records.</p> -</li> -<li> -<p><strong>Procedure</strong></p> -<p>The loaded data can be deleted in the following ways:</p> -<ul> -<li> -<p>Delete by Segment ID</p> -<p>After you get the segment ID of the segment that you want to delete, execute the delete command for the selected segment. -The status of deleted segment is updated to Marked for delete / Marked for Update.</p> -</li> -</ul> -</li> -</ul> -<table> -<thead> -<tr> -<th>SegmentSequenceId</th> -<th>Status</th> -<th>Load Start Time</th> -<th>Load End Time</th> -</tr> -</thead> -<tbody> -<tr> -<td>0</td> -<td>Success</td> -<td>2015-11-19 19:14:...</td> -<td>2015-11-19 19:14:...</td> -</tr> -<tr> -<td>1</td> -<td>Marked for Update</td> -<td>2015-11-19 19:54:...</td> -<td>2015-11-19 20:08:...</td> -</tr> -<tr> -<td>2</td> -<td>Marked for Delete</td> -<td>2015-11-19 20:25:...</td> -<td>2015-11-19 20:49:...</td> -</tr> -</tbody> -</table> -<ul> -<li> -<p>Delete by Date Field</p> -<p>If the table contains date field, you can delete the data based on a specific date.</p> -</li> -<li> -<p>Delete by Record</p> -<p>To delete records from CarbonData table based on some filter Condition(s).</p> -<p>For delete commands refer to <a href="dml-operation-on-carbondata.html">DML operations on CarbonData</a>.</p> -</li> -<li> -<p><strong>NOTE</strong>:</p> -<ul> -<li> -<p>When the delete segment DML is called, segment will not be deleted physically from the file system. Instead the segment status will be marked as "Marked for Delete". For the query execution, this deleted segment will be excluded.</p> -</li> -<li> -<p>The deleted segment will be deleted physically during the next load operation and only after the maximum query execution time configured using "max.query.execution.time". By default it is 60 minutes.</p> -</li> -<li> -<p>If the user wants to force delete the segment physically then he can use CLEAN FILES Command.</p> -</li> -</ul> -</li> -</ul> -<p>Example :</p> -<pre><code>CLEAN FILES FOR TABLE table1 -</code></pre> -<p>This DML will physically delete the segment which are "Marked for delete" and "Compacted" immediately.</p> -<h2> -<a id="compacting-data" class="anchor" href="#compacting-data" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Compacting Data</h2> -<ul> -<li> -<p><strong>Scenario</strong></p> -<p>Frequent data ingestion results in several fragmented CarbonData files in the store directory. Since data is sorted only within each load, the indices perform only within each -load. This means that there will be one index for each load and as number of data load increases, the number of indices also increases. As each index works only on one load, -the performance of indices is reduced. CarbonData provides provision for compacting the loads. Compaction process combines several segments into one large segment by merge sorting the data from across the segments.</p> -</li> -<li> -<p><strong>Procedure</strong></p> -<p>There are two types of compaction Minor and Major compaction.</p> -<ul> -<li> -<p><strong>Minor Compaction</strong></p> -<p>In minor compaction the user can specify how many loads to be merged. Minor compaction triggers for every data load if the parameter carbon.enable.auto.load.merge is set. If any segments are available to be merged, then compaction will -run parallel with data load. There are 2 levels in minor compaction.</p> -<ul> -<li>Level 1: Merging of the segments which are not yet compacted.</li> -<li>Level 2: Merging of the compacted segments again to form a bigger segment.</li> -</ul> -</li> -<li> -<p><strong>Major Compaction</strong></p> -<p>In Major compaction, many segments can be merged into one big segment. User will specify the compaction size until which segments can be merged. Major compaction is usually done during the off-peak time.</p> -</li> -</ul> -<p>There are number of parameters related to Compaction that can be set in carbon.properties file</p> -</li> -</ul> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Default</th> -<th>Application</th> -<th>Description</th> -<th>Valid Values</th> -</tr> -</thead> -<tbody> -<tr> -<td>carbon.compaction.level.threshold</td> -<td>4, 3</td> -<td>Minor</td> -<td>This property is for minor compaction which decides how many segments to be merged. Example: If it is set as "2, 3", then minor compaction will be triggered for every 2 segments in level 1. 3 is the number of level 1 compacted segment which is further compacted to new segment in level 2.</td> -<td>NA</td> -</tr> -<tr> -<td>carbon.major.compaction.size</td> -<td>1024 MB</td> -<td>Major</td> -<td>Major compaction size can be configured using this parameter. Sum of the segments which is below this threshold will be merged.</td> -<td>NA</td> -</tr> -<tr> -<td>carbon.numberof.preserve.segments</td> -<td>0</td> -<td>Minor/Major</td> -<td>This property configures number of segments to preserve from being compacted. Example: carbon.numberof.preserve.segments=2 then 2 latest segments will always be excluded from the compaction. No segments will be preserved by default.</td> -<td>0-100</td> -</tr> -<tr> -<td>carbon.allowed.compaction.days</td> -<td>0</td> -<td>Minor/Major</td> -<td>Compaction will merge the segments which are loaded within the specific number of days configured. Example: If the configuration is 2, then the segments which are loaded in the time frame of 2 days only will get merged. Segments which are loaded 2 days apart will not be merged. This is disabled by default.</td> -<td>0-100</td> -</tr> -<tr> -<td>carbon.number.of.cores.while.compacting</td> -<td>2</td> -<td>Minor/Major</td> -<td>Number of cores which is used to write data during compaction.</td> -<td>0-100</td> -</tr> -</tbody> -</table> -<p>For compaction commands refer to <a href="ddl-operation-on-carbondata.html">DDL operations on CarbonData</a></p> -<h2> -<a id="updating-data" class="anchor" href="#updating-data" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Updating Data</h2> -<ul> -<li> -<p><strong>Scenario</strong></p> -<p>Sometimes after the data has been ingested into the System, it is required to be updated. Also there may be situations where some specific columns need to be updated -on the basis of column expression and optional filter conditions.</p> -</li> -<li> -<p><strong>Procedure</strong></p> -<p>To update we need to specify the column expression with an optional filter condition(s).</p> -<p>For update commands refer to <a href="dml-operation-on-carbondata.html">DML operations on CarbonData</a>.</p> -</li> -</ul> -</div> -</div> -</div> -</div> -<div class="doc-footer"> - <a href="#top" class="scroll-top">Top</a> -</div> -</div> -</section> -</div> -</div> -</div> -</section><!-- End systemblock part --> -<script src="js/custom.js"></script> -</body> -</html> \ No newline at end of file
http://git-wip-us.apache.org/repos/asf/carbondata-site/blob/db7be789/content/datamap-developer-guide.html ---------------------------------------------------------------------- diff --git a/content/datamap-developer-guide.html b/content/datamap-developer-guide.html index 50ac30f..f442fe2 100644 --- a/content/datamap-developer-guide.html +++ b/content/datamap-developer-guide.html @@ -77,7 +77,7 @@ aria-expanded="false">Community <span class="caret"></span></a> <ul class="dropdown-menu"> <li> - <a href="https://github.com/apache/carbondata/blob/master/docs/How-to-contribute-to-Apache-CarbonData.md"; + <a href="https://github.com/apache/carbondata/blob/master/docs/how-to-contribute-to-apache-carbondata.md"; target="_blank">Contributing to CarbonData</a></li> <li> <a href="https://github.com/apache/carbondata/blob/master/docs/release-guide.md"; http://git-wip-us.apache.org/repos/asf/carbondata-site/blob/db7be789/content/datamap-management.html ---------------------------------------------------------------------- diff --git a/content/datamap-management.html b/content/datamap-management.html index ad22bb8..f5f9678 100644 --- a/content/datamap-management.html +++ b/content/datamap-management.html @@ -77,7 +77,7 @@ aria-expanded="false">Community <span class="caret"></span></a> <ul class="dropdown-menu"> <li> - <a href="https://github.com/apache/carbondata/blob/master/docs/How-to-contribute-to-Apache-CarbonData.md"; + <a href="https://github.com/apache/carbondata/blob/master/docs/how-to-contribute-to-apache-carbondata.md"; target="_blank">Contributing to CarbonData</a></li> <li> <a href="https://github.com/apache/carbondata/blob/master/docs/release-guide.md"; http://git-wip-us.apache.org/repos/asf/carbondata-site/blob/db7be789/content/ddl-of-carbondata.html ---------------------------------------------------------------------- diff --git a/content/ddl-of-carbondata.html b/content/ddl-of-carbondata.html index 635d835..434f378 100644 --- a/content/ddl-of-carbondata.html +++ b/content/ddl-of-carbondata.html @@ -77,7 +77,7 @@ aria-expanded="false">Community <span class="caret"></span></a> <ul class="dropdown-menu"> <li> - <a href="https://github.com/apache/carbondata/blob/master/docs/How-to-contribute-to-Apache-CarbonData.md"; + <a href="https://github.com/apache/carbondata/blob/master/docs/how-to-contribute-to-apache-carbondata.md"; target="_blank">Contributing to CarbonData</a></li> <li> <a href="https://github.com/apache/carbondata/blob/master/docs/release-guide.md"; http://git-wip-us.apache.org/repos/asf/carbondata-site/blob/db7be789/content/ddl-operation-on-carbondata.html ---------------------------------------------------------------------- diff --git a/content/ddl-operation-on-carbondata.html b/content/ddl-operation-on-carbondata.html deleted file mode 100644 index 444428f..0000000 --- a/content/ddl-operation-on-carbondata.html +++ /dev/null @@ -1,748 +0,0 @@ -<!DOCTYPE html> -<html lang="en"> -<head> - <meta charset="utf-8"> - <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"> - <link href='images/favicon.ico' rel='shortcut icon' type='image/x-icon'> - <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags --> - <title>CarbonData</title> - <style> - - </style> - <!-- Bootstrap --> - - <link rel="stylesheet" href="css/bootstrap.min.css"> - <link href="css/style.css" rel="stylesheet"> - <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries --> - <!-- WARNING: Respond.js doesn't work if you view the page via file:// --> - <!--[if lt IE 9]> - <script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js";></script> - <script src="https://oss.maxcdn.scom/respond/1.4.2/respond.min.js";></script> - <![endif]--> - <script src="js/jquery.min.js"></script> - <script src="js/bootstrap.min.js"></script> - - -</head> -<body> -<header> - <nav class="navbar navbar-default navbar-custom cd-navbar-wrapper"> - <div class="container"> - <div class="navbar-header"> - <button aria-controls="navbar" aria-expanded="false" data-target="#navbar" data-toggle="collapse" - class="navbar-toggle collapsed" type="button"> - <span class="sr-only">Toggle navigation</span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </button> - <a href="index.html" class="logo"> - <img src="images/CarbonDataLogo.png" alt="CarbonData logo" title="CarbocnData logo"/> - </a> - </div> - <div class="navbar-collapse collapse cd_navcontnt" id="navbar"> - <ul class="nav navbar-nav navbar-right navlist-custom"> - <li><a href="index.html" class="hidden-xs"><i class="fa fa-home" aria-hidden="true"></i> </a> - </li> - <li><a href="index.html" class="hidden-lg hidden-md hidden-sm">Home</a></li> - <li class="dropdown"> - <a href="#" class="dropdown-toggle " data-toggle="dropdown" role="button" aria-haspopup="true" - aria-expanded="false"> Download <span class="caret"></span></a> - <ul class="dropdown-menu"> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.2.0/"; - target="_blank">Apache CarbonData 1.2.0</a></li> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.1.1/"; - target="_blank">Apache CarbonData 1.1.1</a></li> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.1.0/"; - target="_blank">Apache CarbonData 1.1.0</a></li> - <li> - <a href="http://archive.apache.org/dist/incubator/carbondata/1.0.0-incubating/"; - target="_blank">Apache CarbonData 1.0.0</a></li> - <li> - <a href="http://archive.apache.org/dist/incubator/carbondata/0.2.0-incubating/"; - target="_blank">Apache CarbonData 0.2.0</a></li> - <li> - <a href="http://archive.apache.org/dist/incubator/carbondata/0.1.1-incubating/"; - target="_blank">Apache CarbonData 0.1.1</a></li> - <li> - <a href="http://archive.apache.org/dist/incubator/carbondata/0.1.0-incubating/"; - target="_blank">Apache CarbonData 0.1.0</a></li> - <li> - <a href="https://cwiki.apache.org/confluence/display/CARBONDATA/Releases"; - target="_blank">Release Archive</a></li> - </ul> - </li> - <li><a href="mainpage.html" class="active">Documentation</a></li> - <li class="dropdown"> - <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" - aria-expanded="false">Community <span class="caret"></span></a> - <ul class="dropdown-menu"> - <li> - <a href="https://github.com/apache/carbondata/blob/master/docs/How-to-contribute-to-Apache-CarbonData.md"; - target="_blank">Contributing to CarbonData</a></li> - <li> - <a href="https://github.com/apache/carbondata/blob/master/docs/release-guide.md"; - target="_blank">Release Guide</a></li> - <li> - <a href="https://cwiki.apache.org/confluence/display/CARBONDATA/PMC+and+Committers+member+list"; - target="_blank">Project PMC and Committers</a></li> - <li> - <a href="https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=66850609"; - target="_blank">CarbonData Meetups</a></li> - <li><a href="security.html">Apache CarbonData Security</a></li> - <li><a href="https://issues.apache.org/jira/browse/CARBONDATA"; target="_blank">Apache - Jira</a></li> - <li><a href="videogallery.html">CarbonData Videos </a></li> - </ul> - </li> - <li class="dropdown"> - <a href="http://www.apache.org/"; class="apache_link hidden-xs dropdown-toggle" - data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Apache</a> - <ul class="dropdown-menu"> - <li><a href="http://www.apache.org/"; target="_blank">Apache Homepage</a></li> - <li><a href="http://www.apache.org/licenses/"; target="_blank">License</a></li> - <li><a href="http://www.apache.org/foundation/sponsorship.html"; - target="_blank">Sponsorship</a></li> - <li><a href="http://www.apache.org/foundation/thanks.html"; target="_blank">Thanks</a></li> - </ul> - </li> - - <li class="dropdown"> - <a href="http://www.apache.org/"; class="hidden-lg hidden-md hidden-sm dropdown-toggle" - data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Apache</a> - <ul class="dropdown-menu"> - <li><a href="http://www.apache.org/"; target="_blank">Apache Homepage</a></li> - <li><a href="http://www.apache.org/licenses/"; target="_blank">License</a></li> - <li><a href="http://www.apache.org/foundation/sponsorship.html"; - target="_blank">Sponsorship</a></li> - <li><a href="http://www.apache.org/foundation/thanks.html"; target="_blank">Thanks</a></li> - </ul> - </li> - - <li> - <a href="#" id="search-icon"><i class="fa fa-search" aria-hidden="true"></i></a> - - </li> - - </ul> - </div><!--/.nav-collapse --> - <div id="search-box"> - <form method="get" action="http://www.google.com/search"; target="_blank"> - <div class="search-block"> - <table border="0" cellpadding="0" width="100%"> - <tr> - <td style="width:80%"> - <input type="text" name="q" size=" 5" maxlength="255" value="" - class="search-input" placeholder="Search...." required/> - </td> - <td style="width:20%"> - <input type="submit" value="Search"/></td> - </tr> - <tr> - <td align="left" style="font-size:75%" colspan="2"> - <input type="checkbox" name="sitesearch" value="carbondata.apache.org" checked/> - <span style=" position: relative; top: -3px;"> Only search for CarbonData</span> - </td> - </tr> - </table> - </div> - </form> - </div> - </div> - </nav> -</header> <!-- end Header part --> - -<div class="fixed-padding"></div> <!-- top padding with fixde header --> - -<section><!-- Dashboard nav --> - <div class="container-fluid q"> - <div class="col-sm-12 col-md-12 maindashboard"> - <div class="row"> - <section> - <div style="padding:10px 15px;"> - <div id="viewpage" name="viewpage"> - <div class="row"> - <div class="col-sm-12 col-md-12"> - <div> -<h1> -<a id="ddl-operations-on-carbondata" class="anchor" href="#ddl-operations-on-carbondata" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>DDL Operations on CarbonData</h1> -<p>This tutorial guides you through the data definition language support provided by CarbonData.</p> -<h2> -<a id="overview" class="anchor" href="#overview" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Overview</h2> -<p>The following DDL operations are supported in CarbonData :</p> -<ul> -<li><a href="#create-table">CREATE TABLE</a></li> -<li><a href="#show-table">SHOW TABLE</a></li> -<li> -<a href="#alter-table">ALTER TABLE</a> -<ul> -<li><a href="#rename-table">RENAME TABLE</a></li> -<li><a href="#add-column">ADD COLUMN</a></li> -<li><a href="#drop-columns">DROP COLUMNS</a></li> -<li><a href="#change-data-type">CHANGE DATA TYPE</a></li> -</ul> -</li> -<li><a href="#drop-table">DROP TABLE</a></li> -<li><a href="#compaction">COMPACTION</a></li> -<li><a href="#bucketing">BUCKETING</a></li> -</ul> -<h2> -<a id="create-table" class="anchor" href="#create-table" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>CREATE TABLE</h2> -<p>This command can be used to create a CarbonData table by specifying the list of fields along with the table properties.</p> -<pre><code> CREATE TABLE [IF NOT EXISTS] [db_name.]table_name - [(col_name data_type , ...)] - STORED BY 'carbondata' - [TBLPROPERTIES (property_name=property_value, ...)] - // All Carbon's additional table options will go into properties -</code></pre> -<h3> -<a id="parameter-description" class="anchor" href="#parameter-description" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Parameter Description</h3> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Optional</th> -</tr> -</thead> -<tbody> -<tr> -<td>db_name</td> -<td>Name of the database. Database name should consist of alphanumeric characters and underscore(_) special character.</td> -<td>YES</td> -</tr> -<tr> -<td>field_list</td> -<td>Comma separated List of fields with data type. The field names should consist of alphanumeric characters and underscore(_) special character.</td> -<td>NO</td> -</tr> -<tr> -<td>table_name</td> -<td>The name of the table in Database. Table name should consist of alphanumeric characters and underscore(_) special character.</td> -<td>NO</td> -</tr> -<tr> -<td>STORED BY</td> -<td>"org.apache.carbondata.format", identifies and creates a CarbonData table.</td> -<td>NO</td> -</tr> -<tr> -<td>TBLPROPERTIES</td> -<td>List of CarbonData table properties.</td> -<td>YES</td> -</tr> -</tbody> -</table> -<h3> -<a id="usage-guidelines" class="anchor" href="#usage-guidelines" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Usage Guidelines</h3> -<p>Following are the guidelines for using table properties.</p> -<ul> -<li> -<p><strong>Dictionary Encoding Configuration</strong></p> -<p>Dictionary encoding is enabled by default for all String columns, and disabled for non-String columns. You can include and exclude columns for dictionary encoding.</p> -</li> -</ul> -<pre><code> TBLPROPERTIES ('DICTIONARY_EXCLUDE'='column1, column2') - TBLPROPERTIES ('DICTIONARY_INCLUDE'='column1, column2') -</code></pre> -<p>Here, DICTIONARY_EXCLUDE will exclude dictionary creation. This is applicable for high-cardinality columns and is an optional parameter. DICTIONARY_INCLUDE will generate dictionary for the columns specified in the list.</p> -<ul> -<li> -<p><strong>Table Block Size Configuration</strong></p> -<p>The block size of table files can be defined using the property TABLE_BLOCKSIZE. It accepts only integer values. The default value is 1024 MB and supports a range of 1 MB to 2048 MB. -If you do not specify this value in the DDL command, default value is used.</p> -</li> -</ul> -<pre><code> TBLPROPERTIES ('TABLE_BLOCKSIZE'='512') -</code></pre> -<p>Here 512 MB means the block size of this table is 512 MB, you can also set it as 512M or 512.</p> -<ul> -<li> -<p><strong>Inverted Index Configuration</strong></p> -<p>Inverted index is very useful to improve compression ratio and query speed, especially for those low-cardinality columns which are in reward position. -By default inverted index is enabled. The user can disable the inverted index creation for some columns.</p> -</li> -</ul> -<pre><code> TBLPROPERTIES ('NO_INVERTED_INDEX'='column1, column3') -</code></pre> -<p>No inverted index shall be generated for the columns specified in NO_INVERTED_INDEX. This property is applicable on columns with high-cardinality and is an optional parameter.</p> -<p>NOTE:</p> -<ul> -<li> -<p>By default all columns other than numeric datatype are treated as dimensions and all columns of numeric datatype are treated as measures.</p> -</li> -<li> -<p>All dimensions except complex datatype columns are part of multi dimensional key(MDK). This behavior can be overridden by using TBLPROPERTIES. If the user wants to keep any column (except columns of complex datatype) in multi dimensional key then he can keep the columns either in DICTIONARY_EXCLUDE or DICTIONARY_INCLUDE.</p> -</li> -<li> -<p><strong>Sort Columns Configuration</strong></p> -<p>"SORT_COLUMN" property is for users to specify which columns belong to the MDK index. If user don't specify "SORT_COLUMN" property, by default MDK index be built by using all dimension columns except complex datatype column.</p> -</li> -</ul> -<pre><code> TBLPROPERTIES ('SORT_COLUMNS'='column1, column3') -</code></pre> -<h3> -<a id="example" class="anchor" href="#example" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Example:</h3> -<pre><code> CREATE TABLE IF NOT EXISTS productSchema.productSalesTable ( - productNumber Int, - productName String, - storeCity String, - storeProvince String, - productCategory String, - productBatch String, - saleQuantity Int, - revenue Int) - STORED BY 'carbondata' - TBLPROPERTIES ('DICTIONARY_EXCLUDE'='storeCity', - 'DICTIONARY_INCLUDE'='productNumber', - 'NO_INVERTED_INDEX'='productBatch', - 'SORT_COLUMNS'='productName,storeCity') -</code></pre> -<ul> -<li><strong>SORT_COLUMNS</strong></li> -</ul> -<pre><code>This table property specifies the order of the sort column. -</code></pre> -<pre><code> TBLPROPERTIES('SORT_COLUMNS'='column1, column3') -</code></pre> -<p>NOTE:</p> -<ul> -<li> -<p>If this property is not specified, then by default SORT_COLUMNS consist of all dimension (exclude Complex Column).</p> -</li> -<li> -<p>If this property is specified but with empty argument, then the table will be loaded without sort. For example, ('SORT_COLUMNS'='')</p> -</li> -</ul> -<h2> -<a id="show-table" class="anchor" href="#show-table" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>SHOW TABLE</h2> -<p>This command can be used to list all the tables in current database or all the tables of a specific database.</p> -<pre><code> SHOW TABLES [IN db_Name]; -</code></pre> -<h3> -<a id="parameter-description-1" class="anchor" href="#parameter-description-1" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Parameter Description</h3> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Optional</th> -</tr> -</thead> -<tbody> -<tr> -<td>IN db_Name</td> -<td>Name of the database. Required only if tables of this specific database are to be listed.</td> -<td>YES</td> -</tr> -</tbody> -</table> -<h3> -<a id="example-1" class="anchor" href="#example-1" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Example:</h3> -<pre><code> SHOW TABLES IN ProductSchema; -</code></pre> -<h2> -<a id="alter-table" class="anchor" href="#alter-table" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>ALTER TABLE</h2> -<p>The following section shall discuss the commands to modify the physical or logical state of the existing table(s).</p> -<h3> -<a id="rename-table" class="anchor" href="#rename-table" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a><strong>RENAME TABLE</strong> -</h3> -<p>This command is used to rename the existing table.</p> -<pre><code> ALTER TABLE [db_name.]table_name RENAME TO new_table_name; -</code></pre> -<h4> -<a id="parameter-description-2" class="anchor" href="#parameter-description-2" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Parameter Description</h4> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Optional</th> -</tr> -</thead> -<tbody> -<tr> -<td>db_Name</td> -<td>Name of the database. If this parameter is left unspecified, the current database is selected.</td> -<td>YES</td> -</tr> -<tr> -<td>table_name</td> -<td>Name of the existing table.</td> -<td>NO</td> -</tr> -<tr> -<td>new_table_name</td> -<td>New table name for the existing table.</td> -<td>NO</td> -</tr> -</tbody> -</table> -<h4> -<a id="usage-guidelines-1" class="anchor" href="#usage-guidelines-1" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Usage Guidelines</h4> -<ul> -<li> -<p>Queries that require the formation of path using the table name for reading carbon store files, running in parallel with Rename command might fail during the renaming operation.</p> -</li> -<li> -<p>Renaming of Secondary index table(s) is not permitted.</p> -</li> -</ul> -<h4> -<a id="examples" class="anchor" href="#examples" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Examples:</h4> -<pre><code> ALTER TABLE carbon RENAME TO carbondata; -</code></pre> -<pre><code> ALTER TABLE test_db.carbon RENAME TO test_db.carbondata; -</code></pre> -<h3> -<a id="add-column" class="anchor" href="#add-column" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a><strong>ADD COLUMN</strong> -</h3> -<p>This command is used to add a new column to the existing table.</p> -<pre><code> ALTER TABLE [db_name.]table_name ADD COLUMNS (col_name data_type,...) - TBLPROPERTIES('DICTIONARY_INCLUDE'='col_name,...', - 'DICTIONARY_EXCLUDE'='col_name,...', - 'DEFAULT.VALUE.COLUMN_NAME'='default_value'); -</code></pre> -<h4> -<a id="parameter-description-3" class="anchor" href="#parameter-description-3" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Parameter Description</h4> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Optional</th> -</tr> -</thead> -<tbody> -<tr> -<td>db_Name</td> -<td>Name of the database. If this parameter is left unspecified, the current database is selected.</td> -<td>YES</td> -</tr> -<tr> -<td>table_name</td> -<td>Name of the existing table.</td> -<td>NO</td> -</tr> -<tr> -<td>col_name data_type</td> -<td>Name of comma-separated column with data type. Column names contain letters, digits, and underscores (_).</td> -<td>NO</td> -</tr> -</tbody> -</table> -<p>NOTE: Do not name the column after name, tupleId, PositionId, and PositionReference when creating Carbon tables because they are used internally by UPDATE, DELETE, and secondary index.</p> -<h4> -<a id="usage-guidelines-2" class="anchor" href="#usage-guidelines-2" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Usage Guidelines</h4> -<ul> -<li> -<p>Apart from DICTIONARY_INCLUDE, DICTIONARY_EXCLUDE and default_value no other property will be read. If any other property name is specified, error will not be thrown, it will be ignored.</p> -</li> -<li> -<p>If default value is not specified, then NULL will be considered as the default value for the column.</p> -</li> -<li> -<p>For addition of column, if DICTIONARY_INCLUDE and DICTIONARY_EXCLUDE are not specified, then the decision will be taken based on data type of the column.</p> -</li> -</ul> -<h4> -<a id="examples-1" class="anchor" href="#examples-1" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Examples:</h4> -<pre><code> ALTER TABLE carbon ADD COLUMNS (a1 INT, b1 STRING); -</code></pre> -<pre><code> ALTER TABLE carbon ADD COLUMNS (a1 INT, b1 STRING) - TBLPROPERTIES('DICTIONARY_EXCLUDE'='b1'); -</code></pre> -<pre><code> ALTER TABLE carbon ADD COLUMNS (a1 INT, b1 STRING) - TBLPROPERTIES('DICTIONARY_INCLUDE'='a1'); -</code></pre> -<pre><code> ALTER TABLE carbon ADD COLUMNS (a1 INT, b1 STRING) - TBLPROPERTIES('DEFAULT.VALUE.a1'='10'); -</code></pre> -<h3> -<a id="drop-columns" class="anchor" href="#drop-columns" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a><strong>DROP COLUMNS</strong> -</h3> -<p>This command is used to delete a existing column or multiple columns in a table.</p> -<pre><code> ALTER TABLE [db_name.]table_name DROP COLUMNS (col_name, ...); -</code></pre> -<h4> -<a id="parameter-description-4" class="anchor" href="#parameter-description-4" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Parameter Description</h4> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Optional</th> -</tr> -</thead> -<tbody> -<tr> -<td>db_Name</td> -<td>Name of the database. If this parameter is left unspecified, the current database is selected.</td> -<td>YES</td> -</tr> -<tr> -<td>table_name</td> -<td>Name of the existing table.</td> -<td>NO</td> -</tr> -<tr> -<td>col_name</td> -<td>Name of comma-separated column with data type. Column names contain letters, digits, and underscores (_)</td> -<td>NO</td> -</tr> -</tbody> -</table> -<h4> -<a id="usage-guidelines-3" class="anchor" href="#usage-guidelines-3" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Usage Guidelines</h4> -<ul> -<li> -<p>Deleting a column will also clear the dictionary files, provided the column is of type dictionary.</p> -</li> -<li> -<p>For delete column operation, there should be at least one key column that exists in the schema after deletion else error message will be displayed and the operation shall fail.</p> -</li> -</ul> -<h4> -<a id="examples-2" class="anchor" href="#examples-2" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Examples:</h4> -<p>If the table contains 4 columns namely a1, b1, c1, and d1.</p> -<ul> -<li><strong>To delete a single column:</strong></li> -</ul> -<pre><code> ALTER TABLE carbon DROP COLUMNS (b1); -</code></pre> -<pre><code> ALTER TABLE test_db.carbon DROP COLUMNS (b1); -</code></pre> -<ul> -<li><strong>To delete multiple columns:</strong></li> -</ul> -<pre><code> ALTER TABLE carbon DROP COLUMNS (c1,d1); -</code></pre> -<h3> -<a id="change-data-type" class="anchor" href="#change-data-type" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a><strong>CHANGE DATA TYPE</strong> -</h3> -<p>This command is used to change the data type from INT to BIGINT or decimal precision from lower to higher.</p> -<pre><code> ALTER TABLE [db_name.]table_name - CHANGE col_name col_name changed_column_type; -</code></pre> -<h4> -<a id="parameter-description-5" class="anchor" href="#parameter-description-5" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Parameter Description</h4> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Optional</th> -</tr> -</thead> -<tbody> -<tr> -<td>db_Name</td> -<td>Name of the database. If this parameter is left unspecified, the current database is selected.</td> -<td>YES</td> -</tr> -<tr> -<td>table_name</td> -<td>Name of the existing table.</td> -<td>NO</td> -</tr> -<tr> -<td>col_name</td> -<td>Name of comma-separated column with data type. Column names contain letters, digits, and underscores (_).</td> -<td>NO</td> -</tr> -<tr> -<td>changed_column_type</td> -<td>The change in the data type.</td> -<td>NO</td> -</tr> -</tbody> -</table> -<h4> -<a id="usage-guidelines-4" class="anchor" href="#usage-guidelines-4" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Usage Guidelines</h4> -<ul> -<li>Change of decimal data type from lower precision to higher precision will only be supported for cases where there is no data loss.</li> -</ul> -<h4> -<a id="valid-scenarios" class="anchor" href="#valid-scenarios" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Valid Scenarios</h4> -<ul> -<li> -<p>Invalid scenario - Change of decimal precision from (10,2) to (10,5) is invalid as in this case only scale is increased but total number of digits remains the same.</p> -</li> -<li> -<p>Valid scenario - Change of decimal precision from (10,2) to (12,3) is valid as the total number of digits are increased by 2 but scale is increased only by 1 which will not lead to any data loss.</p> -</li> -<li> -<p>Note :The allowed range is 38,38 (precision, scale) and is a valid upper case scenario which is not resulting in data loss.</p> -</li> -</ul> -<h4> -<a id="examples-3" class="anchor" href="#examples-3" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Examples:</h4> -<ul> -<li><strong>Changing data type of column a1 from INT to BIGINT</strong></li> -</ul> -<pre><code> ALTER TABLE test_db.carbon CHANGE a1 a1 BIGINT; -</code></pre> -<ul> -<li><strong>Changing decimal precision of column a1 from 10 to 18.</strong></li> -</ul> -<pre><code> ALTER TABLE test_db.carbon CHANGE a1 a1 DECIMAL(18,2); -</code></pre> -<h2> -<a id="drop-table" class="anchor" href="#drop-table" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>DROP TABLE</h2> -<p>This command is used to delete an existing table.</p> -<pre><code> DROP TABLE [IF EXISTS] [db_name.]table_name; -</code></pre> -<h3> -<a id="parameter-description-6" class="anchor" href="#parameter-description-6" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Parameter Description</h3> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Optional</th> -</tr> -</thead> -<tbody> -<tr> -<td>db_Name</td> -<td>Name of the database. If not specified, current database will be selected.</td> -<td>YES</td> -</tr> -<tr> -<td>table_name</td> -<td>Name of the table to be deleted.</td> -<td>NO</td> -</tr> -</tbody> -</table> -<h3> -<a id="example-2" class="anchor" href="#example-2" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Example:</h3> -<pre><code> DROP TABLE IF EXISTS productSchema.productSalesTable; -</code></pre> -<h2> -<a id="compaction" class="anchor" href="#compaction" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>COMPACTION</h2> -<p>This command merges the specified number of segments into one segment. This enhances the query performance of the table.</p> -<pre><code> ALTER TABLE [db_name.]table_name COMPACT 'MINOR/MAJOR'; -</code></pre> -<p>To get details about Compaction refer to <a href="data-management.html">Data Management</a></p> -<h3> -<a id="parameter-description-7" class="anchor" href="#parameter-description-7" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Parameter Description</h3> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Optional</th> -</tr> -</thead> -<tbody> -<tr> -<td>db_name</td> -<td>Database name, if it is not specified then it uses current database.</td> -<td>YES</td> -</tr> -<tr> -<td>table_name</td> -<td>The name of the table in provided database.</td> -<td>NO</td> -</tr> -</tbody> -</table> -<h3> -<a id="syntax" class="anchor" href="#syntax" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Syntax</h3> -<ul> -<li><strong>Minor Compaction</strong></li> -</ul> -<pre><code>ALTER TABLE table_name COMPACT 'MINOR'; -</code></pre> -<ul> -<li><strong>Major Compaction</strong></li> -</ul> -<pre><code>ALTER TABLE table_name COMPACT 'MAJOR'; -</code></pre> -<h2> -<a id="bucketing" class="anchor" href="#bucketing" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>BUCKETING</h2> -<p>Bucketing feature can be used to distribute/organize the table/partition data into multiple files such -that similar records are present in the same file. While creating a table, a user needs to specify the -columns to be used for bucketing and the number of buckets. For the selection of bucket the Hash value -of columns is used.</p> -<pre><code> CREATE TABLE [IF NOT EXISTS] [db_name.]table_name - [(col_name data_type, ...)] - STORED BY 'carbondata' - TBLPROPERTIES('BUCKETNUMBER'='noOfBuckets', - 'BUCKETCOLUMNS'='columnname') -</code></pre> -<h3> -<a id="parameter-description-8" class="anchor" href="#parameter-description-8" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Parameter Description</h3> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Optional</th> -</tr> -</thead> -<tbody> -<tr> -<td>BUCKETNUMBER</td> -<td>Specifies the number of Buckets to be created.</td> -<td>No</td> -</tr> -<tr> -<td>BUCKETCOLUMNS</td> -<td>Specify the columns to be considered for Bucketing</td> -<td>No</td> -</tr> -</tbody> -</table> -<h3> -<a id="usage-guidelines-5" class="anchor" href="#usage-guidelines-5" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Usage Guidelines</h3> -<ul> -<li> -<p>The feature is supported for Spark 1.6.2 onwards, but the performance optimization is evident from Spark 2.1 onwards.</p> -</li> -<li> -<p>Bucketing can not be performed for columns of Complex Data Types.</p> -</li> -<li> -<p>Columns in the BUCKETCOLUMN parameter must be only dimension. The BUCKETCOLUMN parameter can not be a measure or a combination of measures and dimensions.</p> -</li> -</ul> -<h3> -<a id="example-3" class="anchor" href="#example-3" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Example:</h3> -<pre><code> CREATE TABLE IF NOT EXISTS productSchema.productSalesTable ( - productNumber Int, - saleQuantity Int, - productName String, - storeCity String, - storeProvince String, - productCategory String, - productBatch String, - revenue Int) - STORED BY 'carbondata' - TBLPROPERTIES ('DICTIONARY_EXCLUDE'='productName', - 'DICTIONARY_INCLUDE'='productNumber,saleQuantity', - 'NO_INVERTED_INDEX'='productBatch', - 'BUCKETNUMBER'='4', - 'BUCKETCOLUMNS'='productName') -</code></pre> -</div> -</div> -</div> -</div> -<div class="doc-footer"> - <a href="#top" class="scroll-top">Top</a> -</div> -</div> -</section> -</div> -</div> -</div> -</section><!-- End systemblock part --> -<script src="js/custom.js"></script> -</body> -</html> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/carbondata-site/blob/db7be789/content/dml-of-carbondata.html ---------------------------------------------------------------------- diff --git a/content/dml-of-carbondata.html b/content/dml-of-carbondata.html index e658a68..a96578a 100644 --- a/content/dml-of-carbondata.html +++ b/content/dml-of-carbondata.html @@ -77,7 +77,7 @@ aria-expanded="false">Community <span class="caret"></span></a> <ul class="dropdown-menu"> <li> - <a href="https://github.com/apache/carbondata/blob/master/docs/How-to-contribute-to-Apache-CarbonData.md"; + <a href="https://github.com/apache/carbondata/blob/master/docs/how-to-contribute-to-apache-carbondata.md"; target="_blank">Contributing to CarbonData</a></li> <li> <a href="https://github.com/apache/carbondata/blob/master/docs/release-guide.md";
