Gewusst wie: Hinzufügen von Verweisen zu Datenbankprojekten

Sie können mehrere Typen von Verweisen auf Datenbankprojekte hinzufügen, um unterschiedlichen Situationen gerecht zu werden. Sie können beispielsweise in der gleichen Projektmappe auf andere Projekte verweisen, oder Sie können auf die Ausgabe anderer Projektmappen verweisen. Die Prozeduren zum Hinzufügen unterschiedlicher Verweistypen unterscheiden sich geringfügig. Um beispielsweise einen datenbankübergreifenden Verweis zu verwenden, müssen Sie nicht nur den Verweis hinzufügen, sondern auch eine Variable und einen zugewiesenen Wert für die Datenbank, den Server oder beides. Weitere Informationen zu den Typen von Verweisen und zu Situationen, in denen Sie diese verwenden können, finden Sie unter Verwenden von Verweisen in Datenbankprojekten.

So verweisen Sie auf Objekte, die in einem Datenbankprojekt in der gleichen Projektmappe definiert sind

  1. Öffnen Sie die Projektmappe, die das Datenbankprojekt enthält, dem Sie einen Verweis hinzufügen möchten.

  2. Klicken Sie im Menü Projekt auf Datenbankverweis hinzufügen.

    Das Dialogfeld Datenbankverweis hinzufügen wird angezeigt.

  3. Gehen Sie folgendermaßen vor, um einen Verweis zu einem Datenbankprojekt hinzuzufügen:

    1. Klicken Sie auf Datenbankprojekte in der aktuellen Projektmappe.

    2. Klicken Sie in der Liste auf das Datenbankprojekt, für das Sie einen Verweis hinzufügen möchten.

  4. Gehen Sie folgendermaßen vor, um eine SETVAR-Variable für einen Server zu definieren:

    1. Klicken Sie auf Servervariable definieren.

    2. Geben Sie im Feld Name einen Namen für die Variable ein, die den Server darstellt.

    3. Geben Sie im Feld Wert den Namen des Servers ein, den die Variable darstellt.

    Tipp

    Sie müssen keine Servervariable definieren, wenn Sie auf ein Objekt in einer Datenbank verweisen, die sich auf dem gleichen Server wie die Datenbank befindet, für die Sie den Verweis hinzufügen.

  5. Gehen Sie folgendermaßen vor, um eine SETVAR-Variable für die Datenbank anzugeben, auf die Sie verweisen möchten:

    1. Aktivieren Sie das Kontrollkästchen Datenbankvariable definieren.

    2. Deaktivieren Sie das Kontrollkästchen Literal, wenn es aktiviert war.

    3. Geben Sie im Feld Name einen Namen für die Variable ein, die die Datenbank darstellt.

    4. Geben Sie im Feld Wert den Namen der Datenbank ein, die die Variable darstellt.

    Wichtig

    Wenn Ihr Datenbankprojekt Objekte enthält, die explizit auf Objekte in einer anderen Datenbank verweisen, müssen Sie diese Verweise so aktualisieren, dass sie die soeben definierten Variablen verwenden. Wenn Sie Objekte aus einer Datenbank importiert haben, die datenbankübergreifende Verweise enthält, müssen Sie die Verweise so aktualisieren, dass die Warnungen aufgelöst werden, die durch die datenbankübergreifenden Verweise verursacht werden.

  6. Gehen Sie folgendermaßen vor, um einen Literalwert für die Datenbank anzugeben, auf die Sie verweisen möchten:

    1. Aktivieren Sie das Kontrollkästchen Datenbankvariable definieren.

    2. Aktivieren Sie das Kontrollkästchen Literal.

    3. Geben Sie im Feld Wert den Namen der Datenbank ein, auf die Sie verweisen möchten.

    Tipp

    Sie könnten ein Literal anstelle einer Variablen und eines Wertpaars angeben, wenn der Datenbankname in der Zielbereitstellungsumgebung immer gleich ist. Sie können z. B. ein Literal mit dem Wert "master" für Objekte verwenden, die in der "Master"-Datenbank definiert sind.

  7. Wenn das Projekt, auf das verwiesen wird, möglicherweise auf ein anderes Projekt verweist, können Sie das Kontrollkästchen Fehler unterdrücken, die durch nicht aufgelöste Verweise im Projekt, auf das verwiesen wird, verursacht werden aktivieren. Es ist unwahrscheinlich, dass Fehler in dem Projekt, auf das verwiesen wird, Fehler in Ihrem aktuellen Projekt verursachen. Sie können diese daher ignorieren.

  8. Wenn Sie die Objekte und Skripts nicht aktualisieren möchten, deaktivieren Sie das Kontrollkästchen Vorhandene Schemaobjektdefinitionen und Skripts aktualisieren, sodass die Datenbank-Verweisvariablen verwendet werden, und klicken Sie auf OK.

    Dem Datenbankprojekt wird der Verweis hinzugefügt, und Sie müssen keine weiteren Schritte in dieser Prozedur ausführen.

  9. Wenn Sie die Objekte und Skripts aktualisieren möchten, aktivieren Sie das Kontrollkästchen Vorhandene Schemaobjektdefinitionen und Skripts aktualisieren, sodass die Datenbank-Verweisvariablen verwendet werden, und klicken Sie auf OK.

    Das Dialogfeld Vorschau der Änderungen - Server oder Datenbank umbenennen wird angezeigt.

  10. (Optional) Deaktivieren Sie das Kontrollkästchen neben einer oder mehreren Änderungen in der Liste, wenn die Änderung nicht angewendet werden soll.

  11. (Optional) Klicken Sie auf eine beliebige Änderung klicken, um die Details der Änderung im Bereich Vorschau der Änderungen anzuzeigen.

  12. Klicken Sie auf Übernehmen, um die angegebenen Objekte und Skripts zu aktualisieren.

    Der Verweis wird dem Datenbankprojekt hinzugefügt, und die angegebenen Objekte und Skripts werden geändert, damit sie anstatt der Namen der angegebenen Server und Datenbanken die SETVAR-Variablen verwenden.

