Compartilhar via


Grupo de comandos queries-legacy

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.

Note

Uma nova versão da API do SQL do Databricks agora está disponível. Consulte Atualização para a versão mais recente da API SQL do Databricks. Para executar operações em novas consultas SQL do Databricks, consulte o queries grupo de comandos.

O queries-legacy grupo de comandos dentro da CLI do Databricks permite que você execute operações get, create, update e delete em definições de consulta herdadas.

databricks consultas-legado criar

Crie uma nova definição de consulta. As consultas criadas com este endpoint pertencem ao usuário autenticado que está fazendo a solicitação.

O data_source_id campo especifica a ID do SQL Warehouse para executar essa consulta. Você pode usar o comando de fontes de dados para ver uma lista completa de sql warehouses disponíveis. Ou você pode copiar o data_source_id de uma consulta existente.

Note

Você não pode adicionar uma visualização até criar a consulta.

databricks queries-legacy create [flags]

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

databricks consultas-legado excluir

Mova uma consulta para a lixeira. As consultas destruídas desaparecem imediatamente de pesquisas e exibições de lista e não podem ser usadas para alertas. O lixo é excluído após 30 dias.

databricks queries-legacy delete QUERY_ID [flags]

Arguments

QUERY_ID

    A ID da consulta a ser excluída

Opções

Sinalizadores globais

databricks queries-legacy get

Obtenha uma definição de objeto de consulta junto com informações de permissões contextuais sobre o usuário autenticado no momento.

databricks queries-legacy get QUERY_ID [flags]

Arguments

QUERY_ID

    O ID da consulta a ser obtido

Opções

Sinalizadores globais

lista de consultas herdadas do Databricks

Obtenha uma lista de consultas. Opcionalmente, essa lista pode ser filtrada por um termo de pesquisa.

Important

Executar esse comando simultaneamente 10 ou mais vezes pode resultar em limitação, degradação do serviço ou proibição temporária.

databricks queries-legacy list [flags]

Opções

--order string

    Nome do atributo de consulta pelo qual ordenar.

--page int

    Número da página a ser recuperado.

--page-size int

    Número de consultas a serem retornadas por página.

--q string

    Termo de pesquisa de texto completo.

Sinalizadores globais

restauração de consultas legadas do Databricks

Restaure uma consulta que foi movida para a lixeira. Uma consulta restaurada aparece em exibições de lista e pesquisas. Você pode usar consultas restauradas para alertas.

databricks queries-legacy restore QUERY_ID [flags]

Arguments

QUERY_ID

    A ID da consulta a ser restaurada

Opções

Sinalizadores globais

Atualização de consultas legadas do Databricks

Modifique uma definição de consulta.

Note

Você não pode desfazer essa operação.

databricks queries-legacy update QUERY_ID [flags]

Arguments

QUERY_ID

    A ID da consulta a ser atualizada

Opções

--data-source-id string

    A ID da fonte de dados é mapeada para a ID da fonte de dados usada pelo recurso e é distinta da ID do depósito.

--description string

    Descrição geral que transmite informações adicionais sobre essa consulta, como anotações de uso.

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--name string

    O título desta consulta que aparece em visualizações de listas, títulos de widgets e na página de consulta.

--query string

    O texto da consulta a ser executada.

--run-as-role RunAsRole

    Define a função Executar como para o objeto. Valores com suporte: owner, viewer

Sinalizadores globais

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