Create an Azure Blob Storage Connection

This guide will demonstrate how to create an Azure Blob Storage connection in Ascend.

Prerequisites

• Credentials for your Azure account
  • Shared Key: The Azure Blob File System shared key to use for the ABFS connection.
  • Service Principal: The client ID, client secret, and tenant ID for the service principal to use for the ABFS connection.
• An existing Ascend project (see: Create a Project)
• An existing Ascend Workspace (see: Setting Up a Workspace)

UI

Locate Your Project Folder

1. From your Ascend Instance Homepage, click on your Workspace to open it.
2. From here, click on the Files icon on the left navigation bar. This will open the File Tree in the left panel.
3. In your File Tree, locate your top-level project folder and open it.
4. Within the project folder, locate the connections folder.

Add a New Connection File

1. Right-click on the connections folder and click New File.
2. Provide the file with a name and a .yaml extension, such as abfs_connection.yaml. This will open the empty file in the build pane.
3. From here, you can enter the details for your connection.

Enter Connection Details

Enter the following YAML configuration, replacing the placeholder values with your Azure ABFS connection details:

/my_project/connections/azure_abfs_connection.yaml

connection:
  abfs:
    account: <account-name>
    root: <abfs-root-url>
    shared_key: <shared-key> #Optional
    service_principal:  #Optional
      client_id: <client-id>
      client_secret: <client-secret>
      tenant_id: <tenant-id>

To view all available connection options, see the Azure ABFS Connection Reference.

Once you have entered your Connection details, click "Save" to save the file and click "Build Project" to apply the changes.

Now that you have created an Azure ABFS connection, you can start ingesting data from Azure ABFS or writing data out to Azure ABFS.