SQOOP-3309: Implement HiveServer2 client
[sqoop.git] / src / docs / user / hive-args.txt
1
2 ////
3   Licensed to the Apache Software Foundation (ASF) under one
4   or more contributor license agreements.  See the NOTICE file
5   distributed with this work for additional information
6   regarding copyright ownership.  The ASF licenses this file
7   to you under the Apache License, Version 2.0 (the
8   "License"); you may not use this file except in compliance
9   with the License.  You may obtain a copy of the License at
10  
11       http://www.apache.org/licenses/LICENSE-2.0
12  
13   Unless required by applicable law or agreed to in writing, software
14   distributed under the License is distributed on an "AS IS" BASIS,
15   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16   See the License for the specific language governing permissions and
17   limitations under the License.
18 ////
19
20
21 .Hive arguments:
22 [grid="all"]
23 `-----------------------------`-------------------------------------------
24 Argument                      Description
25 --------------------------------------------------------------------------
26 +\--hive-home <dir>+          Override +$HIVE_HOME+
27 +\--hive-import+              Import tables into Hive (Uses Hive's \
28                               default delimiters if none are set.)
29 +\--hive-overwrite+           Overwrite existing data in the Hive table.
30 +\--create-hive-table+        If set, then the job will fail if the target hive
31                               table exists. By default this property is false.
32 +\--hive-table <table-name>+  Sets the table name to use when importing\
33                               to Hive.
34 +\--hive-drop-import-delims+  Drops '\n', '\r', and '\01' from string\
35                   fields when importing to Hive.
36 +\--hive-delims-replacement+  Replace '\n', '\r', and '\01' from string\
37                   fields with user defined string when importing to Hive.
38 +\--hive-partition-key+       Name of a hive field to partition are \
39                   sharded on
40 +\--hive-partition-value <v>+ String-value that serves as partition key\
41                   for this imported into hive in this job.
42 +\--map-column-hive <map>+    Override default mapping from SQL type to\
43                   Hive type for configured columns. If specify commas in\
44                   this argument, use URL encoded keys and values, for example,\
45                   use DECIMAL(1%2C%201) instead of DECIMAL(1, 1).
46 +\--hs2-url+                  The JDBC connection string to HiveServer2 as you would specify in Beeline. If you use this option with \
47                     --hive-import then Sqoop will try to connect to HiveServer2 instead of using Hive CLI.
48 +\--hs2-user+                 The user for creating the JDBC connection to HiveServer2. The default is the current OS user.
49 +\--hs2-keytab+               The path to the keytab file of the user connecting to HiveServer2. If you choose another \
50                        HiveServer2 user (with --hs2-user) then --hs2-keytab has to be also specified otherwise it can be omitted.
51 --------------------------------------------------------------------------
52