SQL Server のインスタンスへの接続

接続のプール

通常、ServerConnection オブジェクトの Connect メソッドを呼び出す必要はありません。SMO は、必要な場合には自動的に接続を確立し、実行中の操作が完了した後で接続プールに接続を解放します。Connect メソッドが呼び出された場合、接続はプールに解放されません。接続をプールに解放するには、Disconnect メソッドへの明示的な呼び出しが必要です。また、ServerConnection オブジェクトの NonPooledConnection プロパティを設定することによって、プールされていない接続を要求することもできます。

マルチスレッド アプリケーション

マルチスレッド アプリケーションの場合、各スレッドで別々の ServerConnection オブジェクトを使用する必要があります。

RMO の SQL Server のインスタンスへの接続

レプリケーション管理オブジェクト (RMO) では、レプリケーション サーバーへの接続には、SMO とは少し異なる方法を使用します。

RMO プログラミング オブジェクトでは、SQL Server のインスタンスへの接続は、Microsoft.SqlServer.Management.Common 名前空間によって実装された ServerConnection オブジェクトを使用して行われる必要があります。サーバーへのこの接続は、RMO プログラミング オブジェクトからは独立して行われます。そして、インスタンスの作成時、またはオブジェクトの ConnectionContext プロパティへの割り当てによって、RMO オブジェクトに渡されます。この方法では、RMO プログラミング オブジェクトおよび接続オブジェクト インスタンスを別々に作成および管理することが可能となり、単一の接続オブジェクトを複数の RMO プログラミング オブジェクトと共に再利用することができます。レプリケーション サーバーへの接続には次のルールが適用されます。

• 接続のプロパティはすべて、ServerConnection オブジェクトに対して定義します。

• SQL Server のインスタンスへの各接続には、独自の ServerConnection オブジェクトが必要です。

• 接続を作成してサーバーに正常にログオンするための認証情報はすべて、ServerConnection オブジェクトで提供します。

• 既定では、接続は Microsoft Windows 認証を使用して作成します。SQL Server 認証を使用するには、LoginSecure を False に設定し、Login および Password に、有効な SQL Server ログオンおよびパスワードを設定しておく必要があります。セキュリティの資格情報は、常に安全に格納および処理し、いつでも可能であれば実行時に提供する必要があります。

• Connect メソッドは、RMO プログラミング オブジェクトに接続を渡す前に呼び出す必要があります。

例

提供されているコード例を使用するには、アプリケーションを作成するプログラミング環境、プログラミング テンプレート、およびプログラミング言語を選択する必要があります。詳細については、SQL Server オンライン ブックの「Visual Studio .NET で Visual Basic SMO プロジェクトを作成する方法」および「Visual Studio .NET で Visual C# SMO プロジェクトを作成する方法」を参照してください。

Visual Basic で Windows 認証を使用して SQL Server のローカル インスタンスに接続する

SQL Server のローカル インスタンスへの接続に必要なコードは多くありません。ただし、認証方法とサーバーの既定の設定によってコードが異なります。接続は、データの取得を必要とする操作が初めて発生する際に作成します。

この例は、Windows 認証を使用して SQL Server のローカル インスタンスに接続する Visual Basic .NET コードです。

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'The connection is established when a property is requested.
Console.WriteLine(srv.Information.Version)
'The connection is automatically disconnected when the Server variable goes out of scope.

Visual C# で Windows 認証を使用して SQL Server のローカル インスタンスに接続する

SQL Server のローカル インスタンスへの接続に必要なコードは多くありません。ただし、認証方法とサーバーの既定の設定によってコードが異なります。接続は、データの取得を必要とする操作が初めて発生する際に作成します。

この例は、Windows 認証を使用して SQL Server のローカル インスタンスに接続する Visual C# .NET コードです。

{ 
//Connect to the local, default instance of SQL Server. 
Server srv; 
srv = new Server(); 
//The connection is established when a property is requested. 
Console.WriteLine(srv.Information.Version); 
} 
//The connection is automatically disconnected when the Server variable goes out of scope.

Visual Basic で Windows 認証を使用して SQL Server のリモート インスタンスに接続する

Windows 認証を使用して SQL Server のインスタンスに接続する場合、認証の種類を指定する必要はありません。Windows 認証が既定です。

この例は、Windows 認証を使用して SQL Server のリモート インスタンスに接続する Visual Basic .NET コードです。文字列変数の strServer にはリモート インスタンスの名前が含まれています。

'Connect to a remote instance of SQL Server.
Dim srv As Server
'The strServer string variable contains the name of a remote instance of SQL Server.
srv = New Server(strServer)
'The actual connection is made when a property is retrieved. 
Console.WriteLine(srv.Information.Version)
'The connection is automatically disconnected when the Server variable goes out of scope.

Visual C# で Windows 認証を使用して SQL Server のリモート インスタンスに接続する

Windows 認証を使用して SQL Server のインスタンスに接続する場合、認証の種類を指定する必要はありません。既定は Windows 認証です。

