Hive Configuration Properties

Query Execution

mapred.reduce.tasks

  • Default Value: -1
  • Added In: 0.1

The default number of reduce tasks per job. Typically set to a prime close to the number of available hosts. Ignored when mapred.job.tracker is "local". Hadoop set this to 1 by default, whereas hive uses -1 as its default value. By setting this property to -1, Hive will automatically figure out what should be the number of reducers.

hive.exec.reducers.bytes.per.reducer

  • Default Value: 1000000000
  • Added In:

Size per reducer. The default is 1G, i.e if the input size is 10G, it will use 10 reducers.

hive.exec.reducers.max

  • Default Value: 999
  • Added In:

Max number of reducers will be used. If the one specified in the configuration parameter mapred.reduce.tasks is negative, hive will use this one as the max number of reducers when automatically determine number of reducers.

hive.exec.scratchdir

  • Default Value: /tmp/hive-${user.name }
  • Added In:

Scratch space for Hive jobs.

hive.default.fileformat

  • Default Value: TextFile
  • Added In:

Default file format for CREATE TABLE statement. Options are TextFile and SequenceFile. Users can explicitly say CREATE TABLE ... STORED AS TEXTFILE|SEQUENCEFILE to override.

hive.fileformat.check

  • Default Value: true
  • Added In:

Whether to check file format or not when loading data files.

hive.map.aggr

  • Default Value: true
  • Added In:

Whether to use map-side aggregation in Hive Group By queries.

hive.groupby.skewindata

  • Default Value: false
  • Added In:

Whether there is skew in data to optimize group by queries.

hive.groupby.mapaggr.checkinterval

  • Default Value: 100000
  • Added In:

Number of rows after which size of the grouping keys/aggregation classes is performed.

hive.mapred.local.mem

  • Default Value: 0
  • Added In:

For local mode, memory of the mappers/reducers.

hive.mapjoin.followby.map.aggr.hash.percentmemory

  • Default Value: 0.3
  • Added In:

Portion of total memory to be used by map-side grup aggregation hash table, when this group by is followed by map join.

hive.map.aggr.hash.force.flush.memory.threshold

  • Default Value: 0.9
  • Added In:

The max memory to be used by map-side grup aggregation hash table, if the memory usage is higher than this number, force to flush data.

hive.map.aggr.hash.percentmemory

  • Default Value: 0.5
  • Added In:

Portion of total memory to be used by map-side grup aggregation hash table.

hive.map.aggr.hash.min.reduction

  • Default Value: 0.5
  • Added In:

Hash aggregation will be turned off if the ratio between hash table size and input rows is bigger than this number. Set to 1 to make sure hash aggregation is never turned off.

hive.optimize.groupby

  • Default Value: true
  • Added In:

Whether to enable the bucketed group by from bucketed partitions/tables.

hive.multigroupby.singlemr

  • Default Value: false
  • Added In:

Whether to optimize multi group by query to generate single M/R job plan. If the multi group by query has common group by keys, it will be optimized to generate single M/R job.

hive.optimize.cp

  • Default Value: true
  • Added In:

Whether to enable column pruner.

hive.optimize.index.filter

  • Default Value: false
  • Added In:

Whether to enable automatic use of indexes.

hive.optimize.index.groupby

  • Default Value: false
  • Added In:

Whether to enable optimization of group-by queries using Aggregate indexes.

hive.optimize.ppd

  • Default Value: true
  • Added In:

Whether to enable predicate pushdown.

hive.optimize.ppd.storage

  • Default Value: true
  • Added In:

Whether to push predicates down into storage handlers. Ignored when hive.optimize.ppd is false.

hive.ppd.recognizetransivity

  • Default Value: true
  • Added In:

Whether to transitively replicate predicate filters over equijoin conditions.

hive.join.emit.interval

  • Default Value: 1000
  • Added In:

How many rows in the right-most join operand Hive should buffer before emitting the join result.

hive.join.cache.size

  • Default Value: 25000
  • Added In:

How many rows in the joining tables (except the streaming table) should be cached in memory.

hive.mapjoin.bucket.cache.size

  • Default Value: 100
  • Added In:

How many values in each keys in the map-joined table should be cached in memory.

hive.mapjoin.cache.numrows

  • Default Value: 25000
  • Added In:

How many rows should be cached by jdbm for map join.

hive.optimize.skewjoin

  • Default Value: false
  • Added In:

Whether to enable skew join optimization.

hive.skewjoin.key

  • Default Value: 100000
  • Added In:

Determine if we get a skew key in join. If we see more than the specified number of rows with the same key in join operator, we think the key is a skew join key.

hive.skewjoin.mapjoin.map.tasks

  • Default Value: 10000
  • Added In:

Determine the number of map task used in the follow up map join job for a skew join. It should be used together with hive.skewjoin.mapjoin.min.split to perform a fine grained control.

hive.skewjoin.mapjoin.min.split

  • Default Value: 33554432
  • Added In:

Determine the number of map task at most used in the follow up map join job for a skew join by specifying the minimum split size. It should be used together with hive.skewjoin.mapjoin.map.tasks to perform a fine grained control.

hive.mapred.mode

  • Default Value: nonstrict
  • Added In:

The mode in which the hive operations are being performed. In strict mode, some risky queries are not allowed to run.

hive.exec.script.maxerrsize

  • Default Value: 100000
  • Added In:

Maximum number of bytes a script is allowed to emit to standard error (per map-reduce task). This prevents runaway scripts from filling logs partitions to capacity.

hive.exec.script.allow.partial.consumption

  • Default Value: false
  • Added In:

When enabled, this option allows a user script to exit successfully without consuming all the data from the standard input.

hive.script.operator.id.env.var

  • Default Value: HIVE_SCRIPT_OPERATOR_ID
  • Added In:

Name of the environment variable that holds the unique script operator ID in the user's transform function (the custom mapper/reducer that the user has specified in the query).

hive.exec.compress.output

  • Default Value: false
  • Added In:

This controls whether the final outputs of a query (to a local/hdfs file or a hive table) is compressed. The compression codec and other options are determined from hadoop config variables mapred.output.compress*

hive.exec.compress.intermediate

  • Default Value: false
  • Added In:

This controls whether intermediate files produced by hive between multiple map-reduce jobs are compressed. The compression codec and other options are determined from hadoop config variables mapred.output.compress*

hive.exec.parallel

  • Default Value: false
  • Added In:

Whether to execute jobs in parallel.

hive.exec.parallel.thread.number

  • Default Value: 8
  • Added In:

How many jobs at most can be executed in parallel.

hive.exec.rowoffset

  • Default Value: false
  • Added In:

Whether to provide the row offset virtual column.

hive.task.progress

  • Default Value: false
  • Added In:

Whether Hive should periodically update task progress counters during execution. Enabling this allows task progress to be monitored more closely in the job tracker, but may impose a performance penalty. This flag is automatically set to true for jobs with hive.exec.dynamic.partition set to true.

hive.exec.pre.hooks

  • Default Value: (empty)
  • Added In:

Comma-separated list of pre-execution hooks to be invoked for each statement. A pre-execution hook is specified as the name of a Java class which implements the org.apache.hadoop.hive.ql.hooks.ExecuteWithHookContext interface.

hive.exec.post.hooks

  • Default Value: (empty)
  • Added In:

Comma-separated list of post-execution hooks to be invoked for each statement. A post-execution hook is specified as the name of a Java class which implements the org.apache.hadoop.hive.ql.hooks.ExecuteWithHookContext interface.

hive.exec.failure.hooks

  • Default Value: (empty)
  • Added In:

Comma-separated list of on-failure hooks to be invoked for each statement. An on-failure hook is specified as the name of Java class which implements the org.apache.hadoop.hive.ql.hooks.ExecuteWithHookContext interface.

hive.merge.mapfiles

  • Default Value: true
  • Added In:

Merge small files at the end of a map-only job.

hive.merge.mapredfiles

  • Default Value: false
  • Added In:

Merge small files at the end of a map-reduce job.

hive.mergejob.maponly

  • Default Value: true
  • Added In:

Try to generate a map-only job for merging files if CombineHiveInputFormat is supported.

hive.merge.size.per.task

  • Default Value: 256000000
  • Added In:

Size of merged files at the end of the job.

hive.merge.smallfiles.avgsize

  • Default Value: 16000000
  • Added In:

When the average output file size of a job is less than this number, Hive will start an additional map-reduce job to merge the output files into bigger files. This is only done for map-only jobs if hive.merge.mapfiles is true, and for map-reduce jobs if hive.merge.mapredfiles is true.

hive.mapjoin.smalltable.filesize

  • Default Value: 25000000
  • Added In:

The threshold for the input file size of the small tables; if the file size is smaller than this threshold, it will try to convert the common join into map join.

hive.mapjoin.localtask.max.memory.usage

  • Default Value: 0.90
  • Added In:

