PyCharm 2023.3 Help

Spark Submit run configuration

With the Spark plugin, you can execute applications on Spark clusters. PyCharm provides run/debug configurations to run the spark-submit script in Spark’s bin directory. You can execute an application locally or using an SSH configuration.

Install the Spark plugin

This functionality relies on the Spark plugin, which you need to install and enable.

  1. Press Ctrl+Alt+S to open the IDE settings and then select Plugins.

  2. Open the Marketplace tab, find the Spark plugin, and click Install (restart the IDE if prompted).

Run an application with the Spark Submit configurations

  1. Go to Run | Edit Configurations. Alternatively, click in the Run widget and select Edit Configurations from the drop-down menu.

    Run/Debug Configurations popup
  2. Click the Add New Configuration button (Add a run/debug configuration) and select Spark Submit | Cluster.

  3. Enter the run configuration name.

  4. In the Remote target list, do one of the following:

    • If you have connected to an AWS EMR cluster, you can upload your application on it.

    • If you have SSH configurations, you can use them to submit applications to a custom remote server.

    • Otherwise, click Add EMR Connection or Add SSH Connection.

  5. In the Application field, click Upload local file and select the application to be submitted.

  6. In the Class field, type the name of the main class of the application.

    Spark Run Configuration
  7. You can also specify optional parameters:

    • Run arguments: arguments to run the application.

    • Under Spark Configuration, set up:

      • Cluster manager: select the management method to run an application on a cluster. SparkContext can connect to several types of cluster managers (either Spark’s own standalone cluster manager, Mesos, or YARN). See more details in the Cluster Mode Overview.

      • Deploy mode: cluster or client.

      • Target upload directory: the directory on the remote host to upload the executable files.

      • Spark home: a path to the Spark installation directory.

      • Configs: arbitrary Spark configuration property in key=value format.

      • Properties file: the path to a file with Spark properties.

    • Under Dependencies, select files and archives (jars) that are required for the application to be executed.

    • Under Maven, select Maven-specific dependencies. You can add repositories or exclude some packages from the execution context.

    • Under Driver, select Spark Driver settings, such as amount of memory to use for the driver process. For the cluster mode, it is also possible to specify the number of cores.

    • Under Executor, select executor settings, such as amount of memory and the number of cores.

    • Kerberos: settings for establishing a secured connection with Kerberos.

    • Shell options: select if you want to execute any scripts before the Spark submit.

      Enter the path to bash and specify the script to be executed. It is recommended to provide an absolute path to the script.

      Select the Interactive checkbox if you want to launch the script in the interactive mode. You can also specify environment variables, for example, USER=jetbrains.

    • Advanced Submit Options:

      • Proxy user: a username that is enabled for using proxy for the Spark connection.

      • Driver Java options, Driver library path, and Driver class path: add additional driver options. For more information, refer to Runtime Environment.

      • Archives: comma-separated list of archives to be extracted into the working directory of each executor.

      • Print additional debug output: run spark-submit with the --verbose option to print debugging information.

  8. Click OK to save the configuration. Then select configuration from the list of the created configurations and click Run.

    Select a configuration
  9. Inspect the execution results in the Run tool window.

Last modified: 07 March 2024