この例は、Windows 認証を使用して SQL Server のリモート インスタンスに接続する Visual C# .NET コードです。文字列変数の strServer にはリモート インスタンスの名前が含まれています。

{ 
//Connect to a remote instance of SQL Server. 
Server srv; 
//The strServer string variable contains the name of a remote instance of SQL Server. 
srv = new Server(strServer); 
//The actual connection is made when a property is retrieved. 
Console.WriteLine(srv.Information.Version); 
} 
//The connection is automatically disconnected when the Server variable goes out of scope.

Visual Basic で SQL Server 認証を使用して SQL Server のインスタンスに接続する

SQL Server 認証を使用して SQL Server のインスタンスに接続する場合、認証の種類を指定する必要があります。この例では、もう 1 つの方法として、ServerConnection オブジェクト変数を宣言する方法を示します。この方法では、接続情報の再利用が可能になります。

この例は、リモート インスタンスに接続する方法を示す Visual Basic .NET コードです。vPassword にはログインとパスワードが含まれています。

' compile with: 
' /r:Microsoft.SqlServer.Smo.dll
' /r:Microsoft.SqlServer.ConnectionInfo.dll
' /r:Microsoft.SqlServer.Management.Sdk.Sfc.dll 

Imports Microsoft.SqlServer.Management.Smo
Imports Microsoft.SqlServer.Management.Common

Public Class A
   Public Shared Sub Main()
      Dim sqlServerLogin As [String] = "user_id"
      Dim password As [String] = "pwd"
      Dim instanceName As [String] = "instance_name"
      Dim remoteSvrName As [String] = "remote_server_name"


      ' Connecting to an instance of SQL Server using SQL Server Authentication
      Dim srv1 As New Server()   ' connects to default instance
      srv1.ConnectionContext.LoginSecure = False   ' set to true for Windows Authentication
      srv1.ConnectionContext.Login = sqlServerLogin
      srv1.ConnectionContext.Password = password
      Console.WriteLine(srv1.Information.Version)   ' connection is established

      ' Connecting to a named instance of SQL Server with SQL Server Authentication using ServerConnection
      Dim srvConn As New ServerConnection()
      srvConn.ServerInstance = ".\" & instanceName   ' connects to named instance
      srvConn.LoginSecure = False   ' set to true for Windows Authentication
      srvConn.Login = sqlServerLogin
      srvConn.Password = password
      Dim srv2 As New Server(srvConn)
      Console.WriteLine(srv2.Information.Version)   ' connection is established

      ' For remote connection, remote server name / ServerInstance needs to be specified
      Dim srvConn2 As New ServerConnection(remoteSvrName)
      srvConn2.LoginSecure = False
      srvConn2.Login = sqlServerLogin
      srvConn2.Password = password
      Dim srv3 As New Server(srvConn2)
      Console.WriteLine(srv3.Information.Version)   ' connection is established
   End Sub
End Class

Visual C# で SQL Server 認証を使用して SQL Server のインスタンスに接続する

SQL Server 認証を使用して SQL Server のインスタンスに接続する場合、認証の種類を指定する必要があります。この例では、もう 1 つの方法として、ServerConnection オブジェクト変数を宣言する方法を示します。この方法では、接続情報の再利用が可能になります。

この例は、リモート インスタンスに接続する方法を示す Visual C# .NET コードです。vPassword にはログインとパスワードが含まれています。

// compile with: 
// /r:Microsoft.SqlServer.Smo.dll
// /r:Microsoft.SqlServer.ConnectionInfo.dll
// /r:Microsoft.SqlServer.Management.Sdk.Sfc.dll 

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

public class A {
   public static void Main() { 
      String sqlServerLogin = "user_id";
      String password = "pwd";
      String instanceName = "instance_name";
      String remoteSvrName = "remote_server_name";

      // Connecting to an instance of SQL Server using SQL Server Authentication
      Server srv1 = new Server();   // connects to default instance
      srv1.ConnectionContext.LoginSecure = false;   // set to true for Windows Authentication
      srv1.ConnectionContext.Login = sqlServerLogin;
      srv1.ConnectionContext.Password = password;
      Console.WriteLine(srv1.Information.Version);   // connection is established

      // Connecting to a named instance of SQL Server with SQL Server Authentication using ServerConnection
      ServerConnection srvConn = new ServerConnection();
      srvConn.ServerInstance = @".\" + instanceName;   // connects to named instance
      srvConn.LoginSecure = false;   // set to true for Windows Authentication
      srvConn.Login = sqlServerLogin;
      srvConn.Password = password;
      Server srv2 = new Server(srvConn);
      Console.WriteLine(srv2.Information.Version);   // connection is established


      // For remote connection, remote server name / ServerInstance needs to be specified
      ServerConnection srvConn2 = new ServerConnection(remoteSvrName);
      srvConn2.LoginSecure = false;
      srvConn2.Login = sqlServerLogin;
      srvConn2.Password = password;
      Server srv3 = new Server(srvConn2);
      Console.WriteLine(srv3.Information.Version);   // connection is established
   }
}

関連項目

参照