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 warehouses criar-default-warehouse-override
Crie uma configuração default de armazenamento de dados para um usuário. Os usuários podem criar suas próprias configurações personalizadas. Os administradores podem criar configurações personalizadas para qualquer usuário.
databricks warehouses create-default-warehouse-override DEFAULT_WAREHOUSE_OVERRIDE_ID TYPE [flags]
Argumentos
DEFAULT_WAREHOUSE_OVERRIDE_ID
O ID para a substituição. Use um ID de usuário numérico ou as strings literais me para o usuário atual.
TYPE
O tipo de comportamento de sobreposição. Valores suportados: CUSTOM, LAST_SELECTED.
Opções
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--name string
O nome do recurso da substituição do armazém default .
--warehouse-id string
O ID específico do armazém quando o tipo é CUSTOM.
Exemplos
O exemplo a seguir cria uma substituição de armazém personalizada para o usuário atual:
databricks warehouses create-default-warehouse-override me CUSTOM --warehouse-id 1234567890abcdef
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
databricks warehouses delete-default-warehouse-override
Exclua a configuração default de substituição do armazém para um usuário. Os usuários podem excluir suas próprias configurações personalizadas. Os administradores podem excluir as configurações personalizadas de qualquer usuário. Após a exclusão, o repositório default workspace é utilizado.
databricks warehouses delete-default-warehouse-override NAME [flags]
Argumentos
NAME
O nome do recurso da substituição do armazém default a ser excluído. Formato: default-warehouse-overrides/{default_warehouse_override_id}. O ID pode ser um ID de usuário numérico ou as strings literais me para o usuário atual.
Opções
Exemplos
O exemplo a seguir exclui a configuração default de substituição do armazém para o usuário atual:
databricks warehouses delete-default-warehouse-override default-warehouse-overrides/me
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
databricks warehouses get-default-warehouse-override
Obtenha a configuração default de substituição do armazém para um usuário. Os usuários podem obter suas próprias configurações personalizadas. Os administradores podem obter configurações personalizadas para qualquer usuário. Caso não exista nenhuma configuração de substituição, será utilizado o repositório default workspace .
databricks warehouses get-default-warehouse-override NAME [flags]
Argumentos
NAME
O nome do recurso da substituição de armazém default a ser recuperado. Formato: default-warehouse-overrides/{default_warehouse_override_id}. O ID pode ser um ID de usuário numérico ou as strings literais me para o usuário atual.
Opções
Exemplos
O exemplo a seguir obtém a substituição default do armazém para o usuário atual:
databricks warehouses get-default-warehouse-override default-warehouse-overrides/me
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
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
lista de armazéns do Databricks -default- substituições de armazém
Liste todas as configurações default de substituição do armazém no workspace. Somente os administradores workspace podem listar todas as alterações.
databricks warehouses list-default-warehouse-overrides [flags]
Opções
--page-size int
O número máximo de alterações a serem retornadas.
--page-token string
Tokens de página recebidos de uma chamada list-default-warehouse-overrides anterior.
Exemplos
O exemplo a seguir lista todas as substituições default do armazém:
databricks warehouses list-default-warehouse-overrides
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
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
databricks warehouses update-default-warehouse-override
Atualizar uma configuração default de armazenamento de dados existente para um usuário. Os usuários podem atualizar suas próprias configurações de substituição. Os administradores podem atualizar as configurações personalizadas de qualquer usuário.
databricks warehouses update-default-warehouse-override NAME UPDATE_MASK TYPE [flags]
Argumentos
NAME
O nome do recurso da substituição do armazém default . Formato: default-warehouse-overrides/{default_warehouse_override_id}.
UPDATE_MASK
Máscara de campo que especifica quais campos devem ser atualizados. Use * para atualizar todos os campos. Quando --allow-missing é 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.
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--name string
O nome do recurso da substituição do armazém default .
--warehouse-id string
O ID específico do armazém quando o tipo é CUSTOM.
Exemplos
O exemplo a seguir atualiza a configuração personalizada do usuário atual para um armazém específico:
databricks warehouses update-default-warehouse-override default-warehouse-overrides/me warehouse_id CUSTOM --warehouse-id 1234567890abcdef
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