INSERT OVERWRITE DIRECTORY

Aplica a:con marca de verificación sí Databricks SQL marcado sí Databricks Runtime

Sobrescribe los datos existentes en el directorio con los nuevos valores mediante un formato de archivo spark especificado. Especifique la fila insertada por expresiones de valor o el resultado de una consulta.

Sintaxis

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

Parámetros

  • directory_path

    Directorio de destino. También puede especificarlo en OPTIONS mediante path. La palabra clave LOCAL especifica que el directorio está en el sistema de archivos local.

  • file_format

    Formato de archivo que se usa para la inserción. Las opciones válidas son TEXT, CSV, JSON, JDBC, PARQUET, ORC, HIVE u LIBSVM, o un nombre de clase completo de una implementación personalizada de org.apache.spark.sql.execution.datasources.FileFormat.

  • OPCIONES ( { clave [ = ] val } [ , ... ] )

    Especifica una o varias opciones para escribir el formato de archivo. Las claves y los valores válidos dependen de la file_format opción que seleccione. Para ver las opciones admitidas por cada formato, consulte Opciones de formato de datos. También puede establecer la path clave para especificar el directorio de destino.

  • VALUES ( { valor | NULO } [ , ... ] ) [ , ( … ) ]

    Valores que se van a insertar. Puede insertar un valor especificado explícitamente o un valor NULL. Use una coma para separar cada valor de la cláusula . Para insertar varias filas, especifique más de un conjunto de valores.

  • consulta

    Consulta que genera las filas que se van a insertar. Use uno de los formatos siguientes:

    • Una instrucción SELECT
    • Una instrucción TABLE
    • Una instrucción FROM

    La instrucción escribe las filas como uno o más archivos en el directorio destino. No se especifica el número de archivos ni cómo se distribuyen las filas entre ellos. Una ORDER BY cláusula en query no garantiza el orden de filas dentro de un archivo ni entre archivos, así que no confíes en nombres de archivo o números de pieza para reconstruir el orden de clasificación. Si necesitas las filas en un orden específico, aplícalas ORDER BY cuando leas el directorio. Por ejemplo, para leer la salida de Parquet en orden, ejecute lo siguiente:

    SELECT * FROM parquet.`/Volumes/my_catalog/my_schema/my_volume/` ORDER BY col1;
    

Ejemplos

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;