List your data product in Databricks Marketplace

Preview

This feature is in Public Preview.

This article describes how to apply to be a Databricks Marketplace provider and how to create a Databricks Marketplace listing for your data products.

Before you begin

To list products in the Databricks Marketplace, you must agree to provider policies, and your account and workspaces must meet certain requirements.

Policies

To list data products on the Marketplace exchange, you must agree to the Marketplace provider policies.

Account and workspace requirements

Databricks Marketplace uses Delta Sharing to manage secure sharing of data products. Delta Sharing, in turn, requires that your Databricks workspace is enabled for Unity Catalog. Your Databricks account and workspaces must therefore meet the following requirements:

If you have workspaces that meet the criteria listed above, your users will be able to view the Marketplace home page. Additional permissions are required to create and manage listings. These are enumerated in the sections that follow. If you don’t want your users to be able to view the Marketplace home page at all, contact your Databricks representative.

Apply to be a Databricks Marketplace provider

Apply to be a provider through the Databricks Data Partner Program.

Note

If your organization is already in the Databricks Partner Program and you’re interested in becoming a Marketplace provider, skip the following instructions and contact partnerops@databricks.com instead.

  1. On the Databricks Data Partner Program page, click Apply Now.

  2. On the next page, click Apply now.

  3. Enter your email address and click Apply Now.

  4. Fill out the application form.

    Towards the bottom of the application form, you’re asked which Databricks Partner program interests you. Select Marketplace.

The Databricks Partner team will reach out to you to complete the application process. When you’re approved, a provider profile will be added to your Databricks account and the Provider console will become available in your Unity-Catalog-enabled Databricks workspaces. To access the Provider console, a user must have the Marketplace admin role.

Assign the Marketplace admin role

Once you’ve been approved as a Marketplace provider and a provider profile has been added to your Databricks account, you must grant at least one user the Marketplace admin role. This role is required for accessing the Marketplace Provider console and for creating and managing Marketplace listings. A Databricks account admin can grant the role.

  1. As an account admin, log in to the account console.

  2. Click Account Console user management icon User management.

  3. Find and click the username.

  4. On the Roles tab, turn on Marketplace admin.

Create shares

After you have a Databricks account enabled for Delta Sharing and a Databricks workspace enabled for Unity Catalog, you can create the shares that you will use to share your data in the Marketplace.

A share is a Delta Sharing object. It’s a collection of tables that are shareable and securable as a unit.

Note

To list a data product that is free and instantly available to consumers, you must include a share when you create the listing. Listings that require you to approve a consumer request, on the other hand, don’t require that you include a share in the listing. You can create the share later, after any business agreements are complete and you’ve approved the consumer’s request. If that’s what you want to do, skip ahead to Create listings.

  1. Add data tables to your Unity Catalog metastore.

    To learn how to create tables in Unity Catalog, see Create tables.

  2. Create a share and add these tables to the share.

    To learn how to create and update shares, see Create and manage shares for Delta Sharing.

    Permissions required:

    • To create a share, you must be a metastore admin or user with the CREATE SHARE privilege for the Unity Catalog metastore where the data you want to share is registered.

    • To add a table to a share, you must be the share owner and have the SELECT privilege on the table. You must keep that privilege in order for the table to continue to be shared. If you lose it, the recipient cannot access the table through the share. Databricks therefore recommends that you use a group as the share owner.

After your share is created, you can create or update a Marketplace listing that references it.

Create sample notebooks

In addition to tabular data, Databricks highly recommends that you also share Databricks notebooks. A notebook is a great way to demonstrate example use cases and visualize table properties. Your listing can include sample notebook previews, and consumers can import these notebooks into their workspaces.

Notebook preview on a listing

To learn how to create a notebook, see Introduction to Databricks notebooks. If you need help creating an effective sample notebook, contact dataproviders@databricks.com.

Create listings

Marketplace listings enable consumers to browse, select, and access your data products.

Permissions required: Marketplace admin role. If you are creating and managing personalized listings (those that require provider approval before they’re fulfilled), you must also have the CREATE RECIPIENT and USE RECIPIENT privileges. See Unity Catalog privileges and securable objects.

