Compartilhar via


Grupo de comandos warehouses

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

Sinalizadores globais

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

Sinalizadores globais

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

Sinalizadores globais

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

Sinalizadores globais

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.

Sinalizadores globais

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)

Sinalizadores globais

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)

Sinalizadores globais

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

Sinalizadores globais

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

Sinalizadores globais

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

Sinalizadores globais

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

Sinalizadores globais

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.

Sinalizadores globais

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.

Sinalizadores globais

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