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.

...

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: DDL ResourcesWebHCat ReferenceWebHCat (Templeton) ManualHCatalog ManualHive Home
Old version of this document (HCatalog 0.5.0): POST ddlWiki HomeHive Project Site