Share via


Gewusst wie: Definieren von Variablen für Datenbankprojekte

Sie können das Datenbankprojekt in mehreren Umgebungen bereitstellen, indem Sie SQLCMD-Variablen definieren und diese in die Skripts vor der Bereitstellung und nach der Bereitstellung einfügen. Zum Beispiel können Sie SQLCMD-Variablen für einen Service Broker oder ein Dienstzertifikat definieren.

Wenn Sie eine SQLCMD-Variable durch eine MSBuild-Variable definieren, können Sie für diese einen buildkonfigurationsspezifischen Wert angeben. Sie können auch beim Erstellen des Datenbankprojekts die MSBuild-Variable an einer Eingabeaufforderung überschreiben. Sie können keine SQLCMD-Variable durch eine andere SQLCMD-Variable definieren. Weitere Informationen zu MSBuild-Variablen finden Sie unter MSBuild-Eigenschaften.

Tipp

Sie können SQLCMD-Variablen und MSBuild-Variablen im gleichen Skript verwenden. Sie sollten für eine SQLCMD-Variable jedoch nicht den gleichen Namen vergeben wie für eine MSBuild-Variable, da die MSBuild-Variable vorrangig behandelt wird.

Die Liste der Variablen und deren Werte werden im Eigenschaftenordner des Datenbankprojekts gespeichert. Beim Erstellen eines Projekts wird automatisch auch die Datei "Database.sqlcmdvars" erstellt. Wenn Sie für jede Konfiguration andere Werte bereitstellen möchten, können Sie mehrere Dateien definieren und diese unterschiedlichen Buildkonfigurationen zuordnen. Weitere Informationen finden Sie unter Gewusst wie: Konfigurieren der Bereitstellungseinstellungen für Datenbank- und Serverprojekte.

Tipp

Von Visual Studio werden drei Variablen definiert, die Sie in den Objektdefinitionen und -skripts verwenden können. Die Werte dieser Variablen werden beim Bereitstellen des Projekts festgelegt. Die erste Variable ist $(DatabaseName), diese enthält den Namen der Zieldatenbank, in der Sie die Bereitstellung vornehmen. Die zweite Variable ist $(DefaultDataPath) und enthält den Pfad, unter dem die Dateien für die Datenbank auf dem Zielserver gespeichert werden. Die dritte Variable ist $(DefaultLogPath) und enthält den Pfad, unter dem die Protokolldatei für die Datenbank auf dem Zielserver gespeichert wird.

So zeigen Sie SQLCMD-Variablen für ein Datenbankprojekt an

  • Erweitern Sie im Projektmappen-Explorer das Datenbankprojekt, für das Sie SQLCMD-Variablen anzeigen möchten, erweitern Sie den Eigenschaftenordner, und doppelklicken Sie anschließend auf die SQLCMDVARS-Datei, die Sie ändern möchten.

    Eine Liste mit SQLCMD-Variablen und deren Werten wird angezeigt.

So fügen Sie eine SQLCMD-Variable einer SQLCMDVARS-Datei hinzu

  1. Zeigen Sie die Liste an, der Sie eine SQLCMD-Variable hinzufügen möchten.

    Weitere Informationen finden Sie im ersten Verfahren in diesem Thema.

  2. Klicken Sie in der Spalte Variablenname auf die letzte Zeile, und geben Sie einen Namen für die Variable ein, die Sie hinzufügen möchten.

  3. Klicken Sie in die Spalte Variablenwert auf die Zeile, der Sie eben den Variablennamen hinzugefügt haben, und geben Sie einen Wert für die Variable ein.

  4. Klicken Sie im Menü Datei auf Alle speichern.

So ändern Sie eine SQLCMD-Variable in einer SQLCMDVARS-Datei

  1. Zeigen Sie die Liste mit der SQLCMD-Variablen an, die Sie ändern möchten.

    Weitere Informationen finden Sie im ersten Verfahren in diesem Thema.

  2. Klicken Sie in die Spalte Variablenwert auf die Zeile der Variablen, deren Wert Sie ändern möchten, und geben Sie einen neuen Wert ein.

  3. Klicken Sie im Menü Datei auf Alle speichern.

So löschen Sie eine SQLCMD-Variable in einer SQLCMDVARS-Datei

  1. Zeigen Sie die Liste mit der SQLCMD-Variablen an, die Sie löschen möchten.

    Weitere Informationen finden Sie im ersten Verfahren in diesem Thema.

  2. Klicken Sie mit der rechten Maustaste in der Spalte "Variablenname" auf die Zeile mit der Variablen, die Sie löschen möchten, und klicken Sie auf Löschen.

  3. Klicken Sie im Menü Datei auf Alle speichern.

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen von Dateien und Dateigruppen

Konzepte

Übersicht über das Erstellen und Bereitstellen einer Datenbank

Übersicht über Dateien und Dateigruppen