Share via

Importieren in ein Datenbankprojekt

  • Artikel

 

Mithilfe von „Importieren“ können Sie ein Projekt mit neuen Objekten aus einer Livedatenbank oder einer DACPAC-Datei auffüllen bzw. im Projekt vorhandene Objekte anhand einer neuen Definition aus einem Skript aktualisieren.Bei den drei nachfolgend beschriebenen Methoden sind einige Verhaltensunterschiede zu beachten.

Menü "Importieren"

SSDT Importieren (Menü)

Abschnitte in diesem Thema

Importquelle: Datenbank oder Datenebenenanwendung (*.dacpac)

Importquelle: Skript (*.sql)

Importieren verschlüsselter Objekte

Importquelle: Datenbank oder Datenebenenanwendung (*.dacpac)

Die Fähigkeit, ein Schema aus einer Datenbank oder DACPAC-Datei zu importieren, ist nur verfügbar, wenn noch keine Schemaobjekte im Projekt definiert sind.Davon ausgeschlossen sind RefactorLog-Dateien oder Skripts vor und nach der Bereitstellung.

Beim Import werden für Objektdefinitionen Skripts in Projektdateien erstellt, wobei die in SSDT enthaltenen betrieblichen Standardwerte für neue Objekte verwendet werden: neue Dateien für Objekte oberster Ebene, untergeordnete Hierarchieelemente, die in derselben Datei wie das übergeordnete Element definiert sind, oder inline definierte Tabellen- oder Spalteneinschränkungen (sofern möglich).Um die Sichtbarkeit und Steuerung der einzelnen Objekte zu verbessern, verwenden Sie anstelle von „Importieren“ die Option „Schemavergleich“.

Wenn die Importquelle Skripts vor und nach der Bereitstellung, RefactorLog-Dateien oder Definitionen von SQLCMD-Variablen enthält, werden diese in das Projekt importiert.Wenn eines dieser Artefakte bereits im Projekt enthalten ist, werden die importierten Dateien einem Projektordner hinzugefügt, der die beim Import zu ignorierenden Elemente enthält.

Ordner für beim Import zu ignorierende Elemente

SSDT – Ordner für beim Import zu ignorierende Elemente

Importquelle: Skript (*.sql)

Alle Objekte aus der Importquelle, die noch nicht im Projekt enthalten sind, werden hinzugefügt. Demgegenüber wird die Objektdefinition von allen Objekten aus der Importquelle überschrieben, die bereits im Projekt vorhanden sind.

Hinweis

Bei dieser Methode treten zwei bekannte Fehler auf, die in zukünftigen Versionen behoben sein werden:

  • Wenn Tabellen- oder Spalteneinschränkungen außerhalb der CREATE TABLE-Anweisung in der Tabellendefinition des Projekts definiert sind, wird die Tabellendefinition beim Import überschrieben, sodass die Einschränkung inline ist.Dabei bleibt die Out-of-Line-Einschränkung jedoch bestehen, was zu doppelten Einschränkungen im Projekt führt.
  • Alle Masterschlüssel oder Datenbankverschlüsselungsschlüssel aus dem Quellskript, die bereits im Projekt vorhanden sind, werden beim Import dupliziert.Entfernen Sie Duplikate, um das Projekt zu erstellen.

Beim Import aus Skripts können Skripts vor und nach der Bereitstellung, SQLCMD-Variablen oder RefactorLog-Dateien nicht ausgewertet werden.Diese und andere nicht unterstützte Konstrukte, die beim Import erkannt werden, werden projektweise in einer Datei ScriptsIgnoredOnImport.sql im Ordner Skripts abgelegt.

Weitere Informationen finden Sie im SSDT-Teamforum unter https://social.msdn.microsoft.com/Forums/en-US/ssdt/threads.

Importieren verschlüsselter Objekte

Beim Importieren verschlüsselter Objekte in ein Datenbankprojekt kann der vollständige Text der Objektdefinition nicht immer vom Server abgerufen werden.Somit kann das Importverhalten bei der Verwendung dieser Objektklasse abweichen.

Wenn der vollständige Definitionstext nicht abgerufen werden kann, werden für den Objektheader/-footer Skripts zusammen mit einem Pseudotext erstellt.Mit diesem Verhalten ist zu rechnen, wenn Sie „Importieren“ oder „Schemavergleich“ verwenden und es sich bei der Quelle um eine Livedatenbank oder eine aus einer Datenbank extrahierte DACPAC-Datei handelt.

Skript mit einem Pseudotext

Skript mit einem Pseudotext

Wenn die vollständige Objektdefinition verfügbar ist und abgerufen werden kann, wird sie bei Verwendung von „Importieren“ und „Schemavergleich“ vollständig in das Projekt übernommen.Dies ist der Fall, wenn das Projekt anhand eines Skripts aktualisiert bzw. eine DACPAC-Datei aus einem Datenbankprojekt oder einem anderen Projekt erstellt wird.