这些天看到很多人在使用Hive的过程遇到这样或那样的错误,看着那些少的可怜的错误日志出错,一直找不到原因。后来我给他们介绍了修改日志输出级别之后,错误原因很快得到定位。于是乎我写了这篇博文。希望那些在使用HQL的过程中遇到问题,通过这里介绍的方法进行调试而定位到错误,从而少走弯路。好了,废话不多说进入正文。
在很多程序中,我们都可以通过输出日志的形式来得到程序的运行情况,通过这些输出日志来调试程序,Hive也不例外。
在Hive中,使用的是Log4j来输出日志,默认情况下,CLI是不能将日志信息输出到控制台的。在Hive0.13.0之前版本,默认的日志级别是WARN,从Hive0.13.0开始,默认的日志级别是INFO。默认的日志存放在/tmp/<user.name>文件夹的hive.log文件中,全路径就是/tmp/<user.name>/hive.log。
需要注意的一个bug:在本地模式情况下,log文件名为”.log”,而不是”hive.log”,可以在这里看到https://issues.apache.org/jira/browse/HIVE-5528,这个bug将会在Hive0.13.0中得到解决。
在默认的日志级别情况下,是不能将DEBUG信息输出,这样一来出现的各种详细的错误信息都是不能数错的。但是我们可以通过以下两种方式修改log4j输出的日志级别,从而利用这些调试日志进行错误定位,具体做法如下:
1 | [wyp @l -datalog5.data.cn1 ~]$ hive --hiveconf hive.root.logger=DEBUG,console |
或者在${HIVE_HOME}/conf/hive-log4j.properties文件中找到hive.root.logger属性,并将其修改为下面的设置
1 | hive.root.logger=DEBUG,console |
上面两种方法的设置各有优劣,方法一的设定只是对本次会话有效,下次如果还想修改日志输出级别需要重新设定,但是不是每时每刻都需要修改日志的输出级别,所以在有时需要修改输出的日志级别,有时不需要的时候可以用这种方法;方法二将日志输出级别设定到文件中去了,这个设定是对所有的用户都生效,而且每次使用HQL的时候都会输出一大堆的日志,这种情况适合那些无时无刻都需要HQL的运行日志的用户。
在
《Hive几种参数配置方法》文章中我们介绍了Hive三种参数配置方法,其中就提到了某些系统级的参数,在HQL中设定是无效的。这里就是一个很好的例子。因为设定log的参数读取在会话建立以前已经完成了。这也就说,我们不能通过下面的方法来修改log4j的日志输出级别:
1 | hive> set hiveconf:hive.root.logger=DEBUG,console; |
这样你在进入CLI的时候将会得到一些类似下面的调试信息:
01 | [wyp @l -datalog5.data.cn1 /home/q/hive- 0.11 . 0 -bin/conf]$ hive |
02 | ................................为了篇幅,省略了很多............................ |
03 | 13 / 12 / 25 15 : 14 : 54 DEBUG parse.VariableSubstitution: Substitution is on: hive |
04 | ................................为了篇幅,省略了很多............................ |
05 | 13 / 12 / 25 15 : 14 : 54 DEBUG security.Groups: Creating new Groups object |
06 | 13 / 12 / 25 15 : 14 : 54 DEBUG util.NativeCodeLoader: Trying to load the c... |
07 | library for your platform... using builtin-java classes where applicable |
08 | 13 / 12 / 25 15 : 14 : 54 DEBUG security.JniBasedUnixGroupsMappingWithFallback: |
09 | Falling back to shell based |
10 | 13 / 12 / 25 15 : 14 : 54 DEBUG security.JniBasedUnixGroupsMappingWithFallback: |
11 | Group mapping impl=org.apache.hadoop.security.ShellBasedUnixGroupsMapping |
12 | 13 / 12 / 25 15 : 14 : 54 DEBUG security.UserGroupInformation: hadoop login |
13 | 13 / 12 / 25 15 : 14 : 54 DEBUG security.UserGroupInformation: using local |
14 | user:UnixPrincipal: wyp |
15 | 13 / 12 / 25 15 : 14 : 54 DEBUG security.UserGroupInformation: |
16 | UGI loginUser:yangping.wu (auth:SIMPLE) |
17 | ................................为了篇幅,省略了很多............................ |
下面举个日志调试的例子,在没有修改日志输出级别之前,有下面的查询所有表的HQL如下:
2 | FAILED: Error in metadata: java.lang.RuntimeException: Unable to instantiate |
3 | org.apache.hadoop.hive.metastore.HiveMetaStoreClient |
4 | FAILED: Execution Error, return code 1 from |
5 | org.apache.hadoop.hive.ql.exec.DDLTask |
得到上面的错误,我们从上面的错误输出只知道是元数据有问题。具体的错误也不知道,这时候如果我们修改了日志调试级别hive.root.logger=DEBUG,console,我们再来看看运行上面语句的错误输出:
02 | ................................为了篇幅,省略了很多............................ |
03 | 13 / 12 / 25 15 : 23 : 58 INFO metastore.ObjectStore: ObjectStore, initialize called |
04 | 13 / 12 / 25 15 : 23 : 58 ERROR Datastore.Schema: Failed initialising database. |
05 | Access denied for user 'datalog5' @ 'l-datalog5.data.cn1' (using password: YES) |
06 | org.datanucleus.exceptions.NucleusDataStoreException: |
07 | Access denied for user 'datalog5' @ 'l-datalog5.data.cn1' (using password: YES) |
08 | at org.datanucleus.store.rdbms.ConnectionFactoryImpl |
09 | $ManagedConnectionImpl.getConnection(ConnectionFactoryImpl.java: 536 ) |
10 | at org.datanucleus.store.rdbms.RDBMSStoreManager.<init> |
11 | (RDBMSStoreManager.java: 290 ) |
12 | at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method) |
13 | ................................为了篇幅,省略了很多............................ |
通过上面的错误堆栈我们就可以将问题定位到是连接数据库出现了问题,这么一来错误的定位范围就大大减少了,我们可以查看书Hive-site.xml文件中连接数据库的配置是否正确等来解决上述问题。本博客文章除特别声明,全部都是原创!
尊重原创,转载请注明: 转载自过往记忆(http://www.iteblog.com/)
本文链接地址: 《Hive日志调试》(http://www.iteblog.com/archives/873)
E-mail:wyphao.2007@163.com