Partilhar via


clean-rooms grupo de comando

Note

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Pré-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 disposições de Dados de Uso.

O clean-rooms grupo de comandos dentro da CLI Databricks permite-lhe gerir salas limpas. Uma sala limpa usa o Compartilhamento Delta e a computação sem servidor para fornecer um ambiente seguro e que protege a privacidade, onde várias partes podem trabalhar juntas em dados corporativos confidenciais sem acesso direto aos dados uns dos outros. Consulte O que é o Azure Databricks Clean Rooms?.

databricks salas limpas criar

Crie uma nova sala limpa com os colaboradores especificados. Este método é assíncrono; O campo Nome retornado dentro do campo clean_room pode ser usado para sondar o status da sala limpa, usando o método Get. Quando este método retornar, a sala limpa estará em um estado de PROVISIONING, com apenas nome, proprietário, comentário, criado_em e estado preenchidos. A sala limpa será utilizável assim que entrar em um ACTIVE estado.

O chamador deve ser um administrador do metastore ou ter o CREATE_CLEAN_ROOM privilégio no metastore.

databricks clean-rooms create [flags]

Arguments

None

Opções

--comment string

    Comentário para a sala limpa.

--json JSON

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

--name string

    O nome da sala limpa.

--owner string

    Este é o nome de utilizador do Databricks do proprietário da sala limpa local securável para gestão de permissões.

Bandeiras globais

Examples

O exemplo a seguir cria uma sala limpa com um 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 salas limpas criar-saída-catálogo

Crie o catálogo de output da sala limpa.

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

Arguments

CLEAN_ROOM_NAME

    Nome da sala limpa.

Opções

--catalog-name string

    O nome do catálogo de resultados no Unity Catalog.

--json JSON

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

Bandeiras globais

Examples

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 salas limpas excluir

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

databricks clean-rooms delete NAME [flags]

Arguments

NAME

    Nome da sala limpa.

Opções

Bandeiras globais

Examples

O exemplo a seguir exclui uma sala limpa:

databricks clean-rooms delete my-clean-room

databricks ambientes limpos acessar

Obtenha os detalhes de uma sala limpa dado o seu nome.

databricks clean-rooms get NAME [flags]

Arguments

NAME

    Nome da sala limpa.

Opções

Bandeiras globais

Examples

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

databricks clean-rooms get my-clean-room

O exemplo a seguir obtém informações sobre a sala limpa utilizando um perfil específico:

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

Lista de salas limpas Databricks

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

databricks clean-rooms list [flags]

Arguments

None

Opções

--page-size int

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

--page-token string

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

Bandeiras globais

Examples

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 clean-rooms da Databricks

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

Quando o chamador é um administrador de metastore, apenas o owner campo pode ser atualizado.

databricks clean-rooms update NAME [flags]

Arguments

NAME

    Nome da sala limpa.

Opções

--json JSON

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

Bandeiras globais

Examples

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 um proprietário de sala limpa (apenas administrador do 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 o log de depuração deve ser habilitado.

-h ou --help

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

--log-file string

    Uma cadeia de caracteres que representa o ficheiro onde os registos de saída são gravados. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

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

--log-level string

    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á desativado.

-o, --output tipo

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

-p, --profile string

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

--progress-format Formato

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

-t, --target string

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