SQLBrowseConnect

適用対象: はいSQL Server (サポートされているすべてのバージョン) はいAzure SQL データベース はいAzure SQL Managed Instance はいAzure Synapse Analytics はいParallel Data Warehouse

SQLBrowseConnect は、3つのレベルの接続情報に分類できるキーワードを使用します。 次の表では、キーワードごとに、有効な値の一覧が返されるかどうか、およびそのキーワードが省略可能であるかどうかを示します。

[レベル 1]

キーワード 一覧が返されるかどうか 省略できるかどうか 説明
DSN (DSN) 該当なし いいえ Sqldatasources ソースによって返されるデータソースの名前。 DSN キーワードは、DRIVER キーワードと同時に使用できません。
DRIVER 該当なし いいえ Microsoft® SQL Server Native CLIENT ODBC ドライバー名は { SQL Server native client 11} です。 DRIVER キーワードは、DSN キーワードと同時に使用できません。

[レベル 2]

キーワード 一覧が返されるかどうか 省略できるかどうか 説明
SERVER はい いいえ データ ソースがあるネットワーク上のサーバー名。 サーバー名には「(local)」と入力することもできます。これは、ネットワークに接続されていない SQL Server のローカル コピーも使用できることを意味します。
UID いいえ はい ユーザー ログイン ID。
PWD いいえ はい (ユーザーによって異なります) ユーザーが指定したパスワード。
APP いいえ はい SQLBrowseConnect を呼び出すアプリケーションの名前。
WSID いいえ はい ワークステーション ID。 通常は、アプリケーションが実行されているコンピューターのネットワーク名です。

レベル 3

キーワード 一覧が返されるかどうか 省略できるかどうか 説明
DATABASE はい はい データベースの名前 SQL Server 。
LANGUAGE はい はい SQL Server で使用される言語。

SQLBrowseConnect は、ODBC データソースの定義に格納されているデータベースと言語キーワードの値を無視します。 SQLBrowseConnect に渡された接続文字列で指定されたデータベースまたは言語が無効である場合、 SQLBrowseConnect は SQL_NEED_DATA とレベル3の接続属性を返します。

SQLSetConnectAttrを呼び出すことによって設定される次の属性は、 SQLBrowseConnect によって返される結果セットを決定します。

属性 説明
SQL_COPT_SS_BROWSE_CONNECT SQL_MORE_INFO_YES に設定されている場合、 SQLBrowseConnect はサーバープロパティの拡張文字列を返します。

SQLBrowseConnect によって返される拡張文字列の例を次に示します。



ServerName\InstanceName;Clustered:No;Version: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 の HADR サポート

SQLBrowseConnect を使用してクラスターに接続する方法の詳細については、 Always On 可用性グループ 「高可用性、ディザスターリカバリーのサポートの SQL Server Native Client」を参照してください。

SQLBrowseConnect によるサービス プリンシパル名 (SPN) のサポート

接続が開いている場合、SQL Server Native Client では、SQL_COPT_SS_MUTUALLY_AUTHENTICATED および SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD が、接続を開くときに使用された認証方式に設定されます。

Spn の詳細については、「 クライアント接続 (ODBC)のサービスプリンシパル名 (spn) 」を参照してください。

変更履歴

変更内容
SQL_COPT_SS_BROWSE_CACHE_DATA に関する記述を追加しました。

参照

SQLBrowseConnect 関数
ODBC API 実装の詳細