Compartilhar via


Grupo de comandos clean-room-assets

Note

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Visualização Pública.

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer provisionamentos de Dados de Uso.

O clean-room-assets grupo de comandos dentro da CLI do Databricks permite que você gerencie ativos de sala limpa. Os ativos de sala limpa são dados e objetos, como tabelas, volumes e notebooks, que são compartilhados com a sala limpa. Tipos de ativo de suporte: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, VIEW e VOLUME.

databricks clean-room-assets create

Crie um ativo de sala limpa. Para cada ativo do Unity Catalog que é adicionado por meio desse método, o proprietário da clean room também precisa ter privilégios suficientes para consumir o ativo. O privilégio deve ser mantido indefinidamente para que a sala limpa possa acessar o ativo. Normalmente, você deve usar um grupo como responsável pela sala limpa.

databricks clean-room-assets create CLEAN_ROOM_NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Nome da sala limpa.

Opções

--asset-type CleanRoomAssetAssetType

    O tipo do ativo. Valores com suporte: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, VIEW, VOLUME

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--name string

    Um nome totalmente qualificado que identifica exclusivamente o ativo dentro da sala limpa.

Sinalizadores globais

Examples

O exemplo a seguir cria um ativo de tabela em uma sala limpa:

databricks clean-room-assets create my-clean-room --asset-type TABLE --name "catalog.schema.table_name"

O exemplo a seguir cria um ativo de notebook em uma sala limpa:

databricks clean-room-assets create my-clean-room --asset-type NOTEBOOK_FILE --name "my_notebook.py"

O exemplo a seguir cria um ativo de volume em uma sala limpa:

databricks clean-room-assets create my-clean-room --asset-type VOLUME --name "catalog.schema.volume_name"

databricks clean-room-assets delete

Exclua um ativo de sala limpa. Descompartilhar e remover o ativo da sala limpa.

databricks clean-room-assets delete CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Nome da sala limpa.

ASSET_TYPE

    O tipo do ativo. Valores com suporte: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, VIEW, VOLUME

NAME

    O nome totalmente qualificado do ativo: ele é o mesmo que o campo nome em CleanRoomAsset.

Opções

Sinalizadores globais

Examples

O exemplo a seguir exclui um ativo de tabela de uma sala limpa:

databricks clean-room-assets delete my-clean-room TABLE "catalog.schema.table_name"

O exemplo a seguir exclui um ativo de notebook de uma sala limpa:

databricks clean-room-assets delete my-clean-room NOTEBOOK_FILE "my_notebook.py"

O exemplo a seguir exclui um ativo de volume de uma sala limpa:

databricks clean-room-assets delete my-clean-room VOLUME "catalog.schema.volume_name"

databricks clean-room-assets get

Obtenha os detalhes de um ativo de sala limpa pelo seu tipo e nome completo.

databricks clean-room-assets get CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Nome da sala limpa.

ASSET_TYPE

    O tipo do ativo. Valores com suporte: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, VIEW, VOLUME

NAME

    O nome totalmente qualificado do ativo: ele é o mesmo que o campo nome em CleanRoomAsset.

Opções

Sinalizadores globais

Examples

O exemplo a seguir obtém detalhes de um ativo de tabela em uma sala limpa.

databricks clean-room-assets get my-clean-room TABLE "catalog.schema.table_name"

O exemplo a seguir obtém detalhes de um ativo de notebook em uma sala limpa:

databricks clean-room-assets get my-clean-room NOTEBOOK_FILE "my_notebook.py"

O exemplo a seguir obtém detalhes de um ativo de visualização em uma sala limpa:

databricks clean-room-assets get my-clean-room VIEW "catalog.schema.view_name"

lista de ativos de sala limpa do databricks

Liste ativos em uma sala limpa.

databricks clean-room-assets list CLEAN_ROOM_NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Nome da sala limpa.

Opções

--page-token string

    Token de paginação não transparente que permite ir para a próxima página com base na consulta anterior.

Sinalizadores globais

Examples

O exemplo a seguir lista todos os ativos em uma sala limpa:

databricks clean-room-assets list my-clean-room

Atualização do conjunto de ativos do clean-room no Databricks

Atualize um ativo de sala limpa. Por exemplo, atualizando o conteúdo de um bloco de anotações ou alterando as partições compartilhadas de uma tabela.

databricks clean-room-assets update CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Nome da sala limpa.

ASSET_TYPE

    O tipo do ativo. Valores com suporte: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, VIEW, VOLUME

NAME

    Um nome totalmente qualificado que identifica exclusivamente o ativo dentro da sala limpa. Esse também é o nome exibido na interface do usuário da sala limpa. Para ativos protegíveis do Catálogo do Unity (tabelas, volumes etc.), o formato é shared_catalog.shared_schema.asset_name. Para blocos de anotações, o nome é o nome do arquivo do bloco de anotações.

Opções

--asset-type CleanRoomAssetAssetType

    O tipo do ativo. Valores com suporte: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, VIEW, VOLUME

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--name string

    Um nome totalmente qualificado que identifica exclusivamente o ativo dentro da sala limpa.

Sinalizadores globais

Examples

O exemplo a seguir atualiza um ativo de tabela em uma sala limpa:

databricks clean-room-assets update my-clean-room TABLE "catalog.schema.table_name" --json '{
  "asset_type": "TABLE",
  "name": "catalog.schema.table_name"
}'

O exemplo a seguir atualiza um ativo de notebook em uma sala limpa:

databricks clean-room-assets update my-clean-room NOTEBOOK_FILE "my_notebook.py" --name "updated_notebook.py"

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

    Exiba ajuda para a CLI do Databricks ou o grupo de comandos relacionado ou o comando relacionado.

--log-file corda

    Uma cadeia de caracteres que representa o arquivo para o qual gravar logs de saída. Se esse sinalizador não for especificado, o padrão será gravar logs de saída no stderr.

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desabilitado.

-o, --output tipo

    O tipo de saída de comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg para usar ao executar o comando. Se esse sinalizador não for especificado, se existir, o perfil nomeado DEFAULT será usado.

--progress-format formato

    O formato para exibir logs de progresso: default, append, inplace ou json

-t, --target corda

    Se aplicável, o destino do pacote a ser usado