SQL Server のインスタンスに接続する
適用対象:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics
SQL Server 管理オブジェクト (SMO) アプリケーションの最初のプログラミング手順は、オブジェクトのインスタンスを Server 作成し、Microsoft SQL Server のインスタンスへの接続を確立することです。
オブジェクトのインスタンスを Server 作成し、3 つの方法で SQL Server のインスタンスへの接続を確立できます。 1 つは、ServerConnection オブジェクト変数を使用して接続情報を提供する方法です。 2 つ目は、Server オブジェクト プロパティを明示的に設定することで接続情報を提供する方法です。 3 つ目は、オブジェクト コンストラクターで SQL Server インスタンスの名前を Server 渡すことです。
ServerConnection オブジェクトの使用
ServerConnection オブジェクト変数を使用することの利点は、接続情報を再利用できることです。 まず、Server オブジェクト変数を宣言します。 次に、オブジェクトを ServerConnection 宣言し、SQL Server のインスタンスの名前や認証モードなどの接続情報を使用してプロパティを設定します。 そして、パラメーターとして ServerConnection オブジェクト変数を Server オブジェクト コンストラクターに渡します。 異なるサーバー オブジェクト間で同時に接続を共有することはお勧めしません。 Copy メソッドを使用して、既存の接続設定のコピーを取得してください。
サーバー オブジェクトのプロパティを明示的に設定する
別の方法として、Server オブジェクト変数を宣言して、既定のコンストラクターを呼び出すこともできます。 オブジェクトは、 Server すべての既定の接続設定を使用して、SQL Server の既定のインスタンスへの接続を試みます。
サーバー オブジェクト コンストラクターで SQL Server インスタンス名を指定する
オブジェクト変数を Server 宣言し、SQL Server インスタンス名をコンストラクターの文字列パラメーターとして渡します。 オブジェクトは Server 、既定の接続設定を使用して SQL Server のインスタンスとの接続を確立します。
接続のプール
オブジェクトの Connect メソッドの呼び出し ServerConnection は不要です。 操作が完了すると、SMO は必要に応じて接続を自動的に確立し、接続プールに戻します。 メソッドを Connect 呼び出した場合、接続はプールに解放されません。 これを実現するには、メソッドを明示的に使用する Disconnect 必要があります。 さらに、オブジェクトのプロパティを調整 NonPooledConnection することで、プールされていない接続を ServerConnection 取得できます。
マルチスレッド アプリケーション
マルチスレッド化されたアプリケーションの場合、各スレッドで別々の ServerConnection オブジェクトを使用します。
SQL Server for RMO のインスタンスに接続する
レプリケーション管理オブジェクト (RMO) では、レプリケーション サーバーへの接続には、SMO とは少し異なる方法を使用します。
RMO プログラミング オブジェクトでは、Microsoft.SqlServer.Management.Common 名前空間によって実装されたオブジェクトをServerConnection使用して、SQL Server のインスタンスへの接続が確立されている必要があります。 サーバーへのこの接続は、RMO プログラミング オブジェクトからは独立して行われます。 その後、インスタンスの作成時またはオブジェクトのプロパティへの割り当てによって RMO オブジェクトに ConnectionContext 渡されます。 この方法では、RMO プログラミング オブジェクトおよび接続オブジェクト インスタンスを別々に作成および管理することが可能となり、単一の接続オブジェクトを複数の RMO プログラミング オブジェクトと共に再利用することができます。 レプリケーション サーバーへの接続には、次の規則が適用されます。
接続のプロパティはすべて、ServerConnection オブジェクトに対して定義します。
SQL Server のインスタンスへの各接続には、独自 ServerConnection のオブジェクトが必要です。
接続を確立し、サーバーに正常にサインインするためのすべての認証情報がオブジェクトに ServerConnection 提供されます。
既定では、接続は Microsoft Windows 認証を使用して作成します。 SQL Server 認証を使用するには、False に設定しLoginPassword、LoginSecure有効な SQL Server サインインとパスワードに設定する必要があります。 セキュリティの資格情報は、常に安全に格納および処理し、いつでも可能であれば実行時に提供する必要があります。
Connect メソッドは、RMO プログラミング オブジェクトに接続を渡す前に呼び出す必要があります。
例
提供されているコード例を使用するには、プログラミング環境、プログラミング テンプレート、およびアプリケーションを作成するプログラミング言語を選択する必要があります。 詳細については、「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 オブジェクト変数を宣言する方法を示します。この方法では、接続情報の再利用が可能になります。
この例は、サインインとパスワードを含むリモートおよび vPassword に接続する方法を示す Visual Basic .NET コードです。
' 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 オブジェクト変数を宣言する方法を示します。この方法では、接続情報の再利用が可能になります。
この例は、サインインとパスワードを含むリモートおよび vPassword に接続する方法を示す Visual C# .NET コードです。
// 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
}
}
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示