Allgemeine Anweisungen zum Arbeiten mit den Wingtip-Tickets-Beispielanwendungen für SaaS

Artikel
06/02/2023

Dieser Artikel enthält allgemeine Anweisungen zum Ausführen der Wingtip-Tickets-SaaS-Beispielanwendungen, die Azure SQL-Datenbank verwenden.

Herunterladen und Entsperren der Wingtip-Tickets-SaaS-Skripts

Ausführbare Inhalte (Skripts, DLLs) können durch Windows blockiert werden, wenn ZIP-Dateien aus einer externen Quelle heruntergeladen und extrahiert werden. Führen Sie bei der Extraktion der Skripts aus einer ZIP-Datei die nachfolgenden Schritte durch, um die Blockierung der ZIP-Datei vor der Extraktion aufzuheben. Hierdurch wird sichergestellt, dass die Skripts ausgeführt werden dürfen.

Navigieren Sie zum Wingtip-Tickets-SaaS-GitHub-Repository für das Datenbank-Mandantenmuster, das Sie kennenlernen möchten:
Klicken Sie auf Klonen oder herunterladen.
Klicken Sie auf ZIP herunterladen, und speichern Sie die Datei.
Klicken Sie mit der rechten Maustaste auf die Zip-Datei, und wählen Sie Eigenschaften aus. Der Name der Zip-Datei entspricht dabei dem Namen des Repositorys. (Beispiel: WingtipTicketsSaaS-DbPerTenant-master.zip)
Wählen Sie auf der Registerkarte Allgemein die Option Blockierung aufheben.
Klicken Sie auf OK.
Extrahieren Sie die Dateien.

Skripts befinden sich im Ordner ..\Learning Modules (Lernmodule).

Arbeiten mit den Wingtip-Tickets-PowerShell-Skripts

Um das Beispiel optimal nutzen zu können, müssen Sie sich mit den bereitgestellten Skripts auseinandersetzen. Verwenden Sie Haltepunkte, gehen Sie die Skripts schrittweise ausführend durch, und untersuchen Sie die Implementierung der verschiedenen SaaS-Muster. Um mühelos die bereitgestellten Skripts und Module durchzugehen und auf diese Weise bestmöglich zu verstehen, wird die Verwendung der PowerShell ISE empfohlen.

Aktualisieren der Konfigurationsdatei für Ihre Bereitstellung

Bearbeiten Sie die Datei UserConfig.psm1 mit dem Ressourcengruppen- und Benutzerwert, den Sie bei der Bereitstellung festlegen:

Öffnen Sie die PowerShell ISE, und laden Sie ...\Learning ModulesUserConfig.psm1.
Aktualisieren Sie ResourceGroupName und Name mit den jeweiligen Werten für Ihre Bereitstellung (nur in den Zeilen 10 und 11).
Speichern Sie die Änderungen!

Indem Sie diese Werte hier festlegen, wird es Ihnen erspart, diese bereitstellungsspezifischen Werte in jedem Skript aktualisieren zu müssen.

Führen Sie die Skripts aus, indem Sie F5 drücken.

Zur Navigation in Ordnern verwenden die verschiedenen Skripts $PSScriptRoot. $PSScriptRoot wird nur ausgewertet, wenn die Skripts durch Drücken der Taste F5 ausgeführt werden. Das Markieren und Ausführen einer Auswahl (F8) kann zu Fehlern führen. Drücken Sie daher zum Ausführen von Skripts F5.

Schrittweises Durcharbeiten der Skripts zum Überprüfen der Implementierung

Die beste Möglichkeit, die Skripts zu verstehen, besteht darin, die jeweiligen Funktionen durchzugehen. Sehen Sie sich die enthaltenen Demo--Skripts an, die einen einfachen allgemeinen Workflow darstellen. Die Demo --Skripts veranschaulichen die erforderlichen Schritte zur Durchführung der einzelnen Aufgaben. Legen Sie daher die Haltepunkte fest, und führen Sie einen Drilldown auf die einzelnen Aufrufe durch, um Implementierungsdetails für die verschiedenen SaaS-Muster anzuzeigen.

