Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: remove broken link to old doc

DDL

...

Command — POST ddl

Table of Contents

Description

Performs an HCatalog DDL command. The command is executed immediately upon request. Responses are limited to 1 MB. For requests which may return longer results consider using the Hive resource as an alternative.

URL

http://www.myserver.com/templeton/ddl

...

Name

Description

Required?

Default

exec

The HCatalog ddl string to execute

Required

None

group

The user group to use when creating a table

Optional

None

permissions

The permissions string to use when creating a table. The format is "rwxrw-r-x".

Optional

None

The standard parameters are also supported.

Results

...

Example

Curl Command

No Format

% curl -s -d user.name=ctdean \
       -d 'exec=show tables;' \
       'http://localhost:50111/templeton/v1/ddl?user.name=ekoifman'


Info
titleVersion information

Prior to Hive 0.13.0, user.name was specified in POST requests as a form parameter: curl -d user.name=<user>.

In Hive 0.13.0 onward, user.name should be specified in the query string (as shown above): 'http://.../templeton/v1/ddl?user.name=<name>'. Specifying user.name as a form parameter is deprecated.

JSON Output

No Format

{
 "stdout": "important_table
            my_other_table
            my_table
            my_table_2
            pokes
            ",
 "stderr": "WARNING: org.apache.hadoop.metrics.jvm.EventCounter is deprecated...
            Hive history file=/tmp/ctdean/hive_job_log_ctdean_201111111258_2117356679.txt
            OK
            Time taken: 1.202 seconds
            ",
 "exitcode": 0
}

JSON Output (error)

No Format

{
  "stdout": "",
  "stderr": "WARNING: org.apache.hadoop.metrics.jvm.EventCounter is deprecated...
            Hive history file=/tmp/ctdean/hive_job_log_ctdean_201204051246_689834593.txt
            FAILED: Parse Error: line 1:5 Failed to recognize predicate 'tab'...

            ",
  "exitcode": 11
}

...

Panel
titleColorindigo
titleBGColorsilver
titleNavigation Links

Previous: GET version/hadoop
Next: GET ddl/database

General:WebHCat (Templeton) DDL ResourcesWebHCat ReferenceWebHCat ManualHCatalog ManualHive Home
Old version of this document (HCatalog 0.5.0): POST ddlWiki HomeHive Project Site