次の方法で共有

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

  • [アーティクル]

SQL Server管理オブジェクト (SMO) アプリケーションの最初のプログラミング手順は、オブジェクトのServerインスタンスを作成し、Microsoft SQL Server のインスタンスへの接続を確立することです。

オブジェクトのServerインスタンスを作成し、SQL Serverのインスタンスへの接続を確立するには、3 つの方法があります。 1 つは、ServerConnection オブジェクト変数を使用して接続情報を提供する方法です。 2 つ目は、Server オブジェクト プロパティを明示的に設定することで接続情報を提供する方法です。 3 つ目は、オブジェクト コンストラクターで SQL Server インスタンスの名前をServer渡すことです。

ServerConnection オブジェクトの使用

ServerConnection オブジェクト変数を使用することの利点は、接続情報を再利用できることです。 まず、Server オブジェクト変数を宣言します。 次に、オブジェクトをServerConnection宣言し、SQL Serverのインスタンスの名前や認証モードなどの接続情報を使用してプロパティを設定します。 そして、パラメーターとして ServerConnection オブジェクト変数を Server オブジェクト コンストラクターに渡します。 異なるサーバー オブジェクト間で同時に接続を共有することはお勧めできません。 Copy メソッドを使用して、既存の接続設定のコピーを取得してください。

サーバー オブジェクト プロパティの明示的な設定

別の方法として、Server オブジェクト変数を宣言して、既定のコンストラクターを呼び出すこともできます。 オブジェクトは、すべての既定のServer接続設定を使用して、SQL Serverの既定のインスタンスへの接続を試みます。

Server オブジェクト コンストラクターへの SQL Server インスタンス名の提供

オブジェクト変数をServer宣言し、SQL Serverインスタンス名をコンストラクターの文字列パラメーターとして渡します。 オブジェクトはServer、既定の接続設定で SQL Server のインスタンスとの接続を確立します。

接続のプール

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

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

マルチスレッド化されたアプリケーションの場合、各スレッドで別々の ServerConnection オブジェクトを使用します。

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

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

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

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

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

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

  • 既定では、接続は Microsoft Windows 認証を使用して作成します。 SQL Server認証を使用するには、 を False に設定しLoginPassword、LoginSecure有効な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 コードです。

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 には、リモート インスタンスの名前が含まれています。

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  
   }  
}

関連項目

Server
ServerConnection