Compartilhar via


Grupo de comandos account workspaces

Observação

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 account workspaces grupo de comandos dentro da CLI do Databricks contém comandos para gerenciar workspaces para sua conta. Um workspace do Databricks é um ambiente para acessar todos os ativos do Databricks. O workspace organiza objetos (notebooks, bibliotecas e experimentos) em pastas e fornece acesso a dados e recursos computacionais, como clusters e trabalhos. Veja Criar um workspace.

Observação

Esses comandos estarão disponíveis se sua conta estiver na versão E2 da plataforma ou em um plano personalizado selecionado que permita vários workspaces por conta.

criar workspaces de conta do databricks

Crie um novo workspace usando uma configuração de credencial e uma configuração de armazenamento, uma configuração de rede opcional (se estiver usando um VPC gerenciado pelo cliente), uma configuração de chave de serviços gerenciados opcional (se estiver usando chaves gerenciadas pelo cliente para serviços gerenciados pelo cliente) e uma configuração opcional de chave de armazenamento (se estiver usando chaves gerenciadas pelo cliente para armazenamento).

Importante

Esta operação é assíncrona. Uma resposta com o código de status HTTP 200 significa que a solicitação foi aceita e está em andamento, mas não significa que o workspace foi implantado com êxito e está em execução. O status inicial do workspace normalmente é PROVISIONAMENTO. Use o campo ID do workspace (workspace_id) na resposta para identificar o novo workspace e fazer solicitações repetidas GET com a ID do workspace e verificar seu status. O workspace fica disponível quando o status é alterado para RUNNING.

databricks account workspaces create [flags]

Opções

--workspace-name string

    O nome legível pelo ser humano do workspace.

--deployment-name string

    O nome da implantação define parte do subdomínio para o workspace.

--aws-region string

    A região do AWS para o workspace.

--cloud string

    O nome da nuvem.

--location string

    A região do Google Cloud do plano de dados do workspace em sua conta do Google (por exemplo, us-east4).

--credentials-id string

    ID do objeto de configuração de credencial do workspace.

--storage-configuration-id string

    ID do objeto de configuração de armazenamento do workspace.

--network-id string

    A ID do objeto de configuração de rede do workspace.

--managed-services-customer-managed-key-id string

    A ID do objeto de configuração de chave de criptografia de serviços gerenciados do workspace.

--storage-customer-managed-key-id string

    A ID do objeto de configuração de chave de criptografia de armazenamento do workspace.

--private-access-settings-id string

    ID do objeto de configurações de acesso privado do workspace.

--network-connectivity-config-id string

    A ID do objeto da configuração de conectividade de rede.

--compute-mode CustomerFacingComputeMode

    Se o modo de computação for SERVERLESS, um workspace sem servidor será criado. Valores com suporte: HYBRID e SERVERLESS.

--pricing-tier PricingTier

    O tipo de preço do workspace. Valores com suporte: COMMUNITY_EDITION, , DEDICATED, ENTERPRISE, PREMIUM, STANDARD, . UNKNOWN

--no-wait

    Não espere para chegar ao estado RUNNING.

--timeout duration

    Tempo máximo para atingir o estado RUNNING (padrão de 20m0s).

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

Exemplos

O exemplo a seguir cria um workspace usando JSON:

databricks account workspaces create --json '{"workspace_name": "my-workspace", "deployment_name": "my-workspace-deployment", "aws_region": "us-west-2", "credentials_id": "cred-abc123", "storage_configuration_id": "storage-xyz789"}'

O exemplo a seguir cria um workspace usando um arquivo JSON:

databricks account workspaces create --json @workspace.json

O exemplo a seguir cria um workspace com sinalizadores de linha de comando:

databricks account workspaces create --workspace-name "my-workspace" --deployment-name "my-workspace-deployment" --aws-region "us-west-2" --credentials-id "cred-abc123" --storage-configuration-id "storage-xyz789"

Exclusão de workspaces de conta do databricks

Exclua um workspace do Databricks, especificado pela ID.

databricks account workspaces delete WORKSPACE_ID [flags]

Argumentos

WORKSPACE_ID

    Uma ID de inteiro exclusiva para o workspace.

Opções

Sinalizadores globais

Exemplos

O exemplo a seguir exclui um workspace por ID:

databricks account workspaces delete 123456789

obter workspaces de conta do databricks

Obtenha informações, incluindo o status de um workspace do Databricks, especificado pela ID. Na resposta, o workspace_status campo indica o status atual. Após a criação inicial do workspace (que é assíncrono), faça solicitações repetidas GET com a ID do workspace e verifique seu status. O workspace fica disponível quando o status é alterado para RUNNING.

databricks account workspaces get WORKSPACE_ID [flags]

Argumentos

WORKSPACE_ID

    Uma ID de inteiro exclusiva para o workspace.

Opções

Sinalizadores globais

Exemplos

O exemplo a seguir obtém um workspace por ID:

databricks account workspaces get 123456789

Lista de workspaces de conta do databricks

Listar workspaces do Databricks para uma conta.

databricks account workspaces list [flags]

Opções

Sinalizadores globais

Exemplos

O exemplo a seguir lista todos os workspaces:

databricks account workspaces list

atualização de workspaces de conta do databricks

Atualize uma configuração de workspace.

databricks account workspaces update WORKSPACE_ID [flags]

Argumentos

WORKSPACE_ID

    Uma ID de inteiro exclusiva para o workspace.

Opções

--workspace-name string

    O nome legível pelo ser humano do workspace.

--deployment-name string

    O nome da implantação do workspace.

--aws-region string

    A região do AWS para o workspace.

--cloud string

    O nome da nuvem.

--location string

    A região do Google Cloud do plano de dados do workspace em sua conta do Google (por exemplo, us-east4).

--credentials-id string

    ID do objeto de configuração de credencial do workspace.

--storage-configuration-id string

    ID do objeto de configuração de armazenamento do workspace.

--network-id string

    Se esse workspace for VPC BYO, o network_id será preenchido.

--managed-services-customer-managed-key-id string

    ID da configuração de chave para criptografar serviços gerenciados.

--storage-customer-managed-key-id string

    ID da configuração de chave para criptografar o armazenamento do workspace.

--private-access-settings-id string

    ID do objeto de configurações de acesso privado do workspace.

--network-connectivity-config-id string

    A ID do objeto da configuração de conectividade de rede.

--expected-workspace-status WorkspaceStatus

    Um campo de propriedade do cliente usado para indicar o status do workspace no qual o cliente espera estar. Valores com suporte: BANNED, , CANCELLING, FAILED, NOT_PROVISIONED, PROVISIONING, . RUNNING

--update-mask string

    A máscara de campo deve ser uma única cadeia de caracteres, com vários campos separados por vírgulas (sem espaços).

--no-wait

    Não espere para chegar ao estado RUNNING.

--timeout duration

    Tempo máximo para atingir o estado RUNNING (padrão de 20m0s).

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

Exemplos

O exemplo a seguir atualiza um nome de workspace:

databricks account workspaces update 123456789 --workspace-name "updated-workspace-name"

O exemplo a seguir atualiza um workspace usando JSON:

databricks account workspaces update 123456789 --json '{"workspace_name": "updated-workspace-name", "credentials_id": "cred-new123"}'

O exemplo a seguir atualiza um workspace usando um arquivo JSON:

databricks account workspaces update 123456789 --json @update-workspace.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 onde serão gravados os 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 do comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg, que deverá ser usado para 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