存储
========

把主视图的数据存储至其它介质。

.. code-block:: sql


    load jdbc 'select * from orders';
    -- 保存为CSV文件
    save csv orders option path='/folder/';
    -- 以追加的方式保存到数据库中的一张表
    save jdbc append orders option ds='default';
    -- 托管表不支持中文名
    save table orders;
    -- 全局临时视图支持中文名，但需使用 `中文视图名称` 包裹名称
    save orders; -- 默认保存为全局临时视图

语法
------

save [格式] [模式] name [选项]

``name`` 如果存储为文件，则名称为文件名(不带文件名后缀)，如果使用Jdbc写入数据库，则名称为数据表名。

格式
------

======== =============== ================
名称      选项              描述
======== =============== ================
table    无               保存为托管表
view     无               保存为全局临时视图，系统重启时需要重新创建
csv      path
xlsx     path
json     path
xml      path
parquet  path
orc      path
avro     path
jdbc     ds               保存为关系型数据库中的一张表，数据源的获取方式可自定义
======== =============== ================

``path`` 文件夹路径；``ds`` 数据源名称

.. warning:: 存储 ``table`` 格式时，名称必须是英文。

模式
------

默认写入模式 ``overwrite`` 。

========= ============================================
名称       描述
========= ============================================
overwrite  覆盖现有数据
append     将数据追加到现有数据
error      如果数据已经存在，抛出错误
ignore     如果数据已经存在，不做任何操作
========= ============================================