This number means how much memory the local task can take to hold the key/value into in-memory hash table; If the local task's memory usage is more than this number, the local task will be abort by themself. It means the data of small table is too large to be hold in the memory.

hive.mapjoin.followby.gby.localtask.max.memory.usage

  • Default Value: 0.55
  • Added In:

This number means how much memory the local task can take to hold the key/value into in-memory hash table when this map join followed by a group by; If the local task's memory usage is more than this number, the local task will be abort by themself. It means the data of small table is too large to be hold in the memory.

hive.mapjoin.check.memory.rows

  • Default Value: 100000
  • Added In:

The number means after how many rows processed it needs to check the memory usage.

hive.heartbeat.interval

  • Default Value: 1000
  • Added In:

Send a heartbeat after this interval - used by mapjoin and filter operators.

hive.auto.convert.join

  • Default Value: false
  • Added In:

Whether Hive enable the optimization about converting common join into mapjoin based on the input file size.

hive.script.auto.progress

  • Default Value: false
  • Added In:

Whether Hive Tranform/Map/Reduce Clause should automatically send progress information to TaskTracker to avoid the task getting killed because of inactivity. Hive sends progress information when the script is outputting to stderr. This option removes the need of periodically producing stderr messages, but users should be cautious because this may prevent TaskTracker from killing tasks with infinite loops.

hive.script.serde

  • Default Value: org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe
  • Added In:

The default SerDe for transmitting input data to and reading output data from the user scripts.

hive.script.recordreader

  • Default Value: org.apache.hadoop.hive.ql.exec.TextRecordReader
  • Added In:

The default record reader for reading data from the user scripts.

hive.script.recordwriter

  • Default Value: org.apache.hadoop.hive.ql.exec.TextRecordWriter
  • Added In:

The default record writer for writing data to the user scripts.

hive.input.format

  • Default Value: org.apache.hadoop.hive.ql.io.CombineHiveInputFormat
  • Added In:

The default input format. Set this to HiveInputFormat if you encounter problems with CombineHiveInputFormat.

hive.udtf.auto.progress

  • Default Value: false
  • Added In:

Whether Hive should automatically send progress information to TaskTracker when using UDTF's to prevent the task getting killed because of inactivity. Users should be cautious because this may prevent TaskTracker from killing tasks with infinte loops.

hive.mapred.reduce.tasks.speculative.execution

  • Default Value: true
  • Added In:

Whether speculative execution for reducers should be turned on.

hive.exec.counters.pull.interval

  • Default Value: 1000
  • Added In:

The interval with which to poll the JobTracker for the counters the running job. The smaller it is the more load there will be on the jobtracker, the higher it is the less granular the caught will be.

hive.enforce.bucketing

  • Default Value: false
  • Added In:

Whether bucketing is enforced. If true, while inserting into the table, bucketing is enforced.

hive.enforce.sorting

  • Default Value: false
  • Added In:

Whether sorting is enforced. If true, while inserting into the table, sorting is enforced.

hive.optimize.reducededuplication

  • Default Value: true
  • Added In:

Remove extra map-reduce jobs if the data is already clustered by the same key which needs to be used again. This should always be set to true. Since it is a new feature, it has been made configurable.

hive.exec.dynamic.partition

  • Default Value: false
  • Added In:

Whether or not to allow dynamic partitions in DML/DDL.

hive.exec.dynamic.partition.mode

  • Default Value: strict
  • Added In:

In strict mode, the user must specify at least one static partition in case the user accidentally overwrites all partitions.

hive.exec.max.dynamic.partitions

  • Default Value: 1000
  • Added In:

Maximum number of dynamic partitions allowed to be created in total.

hive.exec.max.dynamic.partitions.pernode

  • Default Value: 100
  • Added In:

Maximum number of dynamic partitions allowed to be created in each mapper/reducer node.

hive.exec.max.created.files

  • Default Value: 100000
  • Added In:

Maximum number of HDFS files created by all mappers/reducers in a MapReduce job.

hive.exec.default.partition.name

  • Default Value: __HIVE_DEFAULT_PARTITION__
  • Added In:

The default partition name in case the dynamic partition column value is null/empty string or anyother values that cannot be escaped. This value must not contain any special character used in HDFS URI (e.g., ':', '%', '/' etc). The user has to be aware that the dynamic partition value should not contain this value to avoid confusions.

hive.fetch.output.serde

  • Default Value: org.apache.hadoop.hive.serde2.DelimitedJSONSerDe
  • Added In:

The SerDe used by FetchTask to serialize the fetch output.

hive.exec.mode.local.auto

  • Default Value: false
  • Added In:

Let hive determine whether to run in local mode automatically.

hive.exec.drop.ignorenonexistent

  • Default Value: true
  • Added In:

Do not report an error if DROP TABLE/VIEW specifies a non-existent table/view.

hive.exec.show.job.failure.debug.info

  • Default Value: true
  • Added In:

If a job fails, whether to provide a link in the CLI to the task with the most failures, along with debugging hints if applicable.

hive.auto.progress.timeout

  • Default Value: 0
  • Added In:

How long to run autoprogressor for the script/UDTF operators (in seconds). Set to 0 for forever.

hive.table.parameters.default

  • Default Value: (empty)
  • Added In:

Default property values for newly created tables.

hive.variable.substitute

  • Default Value: true
  • Added In:

This enables substitution using syntax like ${var} ${system:var} and ${env:var}.

hive.error.on.empty.partition

  • Default Value: false
  • Added In:

Whether to throw an exception if dynamic partition insert generates empty results.

hive.exim.uri.scheme.whitelist

  • Default Value: hdfs,pfile
  • Added In:

A comma separated list of acceptable URI schemes for import and export.

hive.limit.row.max.size

  • Default Value: 100000
  • Added In:

When trying a smaller subset of data for simple LIMIT, how much size we need to guarantee each row to have at least.

hive.limit.optimize.limit.file

  • Default Value: 10
  • Added In:

When trying a smaller subset of data for simple LIMIT, maximum number of files we can sample.

hive.limit.optimize.enable

  • Default Value: false
  • Added In:

Whether to enable to optimization to trying a smaller subset of data for simple LIMIT first.

hive.limit.optimize.fetch.max

  • Default Value: 50000
  • Added In:

Maximum number of rows allowed for a smaller subset of data for simple LIMIT, if it is a fetch query. Insert queries are not restricted by this limit.

hive.rework.mapredwork

  • Default Value: false
  • Added In:

Should rework the mapred work or not. This is first introduced by SymlinkTextInputFormat to replace symlink files with real paths at compile time.

hive.sample.seednumber

  • Default Value: 0
  • Added In:

A number used to percentage sampling. By changing this number, user will change the subsets of data sampled.

hive.io.exception.handlers

  • Default Value: (empty)
  • Added In:

A list of io exception handler class names. This is used to construct a list of exception handlers to handle exceptions thrown by record readers.

hive.autogen.columnalias.prefix.label

  • Default Value: _c
  • Added In:

String used as a prefix when auto generating column alias. By default the prefix label will be appended with a column position number to form the column alias. Auto generation would happen if an aggregate function is used in a select clause without an explicit alias.

hive.autogen.columnalias.prefix.includefuncname

  • Default Value: false
  • Added In:

Whether to include function name in the column alias auto generated by hive.

hive.exec.perf.logger

  • Default Value: org.apache.hadoop.hive.ql.log.PerfLogger
  • Added In:

The class responsible logging client side performance metrics. Must be a subclass of org.apache.hadoop.hive.ql.log.PerfLogger.

hive.start.cleanup.scratchdir

  • Default Value: false
  • Added In:

To cleanup the hive scratchdir while starting the hive server.

hive.output.file.extension

  • Default Value: (empty)
  • Added In:

String used as a file extension for output files. If not set, defaults to the codec extension for text files (e.g. ".gz"), or no extension otherwise.

hive.insert.into.multilevel.dirs

  • Default Value: false
  • Added In:

Where to insert into multilevel directories like "insert directory '/HIVEFT25686/chinna/' from table".

hive.files.umask.value

  • Default Value: 0002
  • Added In:

The dfs.umask value for the hive created folders.

MetaStore

hive.metastore.local

Controls whether to connect to remote metastore server or open a new metastore server in Hive Client JVM. As of Hive 0.10 this is no longer used. Instead if hive.metastore.uris is set then remote mode is assumed; otherwise local.

javax.jdo.option.ConnectionURL

  • Default Value: jdbc:derby:;databaseName=metastore_db;create=true
  • Added In:

JDBC connect string for a JDBC metastore.

javax.jdo.option.ConnectionDriverName

  • Default Value: org.apache.derby.jdbc.EmbeddedDriver
  • Added In:

Driver class name for a JDBC metastore.

javax.jdo.PersistenceManagerFactoryClass

  • Default Value: org.datanucleus.jdo.JDOPersistenceManagerFactory
  • Added In:

Class implementing the JDO PersistenceManagerFactory.

javax.jdo.option.DetachAllOnCommit

  • Default Value: true
  • Added In:

Detaches all objects from session so that they can be used after transaction is committed.

javax.jdo.option.NonTransactionalRead

  • Default Value: true
  • Added In:

Reads outside of transactions.

javax.jdo.option.ConnectionUserName

  • Default Value: APP
  • Added In:

Username to use against metastore database.

javax.jdo.option.ConnectionPassword

  • Default Value: mine
  • Added In:

Password to use against metastore database.

javax.jdo.option.Multithreaded

  • Default Value: true
  • Added In:

Set this to true if multiple threads access metastore through JDO concurrently.

datanucleus.connectionPoolingType

  • Default Value: DBCP
  • Added In:

Uses a DBCP connection pool for JDBC metastore.

datanucleus.validateTables

  • Default Value: false
  • Added In:

Validates existing schema against code. Turn this on if you want to verify existing schema.

datanucleus.validateColumns

  • Default Value: false
  • Added In:

Validates existing schema against code. Turn this on if you want to verify existing schema.

datanucleus.validateConstraints

  • Default Value: false
  • Added In:

Validates existing schema against code. Turn this on if you want to verify existing schema.

datanucleus.storeManagerType

  • Default Value: rdbms
  • Added In:

Metadata store type.

datanucleus.autoCreateSchema

  • Default Value: true
  • Added In:

Creates necessary schema on a startup if one doesn't exist. set this to false, after creating it once.

datanucleus.autoStartMechanismMode

  • Default Value: checked
  • Added In:

Throw exception if metadata tables are incorrect.

datanucleus.transactionIsolation

  • Default Value: read-committed
  • Added In:

Default transaction isolation level for identity generation.

datanucleus.cache.level2

  • Default Value: false
  • Added In:

Use a level 2 cache. Turn this off if metadata is changed independently of hive metastore server.

datanucleus.cache.level2.type

  • Default Value: SOFT
  • Added In:

SOFT=soft reference based cache, WEAK=weak reference based cache.

datanucleus.identifierFactory

  • Default Value: datanucleus
  • Added In:

Name of the identifier factory to use when generating table/column names etc. 'datanucleus' is used for backward compatibility.

datanucleus.plugin.pluginRegistryBundleCheck

  • Default Value: LOG
  • Added In:

Defines what happens when plugin bundles are found and are duplicated EXCEPTION.

hive.metastore.warehouse.dir

  • Default Value: /user/hive/warehouse
  • Added In:

Location of default database for the warehouse.

hive.metastore.execute.setugi

  • Default Value: false
  • Added In:

In unsecure mode, setting this property to true will cause the metastore to execute DFS operations using the client's reported user and group permissions. Note that this property must be set on both the client and server sides. Further note that its best effort. If client sets its to true and server sets it to false, client setting will be ignored.

hive.metastore.event.listeners

  • Default Value: (empty)
  • Added In:

List of comma separated listeners for metastore events.

hive.metastore.partition.inherit.table.properties

  • Default Value: (empty)
  • Added In:

List of comma separated keys occurring in table properties which will get inherited to newly created partitions. * implies all the keys will get inherited.

hive.metastore.end.function.listeners

  • Default Value: (empty)
  • Added In:

List of comma separated listeners for the end of metastore functions.

hive.metastore.event.expiry.duration

  • Default Value: 0
  • Added In:

Duration after which events expire from events table (in seconds).

hive.metastore.event.clean.freq

  • Default Value: 0
  • Added In:

Frequency at which timer task runs to purge expired events in metastore (in seconds).

hive.metastore.connect.retries

  • Default Value: 5
  • Added In:

Number of retries while opening a connection to metastore.

hive.metastore.client.connect.retry.delay

  • Default Value: 1
  • Added In:

Number of seconds for the client to wait between consecutive connection attempts.

hive.metastore.client.socket.timeout

  • Default Value: 20
  • Added In:

MetaStore Client socket timeout in seconds.

hive.metastore.rawstore.impl

  • Default Value: org.apache.hadoop.hive.metastore.ObjectStore
  • Added In:

Name of the class that implements org.apache.hadoop.hive.metastore.rawstore interface. This class is used to store and retrieval of raw metadata objects such as table, database.

hive.metastore.batch.retrieve.max

  • Default Value: 300
  • Added In:

Maximum number of objects (tables/partitions) that can be retrieved from metastore in one batch. The higher the number, the fewer round trips are needed to the Hive metastore server, but it may also cause higher memory requirement at the client side.

