provider_exchange_listings

Creates, updates, deletes, gets or lists a provider_exchange_listings resource.

Overview

Name	provider_exchange_listings
Type	Resource
Id	databricks_workspace.marketplace.provider_exchange_listings

Fields

The following fields are returned by SELECT queries:

list_for_listing

Name	Datatype	Description
id	string
exchange_id	string
listing_id	string
exchange_name	string
listing_name	string
created_at	integer
created_by	string

list_for_exchange

Name	Datatype	Description

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_for_listing	select	listing_id, deployment_name, workspace_domain	page_size, page_token	List exchanges associated with a listing
list_for_exchange	select	exchange_id, deployment_name, workspace_domain	page_size, page_token	List listings associated with an exchange
add	insert	deployment_name, workspace_domain, listing_id, exchange_id		Associate an exchange with a listing
delete	delete	id, deployment_name, workspace_domain		Disassociate an exchange with a listing

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
deployment_name	string	The Databricks workspace deployment name: the host prefix of the workspace URL (dbc-abcd0123-a1bc on AWS, adb-1234567890123456.7 on Azure, 1234567890123456.7 on GCP). Set DATABRICKS_DEPLOYMENT_NAME to default it for the session. (default: dbc-abcd0123-a1bc, x-stackQL-envVar: DATABRICKS_DEPLOYMENT_NAME)
exchange_id	string
id	string
listing_id	string
workspace_domain	string	The Databricks workspace domain suffix for the cloud. Selected by DATABRICKS_CLOUD (aws, azure or gcp; default aws). (default: cloud.databricks.com, x-stackQL-envVarSelector: {"envVar":"DATABRICKS_CLOUD","default":"aws","values":{"aws":"cloud.databricks.com","azure":"azuredatabricks.net","gcp":"gcp.databricks.com"}})
page_size	integer
page_token	string

SELECT examples

list_for_listing

List exchanges associated with a listing

SELECT
id,
exchange_id,
listing_id,
exchange_name,
listing_name,
created_at,
created_by
FROM databricks_workspace.marketplace.provider_exchange_listings
WHERE listing_id = '{{ listing_id }}' -- required
AND deployment_name = '{{ deployment_name }}' -- required
AND workspace_domain = '{{ workspace_domain }}' -- required
AND page_size = '{{ page_size }}'
AND page_token = '{{ page_token }}'
;

list_for_exchange

List listings associated with an exchange

SELECT
*
FROM databricks_workspace.marketplace.provider_exchange_listings
WHERE exchange_id = '{{ exchange_id }}' -- required
AND deployment_name = '{{ deployment_name }}' -- required
AND workspace_domain = '{{ workspace_domain }}' -- required
AND page_size = '{{ page_size }}'
AND page_token = '{{ page_token }}'
;

INSERT examples

add

Associate an exchange with a listing

INSERT INTO databricks_workspace.marketplace.provider_exchange_listings (
listing_id,
exchange_id,
deployment_name,
workspace_domain
)
SELECT 
'{{ listing_id }}' /* required */,
'{{ exchange_id }}' /* required */,
'{{ deployment_name }}',
'{{ workspace_domain }}'
RETURNING
exchange_for_listing
;

Manifest

# Description fields are for documentation purposes
- name: provider_exchange_listings
props:
  - name: deployment_name
    value: "{{ deployment_name }}"
    description: Required parameter for the provider_exchange_listings resource.
  - name: workspace_domain
    value: "{{ workspace_domain }}"
    description: Required parameter for the provider_exchange_listings resource.
  - name: listing_id
    value: "{{ listing_id }}"
  - name: exchange_id
    value: "{{ exchange_id }}"

DELETE examples

delete

Disassociate an exchange with a listing

DELETE FROM databricks_workspace.marketplace.provider_exchange_listings
WHERE id = '{{ id }}' --required
AND deployment_name = '{{ deployment_name }}' --required
AND workspace_domain = '{{ workspace_domain }}' --required
;