Re: --hiveconf vs -hiveconf

[Lefty Leverenz <le...@gmail.com>]

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 <le...@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 <ed...@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 <xz...@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 <
>> leftyleverenz@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 <th...@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 <xz...@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 <
>> > edlinuxguru@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 <
>> > > leftyleverenz@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.
>> > > >
>> > >
>> >
>>
>
>