clean-rooms
grupo de comando
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.
Exemplos
O exemplo a seguir cria uma sala limpa com nome e proprietário:
databricks clean-rooms create --name "my-clean-room" --owner "someone@example.com"
O exemplo a seguir cria uma sala limpa com um comentário:
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.
Exemplos
O exemplo a seguir cria um catálogo de saída para uma sala limpa:
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
Exemplos
O exemplo a seguir exclui uma sala limpa:
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
Exemplos
O exemplo a seguir obtém detalhes de uma sala limpa:
databricks clean-rooms get my-clean-room
O exemplo a seguir obtém detalhes da sala limpa usando um perfil específico:
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.
Exemplos
O exemplo a seguir lista todas as salas limpas acessíveis:
databricks clean-rooms list
O exemplo a seguir lista salas limpas com um tamanho de página específico:
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.
Exemplos
O exemplo a seguir atualiza uma sala limpa usando a configuração JSON:
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):
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:
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