|
Hinweis: Bitte stellen Sie sicher, dass Sie die Ansicht SQL Databases für die Datenbankobjekterstellung verwenden, bevor der Assistent zur SQL-Skript-Erstellung verwendet wird. Jedes SQL-Skript muss auf einer bestimmten Datenbankverbindung arbeiten, die durch die Definition eines SQL-Datenbankobjekts hergestellt wird. Es ist nicht möglich, SQL-Datenbankobjekte direkt über die Assistenten-Oberfläche für SQL-Skripts zu erstellen. |
Um einem Packaging-Projekt ein SQL-Skript hinzuzufügen, wechseln Benutzer in die Ansicht SQL Scripts des Visual Designer-Modus.
Mit einem Klick auf die Schaltfläche Create new... wird das Optionsmenü angezeigt. Klicken Sie auf SQL database, um den Assistenten für neue SQL-Datenbanken aufzurufen.
Arbeiten Sie sich durch die Schritte des Assistenten, um alle erforderlichen Eigenschaften für das neue Element zu definieren.
Sie können jederzeit mit den Schaltflächen Next oder Back, die am unteren Rand des Assistentendialogs angezeigt werden, innerhalb der bereits bearbeiteten Schritte navigieren.
Um den Assistenten zu beenden, ohne ein neues Objekt zu erstellen, verwenden Sie die Schaltfläche Cancel, die sich ebenfalls am unteren Rand des Assistentendialogs befindet.
Schritt 1: Datenbank
Database
Bitte wählen Sie das Datenbankobjekt aus, auf dem das neue SQL-Skript arbeiten soll. Das Datenbankobjekt muss als Zeile in der Tabelle RPSqlDatabase vorhanden sein, da diese Tabelle ausgelesen wird, um die Liste der Datenbanken bereitzustellen, aus der Benutzer in diesem Assistentenschritt auswählen können.
Sobald das Datenbankobjekt aus der Liste ausgewählt wurde, wird die zugehörige Serveradresse automatisch als zusätzliche informative Referenz angezeigt.
User
RayPack ermöglicht die Ausführung von SQL-Skripten entweder über die Windows-Authentifizierung oder als bestimmter Benutzer.
Die Standardeinstellung ist die Windows-Authentifizierung, angezeigt durch das aktive Kontrollkästchen "Use Windows Authentication". Um die Verwendung individueller Benutzeranmeldeinformationen zu aktivieren, muss das Kontrollkästchen deaktiviert werden. Sobald es inaktiv ist, werden die Steuerelemente für die Benutzerobjektverwaltung für die Benutzerauswahl aktiv.
Individuelle Benutzeranmeldeinformationen müssen in Form eines RayPack-Benutzerobjekts angegeben werden. Um ein Benutzerobjekt auszuwählen oder zu erstellen, klicken Sie auf die Schaltfläche [...] auf der rechten Seite des Benutzereingabefelds. Der Dialog Select User wird angezeigt. Weitere Informationen finden Sie im Abschnitt Common dialogs und unter Benutzerdatenobjekte verwalten.
|
Achtung: Benutzerobjekte werden möglicherweise an mehreren Stellen innerhalb von SQL-Datenbank-, Skript- und IIS-Verwaltungsstrukturen verwendet. Wenn auf dasselbe Benutzerelement von verschiedenen Stellen aus verwiesen wird, wirken sich Änderungen an den Eigenschaften dieses Benutzerelements auf alle verknüpften Objekte aus. Bitte überprüfen Sie die Korrektheit von Benutzerprofil-Änderungen sorgfältig und stellen Sie sicher, dass alle verknüpften Objekte mit dem geänderten Eigenschaftssatz weiterhin gültig und funktionsfähig sind. |
Schritt 2: Erweitert
Name
Ein Standardname für das neue Skriptobjekt wird automatisch generiert, sobald dieser Assistentenschritt angezeigt wird. Er setzt sich aus dem Präfix RPSqlScript und einem automatisch berechneten und inkrementierten Indexwert zusammen. Der Skriptname muss als eindeutige alphanumerische Zeichenkette mit maximal 72 Zeichen definiert werden.
Obwohl Leerzeichen und Sonderzeichen (z. B. Fragezeichen (?) oder Punkte (.)) technisch erlaubt sind, wird empfohlen, bei alphanumerischen Skriptnamen zu bleiben.
Component
Jedes SQL-Skriptobjekt muss mit einem Komponentenelement des Packaging-Projekts verknüpft sein. RayPack erstellt automatisch eine neue Komponente, wenn ein SQL-Datenbankelement erstellt wird. Es wird empfohlen, SQL-Skripte zur selben Komponente wie das übergeordnete SQL-Datenbankobjekt hinzuzufügen. Daher ist die Komponente der in Schritt 1 ausgewählten SQL-Datenbank für das neue SQL-Skript vorausgewählt.
Um eine andere vorhandene Komponente als übergeordnetes Objekt des SQL-Skriptelements auszuwählen, klicken Benutzer auf den nach unten zeigenden Pfeil auf der rechten Seite des Komponentenauswahlsteuerelements. Eine Liste vorhandener Komponenten wird angezeigt. Die neue Auswahl erfolgt durch einen Klick auf eine der angezeigten Komponenten.
Um eine neue Komponente für das SQL-Skriptobjekt zu erstellen, klicken Benutzer auf die Schaltfläche [...] auf der rechten Seite des Komponentensteuerelements. Der allgemeine Dialog vom Typ Select Component wird angezeigt und ermöglicht das Erstellen und Auswählen von Komponenten.
Sequence
Die Sequenz definiert, in welcher spezifischen Reihenfolge SQL-Skripte auf der Zieldatenbank ausgeführt werden. Das erste für eine Datenbank definierte SQL-Skript wird immer zuerst ausgeführt, während zusätzliche Skripte so zugewiesen werden können, dass sie entweder am Anfang der SQL-Sequenz oder nach einem der bereits vorhandenen SQL-Skripte ausgeführt werden.
Bitte beachten Sie, dass die Sequenz keine Skripte berücksichtigt, die auf anderen Datenbankobjekten innerhalb des Packaging-Projekts ausgeführt werden. Passen Sie die Reihenfolge der Datenbankskriptgruppen in der SQL-Skript-Listenansicht an, um die Reihenfolge der Datenbankmanipulationen auf dieser übergeordneten Ebene zu verwalten.
Attributes
Die Attributspalte der Tabelle RPSqlScript ist ausgestattet, um die folgenden Skriptausführungsoptionen bereitzustellen:
•Execute on install
Das Skript wird ausgeführt, wenn das Paket installiert wird.
•Execute on uninstall
Das Skript wird ausgeführt, wenn das Paket deinstalliert wird.
•Continue on error
Wenn die Skriptausführung einen Fehler verursacht, wird die Paketlaufzeitausführung nicht abgebrochen, unabhängig davon, ob es sich um eine Installation, Reparatur oder Deinstallation handelt.
•Rollback on install
Der Rollback-Mechanismus für dieses SQL-Skript wird ausgeführt, wenn das Paket installiert wird.
•Rollback on uninstall
Der Rollback-Mechanismus für dieses SQL-Skript wird ausgeführt, wenn das Paket installiert wird.
Benutzer können jede Ausführungsoption aktivieren, indem sie das Kontrollkästchen auf der linken Seite der Optionsbezeichnung auswählen.
|
Achtung: Wenn weder "Execute on install" noch "Execute on uninstall" ausgewählt sind, wird das Skript möglicherweise während der Paketlaufzeit nie auf der Zieldatenbank ausgeführt. |
Schritt 3: Skript
Der eigentliche Inhalt des SQL-Skripts muss in diesem Assistentenschritt definiert werden. Es gibt drei verschiedene Optionen für den Quelltyp des Skripts:
Binary Table
Die SQL-Anweisungen sind bereits als Inhalt eines binären Stream-Objekts im aktuellen Packaging-Projekt vorhanden.
Sobald diese Option aus dem Quelltyp-Auswahlfeld ausgewählt wird, wird ein weiteres Auswahlfeld "Binary" angezeigt, das den Benutzer auffordert, die gewünschte Binärdatei aus der Liste der verfügbaren Binärobjekte auszuwählen.
Sobald eine Binärdatei ausgewählt wurde, wird der Inhalt dieser Binärdatei im Skripttextbereich unten angezeigt.
|
Achtung: Das Ändern des Inhalts des SQL-Skript-Textbereichs, nachdem ein Binärobjekt ausgewählt wurde, bewirkt eine Aktualisierung des im Binär-Ressource selbst gespeicherten Inhalts. Das hier angezeigte SQL-Skript ist keine Kopie, die im SQL-Skriptobjekt erstellt wird, sondern der tatsächliche Binärinhalt. Bitte überprüfen Sie sorgfältig die Verwendung der Binärdatei an anderen Stellen, bevor der Inhalt in dieser Ansicht geändert wird. |
Property Table
Die SQL-Anweisungen sind bereits als Inhalt einer Eigenschaft im aktuellen Packaging-Projekt vorhanden.
Sobald diese Option aus dem Quelltyp-Auswahlfeld ausgewählt wird, wird ein weiteres Auswahlfeld "Property" angezeigt, das den Benutzer auffordert, die gewünschte Eigenschaft aus der Liste der verfügbaren Property-Tabellenzeilen auszuwählen.
Sobald eine Eigenschaft ausgewählt wurde, wird der Wert dieser Eigenschaft im Skripttextbereich unten angezeigt.
|
Achtung: Das Ändern des Inhalts des SQL-Skript-Textbereichs, nachdem ein Binärobjekt ausgewählt wurde, bewirkt eine Aktualisierung des in der Eigenschaft selbst gespeicherten Inhalts. Das hier angezeigte SQL-Skript ist keine Kopie, die im SQL-Skriptobjekt erstellt wird, sondern der tatsächliche Eigenschaftsinhalt. Bitte überprüfen Sie sorgfältig die Verwendung der Eigenschaft an anderen Stellen, bevor der Inhalt in dieser Ansicht geändert wird. |
Text
Diese Quelltyp-Option speichert das Skript als Text in der Tabellenspalte Target der Tabelle RPSqlScript. Auch wenn die gleiche SQL-Zeichenkette mehrfach im Packaging-Projekt als Textquelle für SQL-Skriptobjekte verwendet wird, gibt es für jedes Skriptobjekt eine separate Quellkopie.
|
Achtung: Der Quelltyp des SQL-Skripts kann später nicht über die Visual Designer-Benutzeroberfläche geändert werden. Wenn "Property" ausgewählt und das SQL-Skriptobjekt gespeichert wurde, ist der Quelltyp immer "Property". Es ist jedoch möglich zu bearbeiten, in welcher Eigenschaft der Skriptinhalt gespeichert wird (oder welche Binärdatei für die Option "Binary source type" gelesen wird). |
Load from file...
Unabhängig davon, welcher Quelltyp ausgewählt wurde, ist es immer möglich, den aktuellen Inhalt des SQL-Skript-Eingabefelds durch eine aus einer beliebigen erreichbaren Datei abgerufenen Zeichenkette zu ersetzen. Benutzer klicken einfach auf die Schaltfläche "Load from file", navigieren zur gewünschten *.sql-Datei und klicken auf "Open". Der Dateiinhalt ersetzt sofort die vorhandene SQL-Skript-Inhaltszeichenkette. Bitte beachten Sie, dass diese Funktion den Dateiinhalt liest und die Zeichenkette in eine der oben genannten Quelltyp-Referenzen schreibt (eine Binärdatei, eine Eigenschaft, die Spalte "Target" der SQL-Skript-Datenbankzeile). Die Datei selbst wird jedoch nicht als physische Ressource im Packaging-Projekt gespeichert. Dies bedeutet, dass sie nicht für den direkten Zugriff verfügbar ist, z. B. über die Ansicht "Files & Folders".
Switch off '[', ']' und Switch on '[', ']'
Eckige Klammern können entweder als Auslöser für spezielle SQL-Skript-Notationen wie abgegrenzte Bezeichner oder als einfache Textzeichen ohne besondere Funktionalität betrachtet werden. Um Packager bei ihrem Ziel nach klaren und eindeutigen Quelldefinitionen zu unterstützen, wurde der Schalter für eckige Klammern zum SQL-Skript-Textbereich hinzugefügt.
Eckige Klammern ausschalten führt zur expliziten Maskierung von eckigen Klammern, was bedeutet, dass jede öffnende und schließende eckige Klammer mit Maskierungsauslösern versehen wird. Die maskierten Klammerzeichen werden nicht mehr als spezielle Notationen betrachtet, sondern als bloße öffnende/schließende Klammerzeichen ohne zusätzliche Funktionalität.
Beispiel:
Der Originaltext "This is [sample] text" wird zu "This is [\[]sample[\]] text", sobald eckige Klammern ausgeschaltet werden.
Eckige Klammern einschalten entfernt die Maskierung von bereits vorhandenen maskierten öffnenden/schließenden Klammerzeichen. Sie werden wieder als Sonderzeichen (SQL-abgegrenzte Bezeichner) betrachtet.
Beispiel:
Der Originaltext "This is [sample] text with different [\[]square[\]] bracket usages." wird zu "This is [sample] text with different [square] bracket usages.", sobald eckige Klammern eingeschaltet werden.
Schritt 4: Ersetzung
Wenn Suchen-und-Ersetzen-Aktivitäten in SQL-Skripten für die Ausführung zur Paketlaufzeit erforderlich sind, ist dies die Oberfläche zum Erstellen dieser Aktivitäten. Mit einem Klick auf die Schaltfläche Add wird eine neue Ersetzungsaufgabe mit Standardwerten generiert. Um einen dieser Werte zu ändern, müssen Benutzer den Zellenwert des Listenelements doppelt anklicken, das sie ändern möchten. Der aktuelle Wert wird markiert und ist für die direkte Inline-Bearbeitung bereit:
Sequence
Der Sequenzwert ist ein automatisch inkrementierter Ganzzahlwert, der die Reihenfolge der Ersetzungsausführung angibt. Das Element mit dem niedrigsten Sequenzwert wird zuerst ausgeführt.
Search
Die Suchzeichenkette muss als Klartext angegeben werden. Es gibt keine Unterstützung für Platzhalter oder reguläre Ausdrücke als Suchzeichenketten.
Bitte beachten Sie, dass der Standard-Suchalgorithmus Groß- und Kleinschreibung nicht berücksichtigt. Um dies zu ändern, muss der Attributwert 2 für den Ersetzungsauftrag gesetzt werden.
Replace
Die Zeichenkette, die anstelle des übereinstimmenden Schlüsselworts aus "Search" eingefügt wird.
Bitte beachten Sie, dass der Standard-Suchalgorithmus alle Übereinstimmungen ersetzt. Um die Ersetzung nach der ersten Übereinstimmung zu stoppen, muss der Attributwert 4 für den Ersetzungsauftrag gesetzt werden.
Attributes
Benutzer können entweder eine beliebige Kombination der verfügbaren Attributbit-Wertdarstellungen manuell eingeben oder den Attribut-Editor für diese Eigenschaft verwenden. Um den Attribut-Editor anzuzeigen, müssen Benutzer den aktuellen Wert der Attributspalte doppelt anklicken und die nach unten zeigende Pfeilschaltfläche verwenden. Kontrollkästchen werden sichtbar, mit denen jede Attributoption einzeln aktiviert oder deaktiviert werden kann:
1 = Nur ganze Wörter abgleichen
2 = Groß-/Kleinschreibung beachten
4 = Nur einmal ersetzen
Der Standard-Attributwert für neue Ersetzungsaufgaben ist 1, was bedeutet, dass die Suche Wort für Wort aufgelöst wird.
Um eine Ersetzungsaufgabe zu entfernen, müssen Benutzer sie aus der Liste vorhandener Ersetzungen auswählen und die Schaltfläche Remove unterhalb der Liste verwenden. Die Aufgabe wird sofort ohne einen zwischengeschalteten Bestätigungsdialog entfernt.
Schritt 5: Zusammenfassung
Verwenden Sie die Zusammenfassungsseite, um die Korrektheit der SQL-Skript-Eigenschaften zu überprüfen, die in den vorherigen Assistentenschritten definiert wurden.
•Wenn alle Eigenschaften wie gewünscht festgelegt sind, klicken Sie auf Process, um das SQL-Skriptelement endgültig zu erstellen.
•Wenn Änderungen erforderlich sind, klicken Sie auf Back, bis der Assistentenschritt mit der fehlerhaften Eigenschaftsdefinition angezeigt wird, und nehmen Sie die erforderlichen Änderungen vor.
Bitte beachten Sie, dass Änderungen in einem frühen Schritt zu unterschiedlichen Standardwerten oder Optionen in einem späteren Schritt führen können. Überprüfen Sie daher, ob alle Schritte die gewünschten Einstellungen enthalten, während Sie wieder zur Zusammenfassungsseite navigieren.
Schritt 6: Abgeschlossen
Sobald das neue SQL-Skriptobjekt erstellt wurde, kann der Assistent durch Klicken auf die Schaltfläche Finish in der unteren rechten Ecke geschlossen werden. Die Ansicht "SQL Scripts" wird aktualisiert, und die Liste der vorhandenen Elemente enthält das neu erstellte Objekt an der untersten Position innerhalb der Gruppe der Skripte, die für dieselbe Zieldatenbank gespeichert sind.