All occurrences of "-hiveconf" in the wiki have been changed to "--hiveconf" except for one new sentence in the CLI command line options <https://cwiki.apache.org/confluence/display/Hive/LanguageManual+Cli#LanguageManualCli-HiveCommandLineOptions> section, which says it's also supported.
The list of docs changed is in the first March 8th message in this thread. -- Lefty On Sat, Mar 8, 2014 at 11:55 PM, Lefty Leverenz <leftylever...@gmail.com> wrote: > 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. >> > > > >> > > >> > >> > >