Datenbankverweis hinzufügen (Dialogfeld)

 

In diesem Thema werden die Verfahren beschrieben, die Sie im Dialogfeld Datenbankverweis hinzufügen ausführen können.

Datenbankverweise ermöglichen folgende Verfahren:

  • Zugreifen auf Objekte in anderen Datenbanken.
    Ein Projekt kann mithilfe der Auflösung von drei- oder vierteiligen Namen auf eine andere Datenbank auf einem beliebigen Server verweisen.Bei Verwendung eines drei- oder vierteiligen Namens als Verweis können SQLCMD-Variablen verwendet werden, damit Verweise auf mehreren Servern und Datenbanken funktionieren.

  • Erstellen einer aus mehreren Datenbankprojekten zusammengesetzten Projektmappe.
    In einem zusammengesetzten Projekt wird eine große Datenbank mithilfe von Datenbankverweisen in mehrere separate Projekte aufgeteilt.Sie erstellen einen Verweis ohne Variablen oder Werte für die Datenbank oder den Server (nur mithilfe ein- oder zweiteiliger Namen).

Datenbankverweise können auf ein Datenbankprojekt in der aktuellen Projektmappe oder auf eine DACPAC-Datei verweisen.Durch Hinzufügen eines Datenbankverweises zu einem Projekt werden Projektabhängigkeiten und Buildreihenfolge geändert.

Auswählen der Datenbank für den Verweis

Sie können auf ein anderes Datenbankprojekt in derselben Projektmappe, eine Systemdatenbank oder eine DACPAC-Datei verweisen.

Wenn die Projektmappe mehrere Datenbankprojekte enthält, ist Datenbankprojekte in der aktuellen Projektmappe aktiviert.Sie können auf eine andere Datenbank in der Projektmappe verweisen.

Wählen Sie Systemdatenbank aus, wenn Sie eine der Systemdatenbanken als Datenbankverweis verwenden möchten.

Wählen Sie Datenebenenanwendung (.dacpac) aus, wenn Sie auf eine Datenbank in einer DACPAC-Datei verweisen möchten, und navigieren Sie zu dem Verzeichnis mit der DACPAC-Datei.

Auswählen des relativen Speicherorts der Datenbank

Nachdem Sie die Datenbank ausgewählt haben, auf die verwiesen werden soll, können Sie den voraussichtlichen Speicherort eines Datenbankobjekts relativ zum verweisenden Projekt angeben.

Verweise können für Objekte an einem der folgenden Orte aufgelöst werden:

  • In der Datenbank, die den Verweis enthält.

  • In einer anderen Datenbank als der, die den Verweis enthält, die sich aber auf dem gleichen Server befindet.

  • In einer anderen Datenbank als der, die den Verweis enthält, die sich aber auf einem anderen Server befindet.

Geben Sie einen Datenbanknamen an.Wenn Sie Systemdatenbank auswählen, sollte der Literalname der Systemdatenbank nicht geändert werden.Wenn Sie Datenbankprojekte in der aktuellen Projektmappe auswählen, basiert der Standardname der Datenbank auf dem Namen der Datenbank, die im Projekt enthalten ist.

Wenn Sie Andere Datenbank, anderer Server ausgewählt haben, geben Sie einen Servernamen an.

Sie können eine (SQLCMD)-Datenbankvariable verwenden.Wenn Sie mit einer Variablen (anstelle des Literalnamens) auf die Datenbank verweisen möchten, übernehmen Sie die Standardvariable für die Datenbank oder ändern diese.Eine Datenbankvariable ist nützlich, wenn das Datenbankprojekt auf mehreren Servern und Datenbanken veröffentlicht wird.In diesem Fall kann ein Entwickler in den Eigenschaftenseiten des Projekts SQLCMD-Variablen aufrufen und den lokalen Namen der Datenbank angeben.Wenn Sie Datenbankvariable leer lassen, kann auf die Datenbank ausschließlich über ihren Literalnamen verwiesen werden.Wenn Sie einen Datenbankvariablennamen angeben, können Sie auf die Datenbank nicht über ihren Literalnamen verweisen.

