spark-instrumented-optimizer/docs/sql-ref-syntax-dml-load.md

---
layout: global
title: LOAD DATA
displayTitle: LOAD DATA
license: |
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at
 
     http://www.apache.org/licenses/LICENSE-2.0
 
  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
---

### Description
`LOAD DATA` statement loads the data into a table from the user specified directory or file. If a directory is specified then all the files from the directory are loaded. If a file is specified then only the single file is loaded. Additionally the `LOAD DATA` statement takes an optional partition specification. When a partition is specified, the data files (when input source is a directory) or the single file (when input source is a file) are loaded into the partition of the target table.

### Syntax
{% highlight sql %}
LOAD DATA [ LOCAL ] INPATH path [ OVERWRITE ] INTO TABLE table_identifier [ partition_spec ]
{% endhighlight %}

### Parameters
<dl>
  <dt><code><em>path</em></code></dt>
  <dd>Path of the file system. It can be either an absolute or a relative path.</dd>
</dl>

<dl>
  <dt><code><em>table_identifier</em></code></dt>
  <dd>
    Specifies a table name, which may be optionally qualified with a database name.<br><br>
    <b>Syntax:</b>
      <code>
        [ database_name. ] table_name
      </code>
  </dd>
</dl>

<dl>
  <dt><code><em>partition_spec</em></code></dt>
  <dd>
    An optional parameter that specifies a comma separated list of key and value pairs
    for partitions.<br><br>
    <b>Syntax:</b>
      <code>
        PARTITION ( partition_col_name = partition_col_val [ , ... ] )
      </code>
  </dd>
</dl>

<dl>
  <dt><code><em>LOCAL</em></code></dt>
  <dd>If specified, it causes the <code>INPATH</code> to be resolved against the local file system, instead of the default file system, which is typically a distributed storage.</dd>
</dl>

<dl>
  <dt><code><em>OVERWRITE</em></code></dt>
  <dd>By default, new data is appended to the table. If <code>OVERWRITE</code> is used, the table is instead overwritten with new data.</dd>
</dl>

### Examples
{% highlight sql %}
 -- Example without partition specification.
 -- Assuming the students table has already been created and populated.
 SELECT * FROM students;

     + -------------- + ------------------------------ + -------------- +
     | name           | address                        | student_id     |
     + -------------- + ------------------------------ + -------------- +
     | Amy Smith      | 123 Park Ave, San Jose         | 111111         |
     + -------------- + ------------------------------ + -------------- +

 CREATE TABLE test_load (name VARCHAR(64), address VARCHAR(64), student_id INT);

 -- Assuming the students table is in '/user/hive/warehouse/'
 LOAD DATA LOCAL INPATH '/user/hive/warehouse/students' OVERWRITE INTO TABLE test_load;

 SELECT * FROM test_load;

     + -------------- + ------------------------------ + -------------- +
     | name           | address                        | student_id     |
     + -------------- + ------------------------------ + -------------- +
     | Amy Smith      | 123 Park Ave, San Jose         | 111111         |
     + -------------- + ------------------------------ + -------------- +

 -- Example with partition specification.
 CREATE TABLE test_partition (c1 INT, c2 INT, c3 INT) USING HIVE PARTITIONED BY (c2, c3);

 INSERT INTO test_partition PARTITION (c2 = 2, c3 = 3) VALUES (1);

 INSERT INTO test_partition PARTITION (c2 = 5, c3 = 6) VALUES (4);

 INSERT INTO test_partition PARTITION (c2 = 8, c3 = 9) VALUES (7);

 SELECT * FROM test_partition;

      + ------- + ------- + ----- +
      | c1      | c2      | c3    |
      + ------- + --------------- +
      | 1       | 2       | 3     |
      + ------- + ------- + ----- +
      | 4       | 5       | 6     |
      + ------- + ------- + ----- +
      | 7       | 8       | 9     |
      + ------- + ------- + ----- +

 CREATE TABLE test_load_partition (c1 INT, c2 INT, c3 INT) USING HIVE PARTITIONED BY (c2, c3);

 -- Assuming the test_partition table is in '/user/hive/warehouse/'
 LOAD DATA LOCAL INPATH '/user/hive/warehouse/test_partition/c2=2/c3=3'
     OVERWRITE INTO TABLE test_load_partition PARTITION (c2=2, c3=3);

 SELECT * FROM test_load_partition;

      + ------- + ------- + ----- +
      | c1      | c2      | c3    |
      + ------- + --------------- +
      | 1       | 2       | 3     |
      + ------- + ------- + ----- +


{% endhighlight %}