So verweisen Sie auf Objekte, die in der kompilierten Ausgabe (DBSCHEMA-Datei) eines anderen Datenbankprojekts definiert sind

  1. Öffnen Sie die Projektmappe, die das Datenbankprojekt enthält, dem Sie einen Verweis hinzufügen möchten.

  2. Klicken Sie im Menü Projekt auf Datenbankverweis hinzufügen.

    Das Dialogfeld Datenbankverweis hinzufügen wird angezeigt.

  3. Gehen Sie folgendermaßen vor, um einen Verweis für eine Metadatei hinzuzufügen:

    1. Klicken Sie auf Datenbankprojekt-Metadatei (.dbmeta) oder Schema (.dbschema).

    2. Geben Sie im Feld den Pfad und den Dateinamen der Schemadatei ein, oder klicken Sie auf Durchsuchen, um die Schemadatei anzugeben, für die Sie einen Verweis hinzufügen möchten.

  4. Gehen Sie folgendermaßen vor, um eine SETVAR-Variable für einen Server zu definieren:

    1. Klicken Sie auf Servervariable definieren.

    2. Geben Sie im Feld Name einen Namen für die Variable ein, die den Server darstellt.

    3. Geben Sie im Feld Wert den Namen des Servers ein, den die Variable darstellt.

    Tipp

    Sie müssen keine Servervariable definieren, wenn Sie auf ein Objekt in einer Datenbank verweisen, die sich auf dem gleichen Server wie die Datenbank befindet, für die Sie den Verweis hinzufügen.

  5. Gehen Sie folgendermaßen vor, um eine SETVAR-Variable für die Datenbank anzugeben, auf die Sie verweisen möchten:

    1. Aktivieren Sie das Kontrollkästchen Datenbankvariable definieren.

    2. Deaktivieren Sie das Kontrollkästchen Literal, wenn es aktiviert war.

    3. Geben Sie im Feld Name einen Namen für die Variable ein, die die Datenbank darstellt.

    4. Geben Sie im Feld Wert den Namen der Datenbank ein, die die Variable darstellt.

    Wichtig

    Wenn Ihr Datenbankprojekt Objekte enthält, die explizit auf Objekte in einer anderen Datenbank verweisen, müssen Sie diese Verweise so aktualisieren, dass sie die soeben definierten Variablen verwenden. Wenn Sie Objekte aus einer Datenbank importiert haben, die datenbankübergreifende Verweise enthält, müssen Sie die Verweise so aktualisieren, dass die Warnungen aufgelöst werden, die durch die datenbankübergreifenden Verweise verursacht werden.

  6. Gehen Sie folgendermaßen vor, um einen Literalwert für die Datenbank anzugeben, auf die Sie verweisen möchten:

    1. Aktivieren Sie das Kontrollkästchen Datenbankvariable definieren.

    2. Aktivieren Sie das Kontrollkästchen Literal.

    3. Geben Sie im Feld Wert den Namen der Datenbank ein, auf die Sie verweisen möchten.

    Tipp

    Sie könnten ein Literal anstelle einer Variablen und eines Wertpaars angeben, wenn der Datenbankname in der Zielbereitstellungsumgebung immer gleich ist. Sie können z. B. ein Literal mit dem Wert "master" für Objekte verwenden, die in der "Master"-Datenbank definiert sind.

  7. Wenn das Projekt, auf das verwiesen wird, möglicherweise auf ein anderes Projekt verweist, können Sie das Kontrollkästchen Fehler unterdrücken, die durch nicht aufgelöste Verweise im Projekt, auf das verwiesen wird, verursacht werden aktivieren. Es ist unwahrscheinlich, dass Fehler in dem Projekt, auf das verwiesen wird, Fehler in Ihrem aktuellen Projekt verursachen. Sie können diese daher ignorieren.

  8. Wenn Sie die Objekte und Skripts nicht aktualisieren möchten, deaktivieren Sie das Kontrollkästchen Vorhandene Schemaobjektdefinitionen und Skripts aktualisieren, sodass die Datenbank-Verweisvariablen verwendet werden, und klicken Sie auf OK.

    Dem Datenbankprojekt wird der Verweis hinzugefügt, und Sie müssen keine weiteren Schritte in dieser Prozedur ausführen.

  9. Wenn Sie die Objekte und Skripts aktualisieren möchten, aktivieren Sie das Kontrollkästchen Vorhandene Schemaobjektdefinitionen und Skripts aktualisieren, sodass die Datenbank-Verweisvariablen verwendet werden, und klicken Sie auf OK.

    Das Dialogfeld Vorschau der Änderungen - Server oder Datenbank umbenennen wird angezeigt.

  10. (Optional) Deaktivieren Sie das Kontrollkästchen neben einer oder mehreren Änderungen in der Liste, wenn die Änderung nicht angewendet werden soll.

  11. (Optional) Sie können auf eine beliebige Änderung klicken, um die Details im Bereich Vorschau der Änderungen anzuzeigen.

  12. Klicken Sie auf Übernehmen, um die angegebenen Schemaobjekte und Skripts zu aktualisieren.

    Der Verweis wird dem Datenbankprojekt hinzugefügt, und die angegebenen Objekte und Skripts werden geändert, damit sie anstatt der Namen der angegebenen Server und Datenbanken die SETVAR-Variablen verwenden.

