What's the difference between double-dash options and single-dash options? -- Lefty
On Sat, Mar 8, 2014 at 9:40 AM, Edward Capriolo <edlinuxg...@gmail.com>wrote: > Great thanks for following up. THere might be a number of etl processes in > the wild saying -hiveconf which is why it is important to keep around for > the cli at least. > > > On Sat, Mar 8, 2014 at 1:56 AM, Xuefu Zhang <xzh...@cloudera.com> wrote: > > > This is just getting more and more interesting. I never thought of > > -hiveconf option, and always assumed it was a typo of --hiveconf. (That's > > why I edited the one, which triggered the discovery.) I just checked and > > found that both work, which is out of my surprise. > > > > With this assumption, Beeline has implemented only --hiveconf to mimic > CLI. > > > > As to the documentation, I think we can stick to --hiveconf from now on, > > since they are supported by both CLI and Beeline. However, -hiveconf will > > continue to work for CLI until its death. > > > > Thanks, > > Xuefu > > > > > > On Fri, Mar 7, 2014 at 10:36 PM, Lefty Leverenz <leftylever...@gmail.com > > >wrote: > > > > > > OK, so just one of the pages in wiki has changed, and hive behavior > has > > > not changed > > > > > > That's right, and a closer look at the wiki shows that all the examples > > are > > > -hiveconf except the new change. The only place --hiveconf appears is > in > > > duplications of help messages for the hive command, the old Hive > server, > > or > > > Beeline. > > > > > > In a fresh export of the wiki --hiveconf occurs in these docs: > > > > > > - CLI< > > > > > > https://cwiki.apache.org/confluence/display/Hive/LanguageManual+Cli#LanguageManualCli-HiveCommandLineOptions > > > > > > > repeats > > > what hive -H says (--hiveconf) but gives 3 examples of -hiveconf. > > > - Admin Config< > > > > > > https://cwiki.apache.org/confluence/display/Hive/AdminManual+Configuration#AdminManualConfiguration-ConfiguringHive > > > > > > > says > > > --hiveconf twice, in text and an example (both changed this week). > > > - Hive Server< > > > https://cwiki.apache.org/confluence/display/Hive/HiveServer> > > > says > > > --hiveconf once, but that's the Thrift server help message. > > > - HiveServer2 > > > Clients< > > > > > > https://cwiki.apache.org/confluence/display/Hive/HiveServer2+Clients#HiveServer2Clients-BeelineCommandOptions > > > >says > > > --hiveconf twice, but that's the Beeline option. > > > > > > These wikidocs say -hiveconf: > > > > > > - Getting Started (4 in config > > > overview< > > > > > > https://cwiki.apache.org/confluence/display/Hive/GettingStarted#GettingStarted-ConfigurationManagementOverview > > > > > > > and > > > 2 in error logs< > > > > > > https://cwiki.apache.org/confluence/display/Hive/GettingStarted#GettingStarted-ErrorLogs > > > > > > > ) > > > - Avro SerDe< > > > > > > https://cwiki.apache.org/confluence/display/Hive/AvroSerDe#AvroSerDe-SpecifyingtheAvroschemaforatable > > > >(2 > > > in example and text) > > > - Developer Guide< > > > > > > https://cwiki.apache.org/confluence/display/Hive/DeveloperGuide#DeveloperGuide-RunningHiveWithoutaHadoopCluster > > > >(4 > > > in "export HIVE_OPTS") > > > - HBase Integration< > > > > > > https://cwiki.apache.org/confluence/display/Hive/HBaseIntegration#HBaseIntegration-Usage > > > >(2 > > > in examples) > > > - Variable Substitution< > > > > > > https://cwiki.apache.org/confluence/display/Hive/LanguageManual+VariableSubstitution > > > >(1 > > > in the "evil laugh" example) > > > - CLI (2 in one > > > example< > > > > > > https://cwiki.apache.org/confluence/display/Hive/LanguageManual+Cli#LanguageManualCli-Examples > > > >, > > > 1 in logging< > > > > > > https://cwiki.apache.org/confluence/display/Hive/LanguageManual+Cli#LanguageManualCli-Logging > > > > > > > ) > > > > > > (My grep hits were inflated because "-i" caught HiveConf.) > > > > > > So what's it supposed to be? > > > > > > > > > -- Lefty > > > > > > > > > On Fri, Mar 7, 2014 at 11:06 PM, Thejas Nair <the...@hortonworks.com> > > > wrote: > > > > > > > OK, so just one of the pages in wiki has changed, and hive behavior > > > > has not changed ? (I have been using -hiveconf, but i haven't > verified > > > > that with the tip of the trunk as of now). > > > > > > > > On Fri, Mar 7, 2014 at 6:19 PM, Xuefu Zhang <xzh...@cloudera.com> > > wrote: > > > > > I didn't know that -hiveconf is supported. However, from hive -H, > > > double > > > > > dashes are seen. > > > > > > > > > > -h <hostname> connecting to Hive Server on > remote > > > > host > > > > > --hiveconf <property=value> Use value for given property > > > > > --hivevar <key=value> Variable subsitution to apply to > > hive > > > > > > > > > > Thanks, > > > > > Xuefu > > > > > > > > > > > > > > > On Fri, Mar 7, 2014 at 6:00 PM, Edward Capriolo < > > edlinuxg...@gmail.com > > > > >wrote: > > > > > > > > > >> I was not around when this change was made but I think we should > > have > > > > kept > > > > >> the old - dash version. We should consider adding it back. > > > > >> > > > > >> > > > > >> On Fri, Mar 7, 2014 at 8:56 PM, Lefty Leverenz < > > > leftylever...@gmail.com > > > > >> >wrote: > > > > >> > > > > >> > Xuefu just fixed the AdminManual Configuration > > > > >> > wiki< > > > > >> > > > > > >> > > > > > > > > > > https://cwiki.apache.org/confluence/display/Hive/AdminManual+Configuration > > > > >> > >, > > > > >> > changing bin/hive -hiveconf ... to --hiveconf, so I grepped the > > wiki > > > > >> > archive and found many more cases of single-dash hiveconf than > > > > >> double-dash: > > > > >> > > > > > >> > > grep -i '\-\-hiveconf' * | wc > > > > >> > 2 16 178 > > > > >> > > grep -i '\-hiveconf' * | wc > > > > >> > 24 282 4054 > > > > >> > > > > > >> > A bit of googling also showed both versions of the option. So > two > > > > >> > questions: > > > > >> > > > > > >> > > > > > >> > 1. Should I change all cases of single-dash hiveconf to > > > > double-dash in > > > > >> > the wiki? > > > > >> > 2. Should a single-dash option be created to accommodate all > > the > > > > wrong > > > > >> > information on the Internet and in books (including *Hadoop: > > The > > > > >> > Definitive Guide* and chapters 9 & 12 of *Programming Hive*)? > > > > >> > > > > > >> > > > > > >> > -- Lefty > > > > >> > > > > > >> > > > > > > > > -- > > > > CONFIDENTIALITY NOTICE > > > > NOTICE: This message is intended for the use of the individual or > > entity > > > to > > > > which it is addressed and may contain information that is > confidential, > > > > privileged and exempt from disclosure under applicable law. If the > > reader > > > > of this message is not the intended recipient, you are hereby > notified > > > that > > > > any printing, copying, dissemination, distribution, disclosure or > > > > forwarding of this communication is strictly prohibited. If you have > > > > received this communication in error, please contact the sender > > > immediately > > > > and delete it from your system. Thank You. > > > > > > > > > >
