Compartilhar via

Grupo de comandos warehouses

Note

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. The Databricks CLI is in Public Preview.

Databricks CLI use is subject to the Databricks License and Databricks Privacy Notice, including any Usage Data provisions.

The warehouses command group within the Databricks CLI allows you to manage 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 SQL Warehouse.

databricks warehouses create [flags]

Arguments

None

Opções

--auto-stop-mins int

    A quantidade de tempo em minutos em que um sql warehouse deve estar ocioso (em outras palavras, sem RUNNING consultas) antes de ser interrompido automaticamente.

--cluster-size string

    Tamanho dos clusters alocados para este armazém.

--creator-name string

    Nome do criador do armazém.

--enable-photon

    Configura se o warehouse 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 embutida ou o @path 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 se o warehouse 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

Global flags

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 databricks warehouses

Exclua um sql warehouse.

databricks warehouses delete ID [flags]

Arguments

ID

    Required. ID do sql warehouse.

Opções

Global flags

Examples

O exemplo a seguir exclui um warehouse com a ID especificada:

databricks warehouses delete 1234567890abcdef

edição de databricks warehouses

Atualize um armazém. Atualiza a configuração de um SQL Warehouse.

databricks warehouses edit ID [flags]

Arguments

ID

    Required. ID do armazém a ser configurado.

Opções

--auto-stop-mins int

    A quantidade de tempo em minutos em que um sql warehouse deve estar ocioso (em outras palavras, sem RUNNING consultas) antes de ser interrompido automaticamente.

--cluster-size string

    Tamanho dos clusters alocados para este armazém.

--creator-name string

    Nome do criador do armazém.

--enable-photon

    Configura se o warehouse 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 embutida ou o @path 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 RUNNING estado

--spot-instance-policy SpotInstancePolicy

    Configura se o warehouse 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

    Warehouse type. Valores com suporte: CLASSIC, PRO, TYPE_UNSPECIFIED

Global flags

Examples

O exemplo a seguir atualiza um warehouse 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 get

Obtenha as informações de um único sql warehouse.

databricks warehouses get ID [flags]

Arguments

ID

    Required. ID do sql warehouse.

Opções

Global flags

Examples

O exemplo a seguir obtém informações sobre um warehouse com a ID especificada:

databricks warehouses get 1234567890abcdef

lista de databricks warehouses

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 armazéns.

Global flags

Examples

O exemplo a seguir lista todos os armazéns:

databricks warehouses list

O exemplo a seguir lista os armazéns usando uma entidade de serviço específica:

databricks warehouses list --run-as-user-id 123456789

databricks warehouses start

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 RUNNING estado

--timeout duration

    Tempo máximo para atingir RUNNING o estado (padrão de 20ms)

Global flags

Examples

O exemplo a seguir inicia um warehouse com a ID especificada:

databricks warehouses start 1234567890abcdef

O exemplo a seguir inicia um warehouse sem esperar que ele atinja o RUNNING estado:

databricks warehouses start 1234567890abcdef --no-wait

databricks warehouses stop

Interrompa 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 STOPPED estado

--timeout duration

    Tempo máximo para atingir STOPPED o estado (padrão de 20ms)

Global flags

Examples

O exemplo a seguir interrompe um warehouse com a ID especificada:

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 de nível de workspace compartilhada por todos os sql warehouses em um workspace.

databricks warehouses get-workspace-warehouse-config [flags]

Arguments

None

Opções

Global flags

Examples

O exemplo a seguir obtém a configuração do workspace warehouse:

databricks warehouses get-workspace-warehouse-config

databricks warehouses set-workspace-warehouse-config

Defina a configuração de nível de workspace 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 embutida ou o @path 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

Global flags

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 get-permission-levels

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

Global flags

Examples

O exemplo a seguir obtém os níveis de permissão de um warehouse:

databricks warehouses get-permission-levels 1234567890abcdef

permissões de obtenção de databricks warehouses

Obtenha as permissões de um sql warehouse. 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

Global flags

Examples

O exemplo a seguir obtém as permissões para um warehouse:

databricks warehouses get-permissions 1234567890abcdef

databricks warehouses set-permissions

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 embutida ou o @path arquivo JSON com o corpo da solicitação.

Global flags

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 update-permissions

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 embutida ou o @path arquivo JSON com o corpo da solicitação.

Global flags

Examples

O exemplo a seguir atualiza permissões para um warehouse usando um arquivo JSON:

databricks warehouses update-permissions 1234567890abcdef --json @permissions.json

Global flags

--debug

  Se deseja 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 ou textjson. 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 ou textjson. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo a ~/.databrickscfg ser usado para 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, , appendou inplacejson

-t, --target corda

    Se aplicável, o destino do pacote a ser usado