Konfigurera SQL Server i SMO

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSQL-databas i Förhandsversion av Microsoft Fabric

I SMO Information innehåller objektet, Settings objektet, UserOptions objektet och Configuration objektet inställningar och information för instansen av Microsoft SQL Server.

SQL Server har flera egenskaper som beskriver beteendet för den installerade instansen. Egenskaperna beskriver startalternativen, serverns standardvärden, filer och kataloger, system- och processorinformation, produkt och versioner, anslutningsinformation, minnesalternativ, språk- och sorteringsval och autentiseringsläget.

SQL Server-konfiguration

Objektegenskaperna Information innehåller information om instansen av SQL Server, till exempel processor och plattform.

Objektegenskaperna Settings innehåller information om instansen av SQL Server. Standarddatabasfilen och katalogen kan ändras utöver e-postprofilen och serverkontot. Dessa egenskaper finns kvar under anslutningens varaktighet.

Objektegenskaperna UserOptions innehåller information om det aktuella anslutningsbeteendet som rör aritmetik, ANSI-standarder och transaktioner.

Det finns också en uppsättning konfigurationsalternativ som representeras av Configuration objektet. Den innehåller en uppsättning egenskaper som representerar de alternativ som kan ändras av den sp_configure lagrade proceduren. Alternativ som Priority Boost, Recovery Interval och Network Packet Size styr prestanda för sql Server-instansen. Många av dessa alternativ kan ändras dynamiskt, men i vissa fall konfigureras värdet först och ändras sedan när instansen av SQL Server startas om.

Det finns en Configuration objektegenskap för varje konfigurationsalternativ. Med hjälp av ConfigProperty objektet kan du ändra den globala konfigurationsinställningen. Många egenskaper har högsta och lägsta värden som också lagras som ConfigProperty egenskaper. Dessa egenskaper kräver metoden Alter för att genomföra ändringen till instansen av SQL Server.

Alla konfigurationsalternativ i Configuration objektet måste ändras av systemadministratören.

Examples

För följande kodexempel måste du välja programmeringsmiljö, programmeringsmall och programmeringsspråket för att skapa ditt program. Mer information finns i Skapa ett Visual C# SMO-projekt i Visual Studio .NET.

Ändra konfigurationsalternativ för SQL Server i Visual Basic

Kodexemplet visar hur du uppdaterar ett konfigurationsalternativ i Visual Basic .NET. Den hämtar och visar också information om högsta och lägsta värden för det angivna konfigurationsalternativet. Slutligen informerar programmet användaren om ändringen har gjorts dynamiskt eller om den lagras tills instansen av SQL Server startas om.

'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

Ändra SQL Server-inställningar i Visual Basic

Kodexemplet visar information om instansen av SQL Server i Information och Settingsoch ändrar inställningar i Settings och UserOptionsobjektegenskaper.

I exemplet UserOptions har både objektet och Settings objektet en Alter metod. Du kan köra Alter metoderna för dessa individuellt.

'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()

Ändra SQL Server-inställningar i Visual C#

Kodexemplet visar information om instansen av SQL Server i Information och Settingsoch ändrar inställningar i Settings och UserOptionsobjektegenskaper.

I exemplet UserOptions har både objektet och Settings objektet en Alter metod. Du kan köra Alter metoderna för dessa individuellt.

//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.");  
            }  
        }  

Ändra SQL Server-inställningar i PowerShell

Kodexemplet visar information om instansen av SQL Server i Information och Settingsoch ändrar inställningar i Settings och UserOptionsobjektegenskaper.

I exemplet UserOptions har både objektet och Settings objektet en Alter metod. Du kan köra Alter metoderna för dessa individuellt.

# 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()  

Ändra konfigurationsalternativ för SQL Server i PowerShell

Kodexemplet visar hur du uppdaterar ett konfigurationsalternativ i Visual Basic .NET. Den hämtar och visar också information om högsta och lägsta värden för det angivna konfigurationsalternativet. Slutligen informerar programmet användaren om ändringen har gjorts dynamiskt eller om den lagras tills instansen av SQL Server startas om.

#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."  
}