To create a listing:

  1. Log into your Databricks workspace.

  2. In the sidebar, click Marketplace icon Marketplace.

  3. On the upper-right corner of the Data Marketplace page, click Provider console.

  4. On the Provider console page Listings tab, click Create listing.

  5. On the New listing page, enter your listing information.

    For instructions, see Listing fields and options.

You can save a draft and view a preview before you publish. When you click Publish, the listing appears in the Marketplace immediately.

Listing fields and options

This section describes each New listing page field and option. It also provides recommendations for creating an effective listing.

  • Listing name: Each listing should have a unique name that helps consumers understand what it offers.

    Recommendations:

    • Fewer than 100 characters.

    • Title case (capitalize primary words).

    Example

    US Census 2022

  • Short description: A short, informative explanation of the dataset that expands on the listing name. This field appears in listing tiles and consumer search results.

    Recommendations:

    • Fewer than 100 characters. Cannot exceed 160 characters.

    • Sentence case (capitalize only the first word an any proper nouns or acronyms).

    Example

    General information about US population count and demography in 2020

  • Provider profile: Your organization or company name. Select from the drop-down menu. Your profile is created by Databricks as part of the partner organization approval process.

  • Terms of service: A URL that links to your terms of service for the appropriate use of the shared data assets.

    Terms of service must be publicly accessible and require no login.

  • Data is available instantly: Select this option to let consumers gain access to the shared data directly from the Marketplace, without requiring your approval (but requiring acceptance of terms of service). Choose a share from the drop-down menu. This option is typically used for sample and public datasets.

    If you have not yet created the share that you want to include, click + Create new share at the bottom of the drop-down menu. You are taken to the Create a new share dialog box.

    If a share that you select or create here contains no data or assets, a message appears with an Add data button. Click it to go to Data Explorer, where you can add tables to the share.

    For more information about creating shares and adding tables to shares, including required permissions, see Create and manage shares for Delta Sharing.

  • Require approval of consumer requests: Select this option to require your approval before a consumer can access the shared data. Use this option if you require a business agreement before you make the data product available to consumers. You must manage the business agreement with consumers outside of Databricks Marketplace. You can initiate communications using the consumer email address.

    You can view and handle consumer requests on the Provider Console > Consumer requests tab. See Manage requests for your data product in Databricks Marketplace.

  • Categories: Select up to five categories that consumers can use to filter listings. Categories also appear as tags on listing tiles and detail pages.

  • Add attribute: Attributes are optional. They include fields such as geographic coverage, update frequency, time range, data source, and dataset size. Adding attributes helps consumers understand more about your data product. Select as many attributes as you like.

  • Description: The detailed description of your data should include a summary of the data and assets being offered in the listing.

    Basic rich text formatting is supported (that is, bold, italics, bullets, and numbered lists), using Markdown syntax. To preview your content, use the buttons at the far right of the Description field toolbar.

    Recommendations:

    • Include benefits and use cases.

    • Provide brief guidance about how to use the data and sample use cases.

    • Include sample datasets and field names.

    • Specify schemas, tables, and columns.

    • Use consistent punctuation and syntax.

    • Add an extra line break between paragraphs.

    • Check your spelling and grammar.

    • Don’t repeat the attributes that you defined under Add Attribute.

    Example

    Overview:

    The US Census of Population and Dwellings is the official count of people and houses in the US in 2020. It provides a social and economic snapshot. The 2020 Census, held on March 6, 2021, is the 23th census.

    Use cases:

    • Group customers based on demographic variables like age and gender.

    • Customize product offerings to specific consumer groups.

    Information included in this dataset:

    • Population estimates

    • Demographic components (births, deaths, migration)

    • This data can be sorted by characteristics such as age, sex, and race, as well as by national, state, and county location

  • Sample notebook: Databricks highly recommends that you share sample notebooks to demonstrate how best to use the data. Add up to ten notebooks. You must save the listing and return to it in order to upload sample notebooks.

    For more information about creating notebooks, see Create sample notebooks and Introduction to Databricks notebooks.

  • Documentation: A URL that links to documentation that can help consumers use or understand your data set (for example, a dataset dictionary).

  • Privacy policy: A URL that links to your privacy policy.

    The privacy policy must be publicly accessible and require no login.