T-SQL を使用してデータのクエリを実行する

Azure Data Explorer クエリ エディターでは、主要なクエリ言語である Kusto 照会言語 (KQL) に加えて、T-SQL の使用がサポートされています。 KQL は推奨されるクエリ言語ですが、T-SQL は KQL を使用できないツールの場合に役立つことがあります。

Note

データ クエリ言語 (DQL) コマンドのみがサポートされています。 詳細については、カバレッジに関する説明を参照してください。

T-SQL を使用したクエリ

T-SQL クエリを実行するには、空の T-SQL コメント行 (--) でクエリを開始します。 -- 構文は、次のクエリを KQL ではなく T-SQL として解釈するようにクエリ エディターに指示します。

例

クエリを実行する

--
SELECT * FROM StormEvents

T-SQL から Kusto 照会言語

クエリ エディターでは、T-SQL クエリを KQL に変換する機能がサポートされています。 この変換機能は、SQL に精通していて、KQL の詳細を知りたいユーザーに役立ちます。

T-SQL SELECT ステートメントの同等の KQL を取得するには、クエリの前にキーワード explain を追加します。 出力はクエリの KQL バージョンになります。これは、対応する KQL 構文と概念を理解するのに役立ちます。

T-SQL クエリの前に T-SQL コメント行 (--) を記述して、次のクエリを KQL ではなく T-SQL として解釈するようにクエリ エディターに指示することを忘れないでください。

例

クエリを実行する

--
explain
SELECT top(10) *
FROM StormEvents
ORDER BY DamageProperty DESC

出力

StormEvents
| project
    StartTime,
    EndTime,
    EpisodeId,
    EventId,
    State,
    EventType,
    InjuriesDirect,
    InjuriesIndirect,
    DeathsDirect,
    DeathsIndirect,
    DamageProperty,
    DamageCrops,
    Source,
    BeginLocation,
    EndLocation,
    BeginLat,
    BeginLon,
    EndLat,
    EndLon,
    EpisodeNarrative,
    EventNarrative,
    StormSummary
| sort by DamageProperty desc nulls first
| take int(10)

ストアド関数を実行する

T-SQL を使用する場合は、最適化された KQL クエリを作成し、それらをストアド関数にカプセル化することをお勧めします。そうすることで、T-SQL コードが最小限になり、パフォーマンスが向上する可能性があります。 たとえば、次の表で説明されているストアド関数がある場合、次のコード例に示すように実行できます。

名前	パラメーター	本文​​	フォルダー	DocString
MyFunction	(myLimit: long)	{StormEvents | take myLimit}	MyFolder	パラメーターを使用したデモ関数

SELECT * FROM kusto.MyFunction(10)

Note

ストアド関数とエミュレートされた SQL システム ストアド プロシージャを区別するには、kusto スキーマへの明示的な参照を使用してストアド関数を実行します。 この例では、ストアド関数は kusto.Myfunction を使用して実行されます。

要求プロパティを設定する

要求プロパティは、クエリの実行方法と結果を返す方法を制御します。 T-SQL で要求プロパティを設定するには、次の構文を使用して 1 つ以上のステートメントをクエリの先頭に追加します。

構文

DECLARE @__kql_set_requestPropertyName type = value;

パラメーター

件名	タイプ	Required	説明
requestPropertyName	string	✔️	設定する要求プロパティの名前。
type	string	✔️	値の T-SQL データ型。
value	スカラー型	✔️	要求プロパティに割り当てる値。

Note

• 2 つのステートメントはセミコロンで区切る必要があり、クエリの前に空の行を入れないようにします。
• 要求プロパティは、直後に続く表形式の式ステートメントにのみ適用されます。

例

次の表は、T-SQL で要求プロパティを設定する方法の例を示しています。

要求プロパティ	例
query_datetimescope_to	DECLARE @__kql_set_query_datetimescope_to DATETIME = '2023-03-31 03:02:01';
request_app_name	DECLARE @__kql_set_request_app_name NVARCHAR = 'kuku';
query_results_cache_max_age	DECLARE @__kql_set_query_results_cache_max_age TIME = '00:05:00';
truncationmaxsize	DECLARE @__kql_set_truncationmaxsize BIGINT = 4294967297;
maxoutputcolumns	DECLARE @__kql_set_maxoutputcolumns INT = 3001;
notruncation	DECLARE @__kql_set_notruncation BIT = 1;
norequesttimeout	DECLARE @__kql_set_norequesttimeout BIT = 0;

KQL で要求プロパティを設定するには、「set ステートメント」を参照してください。

補充

Azure Data Explorer では、T-SQL のサポートが制限されています。 次の表は、サポートされていない、または部分的にサポートされている T-SQL ステートメントと機能の概要を示しています。

T-SQL ステートメントまたは機能	説明
CREATE、INSERT、DROP、および ALTER	サポートされていません
スキーマまたはデータの変更	サポートされていません
ANY、ALL、EXISTS	サポート対象外
WITHIN GROUP	サポートされていません
TOP PERCENT	サポート対象外
TOP WITH TIES	通常の TOP として評価されます
TRUNCATE	最も近い値を返します
SELECT *	列の順序は予想と異なる場合があります。 順序が重要な場合は、列名を使用します。
AT TIME ZONE	サポートされていません
SQL カーソル	サポートされていません
相関サブクエリ	サポートされていません
再帰 CTE	サポートされていません
動的ステートメント	サポートされていません
フロー制御ステートメント	THEN と ELSE のスキーマが同じ IF、THEN、ELSE ステートメントのみがサポートされます。
重複する列名	サポートされていません。 元の名前は、1 つの列に対して保持されます。
データ型	返されるデータの種類は SQL Server とは異なる場合があります。 たとえば、TINYINT と SMALLINT は Azure Data Explorer で同等の種類を持たず、BYTE や INT16 ではなく、INT32 または INT64 として返される場合があります。

関連するコンテンツ

• Azure Data Explorer の SQL Server エミュレーションについて
• SQL と Kusto 照会言語のクイック ガイドの使用