ODBC を使って Azure Data Explorer に接続する

  • [アーティクル]

Open Database Connectivity (ODBC) は、データベース アクセスのために広く受け入れられているアプリケーション プログラミング インターフェイス (API) です。 Azure Data Explorerは、SQL Server通信プロトコル (MS-TDS) のサブセットと互換性があります。 この互換性により、Azure Data Explorer で odbc ドライバーを使用してSQL Serverできます。

そのため、SQL Server用 ODBC ドライバーのサポートを備えた任意のアプリケーションから Azure Data Explorer への接続を確立できます。

ODBC 接続を作成する方法については、次のビデオをご覧ください。

または、手順に従って ODBC データ ソースを構成します。

注意

可能な限り、Azure Data Explorer専用コネクタを使用することをお勧めします。 使用可能なコネクタの一覧については、「 コネクタの概要」を参照してください。

前提条件

ODBC データ ソースを構成する

SQL Server用 ODBC ドライバーを使用して ODBC データ ソースを構成するには:

  1. Windows で、ODBC データ ソース を検索し、ODBC データ ソース デスクトップ アプリを開きます。

  2. [追加] を選択します。

    データ ソースを追加します。

  3. [ODBC Driver 17 for SQL Server] 、 [完了] の順に選択します。

    ドライバーを選択する。

  4. 接続の名前と説明、および接続先のクラスターを入力してから、 [次へ] を選択します。 クラスターの URL は、<クラスター名>.<リージョン>.kusto.windows.net という形式にする必要があります。

    注意

    クラスター URL を入力するときは、プレフィックス "https://" を含めないでください。

    サーバーを選択する。

  5. [Azure Active Directory 統合] 、 [次へ] の順に選択します。

    Active Directory 統合。

  6. サンプル データを含むデータベース、 [次へ] の順に選択します。

    既定のデータベースを変更する。

  7. 次の画面では、すべてのオプションを既定値のままにし、 [完了] を選択します。

  8. [データ ソースのテスト] を選択します。

    データ ソースをテストする。

  9. テストに成功したことを確認してから、 [OK] を選択します。 テストに成功しなかった場合は、前の手順で指定した値を調べ、クラスターに接続するための十分なアクセス許可があることを確認します。

    テストに成功しました。

ODBC データ ソースを使用する

ODBC 接続をサポートするアプリケーションから、次の形式の接続文字列を使用して Azure Data Explorerに接続できます。

"Driver={ODBC Driver 17 for SQL Server};Server=mykustocluster.kusto.windows.net;Database=mykustodatabase;Authentication=ActiveDirectoryIntegrated"

注意

Azure Data Explorer では、文字列値は とNVARCHAR(MAX)見なされます。これは、一部の ODBC アプリケーションではうまく機能しない可能性があります。 接続文字列 の パラメーターを使用して、LanguageデータNVARCHAR(を n) にキャストします。 たとえば、 Language=any@MaxStringSize:5000 は文字列を として NVARCHAR(5000)エンコードします。 詳細については、「 チューニング オプション」を参照してください。

アプリケーション認証

ODBC でアプリケーション プリンシパル認証を使用するには、Microsoft Entra テナント ID を指定する必要があります。 この構成は、接続文字列、Windows レジストリ、または odbc.ini ファイルで設定できます。 次のタブの例を参照してください。 詳細については、「 チューニング オプション」を参照してください。

接続文字列で アプリケーション プリンシパルLanguage=any@AadAuthority:<aad_tenant_id>を に設定します。 、<aad_application_id>、および <aad_application_secret> をそれぞれ、Microsoft Entra テナント ID、Microsoft Entra アプリケーション ID、Microsoft Entra アプリケーション シークレットに置き換えます<aad_tenant_id>。

"Driver={ODBC Driver 17 for SQL Server};Server=<adx_cluster_name>.<region_name>.kusto.windows.net;Database=<adx_database_name>;Authentication=ActiveDirectoryServicePrincipal;Language=any@AadAuthority:<aad_tenant_id>;UID=<aad_application_id>;PWD=<aad_application_secret>"

関連コンテンツ