Freigeben über


Gewusst wie: Umbenennen von Datenbankobjekten

In diesem Thema wird das Umbenennen eines Datenbankobjekts in Visual Studio Premium erläutert. Wenn Sie ein Datenbankobjekt umbenennen, werden andere Objekte, die auf das umbenannte Objekt verweisen, automatisch mit dem neuen Namen aktualisiert. Wenn Sie beispielsweise eine Spalte in einer Tabelle umbenennen, werden alle gespeicherten Prozeduren, die auf diese Spalte verweisen, automatisch mit dem neuen Namen aktualisiert. Weitere Informationen finden Sie unter Umbenennen aller Verweise auf ein Datenbankobjekt.

So benennen Sie ein Datenbankobjekt um

  1. Klicken Sie in der Schemaansicht auf das Objekt, das Sie umbenennen möchten. Erweitern Sie zum Umbenennen einer Spalte beispielsweise den Unterordner Tabellen, erweitern Sie die Tabelle, erweitern Sie den Ordner Spalten, und klicken Sie auf das umzubenennende Objekt.

    Tipp

    In Visual Studio Premium gestalten Sie Datenbankobjekte im Fenster Schemaansicht um. In einem Codefenster können Sie keine Datenbankobjekte umgestalten.

  2. Zeigen Sie im Menü Daten auf Umgestalten, und klicken Sie dann auf Umbenennen. Sie können auch mit der rechten Maustaste auf das Objekt in der Schemaansicht klicken, auf Umgestalten zeigen und dann auf Umbenennen klicken.

    Das Dialogfeld Umbenennen wird angezeigt.

    Tipp

    Sie können kein Datenbankobjekt umbenennen, wenn das Objekt, das umbenannt werden soll, Buildfehler enthält. In diesem Fall ist die Menüoption nicht verfügbar.

  3. Geben Sie unter Neuer Name den neuen Namen des Objekts ein.

  4. (Optional) Aktivieren Sie das Kontrollkästchen Vorschau der Änderungen anzeigen.

    Tipp

    Genauere Informationen über das Anzeigen der Änderungen in der Vorschau vor dem Übernehmen finden Sie im Folgenden. Standardmäßig werden Verweise in Komponententests und Skripts nicht automatisch aktualisiert. Diese Änderungen müssen Sie im Dialogfeld Vorschau der Änderungen anwenden.

  5. (Optional) Aktivieren Sie das Kontrollkästchen Standardprojektschema dbo für nicht gekennzeichnete Skript- und Komponententestverweise verwenden.

    Wenn das Kontrollkästchen deaktiviert ist und Sie keine vollqualifizierten Namen in den Skripts und Komponententests angeben, werden diese Verweise nicht gefunden. Wenn das Kontrollkästchen aktiviert ist und Sie in den Skripts und Komponententests keine vollqualifizierten Namen angeben, wird davon ausgegangen, dass das Standardschema dieser Objekte dem Standardschema des Projekts entspricht.

  6. (Optional) Aktivieren Sie das Kontrollkästchen Verweise in Schemaobjekten mit Warnungen oder Fehlern aktualisieren.

    Wenn das Kontrollkästchen deaktiviert ist, werden Verweise in Objekten, deren Definitionen zu Fehlern oder Warnungen führen, nicht in die Umgestaltungsoperation einbezogen. Wenn das Kontrollkästchen aktiviert ist, werden alle Verweise aktualisiert, auch wenn die enthaltende Objektdefinition Warnungen oder Fehler enthält.

    Tipp

    Wenn Sie ein Datenbankobjekt umbenennen und das Projekt Buildfehler enthält, kann das Objekt trotzdem korrekt umbenannt werden. Es können jedoch möglicherweise nicht alle Verweise auf dieses Objekt ordnungsgemäß aktualisiert werden. Wenn das Projekt Buildfehler enthält, wird das Objekt umbenannt, und Verweise werden so weit wie möglich aktualisiert. Sie können auch zuerst die Buildfehler beheben und dann den Umbenennungsvorgang ausführen. Weitere Informationen finden Sie unter Überlegungen vor dem Umbenennen von Datenbankobjekten.

  7. Klicken Sie auf OK.

    Wenn Sie das Kontrollkästchen Vorschau der Änderungen anzeigen aktiviert haben, wird das Dialogfeld Vorschau der Änderungen anzeigen angezeigt. Andernfalls werden die Änderungen vorgenommen. Der Objektname wird aktualisiert, und der neue Name wird in der Schemaansicht angezeigt.

    Tipp

    Sie können die Änderungen rückgängig machen. Weitere Informationen finden Sie unter Gewusst wie: Rückgängigmachen einer Datenbankumgestaltung.

    Zusätzlich zu den optionalen in Schritt 6 erwähnten Protokolldateien werden jedes Mal Einträge in die Datei Projektname.refactorlog geschrieben, wenn Sie ein Datenbankobjekt in ein anderes Schema verschieben. Diese Datei ist Teil des Datenbankprojekts und wird verwendet, wenn Sie das Datenbankprojekt bereitstellen. Sie müssen sie für die Versionskontrolle einchecken und sie wie jede andere freigegebene Projektressource verwalten. Weitere Informationen finden Sie unter Verschieben eines Datenbankobjekts in ein anderes Schema.

So zeigen Sie vor dem Übernehmen der Änderungen eine Vorschau an

  1. Geben Sie im Dialogfeld Umbenennen den neuen Namen des Objekts ein.

  2. Aktivieren Sie das Kontrollkästchen Vorschau der Änderungen anzeigen, und klicken Sie auf OK.

    Das Dialogfeld Vorschau der Änderungen wird angezeigt und enthält einen oberen und einen unteren Bereich. Der obere Bereich enthält eine Struktur, in der alle Objekte aufgeführt werden, die geändert werden. Im unteren Bereich wird das Skript angezeigt, das zum Ausführen der Änderungen generiert wird. Im oberen Bereich wird der alte Name angezeigt, und der untere Bereich enthält den neuen Namen.

  3. Erweitern Sie im oberen Bereich Schemaobjekte.

    Ein SQL-Knoten für das Schemaobjekt, das Sie umbenennen (oder das Objekt, das dies enthält), wird angezeigt. Außerdem werden SQL-Knoten für alle Schemaobjekte angezeigt, die auf das umbenannte Objekt verweisen.

  4. Klicken Sie auf einen der SQL-Knoten.

    Im unteren Bereich wird der Transact-SQL-Code angezeigt, und der neue Name ist hervorgehoben.

  5. Klicken Sie auf Übernehmen.

    Die Änderungen werden vorgenommen. Der Objektname wird aktualisiert, und der neue Name wird in der Schemaansicht angezeigt.

    Tipp

    Sie können die Änderungen rückgängig machen. Weitere Informationen hierzu finden Sie unter Gewusst wie: Rückgängigmachen einer Datenbankumgestaltung.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Anwenden von Umgestaltungstechniken für eine Datenbank

Gewusst wie: Bereitstellen von Datenbankumgestaltungsänderungen

Konzepte

Umbenennen aller Verweise auf ein Datenbankobjekt