INSERT OVERWRITE DIRECTORY

S’applique à :coché oui Databricks SQL coché oui Databricks Runtime

Remplace les données existantes dans le répertoire avec les nouvelles valeurs à l’aide d’un format de fichier Spark spécifié. Vous spécifiez les lignes insérées par des expressions de valeur ou le résultat d’une requête.

Syntaxe

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

Paramètres

  • directory_path

    Répertoire cible. Vous pouvez également le spécifier à OPTIONS l’aide pathde . Le mot clé LOCAL spécifie que le répertoire se trouve sur le système de fichiers local.

  • file_format

    Format de fichier à utiliser pour l’insertion. Les options valides sont TEXT, CSV, JSON, JDBC, PARQUET, ORC, HIVE, LIBSVM, ou un nom de classe complet d’une implémentation personnalisée de org.apache.spark.sql.execution.datasources.FileFormat.

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

    Spécifie une ou plusieurs options pour l’écriture du format de fichier. Les clés et valeurs valides dépendent de la file_format sélection. Pour connaître les options prises en charge par chaque format, consultez les options de format de données. Vous pouvez également définir la path clé pour spécifier le répertoire cible.

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

    Valeurs à insérer. Vous pouvez insérer une valeur spécifiée explicitement ou une valeur NULL. Utilisez une virgule pour séparer chaque valeur de la clause. Pour insérer plusieurs lignes, spécifiez plusieurs ensembles de valeurs.

  • requête

    Requête qui produit les lignes à insérer. Utilisez l'un des éléments suivants :

    • Instruction SELECT
    • Instruction TABLE
    • Instruction FROM

    L’instruction écrit les lignes comme un ou plusieurs fichiers dans le répertoire cible. Le nombre de fichiers et la manière dont les lignes sont réparties entre eux ne sont pas spécifiés. Une ORDER BY clause dans query ne garantit pas l’ordre des lignes au sein d’un fichier ou entre fichiers, donc ne vous fiez pas aux noms de fichiers ou aux numéros de pièce pour reconstituer l’ordre de tri. Si vous avez besoin des lignes dans un ordre précis, appliquez-les ORDER BY lors de la lecture du répertoire. Par exemple, pour lire la sortie Parquet dans l’ordre, exécutez ce qui suit :

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

Exemples

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;