Pular para o conteúdo principal

account workspaces grupo de comandos

nota

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

O uso CLI Databricks está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer fornecimento de Dados de Uso.

O grupo de comandos account workspaces dentro da CLIDatabricks contém comandos para gerenciar o espaço de trabalho da sua account. Um workspace Databricks é um ambiente para acessar todos os seus ativos Databricks . O workspace organiza objetos (notebook, biblioteca e experimentos) em pastas e fornece acesso a dados e recursos computacionais, como clusters e tarefas. Consulte Criar um workspace.

nota

Esses comandos estão disponíveis se sua account estiver na versão E2 da plataforma ou em um plano personalizado selecionado que permite vários espaços de trabalho por account.

Criar espaço de trabalho account Databricks

Crie um novo workspace usando uma configuração de credenciais e uma configuração de armazenamento, uma configuração de rede opcional (se estiver usando uma VPC de gerenciamento de cliente), uma configuração key de serviço opcional (se estiver usando uma chave de gerenciamento de cliente para o serviço) e uma configuração key de armazenamento opcional (se estiver usando uma chave de gerenciamento de cliente para o 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 sucesso e está em execução. O estado inicial workspace é normalmente provisionamento. Use o campo de ID workspace (workspace_id) na resposta para identificar o novo workspace e faça solicitações GET repetidas com o ID workspace e verifique seu status. O workspace fica disponível quando o status muda para EM EXECUÇÃO.

databricks account workspaces create [flags]

Opções

--workspace-name string

O nome legível para humanos do workspace.

--deployment-name string

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

--aws-region string

A região AWS para o workspace.

--cloud string

O nome cloud .

--location string

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

--credentials-id string

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

--storage-configuration-id string

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

--network-id string

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

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

O ID do objeto de configuração key de criptografia do serviço do workspace.

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

O ID do objeto de configuração key 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

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

--compute-mode CustomerFacingComputeMode

Se o modo compute for sem servidor, um workspace serverless será criado. Valores suportados: HYBRID, SERVERLESS.

--pricing-tier PricingTier

Os níveis de preço para o workspace. Valores suportados: COMMUNITY_EDITION, DEDICATED, ENTERPRISE, PREMIUM, STANDARD, UNKNOWN.

--no-wait

Não espere até que o estado esteja em execução (RUNNING).

--timeout duration

Tempo máximo para atingir o estado RUNNING (default 20m0s).

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

Bandeiras globais

Exemplos

O exemplo a seguir cria um workspace usando JSON:

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

Bash
databricks account workspaces create --json @workspace.json

O exemplo a seguir cria um workspace com opções de linha de comando:

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

excluir espaço de trabalho account do Databricks

Excluir um workspace Databricks , especificado pelo ID.

databricks account workspaces delete WORKSPACE_ID [flags]

Argumentos

WORKSPACE_ID

Um ID inteiro único para o workspace.

Opções

Bandeiras globais

Exemplos

O exemplo a seguir exclui um workspace por ID:

Bash
databricks account workspaces delete 123456789

obter espaço de trabalho account do Databricks

Obtenha informações, incluindo o status, de um workspace Databricks , especificado pelo ID. Na resposta, o campo workspace_status indica o estado atual. Após a criação inicial workspace (que é assíncrona), faça solicitações GET repetidas com o ID workspace e verifique seu status. O workspace fica disponível quando o status muda para EM EXECUÇÃO.

databricks account workspaces get WORKSPACE_ID [flags]

Argumentos

WORKSPACE_ID

Um ID inteiro único para o workspace.

Opções

Bandeiras globais

Exemplos

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

Bash
databricks account workspaces get 123456789

lista de espaços de trabalho account Databricks

Liste os espaços de trabalho Databricks para uma account.

databricks account workspaces list [flags]

Opções

Bandeiras globais

Exemplos

O exemplo a seguir lista todos os espaços de trabalho:

Bash
databricks account workspaces list

atualização do espaço de trabalho account Databricks

Atualizar a configuração workspace .

databricks account workspaces update WORKSPACE_ID [flags]

Argumentos

WORKSPACE_ID

Um ID inteiro único para o workspace.

Opções

--workspace-name string

O nome legível para humanos do workspace.

--deployment-name string

O nome de implantação para o workspace.

--aws-region string

A região AWS para o workspace.

--cloud string

O nome cloud .

--location string

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

--credentials-id string

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

--storage-configuration-id string

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

--network-id string

Se este workspace for BYOV VPC personalizada), o network_id será preenchido automaticamente.

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

ID da configuração da key para criptografia do serviço gerenciado.

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

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

--private-access-settings-id string

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

--network-connectivity-config-id string

O 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 workspace em que o cliente espera estar. Valores suportados: BANNED, CANCELLING, FAILED, NOT_PROVISIONED, PROVISIONING, RUNNING.

--update-mask string

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

--no-wait

Não espere até que o estado esteja em execução (RUNNING).

--timeout duration

Tempo máximo para atingir o estado RUNNING (default 20m0s).

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza o nome de um workspace :

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

O exemplo a seguir atualiza um workspace usando JSON:

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

Bash
databricks account workspaces update 123456789 --json @update-workspace.json

Bandeiras globais

--debug

Ativar ou não o registro de depuração.

-h ou --help

Exibir ajuda para a CLI Databricks , o grupo de comandos relacionado ou o comando específico.

--log-file string

Uma sequência de caracteres representando o arquivo no qual logs de saída serão gravados. Se essa opção não for especificada, o default é gravar logs de saída em stderr.

--log-format Formato

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

--log-level string

Uma sequência de caracteres representando o nível de formato log . Caso não seja especificado, o nível de formato log será desativado.

-o, --output Tipo

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

-p, --profile string

O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se este sinalizador não for especificado, então, se existir, o perfil denominado 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 pacote de destino a ser usado.