Перечисление экземпляров SQL Server (ADO.NET)
SQL Server позволяет выполнять в приложениях поиск экземпляров SQL Server в используемой сети. Класс SqlDataSourceEnumerator предоставляет эти сведения разработчику приложения, предоставляя DataTable, содержащий сведения обо всех видимых серверах. Эта возвращенная таблица содержит список экземпляров серверов, доступных в сети, который совпадает со списком, предоставляемым при попытке пользователя создать новое соединение, и дополняет раскрывающийся список, содержащий все доступные серверы, в диалоговом окне Свойства соединения. Отображаемые результаты не всегда завершенные.
Примечание.
Как и в большинстве служб Windows, службу обозревателя SQL рекомендуется запускать с минимальными возможными привилегиями.
Получение экземпляра перечислителя
Чтобы получить таблицу с данными о доступных экземплярах SQL Server, вначале необходимо получить перечислитель с помощью общего и (или) статического свойства Instance:
Dim instance As System.Data.Sql.SqlDataSourceEnumerator = _
System.Data.Sql.SqlDataSourceEnumerator.Instance
System.Data.Sql.SqlDataSourceEnumerator instance =
System.Data.Sql.SqlDataSourceEnumerator.Instance
После получения статического экземпляра можно вызвать метод GetDataSources, который возвращает DataTable, содержащий сведения о доступных серверах.
Dim dataTable As System.Data.DataTable = instance.GetDataSources()
System.Data.DataTable dataTable = instance.GetDataSources();
Таблица, возвращенная из вызова метода, содержит следующие столбцы, которые содержат значения string:
| Столбец | Description |
|---|---|
| ServerName | Имя сервера. |
| InstanceName | Имя экземпляра сервера. Если сервер работает как экземпляр по умолчанию, то поле остается пустым. |
| IsClustered | Указывает, является ли сервер частью кластера. |
| Версия | Версия сервера. Например: - 9.00.x (SQL Server 2005) - 10.0.xx (SQL Server 2008) - 10.50.x (SQL Server 2008 R2) - 11.0.xx (SQL Server 2012) |
Ограничения перечисления
Все доступные серверы могут быть или не быть перечислены. Список может различаться в зависимости от таких факторов, как время ожидания и сетевой трафик. Это может привести к тому, что список будет отличаться для двух последовательных вызовов. Будут перечислены только серверы в одной сети. Широковещательные пакеты обычно не проходят через маршрутизаторы, поэтому сервер может не отображаться в списке, но он будет стабильным во всех вызовах.
Перечисленные серверы могут содержать дополнительные сведения, такие как IsClustered и версия. Это зависит от того, каким способом был получен список. В списках серверов, полученных с помощью службы браузера SQL Server, присутствует больше сведений, чем в списках серверов, найденных с помощью инфраструктуры Windows и содержащих только имена.
Примечание.
Перечисление серверов доступно только при выполнении в режиме полного доверия. Сборки, работающие в среде с частичным доверием, не смогут использовать их, даже если у них есть разрешение на Управление доступом для кода (CAS) SqlClientPermission.
В SQL Server сведения для SqlDataSourceEnumerator предоставляются с использованием внешней службы Windows, называемой браузером SQL. Эта служба включена по умолчанию, но администраторы могут отключить ее, что делает этот экземпляр сервера невидимым для этого класса.
Пример
Следующее консольное приложение получает сведения обо всех видимых экземплярах SQL Server и отображает эти сведения в окне консоли.
Imports System.Data.Sql
Module Module1
Sub Main()
' Retrieve the enumerator instance and then the data.
Dim instance As SqlDataSourceEnumerator = _
SqlDataSourceEnumerator.Instance
Dim table As System.Data.DataTable = instance.GetDataSources()
' Display the contents of the table.
DisplayData(table)
Console.WriteLine("Press any key to continue.")
Console.ReadKey()
End Sub
Private Sub DisplayData(ByVal table As DataTable)
For Each row As DataRow In table.Rows
For Each col As DataColumn In table.Columns
Console.WriteLine("{0} = {1}", col.ColumnName, row(col))
Next
Console.WriteLine("============================")
Next
End Sub
End Module
using System.Data.Sql;
class Program
{
static void Main()
{
// Retrieve the enumerator instance and then the data.
SqlDataSourceEnumerator instance =
SqlDataSourceEnumerator.Instance;
System.Data.DataTable table = instance.GetDataSources();
// Display the contents of the table.
DisplayData(table);
Console.WriteLine("Press any key to continue.");
Console.ReadKey();
}
private static void DisplayData(System.Data.DataTable table)
{
foreach (System.Data.DataRow row in table.Rows)
{
foreach (System.Data.DataColumn col in table.Columns)
{
Console.WriteLine("{0} = {1}", col.ColumnName, row[col]);
}
Console.WriteLine("============================");
}
}
}