Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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 warehouses grupo de comandos dentro da CLI Databricks permite-lhe gerir armazéns SQL. Um SQL warehouse é um recurso de computação que permite executar comandos SQL em objetos de dados dentro do Databricks SQL. Consulte Conectar-se a um Armazém SQL.
Databricks Armazéns Criar
Crie um novo SQL warehouse.
databricks warehouses create [flags]
Arguments
None
Opções
--auto-stop-mins int
O tempo, em minutos, que um warehouse SQL precisa estar inativo (sem consultas RUNNING) antes de ser desativado automaticamente.
--cluster-size string
Tamanho dos clusters alocados para este armazém de dados.
--creator-name string
Nome do criador do armazém.
--enable-photon
Configura se o armazém deve usar clusters otimizados para Photon.
--enable-serverless-compute
Configura se o depósito deve usar computação sem servidor.
--instance-profile-arn string
Deprecated.
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
--max-num-clusters int
Número máximo de clusters que o autoscaler criará para lidar com consultas simultâneas.
--min-num-clusters int
Número mínimo de clusters disponíveis que serão mantidos para este SQL warehouse.
--name string
Nome lógico para o cluster.
--no-wait
Não aguarde para atingir o estado RUNNING
--spot-instance-policy SpotInstancePolicy
Configurações que determinam se o armazém deve usar instâncias spot. Valores suportados: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
Tempo máximo para atingir RUNNING o estado (padrão 20ms)
--warehouse-type CreateWarehouseRequestWarehouseType
Tipo de armazém: PRO ou CLASSIC. Valores suportados: CLASSIC, PRO, TYPE_UNSPECIFIED
Examples
O exemplo a seguir cria um novo SQL warehouse com configuração básica:
databricks warehouses create --name "my-warehouse" --cluster-size "Small" --min-num-clusters 1 --max-num-clusters 10 --auto-stop-mins 60
O exemplo a seguir cria um depósito sem servidor com Photon habilitado:
databricks warehouses create --name "serverless-warehouse" --enable-serverless-compute --enable-photon --warehouse-type PRO
Databricks armazéns create-default-warehouse-override
Crie um override de armazém predefinido para um utilizador. Os utilizadores podem criar o seu próprio override. Os administradores podem criar sobreposições para qualquer utilizador.
databricks warehouses create-default-warehouse-override DEFAULT_WAREHOUSE_OVERRIDE_ID TYPE [flags]
Arguments
DEFAULT_WAREHOUSE_OVERRIDE_ID
O ID para a sobreposição. Use um ID de utilizador numérico ou a cadeia me literal para o utilizador atual.
TYPE
O tipo de comportamento de sobreposição. Valores suportados: CUSTOM, LAST_SELECTED.
Opções
--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 do recurso da substituição padrão do armazém.
--warehouse-id string
O ID específico do armazém quando o tipo é CUSTOM.
Examples
O exemplo seguinte cria uma sobreposição personalizada de armazém para o utilizador atual:
databricks warehouses create-default-warehouse-override me CUSTOM --warehouse-id 1234567890abcdef
Databricks armazéns excluir
Exclua um armazém SQL.
databricks warehouses delete ID [flags]
Arguments
ID
Required. Id do armazém SQL.
Opções
Examples
O exemplo a seguir exclui um depósito com a ID especificada:
databricks warehouses delete 1234567890abcdef
Databricks armazéns delete-default-warehouse-override
Eliminar o override padrão do warehouse para um utilizador. Os utilizadores podem eliminar o seu próprio override. Os administradores podem apagar sobrescrições para qualquer utilizador. Após a eliminação, é utilizado o armazém predefinido do workspace.
databricks warehouses delete-default-warehouse-override NAME [flags]
Arguments
NAME
O nome do recurso do armazém predefinido para eliminar. Formato: default-warehouse-overrides/{default_warehouse_override_id}. O ID pode ser um ID numérico de utilizador ou a cadeia me literal para o utilizador atual.
Opções
Examples
O exemplo seguinte elimina a sobreposição padrão do armazém para o utilizador atual:
databricks warehouses delete-default-warehouse-override default-warehouse-overrides/me
Databricks Armazéns Editar
Atualize um depósito. Atualiza a configuração de um SQL warehouse.
databricks warehouses edit ID [flags]
Arguments
ID
Required. ID do armazém a configurar.
Opções
--auto-stop-mins int
O tempo, em minutos, que um warehouse SQL precisa estar inativo (sem consultas RUNNING) antes de ser desativado automaticamente.
--cluster-size string
Tamanho dos clusters alocados para este armazém de dados.
--creator-name string
Nome do criador do armazém.
--enable-photon
Configura se o armazém deve usar clusters otimizados para Photon.
--enable-serverless-compute
Configura se o depósito deve usar computação sem servidor.
--instance-profile-arn string
Deprecated.
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
--max-num-clusters int
Número máximo de clusters que o autoscaler criará para lidar com consultas simultâneas.
--min-num-clusters int
Número mínimo de clusters disponíveis que serão mantidos para este SQL warehouse.
--name string
Nome lógico para o cluster.
--no-wait
Não espere para alcançar RUNNING estado
--spot-instance-policy SpotInstancePolicy
Configurações que determinam se o armazém deve usar instâncias spot. Valores suportados: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
Tempo máximo para atingir RUNNING o estado (padrão 20ms)
--warehouse-type EditWarehouseRequestWarehouseType
Tipo armazém. Valores suportados: CLASSIC, PRO, TYPE_UNSPECIFIED
Examples
O exemplo a seguir atualiza um depósito para alterar o tamanho do cluster e o tempo de parada automática:
databricks warehouses edit 1234567890abcdef --cluster-size "Medium" --auto-stop-mins 30
O exemplo a seguir habilita o Photon para um depósito existente:
databricks warehouses edit 1234567890abcdef --enable-photon
Os armazéns Databricks obtêm
Obtenha as informações para um único armazém SQL.
databricks warehouses get ID [flags]
Arguments
ID
Required. Id do armazém SQL.
Opções
Examples
O exemplo a seguir obtém informações sobre um depósito com a ID especificada:
databricks warehouses get 1234567890abcdef
Databricks warehouses get-default-warehouse-override
Obtenha o override padrão do armazém para um utilizador. Os utilizadores podem obter o seu próprio override. Os administradores podem buscar sobreposições para qualquer utilizador. Se não existir override, o armazém padrão do workspace é usado.
databricks warehouses get-default-warehouse-override NAME [flags]
Arguments
NAME
O nome do recurso do armazém padrão para recuperar. Formato: default-warehouse-overrides/{default_warehouse_override_id}. O ID pode ser um ID numérico de utilizador ou a cadeia me literal para o utilizador atual.
Opções
Examples
O exemplo seguinte obtém a substituição padrão do armazém para o utilizador atual:
databricks warehouses get-default-warehouse-override default-warehouse-overrides/me
armazéns de databricks get-workspace-warehouse-config
Obtenha a configuração no nível do espaço de trabalho que é compartilhada por todos os armazéns SQL em um espaço de trabalho.
databricks warehouses get-workspace-warehouse-config [flags]
Arguments
None
Opções
Examples
O seguinte exemplo obtém a configuração de armazenamento do espaço de trabalho.
databricks warehouses get-workspace-warehouse-config
Lista de Armazenamentos de Dados Databricks
Liste todos os armazéns SQL nos quais um usuário tem permissões de gerenciamento.
databricks warehouses list [flags]
Arguments
None
Opções
--run-as-user-id int
Principal de serviço que será usado para buscar a lista de armazéns.
Examples
O exemplo a seguir lista todos os armazéns:
databricks warehouses list
O exemplo a seguir lista armazéns que usam uma entidade de serviço específica:
databricks warehouses list --run-as-user-id 123456789
Databricks warehouses list-default-warehouse-overrides
Liste todos os overrides predefinidos do armazém no espaço de trabalho. Só os administradores de espaços de trabalho podem listar todas as sobrescrituras.
databricks warehouses list-default-warehouse-overrides [flags]
Opções
--page-size int
O número máximo de sobreposições a devolver.
--page-token string
Um token de página recebido de uma chamada anterior list-default-warehouse-overrides .
Examples
O exemplo seguinte lista todas as sobreposições padrão de armazém:
databricks warehouses list-default-warehouse-overrides
databricks warehouses definir-configuracao-de-armazem-de-espaco-de-trabalho
Defina a configuração no nível do espaço de trabalho que é compartilhada por todos os armazéns SQL em um espaço de trabalho.
databricks warehouses set-workspace-warehouse-config [flags]
Arguments
None
Opções
--google-service-account string
Apenas GCP: Conta de Serviço do Google usada para passar para o cluster para acessar o Google Cloud Storage.
--instance-profile-arn string
Somente AWS: Perfil de instância utilizado para passar a função IAM para o cluster.
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
--security-policy SetWorkspaceWarehouseConfigRequestSecurityPolicy
Política de segurança para armazéns. Valores suportados: DATA_ACCESS_CONTROL, NONE, PASSTHROUGH
Examples
O exemplo a seguir configura a configuração do armazém da área de trabalho com uma política de segurança:
databricks warehouses set-workspace-warehouse-config --security-policy DATA_ACCESS_CONTROL
Início dos armazéns Databricks
Inicie um armazém SQL.
databricks warehouses start ID [flags]
Arguments
ID
Required. Id do armazém SQL.
Opções
--no-wait
Não espere para alcançar RUNNING estado
--timeout duration
Tempo máximo para atingir RUNNING o estado (padrão 20ms)
Examples
O exemplo a seguir inicia um armazém com o ID especificado:
databricks warehouses start 1234567890abcdef
O exemplo a seguir inicia um armazém sem esperar que ele atinja o estado RUNNING:
databricks warehouses start 1234567890abcdef --no-wait
armazéns do databricks interrompem
Parar um armazém de dados SQL.
databricks warehouses stop ID [flags]
Arguments
ID
Required. Id do armazém SQL.
Opções
--no-wait
Não espere para alcançar STOPPED estado
--timeout duration
Tempo máximo para atingir STOPPED o estado (padrão 20ms)
Examples
O exemplo a seguir interrompe um armazém com o ID especificado:
databricks warehouses stop 1234567890abcdef
O exemplo a seguir interrompe um depósito sem esperar que ele atinja STOPPED o estado:
databricks warehouses stop 1234567890abcdef --no-wait
Databricks Warehouses Update-Default-Warehouse-Override
Atualize um override de armazém predefinido existente para um utilizador. Os utilizadores podem atualizar o seu próprio override. Os administradores podem atualizar as sobrescrituras para qualquer utilizador.
databricks warehouses update-default-warehouse-override NAME UPDATE_MASK TYPE [flags]
Arguments
NAME
O nome do recurso da substituição padrão do armazém. Formato: default-warehouse-overrides/{default_warehouse_override_id}.
UPDATE_MASK
Máscara de campo a especificar quais os campos a atualizar. Use * para atualizar todos os campos. Quando --allow-missing está definido, este campo é ignorado e todos os campos são aplicados.
TYPE
O tipo de comportamento de sobreposição. Valores suportados: CUSTOM, LAST_SELECTED.
Opções
--allow-missing
Se estiver definido e a substituição não for encontrada, crie uma nova substituição em vez disso.
--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 do recurso da substituição padrão do armazém.
--warehouse-id string
O ID específico do armazém quando o tipo é CUSTOM.
Examples
O exemplo seguinte atualiza a substituição do utilizador atual para um armazém específico:
databricks warehouses update-default-warehouse-override default-warehouse-overrides/me warehouse_id CUSTOM --warehouse-id 1234567890abcdef
Níveis de Permissão de Armazéns Databricks
Obtenha níveis de permissão do SQL warehouse.
databricks warehouses get-permission-levels WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
O SQL warehouse para o qual receber ou gerir permissões.
Opções
Examples
O exemplo a seguir obtém os níveis de permissão para um depósito:
databricks warehouses get-permission-levels 1234567890abcdef
Databricks Armazéns Obter Permissões
Obtenha as permissões de um SQL warehouse. Os armazéns SQL podem herdar permissões de seu objeto raiz.
databricks warehouses get-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
O SQL warehouse para o qual receber ou gerir permissões.
Opções
Examples
O exemplo a seguir obtém as permissões para um depósito:
databricks warehouses get-permissions 1234567890abcdef
Databricks Armazenamento de Dados Definir Permissões
Defina permissões do SQL warehouse. Define permissões em um objeto, substituindo as permissões existentes, se elas existirem. Exclui todas as permissões diretas se nenhuma for especificada. Os objetos podem herdar permissões de seu objeto raiz.
databricks warehouses set-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
O SQL warehouse para o qual receber ou gerir permissões.
Opções
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
Examples
O exemplo a seguir define permissões para um depósito usando um arquivo JSON:
databricks warehouses set-permissions 1234567890abcdef --json @permissions.json
Databricks Atualizar Permissões do Armazém de Dados
Atualize as permissões em um SQL warehouse. Os armazéns SQL podem herdar permissões de seu objeto raiz.
databricks warehouses update-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
O SQL warehouse para o qual receber ou gerir permissões.
Opções
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
Examples
O exemplo a seguir atualiza as permissões para um depósito usando um arquivo JSON:
databricks warehouses update-permissions 1234567890abcdef --json @permissions.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 arquivo para gravar logs de saída. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.
--log-format Formato
O tipo text de formato de log 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 ~/.databrickscfg arquivo 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