Skip to main content

clean-room-asset-revisions command group

note

This information applies to Databricks CLI versions 0.205 and above. The Databricks CLI is in Public Preview.

Databricks CLI use is subject to the Databricks License and Databricks Privacy Notice, including any Usage Data provisions.

The clean-room-asset-revisions command group within the Databricks CLI contains commands to manage asset revisions in clean rooms. These revisions denote new versions of uploaded assets (for example, notebooks) in the clean room.

databricks clean-room-asset-revisions get

Get a specific revision of an asset in a clean room.

databricks clean-room-asset-revisions get CLEAN_ROOM_NAME ASSET_TYPE NAME ETAG [flags]

Arguments

CLEAN_ROOM_NAME

    Name of the clean room.

ASSET_TYPE

    Asset type. Currently only NOTEBOOK_FILE is supported. Supported values: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, VIEW, VOLUME.

NAME

    Name of the asset.

ETAG

    Revision etag to fetch. If not provided, the latest revision will be returned.

Options

Global flags

Examples

The following example gets a specific revision of a notebook asset:

Bash
databricks clean-room-asset-revisions get my-clean-room NOTEBOOK_FILE my-notebook etag-12345

The following example gets the latest revision of a notebook asset:

Bash
databricks clean-room-asset-revisions get my-clean-room NOTEBOOK_FILE my-notebook ""

databricks clean-room-asset-revisions list

List all revisions for an asset in a clean room.

databricks clean-room-asset-revisions list CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Name of the clean room.

ASSET_TYPE

    Asset type. Currently only NOTEBOOK_FILE is supported. Supported values: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, VIEW, VOLUME.

NAME

    Name of the asset.

Options

--page-size int

    Maximum number of asset revisions to return per page.

--page-token string

    Token to retrieve the next page of results.

Global flags

Examples

The following example lists all revisions for a notebook asset:

Bash
databricks clean-room-asset-revisions list my-clean-room NOTEBOOK_FILE my-notebook

The following example lists asset revisions with pagination:

Bash
databricks clean-room-asset-revisions list my-clean-room NOTEBOOK_FILE my-notebook --page-size 10

Global flags

--debug

  Whether to enable debug logging.

-h or --help

    Display help for the Databricks CLI or the related command group or the related command.

--log-file string

    A string representing the file to write output logs to. If this flag is not specified then the default is to write output logs to stderr.

--log-format format

    The log format type, text or json. The default value is text.

--log-level string

    A string representing the log format level. If not specified then the log format level is disabled.

-o, --output type

    The command output type, text or json. The default value is text.

-p, --profile string

    The name of the profile in the ~/.databrickscfg file to use to run the command. If this flag is not specified then if it exists, the profile named DEFAULT is used.

--progress-format format

    The format to display progress logs: default, append, inplace, or json

-t, --target string

    If applicable, the bundle target to use