Tipps zum Prüfen und schrittweisen Ausführen der PowerShell-Skripts:

Öffnen Sie die Demo--Skripts in der PowerShell ISE.
Drücken Sie zum Ausführen oder Fortfahren die Taste F5. (Es wird davon abgeraten, F8 zu drücken, da $PSScriptRoot beim Ausführen einer Auswahl aus einem Skript nicht ausgewertet wird.)
Platzieren Sie Haltepunkte, indem Sie auf eine Zeile klicken bzw. diese auswählen und F9 drücken.
Überspringen Sie eine Funktion oder einen Skriptaufruf durch Drücken von F10.
Führen Sie eine Funktion oder einen Skriptaufruf als Einzelschritt aus, indem Sie F11 drücken.
Führen Sie die aktuelle Funktion bzw. den aktuellen Skriptaufruf bis zum Rücksprung aus, indem Sie UMSCHALT+F11 drücken.

Untersuchen des Datenbankschemas und Ausführen von SQL-Abfragen mit SSMS

Verwenden Sie SQL Server Management Studio (SSMS), um eine Verbindung mit den Anwendungsservern und -datenbanken herzustellen und diese zu durchsuchen.

Die Bereitstellung verfügt anfänglich über Mandanten und Katalogserver, mit denen Verbindungen hergestellt werden können. Die Benennung der Server hängt vom Mandantenmuster der Datenbank ab (Einzelheiten nachfolgend).

Eigenständige Anwendung: Server für jeden Mandanten (z. B. Server contosoconcerthall-<Benutzer>) und catalog-sa-<Benutzer>
Datenbank pro Mandant: Die Server tenants1-dpt-<Benutzer> und catalog-dpt-<Benutzer>
Mehrinstanzenfähige Datenbank:tenants1-mt-<Benutzer>- und catalog-mt-<Benutzer>-Server

Um sicherzustellen, dass erfolgreich eine Verbindung mit der Demo hergestellt wird, wird allen Servern eine Firewallregel zugewiesen, die alle IP-Adressen zulässt.

Öffnen Sie SSMS, und stellen Sie eine Verbindung mit den Mandanten her. Der Servername hängt vom gewählten Mandantenmuster der Datenbank ab (Einzelheiten nachfolgend):
- Eigenständige Anwendung: Server der einzelnen Mandanten (Beispiel: contosoconcerthall-<Benutzer>.database.windows.net)
- Datenbank pro Mandant:tenants1-dpt-<Benutzer>.database.windows.net
- Mehrinstanzenfähige Datenbank:tenants1-mt-<Benutzer>.database.windows.net
Klicken Sie auf Verbinden>Datenbank-Engine...:
Demo-Anmeldeinformationen: Benutzername = developer, Kennwort = P@ssword1

Die Abbildung unten stellt die Anmeldung für das Muster Datenbank pro Mandant dar.
Wiederholen Sie die Schritte 2 und 3, und stellen Sie die Verbindung zum Katalogserver her (die spezifischen Servernamen, die auf dem gewählten Datenbank-Mandantenmuster basieren, finden Sie unten)
- Eigenständige Anwendung:catalog-sa-<Benutzer>.database.windows.net
- Datenbank pro Mandant:catalog-dpt-<Benutzer>.database.windows.net
- Mehrinstanzenfähige Datenbank:catalog-mt-<Benutzer>.database.windows.net

Nachdem die Verbindung erfolgreich hergestellt wurde, werden alle Server angezeigt. Ihre Liste der Datenbanken kann variieren, je nachdem, welche Mandanten Sie bereitgestellt haben.

Die Abbildung unten stellt die Anmeldung für das Muster Datenbank pro Mandant dar.

object explorer