Configuration de SQL Server dans SMO

Dans SMO, l’objetInformation, l’objet UserOptionsSettings 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 les répertoires, les informations système et processeur, les informations de produit et les versions, les informations de connexion, les options de mémoire, la langue et les sélections de classement, ainsi que le mode d’authentification.

SQL Server Configuration

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 de base de données par défaut peuvent être modifiés en plus du profil de messagerie et du compte de serveur. Ces propriétés restent pendant la durée de la connexion.

Les UserOptions propriétés de l’objet contiennent des informations sur le comportement actuel des connexions relatives aux normes arithmétiques, aux normes ANSI et aux transactions.

Il existe également un ensemble d’options de configuration représentées par l’objet Configuration . Il contient un ensemble de propriétés qui représentent les options qui peuvent être modifiées par la sp_configure procédure stockée. 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 Configuration propriété d’objet pour chaque option de configuration. À l’aide de l’objet ConfigProperty , vous pouvez modifier le paramètre de configuration global. De nombreuses propriétés ont des valeurs maximales et minimales qui sont également stockées en tant que ConfigProperty propriétés. 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

Pour les exemples de code suivants, vous devez sélectionner l’environnement de programmation, le modèle de programmation et le langage de programmation pour créer votre application. Pour plus d’informations, consultez Créer un projet SMO Visual Basic dans Visual Studio .NET et 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 dans Visual Basic .NET. Il récupère et affiche également des informations sur les valeurs maximales et minimales 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.

Modification des paramètres 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 ont tous deux une Alter méthode. Vous pouvez exécuter les Alter méthodes pour ces méthodes individuellement.

Modification des paramètres SQL Server dans 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 ont tous deux une Alter méthode. Vous pouvez exécuter les Alter méthodes pour ces méthodes 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 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 ont tous deux une Alter méthode. Vous pouvez exécuter les Alter méthodes pour ces méthodes 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 dans Visual Basic .NET. Il récupère et affiche également des informations sur les valeurs maximales et minimales 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."  
 }