Freigeben über


Microsoft.SqlServer.Management.Dac-Namespace

The Microsoft.SqlServer.Management.Dac namespace contains classes that represent the Dac objects. The top-level instance is called DacStore and provides the connection to SQL Server. The Dac objects can be used to create and manage a DAC package, which contains all the information required to re-create a data-tier application.

The Microsoft.SqlServer.Management.Dac namespace contains the DAC objects. The DAC objects are used together with the Microsoft.SqlServer.Managment.Smo, Microsoft.SqlServer.Managment.Dmf, and Microsoft.SqlServer.Managment.Utility namespaces to create DAC packages. The DAC packages can be installed on an instance of SQL Server using the DAC object model, or deployed onto the SQL Server Utility using the SQL Server Utility object model. In Design mode, SMO is not connected to an instance of SQL Server. The SMO objects are used to design a data-tier application structure which can be saved into the DAC package. A DAC package can also include a limited amount of reference data and some miscellaneous files. Policy information is stored for each SMO instance class, and for the overall instance of SQL Server using DMF conditions. After it is created, the DAC package can be used to install the data-tier application on an instance of SQL Server that meets the specified DMF conditions. In connected mode, the SMO Server object represents an instance of SQL Server.

The Microsoft.SqlServer.Management.Dac namespace resides in the Microsoft.SqlServer.Management.Dac.dll file. Additionally, some of the enumeration classes are in the Microsoft.SqlServer.Management.DacEnum.dll files. You must import both files to access the classes in the Microsoft.SqlServer.Management.Dac namespace. In addition, you must import the Microsoft.SqlServer.Managment.Smo, Microsoft.SqlServer.Managment.Dmf, and Microsoft.SqlServer.Managment.Sdk.Sfc namespaces to create a DAC package.

By using the Microsoft.SqlServer.Management.Dac namespace, you can do the following:

  • Create an object graph that represents the data-tier application structure.

  • Add reference data.

  • Add miscellaneous files

  • Add deployment conditions.

  • Add configuration conditions.

  • Install the DAC package.

  • Upgrade a DAC package.

  • Create a DAC package.

  • Load and save a DAC package from file (serialize and deserialize).

Klassen

  Klasse Beschreibung
