Benutzerdefinierte Aktionen

funktional

Verwandle deine eigenen SQL-Vorlagen in Rechtsklick-Aktionen für Tabellen, Ansichten und Routinen.

Verwandle jede deiner eigenen SQL-Vorlagen in einen Rechtsklick-Befehl für Tabellen, Ansichten, Prozeduren und Funktionen. Öffne Werkzeuge › Vorlagen-Explorer, erstelle oder bearbeite eine Vorlage in Meine Vorlagen, und markiere Im Explorer-Kontextmenü anzeigen (Benutzerdefinierte Aktionen). Wähle aus, welche Objektarten sie bekommen (standardmäßig alle vier; mindestens eine muss markiert bleiben). Ein Rechtsklick auf ein passendes Objekt im Objekt-Explorer zeigt die Vorlage danach unter Werkzeuge › Benutzerdefinierte Aktionen. Materialisierte Sichten erhalten keine benutzerdefinierten Aktionen.

SQLly
Das Rechtsklick-Menü einer Tabelle mit dem Untermenü Benutzeraktionen, das zwei Benutzervorlagen auflistet.Das Rechtsklick-Menü einer Tabelle mit dem Untermenü Benutzeraktionen, das zwei Benutzervorlagen auflistet.
Das Rechtsklick-Menü einer Tabelle mit dem Untermenü Benutzeraktionen, das zwei Benutzervorlagen auflistet.

Platzhalter

SQLLY füllt diese Platzhalter aus dem Objekt, auf das du rechtsgeklickt hast, bevor es das Skript öffnet. Namen werden als Bezeichner in Anführungszeichen im Dialekt der Verbindung geschrieben, auf der das Skript geöffnet wird ([Orders] bei SQL Server, "Orders" bei PostgreSQL, `Orders` bei MySQL), sodass Namen mit Leerzeichen, reservierten Wörtern oder Anführungszeichen ein Bezeichner bleiben und nicht in zusätzliches SQL umgewandelt werden können.

PlatzhalterWird zu
{server}Der Anzeigename der Verbindung, wie der Explorer ihn zeigt, als Bezeichner in Anführungszeichen.
{database}Die Datenbank, in der das Objekt liegt, in Anführungszeichen.
{schema}Das Schema des Objekts, in Anführungszeichen (leer bei Engines ohne Schemata).
{object}Der eigene Name des Objekts, in Anführungszeichen.
{kind}table, view, procedure, oder function.

Jeder von {server}, {database}, {schema}, und {object} hat zwei andere Formen:

  • {object:literal} schreibt den Namen als vollständige, maskierte Zeichenfolge im Dialekt der Verbindung, Anführungszeichen eingeschlossen (N'Orders' bei SQL Server, 'Orders' anderswo). Verwende es überall dort, wo eine Funktion den Namen als Text erwartet, zum Beispiel OBJECT_ID({object:literal}).
  • {object:raw} schreibt den puren Namen ohne Anführungszeichen oder Maskierung; nur Zeilenumbrüche werden in Leerzeichen umgewandelt. Gedacht für Kommentare und Beschriftungen. Setz ihn nicht in SQL und nicht in deine eigenen Anführungszeichen, weil ein Name mit einem Anführungszeichen sonst ausbricht.

Jeder Platzhalter wird genau einmal ersetzt. Enthält ein Name zufällig Platzhaltertext, etwa {schema} oder <n,int,5>, wird unverändert übernommen und nie wieder expandiert. Geschweifte Klammern, die auf keinen dieser Platzhalter passen, wie JSON in einem String, bleiben unangetastet.

SSMS-Stil <name,type,default> Parameter funktionieren weiterhin in derselben Vorlage. Wenn eine Vorlage welche enthält, öffnet ein Klick auf ihre benutzerdefinierte Aktion zunächst ein kleines Parameter Dialog mit einem Feld pro Parameter, das mit dessen Standardwert vorausgefüllt ist. Ändere, was du brauchst, und drücke Skript (oder Ausführen für eine Ausführen-Aktion) oder Eingabe; Abbrechen oder Esc macht nichts. Wie in SSMS, was du eintippst, ersetzt jede Kopie dieses Platzhalters genau so, wie du es schreibst, ohne Anführungszeichen, sodass ein Wert eine Zahl, ein Name oder eine ganze Bedingung sein kann. Eine Vorlage ohne Parameter überspringt den Dialog. Eine Vorlage wie diese listet die obersten Zeilen der Tabelle auf, auf die du rechtsklickst:

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

Skripten oder ausführen

Standardmäßig eine benutzerdefinierte Aktion Skripte: das ausgefüllte SQL öffnet sich in einem neuen Abfrage-Tab auf der eigenen Verbindung und Datenbank des Objekts, damit du es prüfen kannst. Um die Überprüfung zu überspringen, aktiviere Sofort ausführen auf der Vorlage. Diese Aktionen zeigen (ausführen) nach ihrem Namen im Menü.

Eine Ausführungsaktion führt nur dann sofort aus, wenn ihr SQL nach dem Einsetzen deiner Parameterwerte schreibgeschützt ist (nur SELECT Anweisungen, ohne dass die schreibgeschützte Prüfung der Engine etwas markiert). Alles andere, wie ein UPDATE, ein DROP, oder ein Prozeduraufruf, öffnet den Tab und zeigt das SQL zuerst im Bestätigungsdialog, egal ob die Mutationsprüfung für die Verbindung an ist oder nicht. Alle üblichen Ausführungssicherungen gelten dazu weiterhin, einschließlich SELECT-only-Verbindungen, Produktionssperre und Mandantenabgrenzung.

SQLly sucht die Vorlage beim Klick anhand des Namens (und noch einmal, wenn du ihre Parameter bestätigst), deshalb wirkt eine im Template Explorer gespeicherte Änderung sofort. Löscht du eine Vorlage, verschwindet ihr Menüeintrag. SQLly hält deine Vorlagen im Speicher und beobachtet die Vorlagendatei, sodass eine außerhalb von SQLly vorgenommene Änderung kurz nach dem Speichern im Menü auftaucht. Wenn sich die gespeicherte Vorlagendatei nicht lesen lässt, Benutzerdefinierte Aktionen listet nichts auf, das Ausführen einer Aktion wird mit einer Statusleistenmeldung abgebrochen, und der Template Explorer benennt das Problem, anstatt die Datei zu überschreiben.