Skip to main content Skip to complementary content

Uploading files to DBFS (Databricks File System)

Uploading a file to DBFS allows the Big Data Jobs to read and process it. DBFS is the Big Data file system to be used in this example.

In this procedure, you will create a Job that writes data in your DBFS system. For the files needed for the use case, download tbd_gettingstarted_source_files.zip from the Downloads tab in the left panel of this page .

Procedure

  1. In the Repository tree view, expand the Job Designs node, right-click the Standard node, and select Create folder from the contextual menu.
  2. In the New Folder wizard, name your Job folder getting_started and click Finish to create your folder.
  3. Right-click the getting_started folder and select Create Standard Job from the contextual menu.
  4. In the New Job wizard, give a name to the Job you are going to create and provide other useful information if needed.

    For example, enter write_to_dbfs in the Name field.

    In this step of the wizard, Name is the only mandatory field. The information you provide in the Description field will appear as hover text when you move your mouse pointer over the Job in the Repository tree view.

  5. Click Finish to create your Job.

    An empty Job is opened in the Studio.

  6. In the design space of this empty Job, type dbfs to search for the DBFS related components. On the component list that is displayed, double-click tDBFSConnection to select it. The tDBFSConnection is added to the design space.
  7. Repeat this operation to add tDBFSPut to the design space.
  8. Right click tDBFSConnection and from the contextual menu that is displayed, select Trigger > On Subjob Ok.

    Example

  9. Click tDBFSPut to connect tDBFSConnection to tDBFSPut.
  10. Double-click tDBFSConnection to open its Component view.

    Example

  11. In the Endpoint field, enter the URL address of your Azure Databricks workspace. This URL can be found in the Overview blade of your Databricks workspace page on your Azure portal. For example, this URL could look like https://adb-$workspaceId.$random.azuredatabricks.net.
  12. Click the [...] button next to the Token field to enter the authentication token generated for your Databricks user account. You can generate or find this token on the User settings page of your Databricks workspace. For further information, see Personal access tokens from the Azure documentation.
  13. Double-click tDBFSPut to open its Component view.

    Example

  14. Select Use an existing connection to use the connection information defined in tDBFSConnection.
  15. In the Local directory field, enter the path, or browse to the folder in which the files to be copied to DBFS are stored.
  16. In the DBFS directory field, enter the path to the target directory in DBFS to store the files. This location is recommended to be in the FileStore folder, according to the FileStore section in the Databricks documentation.

    This directory is created on the fly if it does not exist.

  17. From the Overwrite file drop-down list, select always to overwrite the files if they already exist in the target directory in DBFS.
  18. In the Files table, add one row by clicking the [+] button in order to define the criteria to select the files to be copied.
  19. In the Filemask column, enter an asterisk (*) within the double quotation marks to make tDBFSPut select all the files stored in the folder you specified in the Local directory field.
  20. Leave the New name column empty, that is to say, keep the default double quotation marks as is, so as to make the name of the files unchanged after being uploaded.
  21. Press F6 to run the Job.

    The RunThe files about movies and their directors are stored in this view is opened automatically. It shows the progress of this Job.

Results

When the Job is done, the files you uploaded can be found in DBFS in the directory you have specified.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!