INSERT OVERWRITE DIRECTORY

適用対象:「はい」のチェック マーク Databricks SQL Databricks Runtime

指定した Spark ファイル形式を使用して、ディレクトリ内の既存のデータを新しい値で上書きします。 挿入された行は、値式またはクエリの結果によって指定します。

構文

INSERT OVERWRITE [ LOCAL ] DIRECTORY [ directory_path ]
    USING file_format [ OPTIONS ( { key [ = ] val } [ , ... ] ) ]
    { VALUES ( { value | NULL } [ , ... ] ) [ , ( ... ) ] | query }

パラメーター

  • directory_path

    ターゲット ディレクトリ。 pathを使用して、OPTIONSで指定することもできます。 LOCAL キーワードは、ディレクトリがローカル ファイル システム上にあることを示します。

  • file_format

    挿入に使用するファイル形式。 有効なオプションは、TEXT、CSV、JSON、JDBC、PARQUET、ORC、HIVE、LIBSVM、または org.apache.spark.sql.execution.datasources.FileFormat のカスタム実装の完全修飾クラス名です。

  • OPTIONS ( { key [ = ] val } [ , ... ] )

    ファイル形式の書き込みオプションを 1 つ以上指定します。 有効なキーと値は、選択した file_format によって異なります。 各形式でサポートされるオプションについては、「 データ形式のオプション」を参照してください。 path キーを設定して、ターゲット ディレクトリを指定することもできます。

  • VALUES({ value | NULL } [ , ... ])[ , ( … )]

    挿入する値。 明示的に指定された値または NULL を挿入できます。 句の各値を区切るには、コンマを使用します。 複数の行を挿入するには、複数の値セットを指定します。

  • query

    挿入する行を生成するクエリ。 次のいずれかの形式を使用します。

    • SELECT ステートメント
    • TABLE ステートメント
    • FROM ステートメント

例

INSERT OVERWRITE DIRECTORY '/Volumes/my_catalog/my_schema/my_volume/'
    USING parquet
    OPTIONS (col1 1, col2 2, col3 'test')
    SELECT * FROM test_table;

INSERT OVERWRITE DIRECTORY
    USING parquet
    OPTIONS ('path' '/Volumes/my_catalog/my_schema/my_volume/', col1 1, col2 2, col3 'test')
    SELECT * FROM test_table;
  • Last updated on