TSqlModel Klasse

Definition

Namespace:

Microsoft.SqlServer.Dac.Model

Assembly:

Microsoft.SqlServer.Dac.Extensions.dll

Paket:

Microsoft.SqlServer.DacFx v162.2.111

Stellt ein Modell eines SQL Server Datenbankschemas dar.

public sealed class TSqlModel : IDisposable

type TSqlModel = class
    interface IDisposable

Public NotInheritable Class TSqlModel
Implements IDisposable

Vererbung

Object

TSqlModel

Implementiert

IDisposable

Konstruktoren

Name	Beschreibung
TSqlModel(SqlServerVersion, TSqlModelOptions)	Erstellt ein leeres Modell, das auf ein bestimmtes Objekt ausgerichtet ist. SqlServerVersion
TSqlModel(String, DacSchemaModelStorageType, CancellationToken)	Lädt ein Modell aus einem DacPackage oder BacPackage. Dies entspricht dem Aufrufen LoadFromDacpac(String, ModelLoadOptions) mit Standardwerten für alles außer dem modelStorageType.
TSqlModel(String, DacSchemaModelStorageType)	Lädt ein Modell aus einem DacPackage oder BacPackage. Dies entspricht dem Aufrufen LoadFromDacpac(String, ModelLoadOptions) mit Standardwerten für alles außer dem modelStorageType.
TSqlModel(String)	Lädt ein Modell aus einem DacPackage oder BacPackage. Dies entspricht dem Aufrufen LoadFromDacpac(String, ModelLoadOptions) mit Standardwerten.

Eigenschaften

Name	Beschreibung
CollationComparer	Vergleichsfunktion, der Zeichenfolgen und ObjectIdentifierZeichenfolgen mithilfe der Sortierung dieser TSqlModelZeichenfolge vergleicht. Dies kann sehr nützlich sein, wenn Objekte im Modell verglichen werden, da Vergleiche mit den erwarteten Vergleichsergebnissen in SQL Server
DisplayServices	Ruft ab, die das DisplayServices Erstellen von Anzeigeeigenschaften für Objekte im Modell unterstützt.
EngineVersion	Die spezifische Modulversion, die auf das Modell ausgerichtet ist. Für lokale Plattformen ist dies mit der SqlServerVersionSql90 Version 9 des Moduls konsistent. Für Microsoft Azure SQL-Datenbank die mindestens gültige Version 11, und die Modulversion wirkt sich darauf aus, welche Features im Modell unterstützt werden.
IsScriptBacked	Ist dies ein Modell, das von Skripts unterstützt wird? In diesem Fall enthalten Objekte im UserDefined Bereich Quellpositionsinformationen, einschließlich des Quellnamens und der Informationen. Dies ist wichtig für Szenarien wie die Verwendung der CodeAnalysisService. Alle leeren TSqlModel Erstellten werden standardmäßig skriptgesichert. Modelle, die aus einem Dacpac geladen werden, werden nur dann mit Scipt unterstützt, wenn die LoadAsScriptBackedModel Option aktiviert ist. Beachten Sie, dass das Erstellen eines skriptgestützten Modells länger dauert als die Verwendung eines standardmodells, das aus einem Dacpac geladen wurde.
Version	Das spezifische SQL Server Release, das vom Modell verwendet wird.

Methoden

