http://git-wip-us.apache.org/repos/asf/carbondata-site/blob/db7be789/content/dml-operation-on-carbondata.html ---------------------------------------------------------------------- diff --git a/content/dml-operation-on-carbondata.html b/content/dml-operation-on-carbondata.html deleted file mode 100644 index b6a5642..0000000 --- a/content/dml-operation-on-carbondata.html +++ /dev/null @@ -1,716 +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="dml-operations-on-carbondata" class="anchor" href="#dml-operations-on-carbondata" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>DML Operations on CarbonData</h1> -<p>This tutorial guides you through the data manipulation 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 DML operations are supported in CarbonData :</p> -<ul> -<li><a href="#load-data">LOAD DATA</a></li> -<li><a href="#insert-data-into-a-carbondata-table">INSERT DATA INTO A CARBONDATA TABLE</a></li> -<li><a href="#show-segments">SHOW SEGMENTS</a></li> -<li><a href="#delete-segment-by-id">DELETE SEGMENT BY ID</a></li> -<li><a href="#delete-segment-by-date">DELETE SEGMENT BY DATE</a></li> -<li><a href="#update-carbondata-table">UPDATE CARBONDATA TABLE</a></li> -<li><a href="#delete-records-from-carbondata-table">DELETE RECORDS FROM CARBONDATA TABLE</a></li> -</ul> -<h2> -<a id="load-data" class="anchor" href="#load-data" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>LOAD DATA</h2> -<p>This command loads the user data in raw format to the CarbonData specific data format store, this allows CarbonData to provide good performance while querying the data. -Please visit <a href="data-management.html">Data Management</a> for more details on LOAD.</p> -<h3> -<a id="syntax" class="anchor" href="#syntax" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Syntax</h3> -<pre><code>LOAD DATA [LOCAL] INPATH 'folder_path' -INTO TABLE [db_name.]table_name -OPTIONS(property_name=property_value, ...) -</code></pre> -<p>OPTIONS are not mandatory for data loading process. Inside OPTIONS user can provide either of any options like DELIMITER, QUOTECHAR, ESCAPECHAR, MULTILINE as per requirement.</p> -<p>NOTE: The path shall be canonical path.</p> -<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>folder_path</td> -<td>Path of raw csv data folder or file.</td> -<td>NO</td> -</tr> -<tr> -<td>db_name</td> -<td>Database name, if it is not specified then it uses the 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> -<tr> -<td>OPTIONS</td> -<td>Extra options provided to Load</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>You can use the following options to load data:</p> -<ul> -<li> -<p><strong>DELIMITER:</strong> Delimiters can be provided in the load command.</p> -<pre><code>OPTIONS('DELIMITER'=',') -</code></pre> -</li> -<li> -<p><strong>QUOTECHAR:</strong> Quote Characters can be provided in the load command.</p> -<pre><code>OPTIONS('QUOTECHAR'='"') -</code></pre> -</li> -<li> -<p><strong>COMMENTCHAR:</strong> Comment Characters can be provided in the load command if user want to comment lines.</p> -<pre><code>OPTIONS('COMMENTCHAR'='#') -</code></pre> -</li> -<li> -<p><strong>FILEHEADER:</strong> Headers can be provided in the LOAD DATA command if headers are missing in the source files.</p> -<pre><code>OPTIONS('FILEHEADER'='column1,column2') -</code></pre> -</li> -<li> -<p><strong>MULTILINE:</strong> CSV with new line character in quotes.</p> -<pre><code>OPTIONS('MULTILINE'='true') -</code></pre> -</li> -<li> -<p><strong>ESCAPECHAR:</strong> Escape char can be provided if user want strict validation of escape character on CSV.</p> -<pre><code>OPTIONS('ESCAPECHAR'='\') -</code></pre> -</li> -<li> -<p><strong>COMPLEX_DELIMITER_LEVEL_1:</strong> Split the complex type data column in a row (eg., a$b$c --> Array = {a,b,c}).</p> -<pre><code>OPTIONS('COMPLEX_DELIMITER_LEVEL_1'='$') -</code></pre> -</li> -<li> -<p><strong>COMPLEX_DELIMITER_LEVEL_2:</strong> Split the complex type nested data column in a row. Applies level_1 delimiter & applies level_2 based on complex data type (eg., a:b$c:d --> Array> = {{a,b},{c,d}}).</p> -<pre><code>OPTIONS('COMPLEX_DELIMITER_LEVEL_2'=':') -</code></pre> -</li> -<li> -<p><strong>ALL_DICTIONARY_PATH:</strong> All dictionary files path.</p> -<pre><code>OPTIONS('ALL_DICTIONARY_PATH'='/opt/alldictionary/data.dictionary') -</code></pre> -</li> -<li> -<p><strong>COLUMNDICT:</strong> Dictionary file path for specified column.</p> -<pre><code>OPTIONS('COLUMNDICT'='column1:dictionaryFilePath1, -column2:dictionaryFilePath2') -</code></pre> -<p>NOTE: ALL_DICTIONARY_PATH and COLUMNDICT can't be used together.</p> -</li> -<li> -<p><strong>DATEFORMAT:</strong> Date format for specified column.</p> -<pre><code>OPTIONS('DATEFORMAT'='column1:dateFormat1, column2:dateFormat2') -</code></pre> -<p>NOTE: Date formats are specified by date pattern strings. The date pattern letters in CarbonData are same as in JAVA. Refer to <a href="http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html"; target=_blank>SimpleDateFormat</a>.</p> -</li> -<li> -<p><strong>SINGLE_PASS:</strong> Single Pass Loading enables single job to finish data loading with dictionary generation on the fly. It enhances performance in the scenarios where the subsequent data loading after initial load involves fewer incremental updates on the dictionary.</p> -<p>This option specifies whether to use single pass for loading data or not. By default this option is set to FALSE.</p> -<pre><code>OPTIONS('SINGLE_PASS'='TRUE') -</code></pre> -<p>Note :</p> -<ul> -<li> -<p>If this option is set to TRUE then data loading will take less time.</p> -</li> -<li> -<p>If this option is set to some invalid value other than TRUE or FALSE then it uses the default value.</p> -</li> -<li> -<p>If this option is set to TRUE, then high.cardinality.identify.enable property will be disabled during data load.</p> -</li> -</ul> -<h3> -<a id="example" class="anchor" href="#example" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Example:</h3> -</li> -</ul> -<pre><code>LOAD DATA local inpath '/opt/rawdata/data.csv' INTO table carbontable -options('DELIMITER'=',', 'QUOTECHAR'='"','COMMENTCHAR'='#', -'FILEHEADER'='empno,empname,designation,doj,workgroupcategory, - workgroupcategoryname,deptno,deptname,projectcode, - projectjoindate,projectenddate,attendance,utilization,salary', -'MULTILINE'='true','ESCAPECHAR'='\','COMPLEX_DELIMITER_LEVEL_1'='$', -'COMPLEX_DELIMITER_LEVEL_2'=':', -'ALL_DICTIONARY_PATH'='/opt/alldictionary/data.dictionary', -'SINGLE_PASS'='TRUE' -) -</code></pre> -<ul> -<li> -<p><strong>BAD RECORDS HANDLING:</strong> Methods of handling bad records are as follows:</p> -<ul> -<li> -<p>Load all of the data before dealing with the errors.</p> -</li> -<li> -<p>Clean or delete bad records before loading data or stop the loading when bad records are found.</p> -</li> -</ul> -<pre><code>OPTIONS('BAD_RECORDS_LOGGER_ENABLE'='true', 'BAD_RECORD_PATH'='hdfs://hacluster/tmp/carbon', 'BAD_RECORDS_ACTION'='REDIRECT', 'IS_EMPTY_DATA_BAD_RECORD'='false') -</code></pre> -<p>NOTE:</p> -<ul> -<li> -<p>If the REDIRECT option is used, Carbon will add all bad records in to a separate CSV file. However, this file must not be used for subsequent data loading because the content may not exactly match the source record. You are advised to cleanse the original source record for further data ingestion. This option is used to remind you which records are bad records.</p> -</li> -<li> -<p>In loaded data, if all records are bad records, the BAD_RECORDS_ACTION is invalid and the load operation fails.</p> -</li> -<li> -<p>The maximum number of characters per column is 100000. If there are more than 100000 characters in a column, data loading will fail.</p> -</li> -</ul> -</li> -</ul> -<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>LOAD DATA INPATH 'filepath.csv' -INTO TABLE tablename -OPTIONS('BAD_RECORDS_LOGGER_ENABLE'='true', -'BAD_RECORD_PATH'='hdfs://hacluster/tmp/carbon', -'BAD_RECORDS_ACTION'='REDIRECT', -'IS_EMPTY_DATA_BAD_RECORD'='false'); -</code></pre> -<p><strong>Bad Records Management Options:</strong></p> -<table> -<thead> -<tr> -<th>Options</th> -<th>Default Value</th> -<th>Description</th> -</tr> -</thead> -<tbody> -<tr> -<td>BAD_RECORDS_LOGGER_ENABLE</td> -<td>false</td> -<td>Whether to create logs with details about bad records.</td> -</tr> -<tr> -<td>BAD_RECORDS_ACTION</td> -<td>FAIL</td> -<td>Following are the four types of action for bad records: FORCE: Auto-corrects the data by storing the bad records as NULL. REDIRECT: Bad records are written to the raw CSV instead of being loaded. IGNORE: Bad records are neither loaded nor written to the raw CSV. FAIL: Data loading fails if any bad records are found. NOTE: In loaded data, if all records are bad records, the BAD_RECORDS_ACTION is invalid and the load operation fails.</td> -</tr> -<tr> -<td>IS_EMPTY_DATA_BAD_RECORD</td> -<td>false</td> -<td>If false, then empty ("" or '' or ,,) data will not be considered as bad record and vice versa.</td> -</tr> -<tr> -<td>BAD_RECORD_PATH</td> -<td>-</td> -<td>Specifies the HDFS path where bad records are stored. By default the value is Null. This path must to be configured by the user if bad record logger is enabled or bad record action redirect.</td> -</tr> -</tbody> -</table> -<h2> -<a id="insert-data-into-a-carbondata-table" class="anchor" href="#insert-data-into-a-carbondata-table" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>INSERT DATA INTO A CARBONDATA TABLE</h2> -<p>This command inserts data into a CarbonData table. It is defined as a combination of two queries Insert and Select query respectively. It inserts records from a source table into a target CarbonData table. The source table can be a Hive table, Parquet table or a CarbonData table itself. It comes with the functionality to aggregate the records of a table by performing Select query on source table and load its corresponding resultant records into a CarbonData table.</p> -<p><strong>NOTE</strong> : The client node where the INSERT command is executing, must be part of the cluster.</p> -<h3> -<a id="syntax-1" class="anchor" href="#syntax-1" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Syntax</h3> -<pre><code>INSERT INTO TABLE <CARBONDATA TABLE> SELECT * FROM sourceTableName -[ WHERE { <filter_condition> } ]; -</code></pre> -<p>You can also omit the <code>table</code> keyword and write your query as:</p> -<pre><code>INSERT INTO <CARBONDATA TABLE> SELECT * FROM sourceTableName -[ WHERE { <filter_condition> } ]; -</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> -</tr> -</thead> -<tbody> -<tr> -<td>CARBON TABLE</td> -<td>The name of the Carbon table in which you want to perform the insert operation.</td> -</tr> -<tr> -<td>sourceTableName</td> -<td>The table from which the records are read and inserted into destination CarbonData table.</td> -</tr> -</tbody> -</table> -<h3> -<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</h3> -<p>The following condition must be met for successful insert operation :</p> -<ul> -<li>The source table and the CarbonData table must have the same table schema.</li> -<li>The table must be created.</li> -<li>Overwrite is not supported for CarbonData table.</li> -<li>The data type of source and destination table columns should be same, else the data from source table will be treated as bad records and the INSERT command fails.</li> -<li>INSERT INTO command does not support partial success if bad records are found, it will fail.</li> -<li>Data cannot be loaded or updated in source table while insert from source table to target table is in progress.</li> -</ul> -<p>To enable data load or update during insert operation, configure the following property to true.</p> -<pre><code>carbon.insert.persist.enable=true -</code></pre> -<p>By default the above configuration will be false.</p> -<p><strong>NOTE</strong>: Enabling this property will reduce the performance.</p> -<h3> -<a id="examples" class="anchor" href="#examples" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Examples</h3> -<pre><code>INSERT INTO table1 SELECT item1 ,sum(item2 + 1000) as result FROM -table2 group by item1; -</code></pre> -<pre><code>INSERT INTO table1 SELECT item1, item2, item3 FROM table2 -where item2='xyz'; -</code></pre> -<pre><code>INSERT INTO table1 SELECT * FROM table2 -where exists (select * from table3 -where table2.item1 = table3.item1); -</code></pre> -<p><strong>The Status Success/Failure shall be captured in the driver log.</strong></p> -<h2> -<a id="show-segments" class="anchor" href="#show-segments" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>SHOW SEGMENTS</h2> -<p>This command is used to get the segments of CarbonData table.</p> -<pre><code>SHOW SEGMENTS FOR TABLE [db_name.]table_name -LIMIT number_of_segments; -</code></pre> -<h3> -<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</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 the 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> -<tr> -<td>number_of_segments</td> -<td>Limit the output to this number.</td> -<td>YES</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>SHOW SEGMENTS FOR TABLE CarbonDatabase.CarbonTable LIMIT 4; -</code></pre> -<h2> -<a id="delete-segment-by-id" class="anchor" href="#delete-segment-by-id" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>DELETE SEGMENT BY ID</h2> -<p>This command is used to delete segment by using the segment ID. Each segment has a unique segment ID associated with it. -Using this segment ID, you can remove the segment.</p> -<p>The following command will get the segmentID.</p> -<pre><code>SHOW SEGMENTS FOR Table [db_name.]table_name LIMIT number_of_segments -</code></pre> -<p>After you retrieve the segment ID of the segment that you want to delete, execute the following command to delete the selected segment.</p> -<pre><code>DELETE FROM TABLE [db_name.]table_name WHERE SEGMENT.ID IN (segment_id1, segments_id2, ...) -</code></pre> -<h3> -<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</h3> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Optional</th> -</tr> -</thead> -<tbody> -<tr> -<td>segment_id</td> -<td>Segment Id of the load.</td> -<td>NO</td> -</tr> -<tr> -<td>db_name</td> -<td>Database name, if it is not specified then it uses the 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="example-3" class="anchor" href="#example-3" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Example:</h3> -<pre><code>DELETE FROM TABLE CarbonDatabase.CarbonTable WHERE SEGMENT.ID IN (0); -DELETE FROM TABLE CarbonDatabase.CarbonTable WHERE SEGMENT.ID IN (0,5,8); -</code></pre> -<p>NOTE: Here 0.1 is compacted segment sequence id.</p> -<h2> -<a id="delete-segment-by-date" class="anchor" href="#delete-segment-by-date" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>DELETE SEGMENT BY DATE</h2> -<p>This command will allow to delete the CarbonData segment(s) from the store based on the date provided by the user in the DML command. -The segment created before the particular date will be removed from the specific stores.</p> -<pre><code>DELETE FROM TABLE [db_name.]table_name -WHERE SEGMENT.STARTTIME BEFORE DATE_VALUE -</code></pre> -<h3> -<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</h3> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Optional</th> -</tr> -</thead> -<tbody> -<tr> -<td>DATE_VALUE</td> -<td>Valid segment load start time value. All the segments before this specified date will be deleted.</td> -<td>NO</td> -</tr> -<tr> -<td>db_name</td> -<td>Database name, if it is not specified then it uses the 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="example-4" class="anchor" href="#example-4" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Example:</h3> -<pre><code> DELETE FROM TABLE CarbonDatabase.CarbonTable - WHERE SEGMENT.STARTTIME BEFORE '2017-06-01 12:05:06'; -</code></pre> -<h2> -<a id="update-carbondata-table" class="anchor" href="#update-carbondata-table" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Update CarbonData Table</h2> -<p>This command will allow to update the carbon table based on the column expression and optional filter conditions.</p> -<h3> -<a id="syntax-2" class="anchor" href="#syntax-2" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Syntax</h3> -<pre><code> UPDATE <table_name> - SET (column_name1, column_name2, ... column_name n) = - (column1_expression , column2_expression, ... column n_expression ) - [ WHERE { <filter_condition> } ]; -</code></pre> -<p>alternatively the following the command can also be used for updating the CarbonData Table :</p> -<pre><code>UPDATE <table_name> -SET (column_name1, column_name2) = -(select sourceColumn1, sourceColumn2 from sourceTable -[ WHERE { <filter_condition> } ] ) -[ WHERE { <filter_condition> } ]; -</code></pre> -<h3> -<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</h3> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -</tr> -</thead> -<tbody> -<tr> -<td>table_name</td> -<td>The name of the Carbon table in which you want to perform the update operation.</td> -</tr> -<tr> -<td>column_name</td> -<td>The destination columns to be updated.</td> -</tr> -<tr> -<td>sourceColumn</td> -<td>The source table column values to be updated in destination table.</td> -</tr> -<tr> -<td>sourceTable</td> -<td>The table from which the records are updated into destination Carbon table.</td> -</tr> -</tbody> -</table> -<p>NOTE: This functionality is currently not supported in Spark 2.x and will support soon.</p> -<h3> -<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</h3> -<p>The following conditions must be met for successful updation :</p> -<ul> -<li>The update command fails if multiple input rows in source table are matched with single row in destination table.</li> -<li>If the source table generates empty records, the update operation will complete successfully without updating the table.</li> -<li>If a source table row does not correspond to any of the existing rows in a destination table, the update operation will complete successfully without updating the table.</li> -<li>In sub-query, if the source table and the target table are same, then the update operation fails.</li> -<li>If the sub-query used in UPDATE statement contains aggregate method or group by query, then the UPDATE operation fails.</li> -</ul> -<h3> -<a id="examples-1" class="anchor" href="#examples-1" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Examples</h3> -<p>Update is not supported for queries that contain aggregate or group by.</p> -<pre><code> UPDATE t_carbn01 a - SET (a.item_type_code, a.profit) = ( SELECT b.item_type_cd, - sum(b.profit) from t_carbn01b b - WHERE item_type_cd =2 group by item_type_code); -</code></pre> -<p>Here the Update Operation fails as the query contains aggregate function sum(b.profit) and group by clause in the sub-query.</p> -<pre><code>UPDATE carbonTable1 d -SET(d.column3,d.column5 ) = (SELECT s.c33 ,s.c55 -FROM sourceTable1 s WHERE d.column1 = s.c11) -WHERE d.column1 = 'china' EXISTS( SELECT * from table3 o where o.c2 > 1); -</code></pre> -<pre><code>UPDATE carbonTable1 d SET (c3) = (SELECT s.c33 from sourceTable1 s -WHERE d.column1 = s.c11) -WHERE exists( select * from iud.other o where o.c2 > 1); -</code></pre> -<pre><code>UPDATE carbonTable1 SET (c2, c5 ) = (c2 + 1, concat(c5 , "y" )); -</code></pre> -<pre><code>UPDATE carbonTable1 d SET (c2, c5 ) = (c2 + 1, "xyx") -WHERE d.column1 = 'india'; -</code></pre> -<pre><code>UPDATE carbonTable1 d SET (c2, c5 ) = (c2 + 1, "xyx") -WHERE d.column1 = 'india' -and EXISTS( SELECT * FROM table3 o WHERE o.column2 > 1); -</code></pre> -<p><strong>The Status Success/Failure shall be captured in the driver log and the client.</strong></p> -<h2> -<a id="delete-records-from-carbondata-table" class="anchor" href="#delete-records-from-carbondata-table" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Delete Records from CarbonData Table</h2> -<p>This command allows us to delete records from CarbonData table.</p> -<h3> -<a id="syntax-3" class="anchor" href="#syntax-3" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Syntax</h3> -<pre><code>DELETE FROM table_name [WHERE expression]; -</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> -</tr> -</thead> -<tbody> -<tr> -<td>table_name</td> -<td>The name of the Carbon table in which you want to perform the delete.</td> -</tr> -</tbody> -</table> -<p>NOTE: This functionality is currently not supported in Spark 2.x and will support soon.</p> -<h3> -<a id="examples-2" class="anchor" href="#examples-2" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Examples</h3> -<pre><code>DELETE FROM columncarbonTable1 d WHERE d.column1 = 'china'; -</code></pre> -<pre><code>DELETE FROM dest WHERE column1 IN ('china', 'USA'); -</code></pre> -<pre><code>DELETE FROM columncarbonTable1 -WHERE column1 IN (SELECT column11 FROM sourceTable2); -</code></pre> -<pre><code>DELETE FROM columncarbonTable1 -WHERE column1 IN (SELECT column11 FROM sourceTable2 WHERE -column1 = 'USA'); -</code></pre> -<pre><code>DELETE FROM columncarbonTable1 WHERE column2 >= 4; -</code></pre> -<p><strong>The Status Success/Failure shall be captured in the driver log and the client.</strong></p> -</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/documentation.html ---------------------------------------------------------------------- diff --git a/content/documentation.html b/content/documentation.html index c920945..aeab9cc 100644 --- a/content/documentation.html +++ b/content/documentation.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/faq.html ---------------------------------------------------------------------- diff --git a/content/faq.html b/content/faq.html index aac986c..2068c17 100644 --- a/content/faq.html +++ b/content/faq.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/file-structure-of-carbondata.html ---------------------------------------------------------------------- diff --git a/content/file-structure-of-carbondata.html b/content/file-structure-of-carbondata.html index bd2be65..baa34db 100644 --- a/content/file-structure-of-carbondata.html +++ b/content/file-structure-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/how-to-contribute-to-apache-carbondata.html ---------------------------------------------------------------------- diff --git a/content/how-to-contribute-to-apache-carbondata.html b/content/how-to-contribute-to-apache-carbondata.html index 392814c..eae12e3 100644 --- a/content/how-to-contribute-to-apache-carbondata.html +++ b/content/how-to-contribute-to-apache-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/index.html ---------------------------------------------------------------------- diff --git a/content/index.html b/content/index.html index 5c5b663..ea86500 100644 --- a/content/index.html +++ b/content/index.html @@ -80,7 +80,7 @@ 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"; @@ -296,7 +296,7 @@ <div class="cd-indexing-blog"> <img src="images/CDfullyIndexing.png" alt=""/> </div> - <a href="mainpage.html" id="learnmore" + <a href="documentation.html" id="learnmore" class="knowmore-btn"> learn more</a> </div> @@ -429,7 +429,7 @@ </p>--> <ul class="listlink"> <li> To start contributing to CarbonData and be a contributor, see <a - href="https://github.com/apache/carbondata/blob/master/docs/How-to-contribute-to-Apache-CarbonData.md"; + href="https://github.com/apache/carbondata/blob/master/docs/how-to-contribute-to-apache-carbondata.md"; target="_blank">Contributing to Apache CarbonData</a>. </li> <li> To report issue on <a http://git-wip-us.apache.org/repos/asf/carbondata-site/blob/db7be789/content/installation-guide.html ---------------------------------------------------------------------- diff --git a/content/installation-guide.html b/content/installation-guide.html deleted file mode 100644 index 2e7fab6..0000000 --- a/content/installation-guide.html +++ /dev/null @@ -1,455 +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.4.1/"; - target="_blank">Apache CarbonData 1.4.1</a></li> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.4.0/"; - target="_blank">Apache CarbonData 1.4.0</a></li> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.3.1/"; - target="_blank">Apache CarbonData 1.3.1</a></li> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.3.0/"; - target="_blank">Apache CarbonData 1.3.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="installation-guide" class="anchor" href="#installation-guide" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Installation Guide</h1> -<p>This tutorial guides you through the installation and configuration of CarbonData in the following two modes :</p> -<ul> -<li><a href="#installing-and-configuring-carbondata-on-standalone-spark-cluster">Installing and Configuring CarbonData on Standalone Spark Cluster</a></li> -<li><a href="#installing-and-configuring-carbondata-on-spark-on-yarn-cluster">Installing and Configuring CarbonData on Spark on YARN Cluster</a></li> -</ul> -<p>followed by :</p> -<ul> -<li><a href="#query-execution-using-carbondata-thrift-server">Query Execution using CarbonData Thrift Server</a></li> -</ul> -<h2> -<a id="installing-and-configuring-carbondata-on-standalone-spark-cluster" class="anchor" href="#installing-and-configuring-carbondata-on-standalone-spark-cluster" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Installing and Configuring CarbonData on Standalone Spark Cluster</h2> -<h3> -<a id="prerequisites" class="anchor" href="#prerequisites" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Prerequisites</h3> -<ul> -<li> -<p>Hadoop HDFS and Yarn should be installed and running.</p> -</li> -<li> -<p>Spark should be installed and running on all the cluster nodes.</p> -</li> -<li> -<p>CarbonData user should have permission to access HDFS.</p> -</li> -</ul> -<h3> -<a id="procedure" class="anchor" href="#procedure" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Procedure</h3> -<ol> -<li> -<p><a href="https://github.com/apache/carbondata/blob/master/build/README.md"; target=_blank>Build the CarbonData</a> project and get the assembly jar from <code>./assembly/target/scala-2.1x/carbondata_xxx.jar</code>.</p> -</li> -<li> -<p>Copy <code>./assembly/target/scala-2.1x/carbondata_xxx.jar</code> to <code>$SPARK_HOME/carbonlib</code> folder.</p> -<p><strong>NOTE</strong>: Create the carbonlib folder if it does not exist inside <code>$SPARK_HOME</code> path.</p> -</li> -<li> -<p>Add the carbonlib folder path in the Spark classpath. (Edit <code>$SPARK_HOME/conf/spark-env.sh</code> file and modify the value of <code>SPARK_CLASSPATH</code> by appending <code>$SPARK_HOME/carbonlib/*</code> to the existing value)</p> -</li> -<li> -<p>Copy the <code>./conf/carbon.properties.template</code> file from CarbonData repository to <code>$SPARK_HOME/conf/</code> folder and rename the file to <code>carbon.properties</code>.</p> -</li> -<li> -<p>Repeat Step 2 to Step 5 in all the nodes of the cluster.</p> -</li> -<li> -<p>In Spark node[master], configure the properties mentioned in the following table in <code>$SPARK_HOME/conf/spark-defaults.conf</code> file.</p> -</li> -</ol> -<table> -<thead> -<tr> -<th>Property</th> -<th>Value</th> -<th>Description</th> -</tr> -</thead> -<tbody> -<tr> -<td>spark.driver.extraJavaOptions</td> -<td><code>-Dcarbon.properties.filepath = $SPARK_HOME/conf/carbon.properties</code></td> -<td>A string of extra JVM options to pass to the driver. For instance, GC settings or other logging.</td> -</tr> -<tr> -<td>spark.executor.extraJavaOptions</td> -<td><code>-Dcarbon.properties.filepath = $SPARK_HOME/conf/carbon.properties</code></td> -<td>A string of extra JVM options to pass to executors. For instance, GC settings or other logging. <strong>NOTE</strong>: You can enter multiple values separated by space.</td> -</tr> -</tbody> -</table> -<ol start="7"> -<li>Add the following properties in <code>$SPARK_HOME/conf/carbon.properties</code> file:</li> -</ol> -<table> -<thead> -<tr> -<th>Property</th> -<th>Required</th> -<th>Description</th> -<th>Example</th> -<th>Remark</th> -</tr> -</thead> -<tbody> -<tr> -<td>carbon.storelocation</td> -<td>NO</td> -<td>Location where data CarbonData will create the store and write the data in its own format. If not specified then it takes spark.sql.warehouse.dir path.</td> -<td>hdfs://HOSTNAME:PORT/Opt/CarbonStore</td> -<td>Propose to set HDFS directory</td> -</tr> -</tbody> -</table> -<ol start="8"> -<li>Verify the installation. For example:</li> -</ol> -<pre><code>./spark-shell --master spark://HOSTNAME:PORT --total-executor-cores 2 ---executor-memory 2G -</code></pre> -<p><strong>NOTE</strong>: Make sure you have permissions for CarbonData JARs and files through which driver and executor will start.</p> -<p>To get started with CarbonData : <a href="quick-start-guide.html">Quick Start</a>, <a href="data-management-on-carbondata.html">Data Management on CarbonData</a></p> -<h2> -<a id="installing-and-configuring-carbondata-on-spark-on-yarn-cluster" class="anchor" href="#installing-and-configuring-carbondata-on-spark-on-yarn-cluster" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Installing and Configuring CarbonData on Spark on YARN Cluster</h2> -<p>This section provides the procedure to install CarbonData on "Spark on YARN" cluster.</p> -<h3> -<a id="prerequisites-1" class="anchor" href="#prerequisites-1" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Prerequisites</h3> -<ul> -<li>Hadoop HDFS and Yarn should be installed and running.</li> -<li>Spark should be installed and running in all the clients.</li> -<li>CarbonData user should have permission to access HDFS.</li> -</ul> -<h3> -<a id="procedure-1" class="anchor" href="#procedure-1" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Procedure</h3> -<p>The following steps are only for Driver Nodes. (Driver nodes are the one which starts the spark context.)</p> -<ol> -<li> -<p><a href="https://github.com/apache/carbondata/blob/master/build/README.md"; target=_blank>Build the CarbonData</a> project and get the assembly jar from <code>./assembly/target/scala-2.1x/carbondata_xxx.jar</code> and copy to <code>$SPARK_HOME/carbonlib</code> folder.</p> -<p><strong>NOTE</strong>: Create the carbonlib folder if it does not exists inside <code>$SPARK_HOME</code> path.</p> -</li> -<li> -<p>Copy the <code>./conf/carbon.properties.template</code> file from CarbonData repository to <code>$SPARK_HOME/conf/</code> folder and rename the file to <code>carbon.properties</code>.</p> -</li> -<li> -<p>Create <code>tar.gz</code> file of carbonlib folder and move it inside the carbonlib folder.</p> -</li> -</ol> -<pre><code>cd $SPARK_HOME -tar -zcvf carbondata.tar.gz carbonlib/ -mv carbondata.tar.gz carbonlib/ -</code></pre> -<ol start="4"> -<li>Configure the properties mentioned in the following table in <code>$SPARK_HOME/conf/spark-defaults.conf</code> file.</li> -</ol> -<table> -<thead> -<tr> -<th>Property</th> -<th>Description</th> -<th>Value</th> -</tr> -</thead> -<tbody> -<tr> -<td>spark.master</td> -<td>Set this value to run the Spark in yarn cluster mode.</td> -<td>Set yarn-client to run the Spark in yarn cluster mode.</td> -</tr> -<tr> -<td>spark.yarn.dist.files</td> -<td>Comma-separated list of files to be placed in the working directory of each executor.</td> -<td><code>$SPARK_HOME/conf/carbon.properties</code></td> -</tr> -<tr> -<td>spark.yarn.dist.archives</td> -<td>Comma-separated list of archives to be extracted into the working directory of each executor.</td> -<td><code>$SPARK_HOME/carbonlib/carbondata.tar.gz</code></td> -</tr> -<tr> -<td>spark.executor.extraJavaOptions</td> -<td>A string of extra JVM options to pass to executors. For instance <strong>NOTE</strong>: You can enter multiple values separated by space.</td> -<td><code>-Dcarbon.properties.filepath = carbon.properties</code></td> -</tr> -<tr> -<td>spark.executor.extraClassPath</td> -<td>Extra classpath entries to prepend to the classpath of executors. <strong>NOTE</strong>: If SPARK_CLASSPATH is defined in spark-env.sh, then comment it and append the values in below parameter spark.driver.extraClassPath</td> -<td><code>carbondata.tar.gz/carbonlib/*</code></td> -</tr> -<tr> -<td>spark.driver.extraClassPath</td> -<td>Extra classpath entries to prepend to the classpath of the driver. <strong>NOTE</strong>: If SPARK_CLASSPATH is defined in spark-env.sh, then comment it and append the value in below parameter spark.driver.extraClassPath.</td> -<td><code>$SPARK_HOME/carbonlib/*</code></td> -</tr> -<tr> -<td>spark.driver.extraJavaOptions</td> -<td>A string of extra JVM options to pass to the driver. For instance, GC settings or other logging.</td> -<td><code>-Dcarbon.properties.filepath = $SPARK_HOME/conf/carbon.properties</code></td> -</tr> -</tbody> -</table> -<ol start="5"> -<li>Add the following properties in <code>$SPARK_HOME/conf/carbon.properties</code>:</li> -</ol> -<table> -<thead> -<tr> -<th>Property</th> -<th>Required</th> -<th>Description</th> -<th>Example</th> -<th>Default Value</th> -</tr> -</thead> -<tbody> -<tr> -<td>carbon.storelocation</td> -<td>NO</td> -<td>Location where CarbonData will create the store and write the data in its own format. If not specified then it takes spark.sql.warehouse.dir path.</td> -<td>hdfs://HOSTNAME:PORT/Opt/CarbonStore</td> -<td>Propose to set HDFS directory</td> -</tr> -</tbody> -</table> -<ol start="6"> -<li>Verify the installation.</li> -</ol> -<pre><code> ./bin/spark-shell --master yarn-client --driver-memory 1g - --executor-cores 2 --executor-memory 2G -</code></pre> -<p><strong>NOTE</strong>: Make sure you have permissions for CarbonData JARs and files through which driver and executor will start.</p> -<p>Getting started with CarbonData : <a href="quick-start-guide.html">Quick Start</a>, <a href="data-management-on-carbondata.html">Data Management on CarbonData</a></p> -<h2> -<a id="query-execution-using-carbondata-thrift-server" class="anchor" href="#query-execution-using-carbondata-thrift-server" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Query Execution Using CarbonData Thrift Server</h2> -<h3> -<a id="starting-carbondata-thrift-server" class="anchor" href="#starting-carbondata-thrift-server" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Starting CarbonData Thrift Server.</h3> -<p>a. cd <code>$SPARK_HOME</code></p> -<p>b. Run the following command to start the CarbonData thrift server.</p> -<pre><code>./bin/spark-submit ---class org.apache.carbondata.spark.thriftserver.CarbonThriftServer -$SPARK_HOME/carbonlib/$CARBON_ASSEMBLY_JAR <carbon_store_path> -</code></pre> -<table> -<thead> -<tr> -<th>Parameter</th> -<th>Description</th> -<th>Example</th> -</tr> -</thead> -<tbody> -<tr> -<td>CARBON_ASSEMBLY_JAR</td> -<td>CarbonData assembly jar name present in the <code>$SPARK_HOME/carbonlib/</code> folder.</td> -<td>carbondata_2.xx-x.x.x-SNAPSHOT-shade-hadoop2.7.2.jar</td> -</tr> -<tr> -<td>carbon_store_path</td> -<td>This is a parameter to the CarbonThriftServer class. This a HDFS path where CarbonData files will be kept. Strongly Recommended to put same as carbon.storelocation parameter of carbon.properties. If not specified then it takes spark.sql.warehouse.dir path.</td> -<td><code>hdfs://<host_name>:port/user/hive/warehouse/carbon.store</code></td> -</tr> -</tbody> -</table> -<p><strong>NOTE</strong>: From Spark 1.6, by default the Thrift server runs in multi-session mode. Which means each JDBC/ODBC connection owns a copy of their own SQL configuration and temporary function registry. Cached tables are still shared though. If you prefer to run the Thrift server in single-session mode and share all SQL configuration and temporary function registry, please set option <code>spark.sql.hive.thriftServer.singleSession</code> to <code>true</code>. You may either add this option to <code>spark-defaults.conf</code>, or pass it to <code>spark-submit.sh</code> via <code>--conf</code>:</p> -<pre><code>./bin/spark-submit ---conf spark.sql.hive.thriftServer.singleSession=true ---class org.apache.carbondata.spark.thriftserver.CarbonThriftServer -$SPARK_HOME/carbonlib/$CARBON_ASSEMBLY_JAR <carbon_store_path> -</code></pre> -<p><strong>But</strong> in single-session mode, if one user changes the database from one connection, the database of the other connections will be changed too.</p> -<p><strong>Examples</strong></p> -<ul> -<li>Start with default memory and executors.</li> -</ul> -<pre><code>./bin/spark-submit ---class org.apache.carbondata.spark.thriftserver.CarbonThriftServer -$SPARK_HOME/carbonlib -/carbondata_2.xx-x.x.x-SNAPSHOT-shade-hadoop2.7.2.jar -hdfs://<host_name>:port/user/hive/warehouse/carbon.store -</code></pre> -<ul> -<li>Start with Fixed executors and resources.</li> -</ul> -<pre><code>./bin/spark-submit ---class org.apache.carbondata.spark.thriftserver.CarbonThriftServer ---num-executors 3 --driver-memory 20g --executor-memory 250g ---executor-cores 32 -/srv/OSCON/BigData/HACluster/install/spark/sparkJdbc/lib -/carbondata_2.xx-x.x.x-SNAPSHOT-shade-hadoop2.7.2.jar -hdfs://<host_name>:port/user/hive/warehouse/carbon.store -</code></pre> -<h3> -<a id="connecting-to-carbondata-thrift-server-using-beeline" class="anchor" href="#connecting-to-carbondata-thrift-server-using-beeline" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Connecting to CarbonData Thrift Server Using Beeline.</h3> -<pre><code> cd $SPARK_HOME - ./sbin/start-thriftserver.sh - ./bin/beeline -u jdbc:hive2://<thriftserver_host>:port - - Example - ./bin/beeline -u jdbc:hive2://10.10.10.10:10000 -</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/introduction.html ---------------------------------------------------------------------- diff --git a/content/introduction.html b/content/introduction.html index 8f18870..51a46c2 100644 --- a/content/introduction.html +++ b/content/introduction.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/language-manual.html ---------------------------------------------------------------------- diff --git a/content/language-manual.html b/content/language-manual.html index 74c18f4..9f738b8 100644 --- a/content/language-manual.html +++ b/content/language-manual.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/lucene-datamap-guide.html ---------------------------------------------------------------------- diff --git a/content/lucene-datamap-guide.html b/content/lucene-datamap-guide.html index 357286a..f461ca5 100644 --- a/content/lucene-datamap-guide.html +++ b/content/lucene-datamap-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/mainpage.html ---------------------------------------------------------------------- diff --git a/content/mainpage.html b/content/mainpage.html deleted file mode 100644 index d515853..0000000 --- a/content/mainpage.html +++ /dev/null @@ -1,214 +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.4.1/"; - target="_blank">Apache CarbonData 1.4.1</a></li> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.4.0/"; - target="_blank">Apache CarbonData 1.4.0</a></li> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.3.1/"; - target="_blank">Apache CarbonData 1.3.1</a></li> - <li> - <a href="https://dist.apache.org/repos/dist/release/carbondata/1.3.0/"; - target="_blank">Apache CarbonData 1.3.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";> - <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="doc-heading"> - <h4 class="title">Documentation - <span class="title-underline"></span> - </h4> - </div> - - <div class="row"> - - <div class="col-sm-12 col-md-12"> - <span class="text-justify"> - Welcome to Apache CarbonData. Apache CarbonData is a new big data file format for faster interactive query using advanced columnar storage, index, compression and encoding techniques to improve computing efficiency, which helps in speeding up queries by an order of magnitude faster over PetaBytes of data. This user guide provides a detailed description about the CarbonData and its features. - Let's get started ! - </span> - <hr style="margin: 12px 0 8px"> - <div> - <ul class="sub-nav"> - <li><a href="quick-start-guide.html">Quick Start</a></li> - <li><a href="file-structure-of-carbondata.html">CarbonData File Structure</a></li> - <li><a href="supported-data-types-in-carbondata.html">Data Types</a></li> - <li><a href="data-management-on-carbondata.html">Data Management On CarbonData</a></li> - <li><a href="installation-guide.html">Installation Guide</a></li> - <li><a href="configuration-parameters.html">Configuring CarbonData</a></li> - <li><a href="streaming-guide.html">Streaming Guide</a></li> - <li><a href="sdk-guide.html">SDK Guide</a></li> - <li><a href="s3-guide.html">S3 Guide (Alpha Feature)</a></li> - <li><a href="datamap-developer-guide.html">DataMap Developer Guide</a></li> - <li><a href="datamap-management.html">CarbonData DataMap Management</a></li> - <li><a href="bloomfilter-datamap-guide.html">CarbonData BloomFilter DataMap (Alpha Feature)</a></li> - <li><a href="lucene-datamap-guide.html">CarbonData Lucene DataMap (Alpha Feature)</a></li> - <li><a href="preaggregate-datamap-guide.html">CarbonData Pre-aggregate DataMap</a></li> - <li><a href="timeseries-datamap-guide.html">CarbonData Timeseries DataMap</a></li> - <li><a href="faq.html">FAQs</a></li> - <li><a href="troubleshooting.html">Troubleshooting</a></li> - <li><a href="useful-tips-on-carbondata.html">Useful Tips</a></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 --> -</div> -</div> -</div> -</section><!-- End systemblock part --> -<script src="js/custom.js"></script> -</body> -</html>
