Lingua

Enumerazione di istanze di SQL Server (ADO.NET)

SQL Server consente alle applicazioni di trovare istanze di SQL Server all'interno della rete corrente. La SqlDataSourceEnumerator classe restituisce i server visibili nell'oggetto DataTable . Nella tabella sono elencate le istanze del server disponibili nella rete, ad esempio l'elenco dei server nella finestra di dialogo Proprietà connessione . I risultati non sono sempre completi.

Con Microsoft.Data.SqlClient, GetDataSources richiede Windows con rete nativa. In Linux, macOS o Windows con rete gestita abilitata, il metodo genera NotImplementedException. In questi ambienti specificare l'indirizzo del server e la porta direttamente nella stringa di connessione invece del rilevamento del server.

Annotazioni

Come per la maggior parte dei servizi Windows, è consigliabile eseguire il servizio SQL Browser con i privilegi minimi possibili.

Recupero di un'istanza dell'enumeratore

Per recuperare informazioni sulle istanze di SQL Server disponibili, recuperare innanzitutto un enumeratore con la proprietà condivisa/staticaInstance:

Dim instance As Microsoft.Data.Sql.SqlDataSourceEnumerator = _
   Microsoft.Data.Sql.SqlDataSourceEnumerator.Instance
Microsoft.Data.Sql.SqlDataSourceEnumerator instance =
   Microsoft.Data.Sql.SqlDataSourceEnumerator.Instance;

Dopo aver recuperato l'istanza statica, chiamare GetDataSources per recuperare informazioni sui server disponibili nell'oggetto DataTable :

Dim dataTable As System.Data.DataTable = instance.GetDataSources()
System.Data.DataTable dataTable = instance.GetDataSources();

La tabella restituita dalla chiamata al metodo contiene le colonne seguenti, tutte contenenti string valori:

colonna Descrizione
ServerName Nome del server.
InstanceName Nome dell'istanza del server. Vuoto se il server è in esecuzione come istanza predefinita.
IsClustered Indica se il server fa parte di un cluster.
Version Versione del server. Per esempio:

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

Limitazioni dell'enumerazione

Tutti i server disponibili possono essere elencati o meno. L'elenco può variare a seconda di fattori quali timeout e traffico di rete. In questo modo l'elenco può essere diverso in due chiamate consecutive. Verranno elencati solo i server nella stessa rete. I pacchetti di trasmissione in genere non attraversano i router, motivo per cui potrebbe non essere visualizzato un server elencato, ma sarà stabile tra le chiamate.

I server elencati possono avere o meno informazioni aggiuntive, ad IsClustered esempio e versione. Questo dipende dal modo in cui è stato ottenuto l'elenco. I server elencati tramite il servizio browser DI SQL Server avranno maggiori dettagli rispetto a quelli trovati tramite l'infrastruttura di Windows, che elenca solo il nome.

Annotazioni

Il moderno .NET non supporta Code Access Security o l'esecuzione a attendibilità parziale. Per l'individuazione del server, consentire il traffico di rete SQL Server Browser necessario.

SQL Server fornisce informazioni per il SqlDataSourceEnumerator tramite il servizio Windows esterno SQL Browser. Questo servizio è abilitato per impostazione predefinita, ma gli amministratori potrebbero disattivarlo o disabilitarlo, rendendo l'istanza del server invisibile a questa classe.

Esempio

L'applicazione console seguente recupera informazioni sulle istanze visibili SQL Server e visualizza le informazioni nella finestra della console. Installare il pacchetto NuGet Microsoft.Data.SqlClient.

Imports Microsoft.Data.Sql
Imports System.Data

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 Microsoft.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("============================");
    }
  }
}

Vedere anche