Öffentliche Klasse ActionNotSupportedException The ActionNotSupportedException class is used to raise an exception when the requested data-tier action, such as upgrade or register, is not supported by the version of the Database Engine the application is connected to.
Öffentliche Klasse BinarySourceBase The BinarySourceBase type is a base class that provides access to the IBinarySource interface.
Öffentliche Klasse ConnectionNotSetException The ConnectionNotSetException class is used to raise an exception when the connection passed to a DAC action, such as install, upgrade, or uninstall.
Öffentliche Klasse DacActionEventArgs Stellt die Daten dar, die gesendet werden, wenn sowohl während der Bereitstellung als auch während der Deinstallation von einem DAC-Aktionsschritt ein Ereignis ausgelöst wird.
Öffentliche Klasse DacActionValidator Validates that the requirements of the DAC action (install, upgrade, or uninstall) are in place.
Öffentliche Klasse DacCompilationError The CompilationError class represents an error generated when the DAC package is being compiled.
Öffentliche Klasse DacCompilationErrorCollection The DacCompilationErrorCollection type stores a collection of DAC compilation errors.
Öffentliche Klasse DacCompilationResult The DacCompilationResult class represents the DAC package and the collection of errors generated by compiling it.
Öffentliche Klasse DacCompilationUnit The DacCompilationUnit accepts Transact-SQL content and compiles it into a data-tier application (DAC) type. Any Transact-SQL file can be added or removed prior to compilation. 
Öffentliche Klasse DacConfig The DacConfig class returns data-tier application (DAC) configuration information.
Öffentliche Klasse DacDatabaseInformation The DacDatabaseInformation object stores information about data-tier application (DAC) actions that can be performed on a database.
Öffentliche Klasse DacDomain The DacDomain class instantiates the Microsoft.SqlServer.Management.Sdk.Sfc methods and properties inherited by the DacStore class.
Öffentliche Klasse DacDomain. . :: . .Key The DacDomain..::..Key class contains the key that identifies the DacDomain class.
Öffentliche Klasse DacException The DacException class is a generic exception that is raised when an error occurs using the Microsoft.SqlServer.Management.Dac namespace.
Öffentliche Klasse DacExtractionException The DacExtractionException class is a an exception that is raised when an error occurs during extraction of a DAC package.
Öffentliche Klasse DacExtractionUnit The DacExtractionUnit class contains the information that must be extracted to a DAC type, such as server graphs and miscellaneous files.
Öffentliche Klasse DacExtractValidationResult The DacExtractValidationResult object represents the result of extracting objects from a DAC package.
Öffentliche Klasse DacInstance The DacInstance type stores metadata information, such as the instance name and date created, about a deployed instance of a data-tier application (DAC).
Öffentliche Klasse DacInstance. . :: . .Key The DacInstance..::..Key class represents the key that identifies the DacInstance class.
Öffentliche Klasse DacInstanceCollection The DacInstanceCollection type stores one or more DAC instances contained in an instance of the Database Engine.
Öffentliche Klasse DacServerInformation The DacServerInformation class specifies the level of support for data-tier application (DAC) operations, such as upgrade, in an instance of the Database Engine.
Öffentliche Klasse DacStore Der DacStore-Typ bildet den Stamm des DAC-Objektmodells. Hierbei handelt es sich um den Stamm für eine Auflistung von DAC-Instanzen.
Öffentliche Klasse DacType Die DacType-Klasse stellt den Satz von Objekten, Richtlinien und Eigenschaften auf Datenebene dar, die zur Unterstützung einer bestimmten Anwendung entwickelt und bereitgestellt wurden.
Öffentliche Klasse DacUpgradeOptions Geben Sie mit diesem Typ an, welche Optionen beim Upgrade einer DAC-Instanz gelten.
Öffentliche Klasse DacUpgradeResult The DacUpgradeResult class records information about the results of upgrading a DAC instance.
Öffentliche Klasse DatabaseDeploymentProperties The DatabaseDeploymentProperties object represents the properties of a deployed database.
Öffentliche Klasse DatabaseExtractValidator Validates that the database can be extracted.
Öffentliche Klasse DeploymentValidationException The DeploymentValidationException class represents an exception thrown during DAC deployment due to a validation error.
Öffentliche Klasse DesignModeServerExtractException The DesignModeServerExtractException class represents an exception that is raised the server containing the database specified in an extract operation is in Design mode.
Öffentliche Klasse ExtractValidationException The ExtractValidationException class represents an exception thrown during a validation operation.
Öffentliche Klasse FailedTargetSelectionException The FailedTargetSelectionException class represents an exception that is thrown when target selection policy fails during deployment of a DAC.
Öffentliche Klasse FileExtraSource The FileSource type represents a miscellaneous file that is included in the DAC package.
Öffentliche Klasse InvalidaDACTypeCredentialsException The InvalidDacTypeCredentialsException class is an exception that is raised when upgrading a DAC if the credentials of the new DAC type do not match the credentials of the current DAC instance.
Öffentliche Klasse InvalidaDatabaseStateException The InvalidDatabaseStateException class is an exception that is raised when a database is in a state that cannot support a requested data-tier application (DAC) action, such as deploy or upgrade.
Öffentliche Klasse InvalidDatabaseExtractException The DatabaseExtractException class is an exception that is raised when the database specified in an extract operation is invalid.
Öffentliche Klasse InvalidDatabaseStateForExtractException Wird ausgelöst, wenn der Datenbankstatus einen Extraktionsvorgang verhindert.
Öffentliche Klasse InvalidInputException The InvalidInputException class is raised when validation of input data fails in the DAC package.
Öffentliche Klasse MiscellaneousFilesCollection The MiscellaneousFilesCollection class contains a collection of files to be added to the DAC package.
Öffentliche Klasse MissingDacSchemaException The MissingDacSchemaException class is an exception that is raised during validation when the DAC schema is missing.
Öffentliche Klasse MissingExtractServerPermissionsException The MissingExtractServerPermissionsException class represents an exception that is raised during extraction when the caller has insufficient permissions on the server to extract the database.
Öffentliche Klasse MissingServerPermissionsException The MissingServerPermissionsException class represents an exception that is raised when the caller has insufficient permissions on the server to deploy the DAC.
Öffentliche Klasse MissingServerPermissionsForRePartException The MissingServerPermissionsForRePartException class represents an exception that is raised when the caller does not have sufficient permissions
Öffentliche Klasse ServerDeploymentValidator The ServerDeploymentValidator class validates that the specified database engine is able to be used as a DAC store.
Öffentliche Klasse SmoBuilder The SmoBuilder class defines the GetSmoHierarchy method, which generates the SMO server hierarchy from binder metadata.
Öffentliche Klasse SourceInfo The SourceInfo class represents a location in a DAC source file that has thrown an exception.
Öffentliche Klasse TSqlCompilationErrorCollection The TSqlCompilationErrorCollection class represents a collection of TSqlCompilationError objects.
Öffentliche Klasse TSqlCompilationException The TSqlCompilationException class represents an exception that is thrown during Transact-SQL compilation.
Öffentliche Klasse TSqlCompilationResult The TSqlCompilationResult class defines methods and properties that contain information about the result of a Transact-SQL compilation.
Öffentliche Klasse TSqlSourceFile The TSqlSourceFile class represents a Transact-SQL source file.
Öffentliche Klasse ValidatedObject The ValidatedObject class describes objects that have been validated.
Öffentliche Klasse ValidatedObjectEventArgs Represents an object that was validated as part of a data-tier application (DAC) action, such as deploy or delete.

Strukturen

  Struktur Beschreibung
Öffentliche Struktur Location Represents the location of the source of the error in the Transact-SQL input files to the DAC compilation unit.
Öffentliche Struktur TSqlCompilationError The TSqlCompilationError class contains information on a Transact-SQL compilation error or warning.

Schnittstellen

  Schnittstelle Beschreibung
Öffentliche Schnittstelle IBinarySource The IBinarySource type is an interface that provides access to an I/O file stream.
Öffentliche Schnittstelle IExtraSource The IExtraSource type is an interface that provides I/O stream access to a miscellaneous file in the DAC package.
Öffentliche Schnittstelle ISizeItem Defines an interface that allows the implementing class to calculate its size.

Enumerationen

  Enumeration Beschreibung
Öffentliche Enumeration ActionName Die ActionName-Enumeration listet die Namen jedes möglichen Aktionsschritts auf.
Öffentliche Enumeration ActionState The ActionState enumeration lists the possible DAC action step states.
Öffentliche Enumeration DacExceptionType The DacExceptionType enumeration contains values that are used to specify the type of DAC exception.
Öffentliche Enumeration DacUninstallMode The DacUninstallMode enumeration contains values that are used to specify what to do with the database associated with a DAC instance when the instance is uninstalled.
Öffentliche Enumeration DatabaseState Listet die möglichen Status der DAC-Datenbank auf.
Öffentliche Enumeration MessageLevel Diese Enumeration gibt die Meldungsebene der Ereignisargumente an. Die Argumente werden je nach Ereignistyp mit Anmerkungen versehen.
Öffentliche Enumeration ObjectValidationResult An enumeration that specifies the values for reporting the results of validating or extracting an object.