Partilhar via


warehouses grupo de comando

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

Bandeiras 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 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

Bandeiras globais

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

Bandeiras 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 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

Bandeiras globais

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.

Bandeiras globais

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)

Bandeiras globais

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)

Bandeiras globais

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

Bandeiras globais

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

Bandeiras globais

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

Bandeiras globais

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

Bandeiras globais

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.

Bandeiras globais

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.

Bandeiras globais

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