SMO: sprawdzanie dostępnych serwerów MS SQL i automatyczna konstrukcja ConnectionString [PL]

Jakiś czas temu, we wpisie związanym z SQLServer Management Objects (SMO), pod tytułem: „SMO i sprawdzanie, czy baza danych istnieje [PL]” otrzymałem komentarz, że warto wspomnieć o jeszcze innych możliwościach SMO, jak choćby listowanie instancji SQL Server: SmoApplication.EnumAvailableSqlServers(). W tym wpisie chciałbym właśnie wrócić do tego tematu.

Otóż tak jak zostało to wspomniane statyczna funkcja SmoApplication.EnumAvailableSqlServers() potrafi dostarczyć listę instancji serwera Ms SQL. Można tę funkcję wywoływać z parametrem typu Boolean, wtedy przekazując „prawda” ograniczymy otrzymaną listę tylko do lokalnych instancji. Można również wywołać tą funkcję z parametrem typu String, w którym przekazujemy nazwę serwera, z którego listą instancji jesteśmy zainteresowani.

Funkcja SmoApplication.EnumAvailableSqlServers() zwraca tabelę (typu DataTable, charakterystyczną dla DataSet'ów). Tabela jest następującej postaci:

Kolumna	Typ danych	Opis
Name	String	Nazwa instancji serwera SQL.
Server	String	Nazwa serwera, na której zainstalowana jest instancja serwera SQL.
Instance	String	Instancja SQL Server.
IsClustered	Boolean	Prawda – jeśli instancja uczestniczy w klastrze niezawodnościowym.
Version	String	Wersja instancji.
IsLocal	Boolean	Prawda – jeśli instancja jest lokalna, fałsz, gdy zdalna.

Otrzymane z takiej tabeli dane można wykorzystać przy tworzeniu aplikacji, w której użytkownik musi np. wybrać serwer, z którym chce nawiązać połączenie, lub np. w aplikacji, która ma dostarczać użytkownikowi „ConnectionString” do bazy danych typu Ms SQL.

Właśnie na możliwość automatycznego generowania ConnectionString'a chciałbym tutaj zwrócić uwagę. Można bowiem do tego wykorzystać obiekt klasy ServerConnection, w którym ustawiamy nazwę instancji bazy danych, użytkownika (właściwości: Login, Password lub dla impersonalizacji: ConnectAsUser, ConnectAsUserName, ConnectAsUserPassword), bazę danych (właściwość DatabaseName, np. uzyskaną na podstawie Microsoft.SqlServer.Management.Smo.Server.Databases). Ostatecznie do odczytania stworzonego ConnectionString'a wykorzystujemy właściwość ConnectionString klasy ServerConnection.

Dla przykładu zobaczmy kod, który odczytuje wszystkie dostępne instancje. Wyświetla informacje na temat każdej instancji oraz ConnectionString'i do każdej dostępnej bazy danych:

      DataTable serversDataTable = SmoApplication.EnumAvailableSqlServers(false);
      foreach ( DataRow row in serversDataTable.Rows )
      {
        Console.WriteLine( "Server:" );
        foreach ( DataColumn dc in row.Table.Columns )
        {
          Console.WriteLine( "{0}={1}", dc.ColumnName, row[dc.ColumnName] );

        }
        Console.WriteLine( "Databases ConnectionStrings:" );
        ServerConnection serverConnection = new ServerConnection(); //main connection to MS SQLServer
        serverConnection.ServerInstance = (string)row[ "Name" ];
        serverConnection.ConnectAsUser = false;//we are using windows currently logged-in user
        ServerConnection serverConnection2 = new ServerConnection();//additional connection to each DataBase
        serverConnection2.ServerInstance = (string)row[ "Name" ];
        serverConnection2.ConnectAsUser = false;
        foreach ( Database db in new Server( serverConnection ).Databases )
        {
          serverConnection2.DatabaseName = db.Name;
          Console.WriteLine( "ConnectionString={0}", serverConnection2.ConnectionString );
        }
        Console.WriteLine( "-----------------------------" );
      }

Efekt jego uruchomienia może wyglądać następująco: