Spark调优 | Spark SQL参数调优

分手后的思念是犯贱 2021-11-23 07:28 656阅读 0赞

**前言**  
Spark SQL里面有很多的参数，而且这些参数在Spark官网中没有明确的解释，可能是太多了吧，可以通过在spark-sql中使用set -v 命令显示当前spark-sql版本支持的参数。

本文讲解最近关于在参与hive往spark迁移过程中遇到的一些参数相关问题的调优。

内容分为两部分，第一部分讲遇到异常，从而需要通过设置参数来解决的调优；第二部分讲用于提升性能而进行的调优。

**异常调优**  
spark.sql.hive.convertMetastoreParquet  
parquet是一种列式存储格式，可以用于spark-sql 和hive 的存储格式。在spark中，如果使用using parquet的形式创建表，则创建的是spark 的DataSource表；而如果使用stored as parquet则创建的是hive表。

spark.sql.hive.convertMetastoreParquet默认设置是true, 它代表使用spark-sql内置的parquet的reader和writer(即进行反序列化和序列化),它具有更好地性能，如果设置为false，则代表使用 Hive的序列化方式。

但是有时候当其设置为true时，会出现使用hive查询表有数据，而使用spark查询为空的情况.

但是，有些情况下在将spark.sql.hive.convertMetastoreParquet设为false，可能发生以下异常(spark-2.3.2)。

java.lang.ClassCastException: org.apache.hadoop.io.LongWritable cannot be cast to org.apache.hadoop.io.IntWritable
        at org.apache.hadoop.hive.serde2.objectinspector.primitive.WritableIntObjectInspector.get(WritableIntObjectInspector.java:36)

这是因为在其为false时候，是使用hive-metastore使用的元数据进行读取数据，而如果此表是使用spark sql DataSource创建的parquet表，其数据类型可能出现不一致的情况，例如通过metaStore读取到的是IntWritable类型，其创建了一个WritableIntObjectInspector用来解析数据，而实际上value是LongWritable类型，因此出现了类型转换异常。

与该参数相关的一个参数是spark.sql.hive.convertMetastoreParquet.mergeSchema, 如果也是true，那么将会尝试合并各个parquet 文件的schema，以使得产生一个兼容所有parquet文件的schema。

spark.sql.files.ignoreMissingFiles && spark.sql.files.ignoreCorruptFiles  
这两个参数是只有在进行spark DataSource 表查询的时候才有效，如果是对hive表进行操作是无效的。

在进行spark DataSource 表查询时候，可能会遇到非分区表中的文件缺失/corrupt 或者分区表分区路径下的文件缺失/corrupt 异常，这时候加这两个参数会忽略这两个异常，这两个参数默认都是false，建议在线上可以都设为true.

其源码逻辑如下，简单描述就是如果遇到FileNotFoundException, 如果设置了ignoreMissingFiles=true则忽略异常，否则抛出异常;如果不是FileNotFoundException 而是IOException(FileNotFoundException的父类)或者RuntimeException,则认为文件损坏,如果设置了ignoreCorruptFiles=true则忽略异常。

catch {
    case e: FileNotFoundException if ignoreMissingFiles =>
      logWarning(s"Skipped missing file: $currentFile", e)
      finished = true
      null
    // Throw FileNotFoundException even if `ignoreCorruptFiles` is true
    case e: FileNotFoundException if !ignoreMissingFiles => throw e
    case e @ (_: RuntimeException | _: IOException) if ignoreCorruptFiles =>
      logWarning(
      s"Skipped the rest of the content in the corrupted file: $currentFile", e)
      finished = true
      null
      }

spark.sql.hive.verifyPartitionPath  
上面的两个参数在分区表情况下是针对分区路径存在的情况下，分区路径下面的文件不存在或者损坏的处理。而有另一种情况就是这个分区路径都不存在了。这时候异常信息如下:

java.io.FileNotFoundException: File does not exist: hdfs://hz-cluster10/user/da_haitao/da_hivesrc/haitao_dev_log/integ_browse_app_dt/day=2019-06-25/os=Android/000067_0

而spark.sql.hive.verifyPartitionPath参数默认是false，当设置为true的时候会在获得分区路径时对分区路径是否存在做一个校验，过滤掉不存在的分区路径，这样就会避免上面的错误。

spark.files.ignoreCorruptFiles && spark.files.ignoreMissingFiles  
这两个参数和上面的spark.sql.files.ignoreCorruptFiles很像，但是区别是很大的。在spark进行DataSource表查询时候spark.sq.files.\*才会生效，而spark如果查询的是一张hive表，其会走HadoopRDD这条执行路线。

所以就会出现，即使你设置了spark.sql.files.ignoreMissingFiles的情况下，仍然报FileNotFoundException的情况，异常栈如下, 可以看到这里面走到了HadoopRDD，而且后面是org.apache.hadoop.hive.ql.io.parquet.read.ParquetRecordReaderWrappe可见是查询一张hive表。

Caused by: org.apache.spark.SparkException: Job aborted due to stage failure: Task 107052 in stage 914.0 failed 4 times, most recent failure: Lost task 107052.3 in stage 914.0 (TID 387381, hadoop2698.jd.163.org, executor 266): java.io.FileNotFoundException: File does not exist: hdfs://hz-cluster10/user/da_haitao/da_hivesrc/haitao_dev_log/integ_browse_app_dt/day=2019-06-25/os=Android/000067_0
            at org.apache.hadoop.hdfs.DistributedFileSystem$22.doCall(DistributedFileSystem.java:1309)
            at org.apache.hadoop.hdfs.DistributedFileSystem$22.doCall(DistributedFileSystem.java:1301)
            at org.apache.hadoop.fs.FileSystemLinkResolver.resolve(FileSystemLinkResolver.java:81)
            at org.apache.hadoop.hdfs.DistributedFileSystem.getFileStatus(DistributedFileSystem.java:1317)
            at parquet.hadoop.ParquetFileReader.readFooter(ParquetFileReader.java:385)
            at parquet.hadoop.ParquetFileReader.readFooter(ParquetFileReader.java:371)
            at org.apache.hadoop.hive.ql.io.parquet.read.ParquetRecordReaderWrapper.getSplit(ParquetRecordReaderWrapper.java:252)
            at org.apache.hadoop.hive.ql.io.parquet.read.ParquetRecordReaderWrapper.<init>(ParquetRecordReaderWrapper.java:99)
            at org.apache.hadoop.hive.ql.io.parquet.read.ParquetRecordReaderWrapper.<init>(ParquetRecordReaderWrapper.java:85)
            at org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat.getRecordReader(MapredParquetInputFormat.java:72)
            at org.apache.spark.rdd.HadoopRDD$$anon$1.liftedTree1$1(HadoopRDD.scala:257)

此时可以将spark.files.ignoreCorruptFiles && spark.files.ignoreMissingFiles设为true，其代码逻辑和上面的spark.sql.file.\*逻辑没明显区别，此处不再赘述。

性能调优

除了遇到异常需要被动调整参数之外，我们还可以主动调整参数从而对性能进行调优。

spark.hadoopRDD.ignoreEmptySplits  
默认是false，如果是true，则会忽略那些空的splits，减小task的数量。

spark.hadoop.mapreduce.input.fileinputformat.split.minsize  
是用于聚合input的小文件，用于控制每个mapTask的输入文件，防止小文件过多时候，产生太多的task.

spark.sql.autoBroadcastJoinThreshold && spark.sql.broadcastTimeout  
用于控制在spark sql中使用BroadcastJoin时候表的大小阈值，适当增大可以让一些表走BroadcastJoin，提升性能，但是如果设置太大又会造成driver内存压力，而broadcastTimeout是用于控制Broadcast的Future的超时时间，默认是300s，可根据需求进行调整。

spark.sql.adaptive.enabled && spark.sql.adaptive.shuffle.targetPostShuffleInputSize  
该参数是用于开启spark的自适应执行，这是spark比较老版本的自适应执行，后面的targetPostShuffleInputSize是用于控制之后的shuffle 阶段的平均输入数据大小，防止产生过多的task。

intel大数据团队开发的adaptive-execution相较于目前spark的ae更加实用，该特性也已经加入到社区3.0之后的roadMap中，令人期待。

spark.sql.parquet.mergeSchema  
默认false。当设为true，parquet会聚合所有parquet文件的schema，否则是直接读取parquet summary文件，或者在没有parquet summary文件时候随机选择一个文件的schema作为最终的schema。

spark.sql.files.opencostInBytes  
该参数默认4M，表示小于4M的小文件会合并到一个分区中，用于减小小文件，防止太多单个小文件占一个分区情况。

spark.hadoop.mapreduce.fileoutputcommitter.algorithm.version  
1或者2，默认是1. MapReduce-4815 详细介绍了 fileoutputcommitter 的原理，实践中设置了 version=2 的比默认 version=1 的减少了70%以上的 commit 时间，但是1更健壮，能处理一些情况下的异常。

**Spark SQL 参数表(spark-2.3.2)**

<table> 
 <thead> 
  <tr> 
   <th>key</th> 
   <th>value</th> 
   <th>meaning</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>spark.sql.adaptive.enabled</td> 
   <td>TRUE</td> 
   <td>When true, enable adaptive query execution.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.adaptive.shuffle.targetPostShuffleInputSize</td> 
   <td>67108864b</td> 
   <td>The target post-shuffle input size in bytes of a task.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.autoBroadcastJoinThreshold</td> 
   <td>209715200</td> 
   <td>Configures the maximum size in bytes for a table that will be broadcast to all worker nodes when performing a join. By setting this value to -1 broadcasting can be disabled. Note that currently statistics are only supported for Hive Metastore tables where the command&nbsp;ANALYZE TABLE COMPUTE STATISTICS noscanhas been run, and file-based data source tables where the statistics are computed directly on the files of data.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.broadcastTimeout</td> 
   <td>300000ms</td> 
   <td>Timeout in seconds for the broadcast wait time in broadcast joins.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.cbo.enabled</td> 
   <td>FALSE</td> 
   <td>Enables CBO for estimation of plan statistics when set true.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.cbo.joinReorder.dp.star.filter</td> 
   <td>FALSE</td> 
   <td>Applies star-join filter heuristics to cost based join enumeration.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.cbo.joinReorder.dp.threshold</td> 
   <td>12</td> 
   <td>The maximum number of joined nodes allowed in the dynamic programming algorithm.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.cbo.joinReorder.enabled</td> 
   <td>FALSE</td> 
   <td>Enables join reorder in CBO.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.cbo.starSchemaDetection</td> 
   <td>FALSE</td> 
   <td>When true, it enables join reordering based on star schema detection.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.columnNameOfCorruptRecord</td> 
   <td>_corrupt_record</td> 
   <td>The name of internal column for storing raw/un-parsed JSON and CSV records that fail to parse.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.crossJoin.enabled</td> 
   <td>TRUE</td> 
   <td>When false, we will throw an error if a query contains a cartesian product without explicit CROSS JOIN syntax.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.execution.arrow.enabled</td> 
   <td>FALSE</td> 
   <td>When true, make use of Apache Arrow for columnar data transfers. Currently available for use with pyspark.sql.DataFrame.toPandas, and pyspark.sql.SparkSession.createDataFrame when its input is a Pandas DataFrame. The following data types are unsupported: BinaryType, MapType, ArrayType of TimestampType, and nested StructType.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.execution.arrow.maxRecordsPerBatch</td> 
   <td>10000</td> 
   <td>When using Apache Arrow, limit the maximum number of records that can be written to a single ArrowRecordBatch in memory. If set to zero or negative there is no limit.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.extensions</td> 
   <td></td> 
   <td>Name of the class used to configure Spark Session extensions. The class should implement Function1[SparkSessionExtension, Unit], and must have a no-args constructor.</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>spark.sql.files.ignoreCorruptFiles</td> 
   <td>FALSE</td> 
   <td>Whether to ignore corrupt files. If true, the Spark jobs will continue to run when encountering corrupted files and the contents that have been read will still be returned.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.files.ignoreMissingFiles</td> 
   <td>FALSE</td> 
   <td>Whether to ignore missing files. If true, the Spark jobs will continue to run when encountering missing files and the contents that have been read will still be returned.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.files.maxPartitionBytes</td> 
   <td>134217728</td> 
   <td>The maximum number of bytes to pack into a single partition when reading files.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.files.maxRecordsPerFile</td> 
   <td>0</td> 
   <td>Maximum number of records to write out to a single file. If this value is zero or negative, there is no limit.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.function.concatBinaryAsString</td> 
   <td>FALSE</td> 
   <td>When this option is set to false and all inputs are binary,functions.concat&nbsp;returns an output as binary. Otherwise, it returns as a string.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.function.eltOutputAsString</td> 
   <td>FALSE</td> 
   <td>When this option is set to false and all inputs are binary,&nbsp;elt&nbsp;returns an output as binary. Otherwise, it returns as a string.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.groupByAliases</td> 
   <td>TRUE</td> 
   <td>When true, aliases in a select list can be used in group by clauses. When false, an analysis exception is thrown in the case.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.groupByOrdinal</td> 
   <td>TRUE</td> 
   <td>When true, the ordinal numbers in group by clauses are treated as the position in the select list. When false, the ordinal numbers are ignored.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.caseSensitiveInferenceMode</td> 
   <td>INFER_AND_SAVE</td> 
   <td>Sets the action to take when a case-sensitive schema cannot be read from a Hive table’s properties. Although Spark SQL itself is not case-sensitive, Hive compatible file formats such as Parquet are. Spark SQL must use a case-preserving schema when querying any table backed by files containing case-sensitive field names or queries may not return accurate results. Valid options include INFER_AND_SAVE (the default mode– infer the case-sensitive schema from the underlying data files and write it back to the table properties), INFER_ONLY (infer the schema but don’t attempt to write it to the table properties) and NEVER_INFER (fallback to using the case-insensitive metastore schema instead of inferring).</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.convertMetastoreParquet</td> 
   <td>TRUE</td> 
   <td>When set to true, the built-in Parquet reader and writer are used to process parquet tables created by using the HiveQL syntax, instead of Hive serde.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.convertMetastoreParquet.mergeSchema</td> 
   <td>FALSE</td> 
   <td>When true, also tries to merge possibly different but compatible Parquet schemas in different Parquet data files. This configuration is only effective when “spark.sql.hive.convertMetastoreParquet” is true.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.filesourcePartitionFileCacheSize</td> 
   <td>262144000</td> 
   <td>When nonzero, enable caching of partition file metadata in memory. All tables share a cache that can use up to specified num bytes for file metadata. This conf only has an effect when hive filesource partition management is enabled.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.manageFilesourcePartitions</td> 
   <td>TRUE</td> 
   <td>When true, enable metastore partition management for file source tables as well. This includes both datasource and converted Hive tables. When partition management is enabled, datasource tables store partition in the Hive metastore, and use the metastore to prune partitions during query planning.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.metastore.barrierPrefixes</td> 
   <td></td> 
   <td>A comma separated list of class prefixes that should explicitly be reloaded for each version of Hive that Spark SQL is communicating with. For example, Hive UDFs that are declared in a prefix that typically would be shared (i.e.&nbsp;org.apache.spark.*).</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.metastore.jars</td> 
   <td>builtin</td> 
   <td>Location of the jars that should be used to instantiate the HiveMetastoreClient. This property can be one of three options: “ 1. “builtin” Use Hive 1.2.1, which is bundled with the Spark assembly when&nbsp;-Phive&nbsp;is enabled. When this option is chosen,&nbsp;spark.sql.hive.metastore.versionmust be either&nbsp;1.2.1&nbsp;or not defined. 2. “maven” Use Hive jars of specified version downloaded from Maven repositories. 3. A classpath in the standard format for both Hive and Hadoop.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.metastore.sharedPrefixes</td> 
   <td>com.mysql.jdbc,</td> 
   <td>A comma separated list of class prefixes that should be loaded using the classloader that is shared between Spark SQL and a specific version of Hive. An example of classes that should be shared is JDBC drivers that are needed to talk to the metastore. Other classes that need to be shared are those that interact with classes that are already shared. For example, custom appenders that are used by log4j.</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>org.postgresql,</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>com.microsoft.sqlserver,</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>oracle.jdbc</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.metastore.version</td> 
   <td>1.2.1</td> 
   <td>Version of the Hive metastore. Available options are0.12.0&nbsp;through&nbsp;2.1.1.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.metastorePartitionPruning</td> 
   <td>TRUE</td> 
   <td>When true, some predicates will be pushed down into the Hive metastore so that unmatching partitions can be eliminated earlier. This only affects Hive tables not converted to filesource relations (see HiveUtils.CONVERT_METASTORE_PARQUET and HiveUtils.CONVERT_METASTORE_ORC for more information).</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.thriftServer.async</td> 
   <td>TRUE</td> 
   <td>When set to true, Hive Thrift server executes SQL queries in an asynchronous way.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.thriftServer.singleSession</td> 
   <td>FALSE</td> 
   <td>When set to true, Hive Thrift server is running in a single session mode. All the JDBC/ODBC connections share the temporary views, function registries, SQL configuration and the current database.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.verifyPartitionPath</td> 
   <td>FALSE</td> 
   <td>When true, check all the partition paths under the table’s root directory when reading data stored in HDFS.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.hive.version</td> 
   <td>1.2.1</td> 
   <td>deprecated, please use spark.sql.hive.metastore.version to get the Hive version in Spark.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.inMemoryColumnarStorage.batchSize</td> 
   <td>10000</td> 
   <td>Controls the size of batches for columnar caching. Larger batch sizes can improve memory utilization and compression, but risk OOMs when caching data.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.inMemoryColumnarStorage.compressed</td> 
   <td>TRUE</td> 
   <td>When set to true Spark SQL will automatically select a compression codec for each column based on statistics of the data.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.inMemoryColumnarStorage.enableVectorizedReader</td> 
   <td>TRUE</td> 
   <td>Enables vectorized reader for columnar caching.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.optimizer.metadataOnly</td> 
   <td>TRUE</td> 
   <td>When true, enable the metadata-only query optimization that use the table’s metadata to produce the partition columns instead of table scans. It applies when all the columns scanned are partition columns and the query has an aggregate operator that satisfies distinct semantics.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.orc.compression.codec</td> 
   <td>snappy</td> 
   <td>Sets the compression codec used when writing ORC files. If either&nbsp;compression&nbsp;or&nbsp;orc.compress&nbsp;is specified in the table-specific options/properties, the precedence would be&nbsp;compression,&nbsp;orc.compress,spark.sql.orc.compression.codec.Acceptable values include: none, uncompressed, snappy, zlib, lzo.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.orc.enableVectorizedReader</td> 
   <td>TRUE</td> 
   <td>Enables vectorized orc decoding.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.orc.filterPushdown</td> 
   <td>FALSE</td> 
   <td>When true, enable filter pushdown for ORC files.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.orderByOrdinal</td> 
   <td>TRUE</td> 
   <td>When true, the ordinal numbers are treated as the position in the select list. When false, the ordinal numbers in order/sort by clause are ignored.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.binaryAsString</td> 
   <td>FALSE</td> 
   <td>Some other Parquet-producing systems, in particular Impala and older versions of Spark SQL, do not differentiate between binary data and strings when writing out the Parquet schema. This flag tells Spark SQL to interpret binary data as a string to provide compatibility with these systems.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.compression.codec</td> 
   <td>snappy</td> 
   <td>Sets the compression codec used when writing Parquet files. If either&nbsp;compression&nbsp;or&nbsp;parquet.compression&nbsp;is specified in the table-specific options/properties, the precedence would be&nbsp;compression,parquet.compression,&nbsp;spark.sql.parquet.compression.codec. Acceptable values include: none, uncompressed, snappy, gzip, lzo.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.enableVectorizedReader</td> 
   <td>TRUE</td> 
   <td>Enables vectorized parquet decoding.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.filterPushdown</td> 
   <td>TRUE</td> 
   <td>Enables Parquet filter push-down optimization when set to true.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.int64AsTimestampMillis</td> 
   <td>FALSE</td> 
   <td>(Deprecated since Spark 2.3, please set spark.sql.parquet.outputTimestampType.) When true, timestamp values will be stored as INT64 with TIMESTAMP_MILLIS as the extended type. In this mode, the microsecond portion of the timestamp value will betruncated.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.int96AsTimestamp</td> 
   <td>TRUE</td> 
   <td>Some Parquet-producing systems, in particular Impala, store Timestamp into INT96. Spark would also store Timestamp as INT96 because we need to avoid precision lost of the nanoseconds field. This flag tells Spark SQL to interpret INT96 data as a timestamp to provide compatibility with these systems.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.int96TimestampConversion</td> 
   <td>FALSE</td> 
   <td>This controls whether timestamp adjustments should be applied to INT96 data when converting to timestamps, for data written by Impala. This is necessary because Impala stores INT96 data with a different timezone offset than Hive &amp; Spark.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.mergeSchema</td> 
   <td>FALSE</td> 
   <td>When true, the Parquet data source merges schemas collected from all data files, otherwise the schema is picked from the summary file or a random data file if no summary file is available.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.outputTimestampType</td> 
   <td>INT96</td> 
   <td>Sets which Parquet timestamp type to use when Spark writes data to Parquet files. INT96 is a non-standard but commonly used timestamp type in Parquet. TIMESTAMP_MICROS is a standard timestamp type in Parquet, which stores number of microseconds from the Unix epoch. TIMESTAMP_MILLIS is also standard, but with millisecond precision, which means Spark has to truncate the microsecond portion of its timestamp value.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.recordLevelFilter.enabled</td> 
   <td>FALSE</td> 
   <td>If true, enables Parquet’s native record-level filtering using the pushed down filters. This configuration only has an effect when ‘spark.sql.parquet.filterPushdown’ is enabled.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.respectSummaryFiles</td> 
   <td>FALSE</td> 
   <td>When true, we make assumption that all part-files of Parquet are consistent with summary files and we will ignore them when merging schema. Otherwise, if this is false, which is the default, we will merge all part-files. This should be considered as expert-only option, and shouldn’t be enabled before knowing what it means exactly.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parquet.writeLegacyFormat</td> 
   <td>FALSE</td> 
   <td>Whether to be compatible with the legacy Parquet format adopted by Spark 1.4 and prior versions, when converting Parquet schema to Spark SQL schema and vice versa.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.parser.quotedRegexColumnNames</td> 
   <td>FALSE</td> 
   <td>When true, quoted Identifiers (using backticks) in SELECT statement are interpreted as regular expressions.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.pivotMaxValues</td> 
   <td>10000</td> 
   <td>When doing a pivot without specifying values for the pivot column this is the maximum number of (distinct) values that will be collected without error.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.queryExecutionListeners</td> 
   <td></td> 
   <td>List of class names implementing QueryExecutionListener that will be automatically added to newly created sessions. The classes should have either a no-arg constructor, or a constructor that expects a SparkConf argument.</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>spark.sql.redaction.options.regex</td> 
   <td>(?i)url</td> 
   <td>Regex to decide which keys in a Spark SQL command’s options map contain sensitive information. The values of options whose names that match this regex will be redacted in the explain output. This redaction is applied on top of the global redaction configuration defined by spark.redaction.regex.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.redaction.string.regex</td> 
   <td></td> 
   <td>Regex to decide which parts of strings produced by Spark contain sensitive information. When this regex matches a string part, that string part is replaced by a dummy value. This is currently used to redact the output of SQL explain commands. When this conf is not set, the value fromspark.redaction.string.regex&nbsp;is used.</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>spark.sql.session.timeZone</td> 
   <td>Asia/Shanghai</td> 
   <td>The ID of session local timezone, e.g. “GMT”, “America/Los_Angeles”, etc.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.shuffle.partitions</td> 
   <td>4096</td> 
   <td>The default number of partitions to use when shuffling data for joins or aggregations.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.sources.bucketing.enabled</td> 
   <td>TRUE</td> 
   <td>When false, we will treat bucketed table as normal table</td> 
  </tr> 
  <tr> 
   <td>spark.sql.sources.default</td> 
   <td>parquet</td> 
   <td>The default data source to use in input/output.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.sources.parallelPartitionDiscovery.threshold</td> 
   <td>32</td> 
   <td>The maximum number of paths allowed for listing files at driver side. If the number of detected paths exceeds this value during partition discovery, it tries to list the files with another Spark distributed job. This applies to Parquet, ORC, CSV, JSON and LibSVM data sources.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.sources.partitionColumnTypeInference.enabled</td> 
   <td>TRUE</td> 
   <td>When true, automatically infer the data types for partitioned columns.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.sources.partitionOverwriteMode</td> 
   <td>STATIC</td> 
   <td>When INSERT OVERWRITE a partitioned data source table, we currently support 2 modes: static and dynamic. In static mode, Spark deletes all the partitions that match the partition specification(e.g. PARTITION(a=1,b)) in the INSERT statement, before overwriting. In dynamic mode, Spark doesn’t delete partitions ahead, and only overwrite those partitions that have data written into it at runtime. By default we use static mode to keep the same behavior of Spark prior to 2.3. Note that this config doesn’t affect Hive serde tables, as they are always overwritten with dynamic mode.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.statistics.fallBackToHdfs</td> 
   <td>TRUE</td> 
   <td>If the table statistics are not available from table metadata enable fall back to hdfs. This is useful in determining if a table is small enough to use auto broadcast joins.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.statistics.histogram.enabled</td> 
   <td>FALSE</td> 
   <td>Generates histograms when computing column statistics if enabled. Histograms can provide better estimation accuracy. Currently, Spark only supports equi-height histogram. Note that collecting histograms takes extra cost. For example, collecting column statistics usually takes only one table scan, but generating equi-height histogram will cause an extra table scan.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.statistics.size.autoUpdate.enabled</td> 
   <td>FALSE</td> 
   <td>Enables automatic update for table size once table’s data is changed. Note that if the total number of files of the table is very large, this can be expensive and slow down data change commands.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.streaming.checkpointLocation</td> 
   <td></td> 
   <td>The default location for storing checkpoint data for streaming queries.</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>spark.sql.streaming.metricsEnabled</td> 
   <td>FALSE</td> 
   <td>Whether Dropwizard/Codahale metrics will be reported for active streaming queries.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.streaming.numRecentProgressUpdates</td> 
   <td>100</td> 
   <td>The number of progress updates to retain for a streaming query</td> 
  </tr> 
  <tr> 
   <td>spark.sql.thriftserver.scheduler.pool</td> 
   <td></td> 
   <td>Set a Fair Scheduler pool for a JDBC client session.</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>spark.sql.thriftserver.ui.retainedSessions</td> 
   <td>200</td> 
   <td>The number of SQL client sessions kept in the JDBC/ODBC web UI history.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.thriftserver.ui.retainedStatements</td> 
   <td>200</td> 
   <td>The number of SQL statements kept in the JDBC/ODBC web UI history.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.ui.retainedExecutions</td> 
   <td>1000</td> 
   <td>Number of executions to retain in the Spark UI.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.variable.substitute</td> 
   <td>TRUE</td> 
   <td>This enables substitution using syntax like ${var} ${system:var} and ${env:var}.</td> 
  </tr> 
  <tr> 
   <td>spark.sql.warehouse.dir</td> 
   <td>/user/warehouse</td> 
   <td>The default location for managed databases and tables.</td> 
  </tr> 
 </tbody> 
</table>