AffinityInfo 類別

The AffinityInfo object represents the Affinity settings for all CPUs and NUMA nodes on an Instance of SQL Server. Access to the AffinityInfo object is provided though the Server object.

繼承階層

System. . :: . .Object
  Microsoft.SqlServer.Management.Smo..::..AffinityInfo

命名空間：  Microsoft.SqlServer.Management.Smo
組件：  Microsoft.SqlServer.Smo (在 Microsoft.SqlServer.Smo.dll 中)

語法

'宣告
Public NotInheritable Class AffinityInfo _
    Implements IAlterable, IScriptable
'用途
Dim instance As AffinityInfo

public sealed class AffinityInfo : IAlterable, 
    IScriptable

public ref class AffinityInfo sealed : IAlterable, 
    IScriptable

[<SealedAttribute>]
type AffinityInfo =  
    class
        interface IAlterable
        interface IScriptable
    end

public final class AffinityInfo implements IAlterable, IScriptable

AffinityInfo 型別公開下列成員。

屬性

	名稱	說明
	AffinityType	Gets or Sets the AffinityType()()()() member of the AffinityInfo class. Valid values are Auto or Manual.
	Cpus	The Cpus()()()() member is a collection that represents the CPU settings for all CPUs on an Instance of SQL Server.
	NumaNodes	The NumaNode()()()() member is a collection that contains the NUMA node settings for an Instance of SQL Server.
	Parent	This gets the parent object of the AffinityInfo object. This value is the same as the Server object that contains the AffinityInfo()()()() member.

上層

方法

	名稱	說明
	Alter	This method updates the server with the current values in the AffinityInfo class.
	Equals	(繼承自 Object。)
	Finalize	(繼承自 Object。)
	GetHashCode	(繼承自 Object。)
	GetType	(繼承自 Object。)
	MemberwiseClone	(繼承自 Object。)
	Refresh	This method fills in the Cpus()()()() and NumaNode()()()() with the local server settings.
	Script() () () ()	Generates a Transact-SQL script that can be used to re-create the instance of SQL Server affinity settings as specified in the AffinityInfo object.
	Script(ScriptingOptions)	Generates a Transact-SQL script that can be used to re-create the instance of SQL Server affinity settings as specified in the AffinityInfo object.
	ToString	(繼承自 Object。)

上層

備註

To get AffinityInfo object properties, users can be a member of the public fixed server role.

To set any AffinityInfo object properties and run the Alter method, users must have ALTER permission on the database.

To create a AffinityInfo object, users must have ALTER ANY APPLICATION role permission on the parent database.

To drop an AffinityInfo object, users must be the owner of the application role or have ALTER ANY APPLICATION role permission on the parent database.

To grant, deny, and revoke permission on the AffinityInfo object, users must have CONTROL permission on the application role.

範例

This example shows you how to set all of the CPU’s on an instance of SQL Server to hard affinity.

C#

using System;
using Microsoft.SqlServer.Management.Smo;

namespace samples
{
    class Program
    {
        static void Main(string[] args)
        {
            Server dbServer = new Server("(local)");
            dbServer.AffinityInfo.AffinityType = AffinityType.Manual;

            foreach (Cpu cpu in dbServer.AffinityInfo.Cpus)
                cpu.AffinityMask = true;

            dbServer.AffinityInfo.Alter();
        }
    }
}

Powershell

//Create the server. 
$dbServer = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")

//Set the Affinity Type
$dbServer.AffinityInfo.AffinityType = [Microsoft.SqlServer.Management.Smo.AffinityType]'Manual'

//Set each CPU to Hard affinity and update
foreach ($cpu In $dbServer.AffinityInfo.Cpus)
{
   $cpu.AffinityMask = $True
   $dbServer.AffinityInfo.Alter() 
}

執行緒安全性

這個型別的任何公用 static (在 Visual Basic 中為 Shared) 成員都是執行緒安全的。並不是所有的執行個體成員都保證可以用於所有的執行緒。

請參閱

參考

Microsoft.SqlServer.Management.Smo 命名空間

其他資源

Best Practices for Greater than 64 CPU Installations

ALTER SERVER CONFIGURATION SET PROCESS AFFINITY (Transact-SQL)