Learn how to create and configure a Data Share adapter for Databricks using REST APIs.

1. Create a new Databricks adapter

   Send a POST request to the DPH service to define a new Databricks data share:

   POST {dphUrl}/api/tenants/{tenantID}/adapters

   Example request body:

   
   {
     "type": "datashare-databricks",
     "name": "datashare",
     "enabled": true,
     "createdBy": "user@example.com",
     "createdOn": "2025-06-09T10:05:07.864379Z",
     "isOvOnly": true,
     "databricksConfig": {
       "identifier": "identifier1"
     }
   }
             

   The createdOn timestamp is auto-generated. The field isOvOnly determines whether only operational values (OV) are shared. If set to true, the schema is also simplified to a flat format.

   Field reference:

   Parameter	Type	Description
   type	String	Adapter type: must be datashare-databricks
   name	String	Adapter name (alphanumeric, 3–20 characters, no spaces)
   enabled	Boolean	Enable or disable the adapter
   createdBy	String	Username of adapter creator
   createdOn	String	Adapter creation time in UTC format
   isOv	Boolean	Whether to share only operational values and use simplified schema
   databricksConfig	Object	Databricks specific config
   databricksConfig.identifier	String	Identifier for the Databricks delta share

2. Set up the data share

   Provision the cloud resources and enable the share using the adapter name:

   
   POST {dphUrl}/api/tenants/{tenantID}/adapters/{adapterName}/actions/setup