hive.metastore.ds.connection.url.hook

  • Default Value: (empty)
  • Added In:

Name of the hook to use for retriving the JDO connection URL. If empty, the value in javax.jdo.option.ConnectionURL is used.

hive.metastore.ds.retry.attempts

  • Default Value: 1
  • Added In:

The number of times to retry a metastore call if there were a connection error.

hive.metastore.ds.retry.interval

  • Default Value: 1000
  • Added In:

The number of miliseconds between metastore retry attempts.

hive.metastore.server.min.threads

  • Default Value: 200
  • Added In:

Minimum number of worker threads in the Thrift server's pool.

hive.metastore.server.max.threads

  • Default Value: 100000
  • Added In:

Maximum number of worker threads in the Thrift server's pool.

hive.metastore.server.tcp.keepalive

  • Default Value: true
  • Added In:

Whether to enable TCP keepalive for the metastore server. Keepalive will prevent accumulation of half-open connections.

hive.metastore.sasl.enabled

  • Default Value: false
  • Added In:

If true, the metastore thrift interface will be secured with SASL. Clients must authenticate with Kerberos.

hive.metastore.kerberos.keytab.file

  • Default Value: (empty)
  • Added In:

The path to the Kerberos Keytab file containing the metastore thrift server's service principal.

hive.metastore.kerberos.principal

  • Default Value: hive-metastore/_HOST@EXAMPLE.COM
  • Added In:

The service principal for the metastore thrift server. The special string _HOST will be replaced automatically with the correct host name.

hive.metastore.cache.pinobjtypes

  • Default Value: Table,StorageDescriptor,SerDeInfo,Partition,Database,Type,FieldSchema,Order
  • Added In:

List of comma separated metastore object types that should be pinned in the cache.

hive.metastore.authorization.storage.checks

  • Default Value: false
  • Added In:

Should the metastore do authorization checks against the underlying storage for operations like drop-partition (disallow the drop-partition if the user in question doesn't have permissions to delete the corresponding directory on the storage).

Indexing

hive.index.compact.file.ignore.hdfs

  • Default Value: false
  • Added In:

If true, the hdfs location stored in the index file will be ignored at runtime. If the data got moved or the name of the cluster got changed, the index data should still be usable.

hive.optimize.index.filter.compact.minsize

  • Default Value: 5368709120
  • Added In:

Minimum size (in bytes) of the inputs on which a compact index is automatically used.

hive.optimize.index.filter.compact.maxsize

  • Default Value: -1
  • Added In:

Maximum size (in bytes) of the inputs on which a compact index is automatically used. A negative number is equivalent to infinity.

hive.index.compact.query.max.size

  • Default Value: 10737418240
  • Added In:

The maximum number of bytes that a query using the compact index can read. Negative value is equivalent to infinity.

hive.index.compact.query.max.entries

  • Default Value: 10000000
  • Added In:

The maximum number of index entries to read during a query that uses the compact index. Negative value is equivalent to infinity.

hive.index.compact.binary.search

  • Default Value: true
  • Added In:

Whether or not to use a binary search to find the entries in an index table that match the filter, where possible.

hive.exec.concatenate.check.index

  • Default Value: true
  • Added In:

If true, hive will throw error when doing ALTER TABLE tbl_name partSpec CONCATENATE on a table/partition that has indexes on it. The reason the user want to set this to true is because it can help user to avoid handling all index drop, recreation, rebuild work. This is very helpful for tables with thousands of partitions.

Statistics

hive.stats.dbclass

  • Default Value: jdbc:derby
  • Added In:

The default database that stores temporary hive statistics.

hive.stats.autogather

  • Default Value: true
  • Added In:

A flag to gather statistics automatically during the INSERT OVERWRITE command.

hive.stats.jdbcdriver

  • Default Value: org.apache.derby.jdbc.EmbeddedDriver
  • Added In:

The JDBC driver for the database that stores temporary hive statistics.

hive.stats.dbconnectionstring

  • Default Value: jdbc:derby:;databaseName=TempStatsStore;create=true
  • Added In:

The default connection string for the database that stores temporary hive statistics.

hive.stats.default.publisher

  • Default Value: (empty)
  • Added In:

The Java class (implementing the StatsPublisher interface) that is used by default if hive.stats.dbclass is not JDBC or HBase.

hive.stats.default.aggregator

  • Default Value: (empty)
  • Added In:

The Java class (implementing the StatsAggregator interface) that is used by default if hive.stats.dbclass is not JDBC or HBase.

hive.stats.jdbc.timeout

  • Default Value: 30
  • Added In:

Timeout value (number of seconds) used by JDBC connection and statements.

hive.stats.retries.max

  • Default Value: 0
  • Added In:

Maximum number of retries when stats publisher/aggregator got an exception updating intermediate database. Default is no tries on failures.

hive.stats.retries.wait

  • Default Value: 3000
  • Added In:

The base waiting window (in milliseconds) before the next retry. The actual wait time is calculated by baseWindow * failues + baseWindow * (failure + 1) * (random number between 0.0,1.0).

hive.client.stats.publishers

  • Default Value: (empty)
  • Added In:

Comma-separated list of statistics publishers to be invoked on counters on each job. A client stats publisher is specified as the name of a Java class which implements the org.apache.hadoop.hive.ql.stats.ClientStatsPublisher interface.

hive.client.stats.counters

  • Default Value: (empty)
  • Added In:

Subset of counters that should be of interest for hive.client.stats.publishers (when one wants to limit their publishing). Non-display names should be used.

Authentication/Authorization

Hive Client Security

hive.security.authorization.enabled

  • Default Value: false
  • Added In:

Enable or disable the Hive client authorization and authentication.

hive.security.authorization.manager

  • Default Value: org.apache.hadoop.hive.ql.security.authorization.DefaultHiveAuthorizationProvider
  • Added In:

The Hive client authorization manager class name. The user-defined authorization class should implement interface org.apache.hadoop.hive.ql.security.authorization.HiveAuthorizationProvider.

hive.security.authenticator.manager

  • Default Value: org.apache.hadoop.hive.ql.security.HadoopDefaultAuthenticator
  • Added In:

Hive client authenticator manager class name. The user-defined authenticator class should implement interface org.apache.hadoop.hive.ql.security.HiveAuthenticationProvider.

hive.security.authorization.createtable.user.grants

  • Default Value: (empty)
  • Added In:

The privileges automatically granted to some users whenever a table gets created. An example like "userX,userY:select;userZ:create" will grant select privilege to userX and userY, and grant create privilege to userZ whenever a new table is created.

hive.security.authorization.createtable.group.grants

  • Default Value: (empty)
  • Added In:

The privileges automatically granted to some groups whenever a table gets created. An example like "groupX,groupY:select;groupZ:create" will grant select privilege to groupX and groupY, and grant create privilege to groupZ whenever a new table is created.

hive.security.authorization.createtable.role.grants

  • Default Value: (empty)
  • Added In:

The privileges automatically granted to some roles whenever a table gets created. An example like "roleX,roleY:select;roleZ:create" will grant select privilege to roleX and roleY, and grant create privilege to roleZ whenever a new table is created.

hive.security.authorization.createtable.owner.grants

  • Default Value: (empty)
  • Added In:

The privileges automatically granted to the owner whenever a table gets created. An example like "select,drop" will grant select and drop privileges to the owner of the table.

Hive Metastore Security

hive.security.metastore.authorization.manager

  • Default Value: org.apache.hadoop.hive.ql.security.authorization.DefaultHiveMetastoreAuthorizationProvider
  • Added In: Hive 0.10

The authorization manager class name to be used in the metastore for authorization. The user-defined authorization class should implement interface org.apache.hadoop.hive.ql.security.authorization.HiveMetastoreAuthorizationProvider.

A storage-based authorization implementation is provided to use as the value of this parameter:

  • org.apache.hadoop.hive.ql.security.authorization.StorageBasedAuthorizationProvider

which uses HDFS permissions to provide authorization instead of using Hive-style grant-based authorization.

hive.security.metastore.authenticator.manager

  • Default Value: org.apache.hadoop.hive.ql.security.HadoopDefaultMetastoreAuthenticator
  • Added In: Hive 0.10

The authenticator manager class name to be used in the metastore for authentication. The user-defined authenticator class should implement interface org.apache.hadoop.hive.ql.security.HiveAuthenticationProvider.

hive.metastore.pre.event.listeners

  • Default Value: (empty)
  • Added In:

The pre-event listener classes to be loaded on the metastore side to run code whenever databases, tables, and partitions are created, altered, or dropped. Set this parameter to org.apache.hadoop.hive.ql.security.authorization.AuthorizationPreEventListener in hive-site.xml for Hive metastore security.

Archiving

fs.har.impl

  • Default Value: org.apache.hadoop.hive.shims.HiveHarFileSystem
  • Added In:

The implementation for accessing Hadoop Archives. Note that this won't be applicable to Hadoop versions less than 0.20.

hive.archive.enabled

  • Default Value: false
  • Added In:

Whether archiving operations are permitted.

hive.archive.har.parentdir.settable

  • Default Value: false
  • Added In:

In new Hadoop versions, the parent directory must be set while creating a HAR. Because this functionality is hard to detect with just version numbers, this conf var needs to be set manually.

Locking

hive.support.concurrency

  • Default Value: false
  • Added In:

Whether hive supports concurrency or not. A zookeeper instance must be up and running for the default hive lock manager to support read-write locks.

hive.lock.mapred.only.operation

  • Default Value: false
  • Added In:

This parameter controls whether or not to only do lock on queries that need to execute at least one mapred job.

hive.lock.numretries

  • Default Value: 100
  • Added In:

The number of times you want to try to get all the locks.

hive.unlock.numretries

  • Default Value: 10
  • Added In:

The number of times you want to retry to do one unlock.

hive.lock.sleep.between.retries

  • Default Value: 60
  • Added In:

The sleep time (in seconds) between various retries.

hive.zookeeper.quorum

  • Default Value: (empty)
  • Added In:

The list of zookeeper servers to talk to. This is only needed for read/write locks.

hive.zookeeper.client.port

  • Default Value: 2181
  • Added In:

The port of zookeeper servers to talk to. This is only needed for read/write locks.

hive.zookeeper.session.timeout

  • Default Value: 600000
  • Added In:

Zookeeper client's session timeout. The client is disconnected, and as a result, all locks released, if a heartbeat is not sent in the timeout.

hive.zookeeper.namespace

  • Default Value: hive_zookeeper_namespace
  • Added In:

The parent node under which all zookeeper nodes are created.

hive.zookeeper.clean.extra.nodes

  • Default Value: false
  • Added In:

Clean extra nodes at the end of the session.

Clustering

hive.cluster.delegation.token.store.class

  • Default Value: org.apache.hadoop.hive.thrift.MemoryTokenStore
  • Added In:

The delegation token store implementation. Set to org.apache.hadoop.hive.thrift.ZooKeeperTokenStore for load-balanced cluster.

hive.cluster.delegation.token.store.zookeeper.connectString

  • Default Value: localhost:2181
  • Added In:

The ZooKeeper token store connect string.

hive.cluster.delegation.token.store.zookeeper.znode

  • Default Value: /hive/cluster/delegation
  • Added In:

The root path for token store data.

hive.cluster.delegation.token.store.zookeeper.acl

  • Default Value: sasl:hive/host1@EXAMPLE.COM:cdrwa,sasl:hive/host2@EXAMPLE.COM:cdrwa
  • Added In:

ACL for token store entries. List comma separated all server principals for the cluster.

Regions

hive.use.input.primary.region

  • Default Value: true
  • Added In:

When creating a table from an input table, create the table in the input table's primary region.

hive.default.region.name

  • Default Value: default
  • Added In:

The default region name.

hive.region.properties

  • Default Value: (empty)
  • Added In:

The default filesystem and jobtracker for a region.

Command Line Interface

hive.cli.print.header

  • Default Value: false
  • Added In:

Whether to print the names of the columns in query output.

hive.cli.print.current.db

  • Default Value: false
  • Added In:

Whether to include the current database in the hive prompt.

HBase StorageHandler

hive.hbase.wal.enabled

  • Default Value: true
  • Added In:

Whether writes to HBase should be forced to the write-ahead log. Disabling this improves HBase write performance at the risk of lost writes in case of a crash.

Hive Web Interface (HWI)

hive.hwi.war.file

  • Default Value: lib/hive-hwi-@VERSION@.war
  • Added In:

This sets the path to the HWI war file, relative to ${HIVE_HOME}.

hive.hwi.listen.host

  • Default Value: 0.0.0.0
  • Added In:

This is the host address the Hive Web Interface will listen on.

hive.hwi.listen.port

  • Default Value: 9999
  • Added In:

This is the port the Hive Web Interface will listen on.

Test Properties

hive.test.mode

  • Default Value: false
  • Added In:

Whether hive is running in test mode. If true, it turns on sampling and prefixes the output tablename.

hive.test.mode.prefix

  • Default Value: test_
  • Added In:

If hive is running in test mode, prefixes the output table by this string.

hive.test.mode.samplefreq

  • Default Value: 32
  • Added In:

If hive is running in test mode and table is not bucketed, sampling frequency.

hive.test.mode.nosamplelist

  • Default Value: (empty)
  • Added In:

If hive is running in test mode, don't sample the above comma separated list of tables.