blob: 275efa868468cbb7a353e36d9f006820a0bbd489 [file] [log] [blame]
<!DOCTYPE html><html><head><meta charset="utf-8"><title>Untitled Document.md</title><style></style></head><body id="preview">
<p>&lt;!–<br>
Licensed to the Apache Software Foundation (ASF) under one<br>
or more contributor license agreements. See the NOTICE file<br>
distributed with this work for additional information<br>
regarding copyright ownership. The ASF licenses this file<br>
to you under the Apache License, Version 2.0 (the<br>
“License”); you may not use this file except in compliance<br>
with the License. You may obtain a copy of the License at</p>
<pre><code> http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
&quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
</code></pre>
<p>–&gt;</p>
<h1><a id="Configuring_CarbonData_19"></a>Configuring CarbonData</h1>
<p>This tutorial will guide you through the advance configuration of CarbonData.</p>
<h2><a id="System_Configuration_22"></a>System Configuration</h2>
<p>This section provides the details of all the configurations required for Carbon System.<br>
&lt;b&gt;&lt;p align=“center”&gt;System Configuration in carbon.properties&lt;/p&gt;&lt;/b&gt;</p>
<table class="table table-striped table-bordered">
<thead>
<tr>
<th>Parameter</th>
<th>Default Value</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>carbon.storelocation</td>
<td>/user/hive/warehouse/carbon.store</td>
<td>Location where Carbon will create the store, and write the data in its own format.NOTE: Store location should be in HDFS.</td>
</tr>
<tr>
<td>carbon.ddl.base.hdfs.url</td>
<td>hdfs://hacluster/opt/data</td>
<td>This property is used to configure the HDFS relative path from the HDFS base path, configured in fs.defaultFS. The path configured in carbon.ddl.base.hdfs.url will be appended to the HDFS path configured in fs.defaultFS. If this path is configured, then user need not pass the complete path while dataload.For example: If absolute path of the csv file is hdfs://10.18.101.155:54310/data/cnbc/2016/xyz.csv,the path “hdfs://10.18.101.155:54310” will come from property fs.defaultFS and user can configure the /data/cnbc/ as carbon.ddl.base.hdfs.url.Now while dataload user can specify the csv path as/2016/xyz.csv.</td>
</tr>
<tr>
<td>carbon.badRecords.location</td>
<td>/opt/Carbon/Spark/badrecords</td>
<td>Path where the bad records are stored.</td>
</tr>
<tr>
<td>carbon.kettle.home</td>
<td>$SPARK_HOME/carbonlib/carbonplugins</td>
<td>Path used by Carbon internally to create graph for loading the data.</td>
</tr>
<tr>
<td>carbon.data.file.version</td>
<td>2</td>
<td>If this parameter value is set to1, then the Carbon supports the data load which is in old format. If the value is set to 2, then the Carbon supports the data load of new format only.NOTE: The file format created before DataSight Spark V100R002C30 is considered as old format.</td>
</tr>
</tbody>
</table>
<h2><a id="Performance_Configuration_34"></a>Performance Configuration</h2>
<p>This section provides the details of all the configurations required for Carbon Performance Optimization.<br>
&lt;b&gt;&lt;p align=“center”&gt;Performance Configuration in carbon.properties&lt;/p&gt;&lt;/b&gt;</p>
<ol>
<li><strong>Data Loading Configuration</strong></li>
</ol>
<table class="table table-striped table-bordered">
<thead>
<tr>
<th>Parameter</th>
<th>Default Value</th>
<th>Description</th>
<th>Range</th>
</tr>
</thead>
<tbody>
<tr>
<td>carbon.sort.file.buffer.size</td>
<td>20</td>
<td>File read buffer size used during sorting.</td>
<td>The value is in MB.Min=1 and Max=100</td>
</tr>
<tr>
<td>carbon.graph.rowset.size</td>
<td>100000</td>
<td>Rowset size exchanged between data load graph steps.</td>
<td>Min=500 and Max=1000000</td>
</tr>
<tr>
<td>carbon.number.of.cores.while.loading</td>
<td>6</td>
<td>Number of cores to be used while data loading.</td>
<td></td>
</tr>
<tr>
<td>carbon.sort.size</td>
<td>500000</td>
<td>Record count to sort and write to temp intermediate files.</td>
<td></td>
</tr>
<tr>
<td>carbon.enableXXHash</td>
<td>true</td>
<td>Algorithm for hashmap for hashkey calculation.</td>
<td></td>
</tr>
<tr>
<td>carbon.number.of.cores.block.sort</td>
<td>7</td>
<td>Number of cores to be used for block sort while dataloading.</td>
<td></td>
</tr>
<tr>
<td>carbon.max.driver.lru.cache.size</td>
<td>-1</td>
<td>Max LRU cache size upto which data will be loaded at the driver side.</td>
<td>The value is in MB. The default value is -1, means there is no memory limit for caching. Only integer values greater than 0 are accepted.</td>
</tr>
<tr>
<td>carbon.max.executor.lru.cache.size</td>
<td>-1</td>
<td>Max LRU cache size upto which data will be loaded at the executor side.</td>
<td>The value is in MB. The default value is -1, means there is no memory limit for caching. Only integer values greater than 0 are accepted. If this parameter is not configured, then thecarbon.max.driver.lru.cache.size value will be considered.</td>
</tr>
<tr>
<td>carbon.merge.sort.prefetch</td>
<td>true</td>
<td>Enable prefetch of data during merge sort while reading data from sort temp files in data loading.</td>
<td></td>
</tr>
<tr>
<td>carbon.update.persist.enable</td>
<td>true</td>
<td>Enabling this parameter considers persistent data. Enabling this will reduce the execution time of UPDATE operation.</td>
<td></td>
</tr>
</tbody>
</table>
<ol start="2">
<li><strong>Compaction Configuration</strong></li>
</ol>
<table class="table table-striped table-bordered">
<thead>
<tr>
<th>Parameter</th>
<th>Default Value</th>
<th>Description</th>
<th>Range</th>
</tr>
</thead>
<tbody>
<tr>
<td>carbon.number.of.cores.while.compacting</td>
<td>2</td>
<td>Number of cores which is used to write data during compaction.</td>
<td></td>
</tr>
<tr>
<td>carbon.compaction.level.threshold</td>
<td>4,3</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. 3 is the number of level 1 compacted segment which is further compacted to new segment.</td>
<td>Valid values are from 0-100.</td>
</tr>
<tr>
<td>carbon.major.compaction.size</td>
<td>1024</td>
<td>Major compaction size can be configured using this parameter. Sum of the segments which is below this threshold will be merged. The value is in MB.</td>
<td></td>
</tr>
<tr>
<td>carbon.horizontal.compaction.enable</td>
<td>true</td>
<td>This property is used to turn ON/OFF horizontal compaction. After every DELETE and UPDATE statement, horizontal compaction may occur in case the delta (DELETE/ UPDATE) files becomes more than specified threshold. By default the horizontal compaction is Turned ON but can turn OFF the horizontal compaction by setting the value to false.</td>
<td></td>
</tr>
<tr>
<td>carbon.horizontal.UPDATE.compaction.threshold</td>
<td>1</td>
<td>This property specifies the threshold limit on number of UPDATE delta files within a segment. In case the number of delta files goes beyond the threshold, the UPDATE delta files within the segment becomes eligible for horizontal compaction and compacted into single UPDATE delta file.</td>
<td>By default the value is set to 1 and can be altered to values between 1 to 10000.</td>
</tr>
<tr>
<td>carbon.horizontal.DELETE.compaction.threshold</td>
<td>1</td>
<td>This property specifies the threshold limit on number of DELETE delta files within a block of a segment. In case the number of delta files goes beyond the threshold, the DELETE delta files for the particular block of the segment becomes eligible for horizontal compaction and compacted into single DELETE delta file.</td>
<td>By default the value is set to 1 and can be altered to values between 1 to 10000.</td>
</tr>
</tbody>
</table>
<ol start="3">
<li><strong>Query Configuration</strong></li>
</ol>
<table class="table table-striped table-bordered">
<thead>
<tr>
<th>Parameter</th>
<th>Default Value</th>
<th>Description</th>
<th>Range</th>
</tr>
</thead>
<tbody>
<tr>
<td>carbon.number.of.cores</td>
<td>4</td>
<td>Number of cores to be used while querying.</td>
<td></td>
</tr>
<tr>
<td>carbon.inmemory.record.size</td>
<td>120000</td>
<td>Number of records to be in memory while querying.</td>
<td>Min=100000 and Max=240000</td>
</tr>
<tr>
<td>carbon.enable.quick.filter</td>
<td>false</td>
<td>Improves the performance of filter query.</td>
<td></td>
</tr>
<tr>
<td>no.of.cores.to.load.blocks.in.driver</td>
<td>10</td>
<td>Number of core to load the blocks in driver.</td>
<td></td>
</tr>
</tbody>
</table>
<h2><a id="Miscellaneous_Configurations_74"></a>Miscellaneous Configurations</h2>
<p>&lt;b&gt;&lt;p align=“center”&gt;Extra Configuration in carbon.properties&lt;/p&gt;&lt;/b&gt;</p>
<ol>
<li><strong>Time format for CarbonData</strong></li>
</ol>
<table class="table table-striped table-bordered">
<thead>
<tr>
<th>Parameter</th>
<th>Default Format</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>carbon.timestamp.format</td>
<td>yyyy-MM-dd HH:mm:ss</td>
<td>Timestamp format of input data used for timestamp data type.</td>
</tr>
</tbody>
</table>
<ol start="2">
<li><strong>Dataload Configuration</strong></li>
</ol>
<table class="table table-striped table-bordered">
<thead>
<tr>
<th>Parameter</th>
<th>Default Value</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>carbon.sort.file.write.buffer.size</td>
<td>10485760</td>
<td>File write buffer size used during sorting.</td>
</tr>
<tr>
<td>carbon.lock.type</td>
<td>LOCALLOCK</td>
<td>This configuration specifies the type of lock to be acquired during concurrent operations on table.There are following types of lock implementation: - LOCALLOCK: Lock is created on local file system as file. This lock is useful when only one spark driver (thrift server) runs on a machine and no other Carbon spark application is launched concurrently. - HDFSLOCK: Lock is created on HDFS file system as file. This lock is useful when multiple carbon spark applications are launched and no ZooKeeper is running on cluster and HDFS supports file based locking.</td>
</tr>
<tr>
<td>carbon.sort.intermediate.files.limit</td>
<td>20</td>
<td>Minimum no of intermediate files after which sort merged to be started.</td>
</tr>
<tr>
<td>carbon.block.meta.size.reserved.percentage</td>
<td>10</td>
<td>space reserved in percentage for writing block meta data in carbon data file.</td>
</tr>
<tr>
<td>carbon.csv.read.buffersize.byte</td>
<td>1048576</td>
<td>csv reading buffer size.</td>
</tr>
<tr>
<td>high.cardinality.value</td>
<td>100000</td>
<td>To identify and apply compression for non-high cardinality columns.</td>
</tr>
<tr>
<td>carbon.merge.sort.reader.thread</td>
<td>3</td>
<td>Maximum no of threads used for reading intermediate files for final merging.</td>
</tr>
<tr>
<td>carbon.load.metadata.lock.retries</td>
<td>3</td>
<td>Maximum number of retries to get the metadata lock for loading data to table.</td>
</tr>
<tr>
<td>carbon.load.metadata.lock.retry.timeout.sec</td>
<td>5</td>
<td>Interval between the retries to get the lock.</td>
</tr>
<tr>
<td>carbon.tempstore.location</td>
<td>/opt/Carbon/TempStoreLoc</td>
<td>Temporary store location. By default it takes System.getProperty(“java.io.tmpdir”).</td>
</tr>
<tr>
<td>carbon.load.log.counter</td>
<td>500000</td>
<td>Data loading records count logger.</td>
</tr>
</tbody>
</table>
<ol start="3">
<li><strong>Compaction Configuration</strong></li>
</ol>
<table class="table table-striped table-bordered">
<thead>
<tr>
<th>Parameter</th>
<th>Default Value</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>carbon.numberof.preserve.segments</td>
<td>0</td>
<td>If the user wants to preserve some number of segments from being compacted then he can set this property.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>
</tr>
<tr>
<td>carbon.allowed.compaction.days</td>
<td>0</td>
<td>Compaction will merge the segments which are loaded with in 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>
</tr>
<tr>
<td>carbon.enable.auto.load.merge</td>
<td>false</td>
<td>To enable compaction while data loading.</td>
</tr>
</tbody>
</table>
<ol start="4">
<li><strong>Query Configuration</strong></li>
</ol>
<table class="table table-striped table-bordered">
<thead>
<tr>
<th>Parameter</th>
<th>Default Value</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>max.query.execution.time</td>
<td>60</td>
<td>Maximum time allowed for one query to be executed. The value is in minutes.</td>
</tr>
<tr>
<td>carbon.enableMinMax</td>
<td>true</td>
<td>Min max is feature added to enhance query performance. To disable this feature, set it false.</td>
</tr>
</tbody>
</table>
<ol start="5">
<li><strong>Global Dictionary Configurations</strong></li>
</ol>
<table class="table table-striped table-bordered">
<thead>
<tr>
<th>Parameter</th>
<th>Default Value</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>high.cardinality.identify.enable</td>
<td>true</td>
<td>If the parameter is true, the high cardinality columns of the dictionary code are automatically recognized and these columns will not be used as global dictionary encoding. If the parameter is false, all dictionary encoding columns are used as dictionary encoding.The high cardinality column must meet the following requirements:value of cardinality &gt; configured value of high.cardinalityEqually, the value of cardinality is higher than the threshold.value of cardinality/ row number x 100 &gt; configured value of high.cardinality.row.count.percentageEqually, the ratio of the cardinality value to data row number is higher than the configured percentage.</td>
</tr>
<tr>
<td>high.cardinality.threshold</td>
<td>1000000</td>
<td>Threshold to identify whether high cardinality column.Configuration value formula:Value of cardinality &gt; configured value of high.cardinalityThe minimum value is 10000.</td>
</tr>
<tr>
<td>high.cardinality.row.count.percentage</td>
<td>80</td>
<td>Percentage to identify whether column cardinality is more than configured percent of total row count.Configuration value formula:Value of cardinality/ row number x 100 &gt; configured value of high.cardinality.row.count.percentageThe value of the parameter must be larger than 0.</td>
</tr>
<tr>
<td>carbon.cutOffTimestamp</td>
<td>1970-01-01 05:30:00</td>
<td>Sets the start date for calculating the timestamp. Java counts the number of milliseconds from start of “1970-01-01 00:00:00”. This property is used to customize the start of position. For example “2000-01-01 00:00:00”.The date must be in the form “carbon.timestamp.format”.NOTE: The Carbon supports data store up to 68 years from the cut-off time defined. For example, if the cut-off time is 1970-01-01 05:30:00, then the data can be stored up to 2038-01-01 05:30:00.</td>
</tr>
<tr>
<td>carbon.timegranularity</td>
<td>SECOND</td>
<td>The property used to set the data granularity level DAY, HOUR, MINUTE, or SECOND.</td>
</tr>
</tbody>
</table>
<h2><a id="Spark_Configuration_125"></a>Spark Configuration</h2>
<p>&lt;b&gt;&lt;p align=“center”&gt;Spark Configuration Reference in spark-defaults.conf&lt;/p&gt;&lt;/b&gt;</p>
<table class="table table-striped table-bordered">
<thead>
<tr>
<th>Parameter</th>
<th>Default Value</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>spark.driver.memory</td>
<td>1g</td>
<td>Amount of memory to use for the driver process, i.e. where SparkContext is initialized.NOTE: In client mode, this config must not be set through the SparkConf directly in your application, because the driver JVM has already started at that point. Instead, please set this through the --driver-memory command line option or in your default properties file.</td>
</tr>
<tr>
<td>spark.executor.memory</td>
<td>1g</td>
<td>Amount of memory to use per executor process.</td>
</tr>
<tr>
<td>spark.sql.bigdata.register.analyseRule</td>
<td>org.apache.spark.sql.hive.acl.CarbonAccessControlRules</td>
<td>CarbonAccessControlRules need to be set for enabling Access Control.</td>
</tr>
</tbody>
</table>
</body></html>