hive-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Lefty Leverenz <leftylever...@gmail.com>
Subject Re: --hiveconf vs -hiveconf
Date Sun, 09 Mar 2014 04:55:35 GMT
What's the difference between double-dash options and single-dash options?

-- Lefty


On Sat, Mar 8, 2014 at 9:40 AM, Edward Capriolo <edlinuxguru@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 <xzhang@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 <thejas@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 <xzhang@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.
> > > >
> > >
> >
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message