Configuration de SQL Server dans SMO

S’applique à : SQL ServerAzure SQL Database Azure SQL Managed Instance Azure Synapse Analytics

Dans SMO, l’objetInformation, l’objet UserOptions Settings et l’objet Configuration contiennent des paramètres et des informations pour l’instance de Microsoft SQL Server.

SQL Server a de nombreuses propriétés qui décrivent le comportement de l’instance installée. Les propriétés décrivent les options de démarrage, les valeurs par défaut du serveur, les fichiers et répertoires, les informations sur le processeur et le système, le produit et les versions, les informations sur la connexion, les options de mémoire, les sélections de langue et de classement et le mode d'authentification.

Configuration de SQL Server

Les Information propriétés de l’objet contiennent des informations sur l’instance de SQL Server, telles que le processeur et la plateforme.

Les Settings propriétés de l’objet contiennent des informations sur l’instance de SQL Server. Le fichier et le répertoire par défaut de la base de données peuvent être modifiés en plus du profil de messagerie et du compte du serveur. Ces propriétés restent valables pendant toute la durée de la connexion.

Les propriétés de l'objet UserOptions contiennent des informations sur le comportement des connexions actuelles en ce qui concerne l'arithmétique, les normes ANSI et les transactions.

Il existe également un jeu d'options de configuration représenté par l'objet Configuration. Il contient un jeu de propriétés qui représentent les options qui peuvent être modifiées par la procédure stockée sp_configure . Les options telles que Priority Boost, Recovery Interval et Network Packet Sizecontrôlent les performances de l’instance de SQL Server. La plupart de ces options peuvent être modifiées dynamiquement, mais dans certains cas, la valeur est d’abord configurée, puis modifiée lorsque l’instance de SQL Server est redémarrée.

Il existe une propriété d'objet Configuration pour chaque option de configuration. Vous pouvez modifier le paramètre de configuration global en utilisant l'objet ConfigProperty. De nombreuses propriétés disposent de valeurs minimum et maximum qui sont également stockées sous la forme de propriétés ConfigProperty. Ces propriétés nécessitent la méthode pour valider la Alter modification apportée à l’instance de SQL Server.

Toutes les options de configuration de l'objet Configuration doivent être modifiées par l'administrateur système.

Exemples

Dans les exemples de code suivants, vous devez sélectionner l'environnement, le modèle et le langage de programmation à utiliser pour créer votre application. Pour plus d’informations, consultez Créer un projet SMO Visual C# dans Visual Studio .NET.

Modification des options de configuration de SQL Server en Visual Basic

L'exemple de code montre comment mettre à jour une option de configuration en Visual Basic .NET. Il récupère et affiche également des informations relatives aux valeurs minimale et maximale de l'option de configuration spécifiée. Enfin, le programme informe l’utilisateur si la modification a été apportée dynamiquement ou s’il est stocké jusqu’à ce que l’instance de SQL Server soit redémarrée.

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Display all the configuration options.
Dim p As ConfigProperty
For Each p In srv.Configuration.Properties
    Console.WriteLine(p.DisplayName)
Next
Console.WriteLine("There are " & srv.Configuration.Properties.Count.ToString & " configuration options.")
'Display the maximum and minimum values for ShowAdvancedOptions.
Dim min As Integer
Dim max As Integer
min = srv.Configuration.ShowAdvancedOptions.Minimum
max = srv.Configuration.ShowAdvancedOptions.Maximum
Console.WriteLine("Minimum and Maximum values are " & min & " and " & max & ".")
'Modify the value of ShowAdvancedOptions and run the Alter method.
srv.Configuration.ShowAdvancedOptions.ConfigValue = 0
srv.Configuration.Alter()
'Display when the change takes place according to the IsDynamic property.
If srv.Configuration.ShowAdvancedOptions.IsDynamic = True Then
    Console.WriteLine("Configuration option has been updated.")
Else
    Console.WriteLine("Configuration option will be updated when SQL Server is restarted.")
End If

Modification des paramètres de SQL Server en Visual Basic

L’exemple de code affiche des informations sur l’instance de SQL Server dans Information et Settingsmodifie les paramètres dans et UserOptionsles Settings propriétés d’objet.

Dans l'exemple, l'objet UserOptions et l'objet Settings disposent tous deux d'une méthode Alter. Vous pouvez exécuter ces méthodes Alter individuellement.

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Display information about the instance of SQL Server in Information and Settings.
Console.WriteLine("OS Version = " & srv.Information.OSVersion)
Console.WriteLine("State = " & srv.Settings.State.ToString)
'Display information specific to the current user in UserOptions.
Console.WriteLine("Quoted Identifier support = " & srv.UserOptions.QuotedIdentifier)
'Modify server settings in Settings.