Wenn Sie Andere Datenbank, anderer Server ausgewählt haben, ist eine (SQLCMD)-Servervariable erforderlich.Eine Servervariable ist nützlich, um das Datenbankprojekt auf mehreren Servern und Datenbanken zu veröffentlichen.In diesem Fall kann ein Entwickler in den Eigenschaftenseiten des Projekts SQLCMD-Variablen aufrufen und den lokalen Namen des Servers angeben.Sie können nur über die Variable auf den Server verweisen, nicht über den Servernamen.

Wichtig

In bestimmten Situationen können Sie einen Datenbankverweis erstellen, der den gleichen Namen wie ein vorhandener Datenbankverweis besitzt.Wenn zwei Datenbankverweise den gleichen Namen besitzen, kann dies zu unerwartetem Verhalten führen.In diesem Fall löschen Sie beide Datenbankverweise.

Allgemeine Verfahren

Im Folgenden sind allgemeine Verfahren aufgeführt:

So erstellen Sie einen Verweis auf eine Datenbank auf dem gleichen Server

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und wählen Sie Datenbankverweis hinzufügen aus.

  2. Geben Sie im Dialogfeld Datenbankverweis hinzufügen als Datenbankort die Option Andere Datenbank, derselbe Server an.

  3. Geben Sie den Namen der Datenbank an.

  4. Überlegen Sie sich, ob Sie eine Datenbankvariable verwenden möchten.

  5. Kopieren Sie das Verwendungsbeispiel, und fügen Sie es in Ihre SQL-Datei ein.Ändern Sie [Schema1] im Verwendungsbeispiel in den Namen Ihres Schemas (z. B. [dbo]).Ändern Sie auch den Namen des Datenbankobjekts in einen für das Projekt geeigneten Namen.

  6. Erstellen Sie die Projektmappe.

So erstellen Sie einen Verweis auf eine Datenbank auf einem anderen Server

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und wählen Sie Datenbankverweis hinzufügen aus.

  2. Geben Sie im Dialogfeld Datenbankverweis hinzufügen als Datenbankort die Option Andere Datenbank, anderer Server an.

  3. Stellen Sie sicher, dass der Datenbankname richtig ist.

  4. Überlegen Sie sich, ob Sie eine Datenbankvariable verwenden möchten.

  5. Geben Sie den Namen des Servers und die Servervariable an.

  6. Kopieren Sie das Verwendungsbeispiel, und fügen Sie es in Ihre SQL-Datei ein.Ändern Sie [Schema1] im Verwendungsbeispiel in den Namen Ihres Schemas (z. B. [dbo]).Ändern Sie auch den Namen des Datenbankobjekts in einen für das Projekt geeigneten Namen.

  7. Erstellen Sie die Projektmappe.

So erstellen Sie ein zusammengesetztes Projekt

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und wählen Sie Datenbankverweis hinzufügen aus.

  2. Wählen Sie die Quelle der Datenbank aus, auf die Sie verweisen (ein Projekt in der Projektmappe oder eine DACPAC-Datei).

  3. Geben Sie im Dialogfeld Datenbankverweis hinzufügen als Datenbankort die Option Dieselbe Datenbank an.

  4. Kopieren Sie das Verwendungsbeispiel, und fügen Sie es in Ihre SQL-Datei ein.Ändern Sie [Schema1] im Verwendungsbeispiel in den Namen Ihres Schemas.Ändern Sie auch den Namen des Datenbankobjekts in einen für das Projekt geeigneten Namen.

  5. Erstellen Sie die Projektmappe.

Wenn Sie dieses Projekt veröffentlichen, können Sie zusammengesetzte Projekte in derselben Projektmappe unter einem Ziel bereitstellen:

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, und wählen Sie Veröffentlichen aus, um das Dialogfeld Datenbank veröffentlichen anzuzeigen.

  2. Klicken Sie im Dialogfeld Datenbank veröffentlichen auf Erweitert.

  3. Stellen Sie im Dialogfeld Erweiterte Veröffentlichungseinstellungen sicher, dass Zusammengesetzte Objekte einschließen in der Liste Erweiterte Bereitstellungsoptionen aktiviert ist.

Siehe auch

Projektorientierte Offlinedatenbankentwicklung