warehouses
grupo de comando
Esta informação se aplica a Databricks CLI versões 0.205 e acima. A CLI do Databricks está em pré-visualização pública.
Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.
O grupo de comandos warehouses
dentro do Databricks CLI permite gerenciar um armazém SQL. Um " SQL warehouse " é um recurso " compute " que permite a execução de " SQL " comando em objetos de dados dentro de um " Databricks SQL". Consulte Conectar-se a um SQL warehouse.
armazéns de databricks criam
Crie um novo arquivo chamado “ SQL warehouse”.
databricks warehouses create [flags]
Argumentos
Nenhuma
Opções
--auto-stop-mins int
O tempo em minutos que um " SQL warehouse " deve permanecer parado (ou seja, sem consultas " RUNNING
") antes de ser automaticamente interrompido.
--cluster-size string
Tamanho do agrupamento alocado para este armazém.
--creator-name string
Nome do criador do armazém.
--enable-photon
Configura se o armazém deve utilizar um agrupamento otimizado d Photon.
--enable-serverless-compute
Configura se o armazém deve utilizar um serverless ou um compute.
--instance-profile-arn string
Obsoleto.
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--max-num-clusters int
Número máximo de agrupamentos que o autoescalador criará para lidar com consultas simultâneas.
--min-num-clusters int
Número mínimo de agrupamentos disponíveis que serão mantidos para este SQL warehouse.
--name string
Nome lógico para o agrupamento.
--no-wait
Não espere para atingir o estado RUNNING
--spot-instance-policy SpotInstancePolicy
Configurações sobre se o depósito deve usar instâncias spot. Valores suportados: COST_OPTIMIZED
, POLICY_UNSPECIFIED
, RELIABILITY_OPTIMIZED
--timeout duration
Tempo máximo para atingir o estado “ RUNNING
” (default 20ms)
--warehouse-type CreateWarehouseRequestWarehouseType
Tipo de armazém: PRO ou CLASSIC. Valores suportados: CLASSIC
, PRO
, TYPE_UNSPECIFIED
Exemplos
O exemplo a seguir cria um novo objeto 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 armazém de teste ( serverless ) com o recurso de controle de versão ( Photon ) habilitado:
databricks warehouses create --name "serverless-warehouse" --enable-serverless-compute --enable-photon --warehouse-type PRO
databricks, armazéns, excluir
Excluir um SQL warehouse.
databricks warehouses delete ID [flags]
Argumentos
ID
Obrigatório. ID do SQL warehouse.
Opções
Exemplos
O exemplo a seguir exclui um depósito com a ID especificada:
databricks warehouses delete 1234567890abcdef
edição de armazéns de databricks
Atualize um depósito. Atualiza a configuração de um SQL warehouse.
databricks warehouses edit ID [flags]
Argumentos
ID
Obrigatório. ID do depósito a ser configurado.
Opções
--auto-stop-mins int
O tempo em minutos que um " SQL warehouse " deve permanecer parado (ou seja, sem consultas " RUNNING
") antes de ser automaticamente interrompido.
--cluster-size string
Tamanho do agrupamento alocado para este armazém.
--creator-name string
Nome do criador do armazém.
--enable-photon
Configura se o armazém deve utilizar um agrupamento otimizado d Photon.
--enable-serverless-compute
Configura se o armazém deve utilizar um serverless ou um compute.
--instance-profile-arn string
Obsoleto.
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--max-num-clusters int
Número máximo de agrupamentos que o autoescalador criará para lidar com consultas simultâneas.
--min-num-clusters int
Número mínimo de agrupamentos disponíveis que serão mantidos para este SQL warehouse.
--name string
Nome lógico para o agrupamento.
--no-wait
Não espere para alcançar o estado RUNNING
--spot-instance-policy SpotInstancePolicy
Configurações sobre se o depósito deve usar instâncias spot. Valores suportados: COST_OPTIMIZED
, POLICY_UNSPECIFIED
, RELIABILITY_OPTIMIZED
--timeout duration
Tempo máximo para atingir o estado “ RUNNING
” (default 20ms)
--warehouse-type EditWarehouseRequestWarehouseType
Tipo de armazém. Valores suportados: CLASSIC
, PRO
, TYPE_UNSPECIFIED
Exemplos
O exemplo a seguir atualiza um armazém para alterar seu tamanho de agrupamento e 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
armazéns de databricks recebem
Obtenha as informações para um único SQL warehouse.
databricks warehouses get ID [flags]
Argumentos
ID
Obrigatório. ID do SQL warehouse.
Opções
Exemplos
O exemplo a seguir obtém informações sobre um armazém com o ID especificado:
databricks warehouses get 1234567890abcdef
lista de armazéns de databricks
Listar todos os armazéns SQL para os quais um usuário possui permissões de gerenciar.
databricks warehouses list [flags]
Argumentos
Nenhuma
Opções
--run-as-user-id int
entidade de serviço que será utilizada para buscar a lista de armazéns.
Exemplos
O exemplo a seguir lista todos os depósitos:
databricks warehouses list
O exemplo a seguir lista os armazéns que utilizam uma entidade de serviço específica:
databricks warehouses list --run-as-user-id 123456789
armazéns de dados começar
Iniciar a SQL warehouse.
databricks warehouses start ID [flags]
Argumentos
ID
Obrigatório. ID do SQL warehouse.
Opções
--no-wait
Não espere para alcançar o estado RUNNING
--timeout duration
Tempo máximo para atingir o estado “ RUNNING
” (default 20ms)
Exemplos
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 aguardar que ele atinja o estado “ RUNNING
”:
databricks warehouses start 1234567890abcdef --no-wait
Os armazéns da Databricks param
Interrompa um SQL warehouse.
databricks warehouses stop ID [flags]
Argumentos
ID
Obrigatório. ID do SQL warehouse.
Opções
--no-wait
Não espere para alcançar o estado STOPPED
--timeout duration
Tempo máximo para atingir o estado “ STOPPED
” (default 20ms)
Exemplos
O exemplo a seguir interrompe um depósito com a ID especificada:
databricks warehouses stop 1234567890abcdef
O exemplo a seguir interrompe um depósito sem esperar que ele atinja o estado STOPPED
:
databricks warehouses stop 1234567890abcdef --no-wait
armazéns de dados -workspace-warehouse-config
Obtenha a configuração de nível workspace que é compartilhada por todos os repositórios SQL em um workspace.
databricks warehouses get-workspace-warehouse-config [flags]
Argumentos
Nenhuma
Opções
Exemplos
O exemplo a seguir obtém a configuração do armazém workspace:
databricks warehouses get-workspace-warehouse-config
configuração do armazém do Databricks -workspace-warehouse-config
Defina a configuração do nível de segurança ( workspace ) que é compartilhada por todos os repositórios ( SQL ) em um repositório de configuração ( workspace).
databricks warehouses set-workspace-warehouse-config [flags]
Argumentos
Nenhuma
Opções
--google-service-account string
GCP Apenas: conta do serviço Google utilizada para passar para o agrupamento para acessar Google Cloud Storage.
--instance-profile-arn string
AWS Apenas: perfil de instância utilizado para passar IAM role para o agrupamento.
--json JSON
As cadeias de caracteres JSON ou o caminho @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
Exemplos
O exemplo a seguir define a configuração do armazém workspace com uma política de segurança:
databricks warehouses set-workspace-warehouse-config --security-policy DATA_ACCESS_CONTROL
os armazéns da Databricks obtêm níveis de permissão
Obtenha os níveis de permissão d SQL warehouse.
databricks warehouses get-permission-levels WAREHOUSE_ID [flags]
Argumentos
WAREHOUSE_ID
O SQL warehouse para o qual obter ou gerenciar permissões.
Opções
Exemplos
O exemplo a seguir obtém os níveis de permissão para um depósito:
databricks warehouses get-permission-levels 1234567890abcdef
repositórios de databricks obtêm permissões
Obtenha as permissões de um SQL warehouse. SQL O armazém pode herdar permissões do seu objeto raiz.
databricks warehouses get-permissions WAREHOUSE_ID [flags]
Argumentos
WAREHOUSE_ID
O SQL warehouse para o qual obter ou gerenciar permissões.
Opções
Exemplos
O exemplo a seguir obtém as permissões para um depósito:
databricks warehouses get-permissions 1234567890abcdef
repositórios de databricks definem permissões
Defina as permissões d SQL warehouse. Define as 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 do objeto raiz.
databricks warehouses set-permissions WAREHOUSE_ID [flags]
Argumentos
WAREHOUSE_ID
O SQL warehouse para o qual obter ou gerenciar permissões.
Opções
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
Exemplos
O exemplo a seguir define permissões para um armazém usando um arquivo JSON:
databricks warehouses set-permissions 1234567890abcdef --json @permissions.json
permissões de atualização de armazéns do databricks
Atualize as permissões em um SQL warehouse. SQL O armazém pode herdar permissões do seu objeto raiz.
databricks warehouses update-permissions WAREHOUSE_ID [flags]
Argumentos
WAREHOUSE_ID
O SQL warehouse para o qual obter ou gerenciar permissões.
Opções
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
Exemplos
O exemplo a seguir atualiza as permissões para um armazém utilizando um arquivo JSON:
databricks warehouses update-permissions 1234567890abcdef --json @permissions.json
Bandeiras globais
--debug
Se deve habilitar o registro de depuração.
-h
ou --help
Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.
--log-file
string
Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.
--log-format
Formato
O tipo de formato do log, text
ou json
. O valor de default é text
.
--log-level
string
Uma string que representa o nível de formato do log. Se não for especificado, o nível de formato do log será desativado.
-o, --output
Tipo
O tipo de saída do comando, text
ou json
. O valor de default é text
.
-p, --profile
string
O nome do perfil no arquivo ~/.databrickscfg
a ser utilizado para executar o comando. Se esse sinalizador não for especificado, se existir, o perfil chamado DEFAULT
será usado.
--progress-format
Formato
O formato para exibir o progresso logs: default
, append
, inplace
ou json
-t, --target
string
Se aplicável, o destino do pacote a ser usado