Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 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 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
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
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
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
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
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