Name	Beschreibung
AddObjects(String, TSqlObjectOptions)	Fügen Sie dem Modell Objekte basierend auf dem Inhalt einer TSql-Skriptzeichenfolge sowie zusätzliche Metadaten hinzu, die durch ein TSqlObjectOptions Objekt definiert werden. Das Skript sollte aus gültigen TSql DDL-Anweisungen bestehen. Objekte, die mit dieser Methode hinzugefügt werden, können zu einem späteren Zeitpunkt nicht aktualisiert oder gelöscht werden, da beim Hinzufügen der Objekte ein Skriptname angegeben werden muss. Wenn dies eine Anforderung ist, verwenden Sie stattdessen die AddOrUpdateObjects(String, String, TSqlObjectOptions) Methode.
AddObjects(String)	Fügt dem Modell Objekte basierend auf dem Inhalt einer TSql Script-Zeichenfolge hinzu. Das Skript sollte aus gültigen TSql DDL-Anweisungen bestehen. Objekte, die mit dieser Methode hinzugefügt werden, können zu einem späteren Zeitpunkt nicht aktualisiert oder gelöscht werden, da beim Hinzufügen der Objekte ein Skriptname angegeben werden muss. Wenn dies eine Anforderung ist, verwenden Sie stattdessen die AddOrUpdateObjects(String, String, TSqlObjectOptions) Methode.
AddObjects(TSqlScript, TSqlObjectOptions)	Fügen Sie dem Modell Objekte basierend auf dem Inhalt eines TSqlScript Objekts sowie zusätzliche Metadaten hinzu, die von einem TSqlObjectOptions Objekt definiert wurden. Das Skript sollte gültiger TSql ohne Analysefehler sein. Objekte, die mit dieser Methode hinzugefügt werden, können zu einem späteren Zeitpunkt nicht aktualisiert oder gelöscht werden, da beim Hinzufügen der Objekte ein Skriptname angegeben werden muss. Wenn dies eine Anforderung ist, verwenden Sie stattdessen die AddOrUpdateObjects(TSqlScript, String, TSqlObjectOptions) Methode.
AddObjects(TSqlScript)	Fügt dem Modell Objekte basierend auf dem Inhalt eines TSqlScript Objekts hinzu. Das Skript sollte gültige TSql ohne Analysefehler sein. Objekte, die mit dieser Methode hinzugefügt werden, können zu einem späteren Zeitpunkt nicht aktualisiert oder gelöscht werden, da beim Hinzufügen der Objekte ein Skriptname angegeben werden muss. Wenn dies eine Anforderung ist, verwenden Sie stattdessen die AddOrUpdateObjects(TSqlScript, String, TSqlObjectOptions) Methode.
AddOrUpdateObjects(String, String, TSqlObjectOptions)	Fügt die für ein bestimmtes Objekt definierten sourceName Objekte mit den in der inputScriptDatei definierten Objekten hinzu oder aktualisiert sie. Wenn objekte zuvor mit demselben sourceName hinzugefügt wurden, werden diese vollständig ersetzt Die Objektdefinitionen basieren auf dem Inhalt einer TSql Script-Zeichenfolge sowie zusätzliche Metadaten, die durch ein TSqlObjectOptions Objekt definiert werden. Das Skript sollte aus gültigen TSql DDL-Anweisungen bestehen.
AddOrUpdateObjects(TSqlScript, String, TSqlObjectOptions)	Fügt die für ein bestimmtes Objekt definierten sourceName Objekte mit den in der inputScriptDatei definierten Objekten hinzu oder aktualisiert sie. Wenn objekte zuvor mit demselben sourceName hinzugefügt wurden, werden diese vollständig ersetzt Die Objektdefinitionen basieren auf dem Inhalt eines TSqlScript Objekts sowie zusätzliche Metadaten, die durch ein TSqlObjectOptions Objekt definiert werden. Das Skript sollte aus gültigen TSql DDL-Anweisungen bestehen.
CheckVersionCompatibility(SqlServerVersion, CancellationToken)	Überprüft das Modell, um festzustellen, ob es Elemente enthält, die nicht mit einer Zielversion von SQL Server oder Azure SQL-Datenbank kompatibel sind, und gibt Fehler oder Warnungen zurück.
ConvertToScriptedObject(TSqlObject, String)	Konvertiert ein bestimmtes Objekt auf oberster Ebene im Modell in eine skriptgesteuerte Darstellung von sich selbst. Dies ist nützlich, wenn sie mit einem Datenbankquellmodell beginnen und der Aufrufer den Inhalt dieses Objekts ändern möchte.
CopyModelOptions()	Kopiert das DatabaseOptions Modell in ein TSqlModelOptions Objekt. Dies ist nützlich, wenn Sie beim Erstellen eines neuen Modells die Optionen für ein Modell duplizieren möchten.
DeleteObjects(String)	Löscht alle Objekte, die dem Modell mit dem angegebenen Objekt sourceNamehinzugefügt wurden.
Dispose()	Gibt alle vom TSqlModel Objekt verwendeten Ressourcen frei.
GetModelErrors()	Gibt alle DacModelErrors zurück, die im Modell vorhanden sind.
GetObject(ModelTypeClass, ObjectIdentifier, DacQueryScopes)	Gibt TSqlObjects der angegebenen objectType und id. Nur Typen der obersten Ebene ModelTypeClass werden von dieser Methode unterstützt. Der objectType Parameter muss sich in den Typen befinden, die von der TopLevelTypes Methode zurückgegeben werden, oder der Aufruf schlägt fehl.
GetObjects(DacQueryScopes, ModelTypeClass[])	Gibt alle TSqlObjects zurück, die der Liste der .typeFilters Nur Typen der obersten Ebene ModelTypeClass werden von dieser Methode unterstützt. Alle Typen im typeFilters Parameter müssen im TopLevelTypes Parameter vorhanden sein, oder der Aufruf schlägt fehl.
GetObjects(ModelTypeClass, ObjectIdentifier, DacQueryScopes)	Gibt alle TSqlObjects zurück, die mit und ModelTypeClass .ObjectIdentifier Nur Typen der obersten Ebene ModelTypeClass werden von dieser Methode unterstützt. Der objectType Parameter muss sich in den Typen befinden, die von der TopLevelTypes Methode zurückgegeben werden, oder der Aufruf schlägt fehl.
GetObjects(String, ModelTypeClass[])	Gibt alle TSqlObjects in einem bestimmten sourceName Dokument zurück, gefiltert nach ModelTypeClasss, die durch den typeFilters Parameter angegeben wurden.
LoadFromDacpac(Stream, ModelLoadOptions, CancellationToken)	Lädt ein Modell aus einem DacPackage oder BacPackage mithilfe des angegebenen options , um zu konfigurieren, welche Art von Speicher verwendet werden soll, und ob ein skriptgestütztes Modell geladen werden soll oder nicht.
LoadFromDacpac(Stream, ModelLoadOptions)	Lädt ein Modell aus einem DacPackage oder BacPackage mithilfe des angegebenen options , um zu konfigurieren, welche Art von Speicher verwendet werden soll, und ob ein skriptgestütztes Modell geladen werden soll oder nicht.
LoadFromDacpac(String, ModelLoadOptions, CancellationToken)	Lädt ein Modell aus einem DacPackage oder BacPackage mithilfe des angegebenen options , um zu konfigurieren, welche Art von Speicher verwendet werden soll, und ob ein skriptgestütztes Modell geladen werden soll oder nicht.
LoadFromDacpac(String, ModelLoadOptions)	Lädt ein Modell aus einem DacPackage oder BacPackage mithilfe des angegebenen options , um zu konfigurieren, welche Art von Speicher verwendet werden soll, und ob ein skriptgestütztes Modell geladen werden soll oder nicht.
LoadFromDatabase(String, ModelExtractOptions, Nullable<CancellationToken>)	Lädt ein Modell aus einer Datenbank mithilfe des angegebenen options.
LoadFromDatabase(String, SecureString, ModelExtractOptions, Nullable<CancellationToken>)	Lädt ein Modell aus einer Datenbank mithilfe des angegebenen options.
LoadFromDatabaseWithAuthProvider(String, IUniversalAuthProvider, ModelExtractOptions, Nullable<CancellationToken>)	Lädt ein Modell aus einer Datenbank mithilfe des angegebenen options.
Validate()	Überprüft das Modell und gibt eine Liste von Nachrichten mit allen Fehlern/Warnungen zurück.