Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Grupo de comandos
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 warehouses grupo de comandos dentro da CLI do Databricks permite que você gerencie os sql warehouses. Um SQL Warehouse é um recurso de computação que permite executar comandos SQL em objetos de dados no DATAbricks SQL. Consulte Conectar-se a um armazém de dados SQL.
criar databricks warehouses
Crie um novo armazém de dados SQL.
databricks warehouses create [flags]
Arguments
None
Opções
--auto-stop-mins int
O tempo em minutos que um SQL Warehouse deve estar ocioso (em outras palavras, sem consultas RUNNING) antes de ser automaticamente interrompido.
--cluster-size string
Tamanho dos clusters alocados para este depósito.
--creator-name string
Nome do criador do depósito.
--enable-photon
Configura se o depósito deve usar clusters otimizados para Photon.
--enable-serverless-compute
Configura se o warehouse deve usar computação sem servidor.
--instance-profile-arn string
Deprecated.
--json JSON
A cadeia de caracteres JSON inserida em linha 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 dimensionador automático 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 até alcançar o estado RUNNING
--spot-instance-policy SpotInstancePolicy
Configurações sobre se o depósito deve usar instâncias spot. Valores com suporte: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
Tempo máximo para atingir RUNNING o estado (padrão de 20ms)
--warehouse-type CreateWarehouseRequestWarehouseType
Tipo de armazém: PRO ou CLASSIC. Valores com suporte: 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 warehouse sem servidor com o Photon habilitado:
databricks warehouses create --name "serverless-warehouse" --enable-serverless-compute --enable-photon --warehouse-type PRO
Exclusão de warehouses do Databricks
Excluir um armazém de dados SQL.
databricks warehouses delete ID [flags]
Arguments
ID
Required. ID do SQL warehouse.
Opções
Examples
O exemplo a seguir exclui um warehouse com a ID especificada:
databricks warehouses delete 1234567890abcdef
Edição de Warehouses do Databricks
Atualize um depósito. Atualiza a configuração de um SQL Warehouse.
databricks warehouses edit ID [flags]
Arguments
ID
Required. Identificador do armazém para configuração.
Opções
--auto-stop-mins int
O tempo em minutos que um SQL Warehouse deve estar ocioso (em outras palavras, sem consultas RUNNING) antes de ser automaticamente interrompido.
--cluster-size string
Tamanho dos clusters alocados para este depósito.
--creator-name string
Nome do criador do depósito.
--enable-photon
Configura se o depósito deve usar clusters otimizados para Photon.
--enable-serverless-compute
Configura se o warehouse deve usar computação sem servidor.
--instance-profile-arn string
Deprecated.
--json JSON
A cadeia de caracteres JSON inserida em linha 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 dimensionador automático 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 chegar ao estado RUNNING
--spot-instance-policy SpotInstancePolicy
Configurações sobre se o depósito deve usar instâncias spot. Valores com suporte: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
Tempo máximo para atingir RUNNING o estado (padrão de 20ms)
--warehouse-type EditWarehouseRequestWarehouseType
Tipo de armazém. Valores com suporte: 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 armazém existente:
databricks warehouses edit 1234567890abcdef --enable-photon
databricks warehouses obter
Obtenha as informações de um único sql warehouse.
databricks warehouses get ID [flags]
Arguments
ID
Required. ID do SQL warehouse.
Opções
Examples
O exemplo a seguir obtém informações sobre um warehouse com a ID especificada:
databricks warehouses get 1234567890abcdef
Lista de Warehouses do Databricks
Liste todos os sql warehouses nos quais um usuário tem permissões de gerenciamento.
databricks warehouses list [flags]
Arguments
None
Opções
--run-as-user-id int
Entidade de Serviço que será usada para buscar a lista de depósitos.
Examples
O exemplo a seguir lista todos os armazéns:
databricks warehouses list
O exemplo a seguir lista os armazéns usando um principal de serviço específico:
databricks warehouses list --run-as-user-id 123456789
databricks armazéns iniciar
Inicie um sql warehouse.
databricks warehouses start ID [flags]
Arguments
ID
Required. ID do SQL warehouse.
Opções
--no-wait
Não espere para chegar ao estado RUNNING
--timeout duration
Tempo máximo para atingir RUNNING o estado (padrão de 20ms)
Examples
O exemplo a seguir inicia um warehouse com a ID especificada:
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 interromper
Parar um SQL warehouse.
databricks warehouses stop ID [flags]
Arguments
ID
Required. ID do SQL warehouse.
Opções
--no-wait
Não espere para chegar ao estado STOPPED
--timeout duration
Tempo máximo para atingir STOPPED o estado (padrão de 20ms)
Examples
O exemplo a seguir interrompe um depósito com o ID especificado:
databricks warehouses stop 1234567890abcdef
O exemplo a seguir interrompe um armazém sem esperar que ele atinja o STOPPED estado:
databricks warehouses stop 1234567890abcdef --no-wait
databricks warehouses get-workspace-warehouse-config
Obtenha a configuração do nível do workspace que é compartilhada por todos os depósitos SQL em um workspace.
databricks warehouses get-workspace-warehouse-config [flags]
Arguments
None
Opções
Examples
O exemplo a seguir obtém a configuração do depósito do workspace:
databricks warehouses get-workspace-warehouse-config
databricks warehouses set-workspace-warehouse-config
Defina a configuração no nível do workspace que é compartilhada por todos os SQL Warehouses em um workspace.
databricks warehouses set-workspace-warehouse-config [flags]
Arguments
None
Opções
--google-service-account string
Somente 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 usado para passar a função IAM para o cluster.
--json JSON
A cadeia de caracteres JSON inserida em linha 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 com suporte: DATA_ACCESS_CONTROL, NONE, PASSTHROUGH
Examples
O exemplo a seguir define a configuração do workspace warehouse com uma política de segurança:
databricks warehouses set-workspace-warehouse-config --security-policy DATA_ACCESS_CONTROL
databricks warehouses obter-níveis-de-permissão
Obter 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 obter ou gerenciar permissões.
Opções
Examples
O exemplo a seguir obtém os níveis de permissão de um armazém:
databricks warehouses get-permission-levels 1234567890abcdef
obter permissões de databricks warehouses
Obtenha as permissões de um armazém de dados SQL. Os sql warehouses podem herdar permissões de seu objeto raiz.
databricks warehouses get-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
O SQL Warehouse para o qual obter ou gerenciar permissões.
Opções
Examples
O exemplo a seguir obtém as permissões para um warehouse:
databricks warehouses get-permissions 1234567890abcdef
databricks warehouses definir-permissões
Defina permissões do SQL Warehouse. Define permissões em um objeto, substituindo as permissões existentes se elas existirem. Excluirá 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 obter ou gerenciar permissões.
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.
Examples
O exemplo a seguir define permissões para um warehouse usando um arquivo JSON:
databricks warehouses set-permissions 1234567890abcdef --json @permissions.json
databricks warehouses atualizar permissões
Atualize as permissões em um SQL Warehouse. Os sql warehouses podem herdar permissões de seu objeto raiz.
databricks warehouses update-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
O SQL Warehouse para o qual obter ou gerenciar permissões.
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.
Examples
O exemplo a seguir atualiza permissões para um warehouse usando um arquivo JSON:
databricks warehouses update-permissions 1234567890abcdef --json @permissions.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