Listing Properties Reference

This topic describes the fields for capabilities that you can configure for a listing. Depending on the capabilities you specified when creating a listing, different sections are displayed.

In this Topic:

Basic Information

The following table describes the available fields in the Basic Information section.

Field Name

Description

Example

Listing Type

The type of listing. After you publish a listing, the listing type and secure share cannot be changed.

Available Values: Free, Personalized, or Paid.

Profile

Name of the provider profile that owns the share. You must create a provider profile before you can publish a listing.

This option is not available for free (or paid off-platform) private listings.

Title

The title of the dataset. The listing title cannot exceed 110 characters, but it is recommended that the title is between 40-60 characters. All major words should be capitalized (i.e. follow the title case format). . The title appears below your company name on the listing tile, and it must be unique (i.e. different from any other listings you may have). .

If you decide to use a Free listing to showcase a subset of your data, and a Personalized listing to allow consumers to request the full dataset, make sure to distinguish the two listings with different but related titles.

For example, you can use <title-demo> for the Free listing and <title> for the Personalized listing.

Free listings used to showcase other personalized listings should use a -Demo or - Sample suffix.

Free listings available for a limited time should use a - Trial suffix.

Historical Weather by Postcode.

Subtitle

Subtitle of the data listing. The subtitle cannot exceed 110 characters, and only the first word of the subtitle should be capitalized. The title and subtitle should not be redundant.

This option is not available for free (or paid off-platform) private listings.

Historical weather data by location.

Category

Data listings are categorized for easy discovery. Select the desired category from the drop-down list of available values.

This option is not available for free (or paid off-platform) private listings.

Terms of Service

Specifies a link to the Terms of Service agreement for the listing. Consumers accept the terms before they can access the listing. Terms of Service agreements are required for free listings, and are optional for personalized listings.

Select one of the following:

  • Standard Agreement for Marketplace Products: Snowflake provides a standard terms of service agreement for Snowflake Marketplace products, called the Standard Agreement for Marketplace Products. This agreement is available at: https://www.snowflake.com/marketplace/standard-agreement/. You can choose to use the Standard Agreement as the terms of service agreement for your listing. You can learn more about the Standard Agreement by reviewing the FAQs available at: https://www.snowflake.com/standard-agreement-for-marketplace-products/.

    By selecting the Standard Agreement for Marketplace Products, you’re confirming that you’ve reviewed it and the Disclaimer with your legal counsel.

  • Custom: Allows you to specify a URL to a terms of service agreement for your listing.

https://www.example.com/en/legal

Details

The following table describes the available fields in the Details section.

Field Name

Description

Example

Description

Description of the shared dataset. The description should be between 250 and 6000 characters, with line breaks between paragraphs. Use dashes in lieu of bullet points. The description must include: . (a) Introductory paragraph with scale of data . (b) Description of included tables/views . (c) Key data fields . For data enrichment and services listings, the description must include the expected workflow for consumers to access your services or secure functions. The description can optionally include sources or additional information not covered in other input fields.

ACME is the number one supplier of customized, pinpoint weather warnings to large enterprises, as well as a vital information source for worldwide weather forecasts, data and meteorological consulting services. This data is historical weather data for US zip codes that can be used to further enhance your existing data to provide deeper analytics. . Samples/tables included: . - Daily historical weather data from 2016-Present . - 15-day Daily Forecast weather data . - Daily 15-year climatology data (weather statistics, i.e. avg, std, freq, etc.) . Fields included: . - Date . - Zip Code . - Country . - Min, Max, Avg weather statistics (temperature, precipitation, wind, humidity, etc.)

Link to Documentation

A link to a page on provider’s website with more detailed documentation. Documentation must be clear, and reference the right schema objects present in the share. The link must be accessible, and not locked behind a login screen.

https://developer.acme.com

Data Product - Secure Share

The Data Product - Secure Share section enables you to configure the share that is associated with a listing.

  • Secure shares can only be attached to one listing.

  • After the listing is published, you cannot attach a different share.

  • You can only see shares owned by your current role — ACCOUNTADMIN.

  • The data product must be legally shareable (i.e. you must own the data or have the right to share it).

  • Until a listing is published, it can only be associated with a share in the local/primary account. After the listing is published, it can be associated with a share in additional regions that you have selected.

Field Name

Description

Database Objects or Secure Share

Data you wish to share.

This section is only available for free data listings.

Data Product - Attributes

After specifying a data product, you can define additional attributes for a listing.

Note

This section is optional for private listings.

Field Name

Description

Update Frequency

How often your data product is updated to Snowflake

Geographic Coverage

What geographic area that the data covers.

Time Range

The range of time that the data covers.

Additional attributes (optional)

Any additional information that you want to communicate to your users. For example, include a description of the scope and scale of your data, and why someone will find your data useful.

Business Needs

The following table describes the available fields in the Business Needs section.

Field Name

Description

Business Need

Data listings are grouped by business needs for easy discovery. You can select up to six business needs for your listing. If you do not see a relevant business need in the drop-down list, you can create a custom one.

Consumers can easily discover listings based on business needs available in the drop-down list. However, the custom business needs that you add are not included the list and are only visible in your listing details. You can edit the list of business needs at any time without resubmitting the listing for approval.

Description

Description of how your data or data service addresses the business need.

Region Availability (Marketplace Listings Only)

The following table describes the available fields in the Region Availability section.

Field Name

Description

Global Availability

  • If Global Availability is On (default):

    By default, a listing is available to consumers in all current Marketplace regions. The listing is automatically available in any region that Snowflake adds in the future.

    Selecting Global Availability for your listing doesn’t automatically replicate your listing’s product. You must replicate the product to the regions where you want to make the product available. You can edit the Region Availability at any time without re-submitting the listing for administrator’s approval. If you remove a region where the listing was previously available, consumers in that region will no longer be able to get or purchase the listing’s product.

  • If Global Availability is Off:

    By turning off Global Availability, you can specify settings for auto-fulfillment. Disabling this setting makes listings available only in their selected regions. Also the listings do not automatically become available to new regions Snowflake adds in the future.

    See Configuring Auto-fulfillment for a Listing for more information.

Sample SQL Queries

You can specify a valid sample SQL query that consumers can use to verify that your data product was successfully installed in their Snowflake account.

Note

A valid SQL query is required in order for you to publish a Marketplace listing. SQL queries are optional when publishing a private listings.

The sample SQL has the following requirements:

  • The query must return at least one row.

  • The query must reference objects that are explicitly in the share.

  • Objects must be qualified using SCHEMA.OBJECT. Do not include the database name. For example, EXAMPLE_SCHEMA.TABLE_A.

Field Name

Description

Title

The title of your SQL example query.

Description

A general description of the query.

Query

The SQL query

Select a warehouse for query validation

The warehouse that should be used to run the example SQL query.

Consumer Accounts (Private Listing Only)

If you are configuring a private listing, you must configure the fields in the following table.

Field Name

Description

Example

Consumer Accounts

Specifies the Snowflake accounts that you want to share your private listing with. You can use Snowflake account identifiers or URLs.

ORGABC.ACCOUNT123 https://<organization_name>-<account_name>.snowflakecomputing.com

If you’re sharing with a consumer account that is in a different region than your account, you are prompted to set up replication.

Field Name

Description

Auto-fulfillment

Enables you to select the replication interval and frequency. For example, you can configure replication to occur every two hours.

See Configuring Auto-fulfillment for a Listing for more information.

Back to top