So schließen Sie den Inhalt eines Datenbankprojekts in die aktuelle Projektmappe als Teil des verweisenden Projekts ein

  1. Öffnen Sie die Projektmappe, die das Datenbankprojekt enthält, dem Sie einen Verweis hinzufügen möchten.

  2. Klicken Sie im Menü Projekt auf Datenbankverweis hinzufügen.

    Das Dialogfeld Datenbankverweis hinzufügen wird angezeigt.

  3. Klicken Sie auf Datenbankprojekte in der aktuellen Projektmappe, klicken Sie auf das Datenbankprojekt, zu dem Sie einen Verweis hinzufügen möchten, und klicken Sie auf OK.

    Der Verweis wird dem Datenbankprojekt hinzugefügt. Wenn Sie das Projekt bereitstellen, dem Sie den Verweis hinzugefügt haben, wird das Projekt, das Sie im Verweis angegeben haben, als Teil des Projekts behandelt, das Sie bereitstellen.

So fügen Sie einem SQLCLR-Projekt in der aktuellen Projektmappe einen Verweis hinzu

  1. Öffnen Sie die Projektmappe, die das Datenbankprojekt enthält, dem Sie einen Verweis hinzufügen möchten.

  2. Klicken Sie im Menü Projekt auf Verweis hinzufügen.

    Das Dialogfeld Verweis hinzufügen wird angezeigt.

  3. Klicken Sie auf die Registerkarte Projekte, falls sie nicht bereits ausgewählt ist.

  4. Klicken Sie auf den Namen des SQL-CLR-Projekts (Common Language Runtime), auf das Sie verweisen möchten, und dann auf OK.

    Der Verweis wird dem Datenbankprojekt hinzugefügt.

  5. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Verweis, und klicken Sie dann auf Eigenschaften.

    Das Eigenschaftenfenster wird angezeigt.

  6. Aktualisieren Sie die Eigenschaften des Verweises so, dass die Details der CREATE ASSEMBLY-Anweisung angegeben werden, die generiert wird, wenn Sie das Datenbankprojekt erstellen.

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

So fügen einer SQLCLR-Assembly einen Verweis hinzu

  1. Öffnen Sie die Projektmappe, die das Datenbankprojekt enthält, dem Sie einen Verweis hinzufügen möchten.

  2. Klicken Sie im Menü Projekt auf Verweis hinzufügen.

    Das Dialogfeld Verweis hinzufügen wird angezeigt.

  3. Klicken Sie auf die Registerkarte Durchsuchen, falls sie nicht bereits ausgewählt ist.

  4. Geben Sie die Assembly (.dll) an, auf die Sie verweisen möchten, und klicken Sie dann auf OK.

    Der Verweis wird dem Datenbankprojekt hinzugefügt.

  5. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Verweis, und klicken Sie dann auf Eigenschaften.

    Das Eigenschaftenfenster wird angezeigt.

  6. Aktualisieren Sie die Eigenschaften des Verweises so, dass die Details der CREATE ASSEMBLY-Anweisung angegeben werden, die generiert wird, wenn Sie das Datenbankprojekt erstellen.

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

Siehe auch

Konzepte

Verwenden von Verweisen in Datenbankprojekten

Teamentwicklung von Datenbanken mit Verweisen auf andere Datenbanken

Teamentwicklung von Datenbanken mit SQLCLR-Objektverweisen

Teamentwicklung von Datenbanken, die auf freigegebene Serverobjekte verweisen

Übersicht über Datenbank- und Serverprojekte