Actions personnalisées
fonctionnelTransformez vos propres modèles SQL en actions au clic droit sur les tables, vues et routines.
Transformez vos propres modèles SQL en une commande au clic droit sur les tables, vues, procédures et fonctions. Ouvrez Outils › Explorateur de modèles, créez ou modifiez un modèle dans Mes modèles, et cochez Afficher dans le menu contextuel de l’explorateur (Actions personnalisées). Choisissez les types d'objets qui le reçoivent (les quatre par défaut ; au moins un doit rester coché). Après cela, faire un clic droit sur un objet correspondant dans l'Explorateur d'objets affiche le modèle sous Outils › Actions personnalisées. Les vues matérialisées n'ont pas d'actions personnalisées.


Espaces réservés
SQLly remplit ces espaces réservés à partir de l'objet sur lequel vous avez cliqué avec le bouton droit avant d'ouvrir le script. Les noms sont écrits comme des identifiants entre guillemets dans le dialecte de la connexion sur laquelle le script s'ouvre ([Orders] sur SQL Server, "Orders" sur PostgreSQL, `Orders` sur MySQL), donc les noms contenant des espaces, des mots réservés ou des guillemets restent un seul identifiant et ne peuvent pas se transformer en SQL supplémentaire.
| Espace réservé | Devient |
|---|---|
{server} | Le nom d'affichage de la connexion, tel qu'il apparaît dans l'explorateur, cité comme un identifiant. |
{database} | La base de données dans laquelle se trouve l'objet, citée. |
{schema} | Le schéma de l'objet, entre guillemets (vide sur les moteurs sans schémas). |
{object} | Le nom de l’objet lui-même, entre guillemets. |
{kind} | table, view, procedure, ou function. |
Chacun de {server}, {database}, {schema}, et {object} a deux autres formes :
{object:literal}écrit le nom comme une chaîne littérale complète et échappée dans le dialecte de la connexion, guillemets inclus (N'Orders'sur SQL Server,'Orders'ailleurs). Utilisez-le partout où une fonction attend le nom sous forme de texte, par exempleOBJECT_ID({object:literal}).{object:raw}écrit le nom brut sans guillemets ni échappement ; seuls les retours à la ligne sont transformés en espaces. Il est destiné aux commentaires et aux étiquettes. Ne le mettez pas à l'intérieur de SQL ou à l'intérieur de vos propres guillemets, car un nom contenant un guillemet pourrait sortir de la chaîne.
Chaque espace réservé est remplacé exactement une fois. Un nom qui contient par hasard du texte d'espace réservé, tel que {schema} ou <n,int,5>, est écrit tel quel et n'est jamais développé à nouveau. Les accolades qui ne correspondent à aucun de ces espaces réservés, comme du JSON dans une chaîne, sont laissées intactes.
Le style SSMS <name,type,default> Les paramètres fonctionnent toujours dans le même modèle. Lorsqu'un modèle en possède, cliquer sur son action personnalisée ouvre d'abord une petite boîte de dialogue Paramètres avec une case par paramètre, remplie avec sa valeur par défaut. Changez ce dont vous avez besoin et appuyez sur Script (ou Exécuter pour une action d'exécution) ou Entrée; Annuler ou Échap ne fait rien. Comme dans SSMS, ce que vous tapez remplace chaque copie de cet espace réservé exactement comme écrit, sans guillemets, donc une valeur peut être un nombre, un nom ou une condition entière. Un modèle sans paramètres ignore la boîte de dialogue. Un modèle comme celui-ci liste les premières lignes de n'importe quelle table sur laquelle vous faites un clic droit :
-- {kind} {object:raw} on {server:raw}
SELECT TOP <top_n,int,100> * FROM {schema}.{object};
Script ou exécution
Par défaut, une action personnalisée scripts: le SQL rempli s'ouvre dans un nouvel onglet de requête sur la connexion et la base de données de l'objet, pour que vous puissiez le relire. Pour passer la relecture, cochez Exécuter immédiatement sur le modèle. Ces actions affichent (exécution) après leur nom dans le menu.
Une action d'exécution ne s'exécute immédiatement que si son SQL, une fois vos valeurs de paramètres renseignées, est en lecture seule (uniquement des SELECT instructions, sans rien que le contrôle de lecture seule du moteur signale). Tout le reste, comme un UPDATE, un DROP, ou un appel de procédure, ouvre l'onglet et affiche d'abord le SQL dans la boîte de dialogue de confirmation, que la révision des mutations soit activée ou non pour la connexion. Toutes les protections d'exécution habituelles s'appliquent par-dessus, y compris les connexions en lecture seule, le verrou de production et la portée par locataire.
SQLly recherche le modèle par nom lorsque vous cliquez dessus (et à nouveau lorsque vous confirmez ses paramètres), donc une modification que vous enregistrez dans l'Explorateur de modèles prend effet immédiatement. La suppression d'un modèle supprime son entrée dans le menu. SQLly conserve vos modèles en mémoire et surveille le fichier de modèle, donc un changement effectué dans le fichier en dehors de SQLly apparaît dans le menu un instant après son enregistrement. Si le fichier de modèle enregistré ne peut pas être lu, Actions personnalisées ne liste rien, l'exécution d'une action s'arrête avec un message dans la barre d'état, et l'Explorateur de modèles indique le problème au lieu d'écraser le fichier.