Github user jihoonson commented on a diff in the pull request:
https://github.com/apache/tajo/pull/588#discussion_r31194129
--- Diff: tajo-docs/src/main/sphinx/table_management/table_overview.rst ---
@@ -8,12 +8,36 @@ Overview
Managed Table
================
-.. todo::
+``CREATE TABLE`` statement with ``EXTERNAL`` keyword lets you create a
table located in the warehouse directory specified by the configuration
property ``tajo.warehouse.directory`` or ``${tajo.root}/warehouse`` by default.
For example:
+
+.. code-block:: sql
+
+ CREATE TABLE employee (
+ id int,
+ name text,
+ age
+ );
+
External Table
================
-.. todo::
+``CREATE EXTERNAL TABLE`` statement lets you create a table located in a
specify location so that Tajo does not use a default data warehouse location
for the table. External tables are in common used if you already have data
generated. LOCATION clause must be required for an external table.
+
+.. code-block:: sql
+
+ CREATE EXTERNAL TABLE employee (
+ id int,
+ name text,
+ age
+ ) LOCATION 'hdfs://table/path';
+
+
+The location can be a directory located in HDFS, Amazon S3, HBase, or
local file system (if a Tajo cluster runs in a single machine). URI examples
are as follows:
--- End diff --
Please add swift as a supported storage type.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
