Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
platí pro:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytický platformní systém (PDW)
SQLBrowseConnect používá klíčová slova, která lze kategorizovat do tří úrovní informací o připojení. Pro každé klíčové slovo následující tabulka uvádí, zda je vrácen seznam platných hodnot a zda je klíčové slovo volitelné.
Úroveň 1
| Keyword | Seznam vrácen? | Optional? | Description |
|---|---|---|---|
| DSN | N/A | No | Název zdroje dat vrácený pomocí SQLDataSources. Klíčové slovo DSN nelze použít, pokud je použito klíčové slovo DRIVER. |
| OVLADAČ | N/A | No | Název ovladače SQL Server Native Client ODBC je {SQL Server Native Client 11}. Klíčové slovo DRIVER nelze použít, pokud je použito klíčové slovo DSN. |
Úroveň 2
| Keyword | Seznam vrácen? | Optional? | Description |
|---|---|---|---|
| SERVER | Ano | No | Název serveru v síti, na kterém se nachází zdroj dat. Termín "(lokální)" lze zadat jako server, v takovém případě lze použít lokální kopii SQL Server, i když jde o nesíťovou verzi. |
| Jedinečný identifikátor (UID) | No | Ano | Uživatelské přihlašovací ID. |
| PWD | No | Ano (záleží na uživateli) | Uživatelské heslo. |
| Aplikace | No | Ano | Název aplikace volající SQLBrowseConnect. |
| WSID | No | Ano | ID pracovní stanice. Obvykle je to síťový název počítače, na kterém aplikace běží. |
Úroveň 3
| Keyword | Seznam vrácen? | Optional? | Description |
|---|---|---|---|
| DATABASE | Ano | Ano | Název databáze SQL Server. |
| LANGUAGE | Ano | Ano | Národní jazyk používaný SQL Server. |
SQLBrowseConnect ignoruje hodnoty a DATABASELANGUAGE klíčová slova uložená v definicích zdrojů dat ODBC. Pokud je databáze nebo jazyk specifikovaný v připojovací řetězec předaném SQLBrowseConnect neplatný, SQLBrowseConnect vrátí SQL_NEED_DATA a atributy připojení úrovně 3.
Následující atributy, které se nastavují voláním SQLSetConnectAttr, určují výslednou sadu vrácenou pomocí SQLBrowseConnect.
| Attribute | Description |
|---|---|
| SQL_COPT_SS_BROWSE_CONNECT | Pokud je nastavení na SQL_MORE_INFO_YES, SQLBrowseConnect vrátí rozšířený řetězec vlastností serveru. Následuje příklad rozšířeného řetězce vráceného pomocí SQLBrowseConnect: ServerName\InstanceName;Clustered:No;Version:8.00.131V tomto řetězci jsou středníky odděleny od různých informací o serveru. Používejte čárky k oddělení různých serverových instancí. |
| SQL_COPT_SS_BROWSE_SERVER | Pokud je zadáno jméno serveru, SQLBrowseConnect vrátí informace o daném serveru. Pokud je SQL_COPT_SS_BROWSE_SERVER nastaveno na NULL, SQLBrowseConnect vrátí informace pro všechny servery v domě. Všimněte si, že kvůli problémům se sítí nemusí SQLBrowseConnect dostat včasnou odpověď od všech serverů. Seznam vrácených serverů se proto může lišit pro každý požadavek. |
| SQL_COPT_SS_BROWSE_CACHE_DATA | Když je atribut SQL_COPT_SS_BROWSE_CACHE_DATA nastaven na SQL_CACHE_DATA_YES, můžete data načítat po částech, když délka bufferu není dostatečně velká pro uložení výsledku. Tato délka je specifikována v argumentu BufferLength pro SQLBrowseConnect. SQL_NEED_DATA se vrací, když je k dispozici více dat. SQL_SUCCESS se vrací, když už není potřeba žádná další data. Výchozí je SQL_CACHE_DATA_NO. |
Podpora SQLBrowseConnect pro vysokou dostupnost a obnovu po havárii
Pro více informací o použití SQLBrowseConnect k připojení ke skupinám Always On dostupnosti viz SQL Server Native Client Support for High Availability, Disaster Recovery.
Podpora SQLBrowseConnect pro názvy principálních služeb (SPN)
Když je spojení otevřeno, SQL Server nativní klient nastaví SQL_COPT_SS_MUTUALLY_AUTHENTICATED a SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD na autentizační metodu použitou k otevření spojení.
Pro více informací o SPN viz Názvy principálů služeb (SPN) v Client Connections (ODBC).
Historie změn
| Aktualizovaný obsah |
|---|
| Zdokumentováno SQL_COPT_SS_BROWSE_CACHE_DATA. |
Viz také
Funkce SQLBrowseConnect
Podrobnosti implementace rozhraní ODBC API