SQLBrowseConnect

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)

SQLBrowse Connessione usa parole chiave che possono essere classificate in tre livelli di informazioni di connessione. Per ogni parola chiave nella tabella seguente è indicato se viene restituito un elenco di valori validi e se la parola chiave è facoltativa.

Livello 1

Parola chiave	Elenco restituito?	Facoltativa?	Descrizione
DSN	N/D	No	Nome dell'origine dati restituita da SQLDataSources. Se viene utilizzata la parola chiave DRIVER, non è possibile utilizzare la parola chiave DSN.
DRIVER	N/D	No	Il nome del driver ODBC di SQL Server Native Client è {SQL Server Native Client 11}. Se viene utilizzata la parola chiave DSN, non è possibile utilizzare la parola chiave DRIVER.

Livello 2

Parola chiave	Elenco restituito?	Facoltativa?	Descrizione
SERVER	Sì	No	Nome del server in rete nel quale risiede l'origine dati. Il termine "(local)" può essere immesso come server, nel qual caso è possibile usare una copia locale di SQL Server, anche quando si tratta di una versione non di rete.
UID	No	Sì	ID di accesso dell'utente.
PWD	No	Sì (dipende dall'utente)	Password specificata dall'utente.
APP	No	Sì	Nome dell'applicazione che chiama SQLBrowse Connessione.
WSID	No	Sì	ID della workstation. In genere, si tratta del nome di rete del computer sul quale viene eseguita l'applicazione.

Livello 3

Parola chiave	Elenco restituito?	Facoltativa?	Descrizione
DATABASE	Sì	Sì	Nome del database di SQL Server.
LANGUAGE	Sì	Sì	Linguaggio nazionale usato da SQL Server.

SQLBrowse Connessione ignora i valori delle parole chiave DATABA edizione Standard e LANGUAGE archiviate nelle definizioni dell'origine dati ODBC. Se il database o la lingua specificata nel stringa di connessione passato a SQLBrowse Connessione non è valido, SQLBrowse Connessione restituisce SQL_N edizione Enterprise D_DATA e gli attributi di connessione di livello 3.

Gli attributi seguenti, impostati chiamando SQLSet Connessione Attr, determinano il set di risultati restituito da SQLBrowse Connessione.

Attributo	Descrizione
SQL_COPT_SS_BROWSE_CONNECT	Se è impostato su SQL_MORE_INFO_YES, SQLBrowse Connessione restituisce una stringa estesa di proprietà del server. Di seguito è riportato un esempio di stringa estesa restituita da SQLBrowse Connessione: ServerName\InstanceName;Clustered:No;Version:8.00.131 In questa stringa i punti e virgola separano le diverse informazioni sul server. Le virgole separano le diverse istanze del server.
SQL_COPT_SS_BROWSE_SERVER	Se viene specificato un nome server, SQLBrowse Connessione restituirà informazioni per il server specificato. Se SQL_COPT_SS_BROW edizione Standard_edizione Standard RVER è impostato su NULL, SQLBrowse Connessione restituisce informazioni per tutti i server nel dominio. Si noti che a causa di problemi di rete, SQLBrowse Connessione potrebbe non ricevere una risposta tempestiva da tutti i server. L'elenco di server restituito può pertanto variare per ogni richiesta.
SQL_COPT_SS_BROWSE_CACHE_DATA	Quando l'attributo SQL_COPT_SS_BROWSE_CACHE_DATA è impostato su SQL_CACHE_DATA_YES, è possibile recuperare i dati in blocchi quando la lunghezza del buffer non è sufficiente per contenere il risultato. Questa lunghezza viene specificata nell'argomento BufferLength in SQLBrowse Connessione. Quando sono disponibili più dati, viene restituito SQL_NEED_DATA. Quando non vi sono più dati da recuperare, viene restituito SQL_SUCCESS. Il valore predefinito è SQL_CACHE_DATA_NO.

Supporto di SQLBrowseConnect per il ripristino di emergenza a disponibilità elevata

Per altre informazioni sull'uso di SQLBrowse Connessione per connettersi a un cluster di gruppi di disponibilità AlwaysOn, vedere Supporto di SQL Server Native Client per disponibilità elevata, ripristino di emergenza.

Supporto di SQLBrowseConnect per i nomi SPN (Service Principal Name)

Quando viene aperta una connessione, SQL Server Native Client imposta SQL_COPT_SS_MUTUALLY_AUTHENTICATED e SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD al metodo di autenticazione usato per aprire la connessione.

Per altre informazioni sui nomi SPN, vedere Service Principal Names (SPN) in Client Connessione ions (ODBC).For more information about SPN, see Service Principal Names (SPN) in Client Connessione ions (ODBC).

Cronologia delle modifiche

Contenuto aggiornato
Informazioni su SQL_COPT_SS_BROWSE_CACHE_DATA.

Vedi anche

Funzione SQLBrowseConnect
Dettagli di implementazione dell'API ODBC