SQLBrowseConnect では、3 つのレベルの接続情報に分類できるキーワードを使用します。 次の表は、各キーワードについて、有効な値のリストが返されるかどうか、およびキーワードが省略可能かどうかを示します。
レベル 1
| キーワード | 一覧が返されましたか? | 省略できるかどうか | 説明 |
|---|---|---|---|
| DSN | なし | いいえ | SQLDataSources によって返されるデータ ソースの名前。 DRIVER キーワードが使用されている場合は、DSN キーワードを使用できません。 |
| 運転手 | なし | いいえ | Microsoft?? SQL Server Native Client ODBC ドライバー名は {SQL Server Native Client 11} です。 DSN キーワードが使用されている場合は、DRIVER キーワードを使用できません。 |
レベル 2
| キーワード | 一覧が返されましたか? | 省略できるかどうか | 説明 |
|---|---|---|---|
| サーバー | イエス | いいえ | データ ソースが存在するネットワーク上のサーバーの名前。 "(local)" という用語はサーバーとして入力できます。この場合、ネットワークに接続されていないバージョンの場合でも、SQL Server のローカル コピーを使用できます。 |
| UID | いいえ | イエス | ユーザー ログイン ID。 |
| PWD | いいえ | はい (ユーザーによって異なります) | ユーザー指定のパスワード。 |
| アプリ | いいえ | イエス | SQLBrowseConnect を呼び出すアプリケーションの名前。 |
| WSID | いいえ | イエス | ワークステーション ID。 通常、これはアプリケーションが実行されているコンピューターのネットワーク名です。 |
レベル 3
| キーワード | 一覧が返されましたか? | 省略できるかどうか | 説明 |
|---|---|---|---|
| データベース | イエス | イエス | SQL Server データベースの名前。 |
| 言語 | イエス | イエス | SQL Server で使用される各国語。 |
SQLBrowseConnect は、ODBC データ ソース定義に格納されている DATABASE キーワードと LANGUAGE キーワードの値を無視します。 SQLBrowseConnect に渡される接続文字列で指定されたデータベースまたは言語が無効な場合、SQLBrowseConnect はSQL_NEED_DATAとレベル 3 の接続属性を返します。
次の属性は、 SQLSetConnectAttr を呼び出すことによって設定され、 SQLBrowseConnect によって返される結果セットを決定します。
| 特性 | 説明 |
|---|---|
| SQL_COPT_SS_BROWSE_CONNECT | SQL_MORE_INFO_YESに設定されている場合、 SQLBrowseConnect はサーバー プロパティの拡張文字列を返します。 SQLBrowseConnect:ServerName\InstanceName によって返される拡張文字列の例を次に示します。Clustered:No;バージョン:8.00.131 この文字列では、サーバーに関するさまざまな情報をセミコロンで区切ります。 異なるサーバー インスタンスを区切るには、コンマを使用します。 |
| SQL_COPT_SS_BROWSE_SERVER | サーバー名が指定されている場合、 SQLBrowseConnect は指定されたサーバーの情報を返します。 SQL_COPT_SS_BROWSE_SERVERが NULL に設定されている場合、 SQLBrowseConnect はドメイン内のすべてのサーバーの情報を返します。 ネットワークの問題により、 SQLBrowseConnect はすべてのサーバーからタイムリーな応答を受け取らない可能性があります。 そのため、返されるサーバーの一覧は、要求ごとに異なる場合があります。 |
| SQL_COPT_SS_BROWSE_CACHE_DATA | SQL_COPT_SS_BROWSE_CACHE_DATA属性が SQL_CACHE_DATA_YES に設定されている場合、バッファーの長さが結果を保持するのに十分な大きさでない場合は、チャンク単位でデータをフェッチできます。 この長さは、SQLBrowseConnect の BufferLength 引数で指定されます。 SQL_NEED_DATAは、より多くのデータが使用可能な場合に返されます。 SQL_SUCCESSは、取得するデータがそれ以上ない場合に返されます。 既定値は SQL_CACHE_DATA_NO です。 |
高可用性、ディザスター リカバリーのための SQLBrowseConnect のサポート
SQLBrowseConnect を使用して Always On 可用性グループ クラスターに接続する方法の詳細については、「高可用性、ディザスター リカバリーのための SQL Server Native Client Support」を参照してください。
SQLBrowseConnect でのサービス プリンシパル名 (SPN) のサポート
接続が開かれると、SQL Server Native Client はSQL_COPT_SS_MUTUALLY_AUTHENTICATEDを設定し、接続を開くために使用される認証方法にSQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHODします。
SPN の詳細については、「クライアント接続 (ODBC)の「Service Principal Names (SPN)」を参照してください。
変更履歴
| 変更内容 |
|---|
| 文書化されたSQL_COPT_SS_BROWSE_CACHE_DATA。 |