Step 4: Add an instance profile to Databricks

This article explains how to add a configured instance profile to your Databricks workspace.

  1. Go to the admin settings page.

  2. Click the Instance Profiles tab.

  3. Click Add Instance Profile.

  4. Paste your instance profile ARN into the Instance profile ARN field. If you don’t have the ARN, see Step 1: Create an instance profile.

  5. For serverless SQL to work with your instance profile, you may need to explicitly specify the role ARN associated with your instance profile in the IAM role ARN field.

    This is only a required step if your instance profile’s associated role name (the text after the last slash in the role ARN) and the instance profile name (the text after the last slash in the instance profile ARN) do not match. To confirm whether this applies to you:

    1. In the AWS console, go to the IAM service’s Roles tab. It lists the IAM roles in your account.

    2. Click the role with the name that matches the instance profile name in the Databricks SQL admin settings in the Data Security section for the Instance Profile field that you found earlier in this section.

    3. In the summary area, find the Role ARN and Instance Profile ARNs fields and see if they match.

      Does instance profile name and role arn name match
    4. If they do not match, paste the role ARN into the IAM role ARN field. If the names match, you do not need to set the IAM role ARN field.

    5. Only if you are setting up IAM credential passthrough, select the Meta Instance Profile property.

  6. Databricks validates that the instance profile ARN is both syntactically and semantically correct. To validate semantic correctness, Databricks does a dry run by launching a cluster with this instance profile. Any failure in this dry run produces a validation error in the UI. Validation of the instance profile can fail if the instance profile contains the tag-enforcement policy, preventing you from adding a legitimate instance profile. If the validation fails and you still want to add the instance profile, select the Skip Validation checkbox.

  7. Click Add.

Next steps

You’ve now set up your instance profile to be used in your Databricks workspace. To learn how to manage the instance profile, see Manage instance profile access in Databricks. To learn how to deploy a compute resources with the instance profile, see Launch a compute resource with the instance profile.