Breadcrumbs

Databricks - Authorization


To get started with any Databricks Blueprints, you will need to create an Access Token and know your Instance URL. These pieces of information form a secure way for Shipyard to access Databricks and will be required for every Databricks Blueprint.


Create a Databricks Access Token


  1. Navigate to your . Open whichever one you want to get an access token for.


https://cdn.sanity.io/images/2xyydva6/production/46c66077234d36529a81786db5268d9e0c5dc6cb-1304x380.png?w=450
2. On the sidebar, select the Settings icon and then User Settings.


https://cdn.sanity.io/images/2xyydva6/production/6537c26e3401f8615c587a05c44277b27c4ddf64-404x263.png?w=450


  1. Select the Access tokens tab at the top.


https://cdn.sanity.io/images/2xyydva6/production/1e1cda213bb7bf884ce8f4a4a3cfc0973941418d-1103x253.png?w=450


  1. Click Generate new token.

  2. Provide a descriptive name under Comment (like "Shipyard")

  3. Remove the value under Lifetime (days) so that it's blank.


CAUTION:
While best practice is typically to have expiring API tokens that rotate, we recommend letting Shipyard tokens run indefinitely to prevent interruption to your Fleets.


  1. Click Generate.


https://cdn.sanity.io/images/2xyydva6/production/6ed9caf708de720434ded58d4b523fa92209c570-523x299.png?w=450


  1. Copy the newly created token and store it in a safe location. This is the access token value you will use for every Databricks Blueprint.


https://cdn.sanity.io/images/2xyydva6/production/2a6de8d12695d9b7ea940a57988f7fb92dfcb275-520x252.png?w=450


  1. Click Done.


Finding the Instance URL


The Instance URL is a part of every URL on Databricks. For example, if the full URL was https://random-id-242.cloud.databricks.com/, your Instance URL would be random-id-242.cloud.databricks.com.