srv.Settings.LoginMode = ServerLoginMode.Integrated
'Modify settings specific to the current connection in UserOptions.
srv.UserOptions.AbortOnArithmeticErrors = True
'Run the Alter method to make the changes on the instance of SQL Server.
srv.Alter()

Modification des paramètres de SQL Server en Visual C#

L’exemple de code affiche des informations sur l’instance de SQL Server dans Information et Settingsmodifie les paramètres dans et UserOptionsles Settings propriétés d’objet.

Dans l'exemple, l'objet UserOptions et l'objet Settings disposent tous deux d'une méthode Alter. Vous pouvez exécuter ces méthodes Alter individuellement.

//Connect to the local, default instance of SQL Server.

{  
            Server srv = new Server();  
            //Display all the configuration options.   
  
            foreach (ConfigProperty p in srv.Configuration.Properties)  
            {  
                Console.WriteLine(p.DisplayName);  
            }  
            Console.WriteLine("There are " + srv.Configuration.Properties.Count.ToString() + " configuration options.");  
            //Display the maximum and minimum values for ShowAdvancedOptions.   
            int min = 0;  
            int max = 0;  
            min = srv.Configuration.ShowAdvancedOptions.Minimum;  
            max = srv.Configuration.ShowAdvancedOptions.Maximum;  
            Console.WriteLine("Minimum and Maximum values are " + min + " and " + max + ".");  
            //Modify the value of ShowAdvancedOptions and run the Alter method.   
            srv.Configuration.ShowAdvancedOptions.ConfigValue = 0;  
            srv.Configuration.Alter();  
            //Display when the change takes place according to the IsDynamic property.   
            if (srv.Configuration.ShowAdvancedOptions.IsDynamic == true)  
            {  
                Console.WriteLine("Configuration option has been updated.");  
            }  
            else  
            {  
                Console.WriteLine("Configuration option will be updated when SQL Server is restarted.");  
            }  
        }  

Modification des paramètres de SQL Server dans PowerShell

L’exemple de code affiche des informations sur l’instance de SQL Server dans Information et Settingsmodifie les paramètres dans et UserOptionsles Settings propriétés d’objet.

Dans l'exemple, l'objet UserOptions et l'objet Settings disposent tous deux d'une méthode Alter. Vous pouvez exécuter ces méthodes Alter individuellement.

# Set the path context to the local, default instance of SQL Server.  
CD \sql\localhost\  
$srv = get-item default  
  
#Display information about the instance of SQL Server in Information and Settings.  
"OS Version = " + $srv.Information.OSVersion  
"State = "+ $srv.Settings.State.ToString()  
  
#Display information specific to the current user in UserOptions.  
"Quoted Identifier support = " + $srv.UserOptions.QuotedIdentifier  
  
#Modify server settings in Settings.  
$srv.Settings.LoginMode = [Microsoft.SqlServer.Management.SMO.ServerLoginMode]::Integrated  
  
#Modify settings specific to the current connection in UserOptions.  
$srv.UserOptions.AbortOnArithmeticErrors = $true  
  
#Run the Alter method to make the changes on the instance of SQL Server.  
$srv.Alter()  

Modification des options de configuration de SQL Server dans PowerShell

L'exemple de code montre comment mettre à jour une option de configuration en Visual Basic .NET. Il récupère et affiche également des informations relatives aux valeurs minimale et maximale de l'option de configuration spécifiée. Enfin, le programme informe l’utilisateur si la modification a été apportée dynamiquement ou s’il est stocké jusqu’à ce que l’instance de SQL Server soit redémarrée.

#Get a server object which corresponds to the default instance replace LocalMachine with the physical server  
cd \sql\LocalMachine  
$svr = get-item default  
  
#enumerate its properties  
foreach ($Item in $Svr.Configuration.Properties)   
{  
 $Item.DisplayName  
}  
  
"There are " + $svr.Configuration.Properties.Count.ToString() + " configuration options."  
  
#Display the maximum and minimum values for ShowAdvancedOptions.  
$min = $svr.Configuration.ShowAdvancedOptions.Minimum  
$max = $svr.Configuration.ShowAdvancedOptions.Maximum  
"Minimum and Maximum values are " + $min.ToString() + " and " + $max.ToString() + "."  
  
#Modify the value of ShowAdvancedOptions and run the Alter method.  
$svr.Configuration.ShowAdvancedOptions.ConfigValue = 0  
$svr.Configuration.Alter()  
  
#Display when the change takes place according to the IsDynamic property.  
If ($svr.Configuration.ShowAdvancedOptions.IsDynamic -eq $true)  
 {    
   "Configuration option has been updated."  
 }  
Else  
{  
    "Configuration option will be updated when SQL Server is restarted."  
}