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 をクラスター レベルで変更するには、Azure portal で必要なテナント ID を使用して SecuritySettings.TdsEndpointDefaultAuthority に関するサポート リクエストを開いてください。
チューニング オプション
具体的な要件に従って Azure Data Explorer をカスタマイズするには、標準的な SQL Server の接続構成ではサポートされていない特定の情報を指定することが必要になる場合があります。
そのようなパラメーターを許容するために、Azure Data Explorer では、これらの値を TDS の Language および Application プロパティに入力できるようになっています。 可能な限り Language プロパティを使用することをお勧めします。
サポートされているチューニング オプション
次の表は、サポートされているチューニング オプションを示したものです。 これらのオプションの使用方法を確認するには、構文の説明を参照してください。
| チューニング オプション | 説明 |
|---|---|
MaxStringSize |
Azure Data Explorer の既定の動作では、文字列値は NVARCHAR(MAX) と見なされます。 NVARCHAR(MAX) 型で適切に動作しないアプリケーションの場合は、データを NVARCHAR(n) にキャストすることができます。 |
AadAuthority |
認証用の Microsoft Entra テナント ID を指定するために使用されます。 |
構文
[ Language | Application ] = ExpectedArguments@TuningOptions
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| ExpectedArguments | string |
✔️ | TDS の Language または Application フィールドの想定される値。 |
| TuningOptions | string |
0 個以上のコンマ区切りのサポートされているチューニング オプション。 各チューニング オプションは TuningOptionName:TuningOptionValue という形式である必要があります。 |
例
次の例は、Language プロパティと AadAuthority チューニング オプションを使用して、ODBC 接続文字列内で Microsoft Entra テナント ID を指定しています。
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