Pular para o conteúdo principal

clean-rooms grupo de comando

nota

Esta informação se aplica a Databricks CLI versões 0.205 e acima. A CLI do Databricks está em pré-visualização pública.

Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.

O grupo de comandos clean-rooms dentro do Databricks CLI permite gerenciar salas limpas. Uma sala limpa utiliza Delta Sharing e serverless compute para fornecer um ambiente seguro e que protege a privacidade, onde várias partes podem trabalhar em conjunto em dados empresariais confidenciais sem acesso direto aos dados uns dos outros. Consulte O que são salas limpas do Databricks?

salas limpas de databricks criam

Crie uma nova sala limpa com os colaboradores especificados. Esse método é assíncrono; o campo de nome retornado dentro do campo clean_room pode ser usado para pesquisar o status da sala limpa, usando o método get. Quando esse método retornar, a sala limpa estará no estado PROVISIONING, com apenas nome, proprietário, comentário, created_at e status preenchidos. A sala limpa poderá ser usada assim que entrar no estado ACTIVE.

O chamador deve ser administrador da metastore ou ter o privilégio CREATE_CLEAN_ROOM na metastore.

databricks clean-rooms create [flags]

Argumentos

Nenhuma

Opções

--comment string

Comente sobre a sala limpa.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--name string

O nome da sala limpa.

--owner string

Este é o nome de usuário Databricks do proprietário da sala limpa local protegida para gerenciamento de permissões.

Bandeiras globais

Exemplos

O exemplo a seguir cria uma sala limpa com nome e proprietário:

Bash
databricks clean-rooms create --name "my-clean-room" --owner "someone@example.com"

O exemplo a seguir cria uma sala limpa com um comentário:

Bash
databricks clean-rooms create --name "analytics-clean-room" --owner "someone@example.com" --comment "Clean room for analytics collaboration"

databricks clean-rooms create-output-catalog

Crie o catálogo de saída da sala limpa.

databricks clean-rooms create-output-catalog CLEAN_ROOM_NAME [flags]

Argumentos

CLEAN_ROOM_NAME

Nome da sala limpa.

Opções

--catalog-name string

O nome do catálogo de saída no Unity Catalog.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Exemplos

O exemplo a seguir cria um catálogo de saída para uma sala limpa:

Bash
databricks clean-rooms create-output-catalog my-clean-room --catalog-name "my_output_catalog"

databricks clean-rooms excluir

Exclua uma sala limpa. Após a exclusão, a sala limpa será removida do metastore. Se os outros colaboradores não tiverem excluído a sala limpa, eles ainda a terão em seu metastore, mas ela estará no estado EXCLUÍDA e nenhuma operação além da exclusão poderá ser realizada nela.

databricks clean-rooms delete NAME [flags]

Argumentos

NAME

Nome da sala limpa.

Opções

Bandeiras globais

Exemplos

O exemplo a seguir exclui uma sala limpa:

Bash
databricks clean-rooms delete my-clean-room

salas limpas de databricks obtêm

Obtenha os detalhes de uma sala limpa com seu nome.

databricks clean-rooms get NAME [flags]

Argumentos

NAME

Nome da sala limpa.

Opções

Bandeiras globais

Exemplos

O exemplo a seguir obtém detalhes de uma sala limpa:

Bash
databricks clean-rooms get my-clean-room

O exemplo a seguir obtém detalhes da sala limpa usando um perfil específico:

Bash
databricks clean-rooms get analytics-clean-room --profile production

lista de salas limpas de databricks

Liste todas as salas limpas da metastore. Somente as salas limpas às quais o chamador tem acesso são devolvidas.

databricks clean-rooms list [flags]

Argumentos

Nenhuma

Opções

--page-size int

Número máximo de salas limpas a serem devolvidas (ou seja, o tamanho da página).

--page-token string

Tokens de paginação opacos para avançar para a próxima página com base na consulta anterior.

Bandeiras globais

Exemplos

O exemplo a seguir lista todas as salas limpas acessíveis:

Bash
databricks clean-rooms list

O exemplo a seguir lista salas limpas com um tamanho de página específico:

Bash
databricks clean-rooms list --page-size 10

atualização de salas limpas do databricks

Atualize uma sala limpa. O chamador deve ser o proprietário da sala limpa, ter o privilégio MODIFY_CLEAN_ROOM ou ser administrador da metastore.

Quando o chamador é administrador da metastore, somente o campo owner pode ser atualizado.

databricks clean-rooms update NAME [flags]

Argumentos

NAME

Nome da sala limpa.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza uma sala limpa usando a configuração JSON:

Bash
databricks clean-rooms update my-clean-room --json '{"comment": "Updated clean room description"}'

O exemplo a seguir atualiza o proprietário de uma sala limpa (somente para administradores da metastore):

Bash
databricks clean-rooms update my-clean-room --json '{"owner": "new-someone@example.com"}'

O exemplo a seguir atualiza uma sala limpa usando um arquivo JSON:

Bash
databricks clean-rooms update my-clean-room --json @update-config.json

Bandeiras globais

--debug

Se deve habilitar o registro de depuração.

-h ou --help

Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file string

Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.

--log-format Formato

O tipo de formato do log, text ou json. O valor de default é text.

--log-level string

Uma string que representa o nível de formato do log. Se não for especificado, o nível de formato do log será desativado.

-o, --output Tipo

O tipo de saída do comando, text ou json. O valor de default é text.

-p, --profile string

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

--progress-format Formato

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

-t, --target string

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