Share via

SQL Server エミュレーションを使って Azure Data Explorer でデータのクエリを実行します

  • [アーティクル]

Microsoft Entra認証を使用してMicrosoft Azure SQL Databaseに接続できるライブラリとアプリケーションは、Azure Data Explorerにも接続できます。 この機能は、Microsoft SQL Serverをエミュレートする Azure Data Explorer の TDS 準拠エンドポイントによって可能になります。 エンドポイントでは、TDS バージョン 7.x と 8.0 がサポートされています。

SQL Server エミュレーションを使用すると、ODBC、JDBC、LINQPad や Azure Data Studio などの一般的なアプリなど、さまざまな方法で Azure Data Explorerに接続できます。

認証

Azure Data Explorerでは、Microsoft Entra IDによる認証が必要です。

アプリケーション プリンシパルを認証するには、 チューニング オプションにテナント ID を含める必要があります。 例については、「 ODBC を使用した接続」を参照してください。

クラスター レベルでMicrosoft Entraテナント ID を構成し、クライアントから指定する必要を取り除く可能性があります。 クラスター レベルでテナント ID を変更するには、必要なテナント ID を使用して SecuritySettings.TdsEndpointDefaultAuthority を構成する方法に関するAzure portalでサポート 要求を開きます。

チューニング オプション

特定の要件に従って Azure Data Explorerをカスタマイズするには、標準のSQL Server接続構成でサポートされていない特定の情報を指定する必要がある場合があります。

このようなパラメーターを許可するために、Azure Data Explorerでは、これらの値を TDS Language とApplicationプロパティに入力できます。 可能な場合は、 プロパティを Language 使用することをお勧めします。

サポートされているチューニング オプション

次の表では、サポートされているチューニング オプションについて説明します。 これらのオプションの使用方法については、 構文 の説明を参照してください。

チューニング オプション 説明
MaxStringSize Azure Data Explorerの既定の動作では、文字列値を とNVARCHAR(MAX)見なします。 型でうまく機能しないアプリケーションのNVARCHAR(MAX)場合は、データを n) にNVARCHAR(キャストできます。
AadAuthority 認証用のMicrosoft Entra テナント ID を指定するために使用します。

構文

[ Language | Application ] =ExpectedArguments@TuningOptions

構文規則について詳しく知る。

パラメーター

名前 型 必須 説明
ExpectedArguments string ✔️ TDS の または Application フィールドに対してLanguage想定される値。
TuningOptions string 0 個以上のコンマ区切り でサポートされるチューニング オプション。 各チューニング オプションは、 TuningOptionName:TuningOptionValue の形式である必要があります。

例

次の例では、 プロパティとチューニング オプションを使用してLanguage、ODBC 接続文字列のMicrosoft Entraテナント ID をAadAuthority指定します。

Driver={ODBC Driver 17 for SQL Server};Server=myadxcluster.westeurope.kusto.windows.net;Database=mydatabase;Authentication=ActiveDirectoryServicePrincipal;Language=any@AadAuthority:57B489CD-590C-417F-A8B9-E75D2F9A04C8,MaxStringSize:5000;UID=A9BCAB99-8AAD-4411-A232-37E2116B935E;PWD=mysecret

関連コンテンツ