List your data product in Databricks Marketplace

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, 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, 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 your Marketplace provider profile and 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 your Marketplace provider profile

Your provider profile gives you the opportunity to tell prospective consumers who you are and to group your data products under a single brand or identity. Typically, a data provider has one profile but can list multiple data products. If you want more than one profile, reach out to your Databricks representative.

Permission required: Marketplace admin role

To create a profile:

  1. After your provider application has been approved, log in to the Databricks workspace you will use for creating shares and listings.

  2. In the sidebar, click Marketplace icon Marketplace.

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

  4. On the Provider console page Profiles tab, click Create profile.

  5. Enter the following information. All fields are required:

    • Provider name: Use a name that consumers will recognize. Consumers can filter listings by provider name.

    • Description: Describe your organization clearly and accurately. Include details such as industries you typically serve or represent and the types of data assets that you typically list. Consumers can see this description when they view your profile and on all of your listings.

    • Organization website: Link to your organization’s website. Consumers can follow this link to learn more about your organization. This link appears on all of your listings.

    • Business email: Enter an email address that Databricks can use to send you notifications. Consumers do not see this information.

    • Support email: Enter an email address that consumers can use to request support. This link appears on all of your listings.

    • Terms of service link: This link appears on all of your listings. You can override this link by entering a different one at the listing level.

    • Privacy policy: This link appears on all of your listings. You can override this link by entering a different one at the listing level.

  6. Save the profile.

  7. Reopen the profile and upload a logo image file.

    The logo appears on all of your listings. Use only images that you are authorized to use.

If any of this information changes while you are a Marketplace provider, update your profile. Your profile must be accurate and kept up to date.

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 and views 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 and views to your Unity Catalog metastore.

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

  2. Create a share and add these tables and views 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 or view to a share, you must be the share owner, have the USE SCHEMA privilege on the schema that contains the table or view, and have the SELECT privilege on the table or view. You must keep that privilege in order for the table or view to continue to be shared. If you lose it, the recipient cannot access the table or view through the share. Databricks therefore recommends that you use a group as the share owner.

    For a more details about requirements for sharing tables and views, including compute and data type requirements, see Create and manage shares for Delta Sharing.

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

Notebook example: Sample notebook

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

For more information about creating notebooks, see Introduction to Databricks notebooks. If you need help creating an effective sample notebook, contact dataproviders@databricks.com.

Note

The Sample notebooks display and preview in the listings UI does not work in Chrome Incognito mode.

The following example shows how to create an effective sample notebook. It includes guidance for creating effective sample notebooks for your listings.

Marketplace starter notebook for data providers

Open notebook in new tab

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 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.

  • Public Marketplace: All consumers can browse and view the listing in the public Databricks Marketplace.

  • Private exchange: Only consumers who are members of a private exchange, created by you or another marketplace admin, can browse, view, and request the listing. See Create and manage private exchanges in Databricks Marketplace.

    You must select at least one private exchange from the drop-down list.

  • 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 Catalog 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 Notebook example: Sample notebook 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.

Analyze consumer activity with system tables (Public Preview)

If you have system tables enabled in your account you can use the Marketplace system tables to analyze consumer activity on your listings. For more information, see Marketplace system table reference.