Ações personalizadas

funcional

Transforme seus próprios modelos SQL em ações de clique direito em tabelas, visualizações e rotinas.

Transforme qualquer um dos seus próprios modelos SQL em um comando de clique com o botão direito em tabelas, visualizações, procedimentos e funções. Abra Ferramentas › Explorador de Modelos, crie ou edite um modelo em Meus modelos, e marque Mostrar no menu de clique direito do explorador (Ações personalizadas). Escolha quais tipos de objetos devem recebê-lo (todos os quatro por padrão; pelo menos um deve permanecer marcado). Depois disso, clicar com o botão direito em um objeto correspondente no Explorador de Objetos mostra o modelo em Ferramentas › Ações Personalizadas. Views materializadas não recebem ações personalizadas.

SQLly
O menu de clique direito de uma tabela, com o submenu Ações Personalizadas listando dois modelos do usuário.O menu de clique direito de uma tabela, com o submenu Ações Personalizadas listando dois modelos do usuário.
O menu de clique direito de uma tabela, com o submenu Ações Personalizadas listando dois modelos do usuário.

Espaços reservados

O SQLly preenche esses espaços reservados a partir do objeto no qual você clicou com o botão direito antes de abrir o script. Os nomes são escritos como identificadores entre aspas no dialeto da conexão em que o script é aberto ([Orders] no SQL Server, "Orders" no PostgreSQL, `Orders` no MySQL), então nomes com espaços, palavras reservadas ou caracteres de aspas permanecem um único identificador e não podem virar SQL extra.

Espaço reservadoSe torna
{server}O nome de exibição da conexão, como o explorador o mostra, entre aspas como identificador.
{database}O banco de dados em que o objeto está, entre aspas.
{schema}O esquema do objeto, entre aspas (vazio em motores sem esquemas).
{object}O próprio nome do objeto, entre aspas.
{kind}table, view, procedure, ou function.

Cada um de {server}, {database}, {schema}, e {object} tem duas outras formas:

  • {object:literal} escreve o nome como uma string literal completa e escapada no dialeto da conexão, incluindo as aspas (N'Orders' no SQL Server, 'Orders' em outro lugar). Use-o sempre que uma função esperar o nome como texto, por exemplo OBJECT_ID({object:literal}).
  • {object:raw} escreve o nome puro, sem aspas ou escape; apenas quebras de linha viram espaços. Serve para comentários e rótulos. Não coloque dentro do SQL nem dentro das suas próprias aspas, porque um nome que contenha uma aspa escaparia delas.

Cada espaço reservado é substituído exatamente uma vez. Um nome que por acaso contenha texto de espaço reservado, como {schema} ou <n,int,5>, é escrito como está e nunca mais é expandido. Chaves que não correspondem a um desses placeholders, como JSON em uma string, ficam como estão.

Estilo SSMS <name,type,default> os parâmetros ainda funcionam no mesmo modelo. Quando um modelo possui algum, clicar em sua ação personalizada primeiro abre um pequeno Parâmetros diálogo com uma caixa por parâmetro, preenchida com seu padrão. Altere o que você precisar e pressione Gerar script (ou Executar para uma ação de execução) ou Enter; Cancelar ou Esc não faz nada. Como em SSMS, o que você digitar substitui todas as ocorrências daquele marcador exatamente como escrito, sem aspas, então um valor pode ser um número, um nome ou uma condição inteira. Um modelo sem parâmetros pula o diálogo. Um modelo como este lista as primeiras linhas de qualquer tabela em que você clicar com o botão direito:

-- {kind} {object:raw} on {server:raw}
SELECT TOP <top_n,int,100> * FROM {schema}.{object};

Gerar script ou executar

Por padrão, uma ação personalizada scripts: o SQL preenchido é aberto em uma nova aba de consulta na própria conexão e banco de dados do objeto, para você revisar. Para pular a revisão, marque Executar imediatamente no modelo. Essas ações mostram (executar) após seu nome no menu.

Uma ação de execução roda imediatamente só quando o SQL dela, depois de preencher os valores dos parâmetros, é somente leitura (apenas SELECT instruções, sem nada que o verificador de somente leitura do motor sinalize). Qualquer outra coisa, como um UPDATE, um DROP, ou uma chamada de procedimento, abre a aba e mostra o SQL no diálogo de confirmação primeiro, esteja ou não a revisão de mutações ativada para a conexão. Todas as proteções normais de execução continuam valendo por cima, incluindo conexões somente SELECT, o bloqueio de produção e o escopo de locatário.

O SQLly procura o modelo pelo nome quando você clica (e novamente quando confirma seus parâmetros), então uma edição que você salva no Explorador de Modelos entra em efeito imediatamente. Excluir um modelo remove sua entrada no menu. O SQLly mantém seus modelos na memória e monitora o arquivo de modelo, então uma alteração feita no arquivo fora do SQLly aparece no menu um momento depois de ser salva. Se o arquivo de modelo salvo não puder ser lido, Ações personalizadas não lista nada, executar uma ação é interrompido com uma mensagem na barra de status, e o Explorador de Modelos indica o problema em vez de sobrescrever o arquivo.