Compartilhar via


Grupo de comandos clean-rooms

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-rooms grupo de comandos dentro da CLI do Databricks permite que você gerencie salas limpas. Uma sala limpa usa o Compartilhamento Delta e a computação sem servidor para fornecer um ambiente seguro e de proteção de privacidade, em que várias partes podem trabalhar juntas em dados corporativos confidenciais sem acesso direto aos dados uns dos outros. Confira O que é o Azure Databricks Clean Rooms?.

criar salas limpas do databricks

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 sondar o status da sala limpa, usando o método get. Quando este método retornar, a sala limpa estará no estado PROVISIONING, com apenas os campos name, owner, comment, created_at e status preenchidos. A sala limpa estará utilizável assim que entrar no estado ACTIVE.

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

    Deixe um comentário sobre a sala limpa.

--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

    O nome da sala limpa.

--owner string

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

Sinalizadores globais

Examples

O exemplo a seguir cria uma sala limpa com um nome e um 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]

Arguments

CLEAN_ROOM_NAME

    Nome da sala limpa.

Opções

--catalog-name string

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

--json JSON

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

Sinalizadores 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 exclusão de salas limpas

Excluir 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 terão a sala limpa em seu metastore, mas ela estará em um estado DELETED e nenhuma 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

Sinalizadores globais

Examples

O exemplo a seguir exclui uma sala limpa:

databricks clean-rooms delete my-clean-room

databricks clean-rooms get

Obtenha os detalhes de uma sala limpa com seu nome.

databricks clean-rooms get NAME [flags]

Arguments

NAME

    Nome da sala limpa.

Opções

Sinalizadores globais

Examples

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

databricks clean-rooms get my-clean-room

O seguinte exemplo obtém detalhes de sala limpa usando um perfil específico:

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

lista de Databricks Clean-Rooms

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

databricks clean-rooms list [flags]

Arguments

None

Opções

--page-size int

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

--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 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 do metastore.

Quando o chamador é um administrador do metastore, somente 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 inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

Sinalizadores 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 seguinte exemplo 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

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