NRQLサブクエリ

NRQLを使用すると、別のクエリ内にネストされたクエリであるサブクエリを実行できます。

サブクエリの基本

サブクエリは、別のクエリ内にネストされたクエリです。サブクエリを使用すると、あるクエリの結果を別のクエリで使用できます。サブクエリで実行できることの例：

• 親エンティティの子エンティティで計算を実行します
• インフラストラクチャエージェントのCPU使用率に基づいて、CPU負荷が高いホストのエラーログを参照してください

NRQLでは、サブクエリはSELECTステートメントとWHERE句に表示できます。

サブクエリの例

平均以上の期間のトランザクションの数を取得するためのクエリの例を次に示します。

SELECT count(*) FROM Transaction WHERE duration > (SELECT average(duration) FROM Transaction)

サブクエリの結果は、コンテキストで意味をなさなければなりません。上記の例では、 WHERE句の大なり記号条件には、単一の値を返すサブクエリが必要です。値のセットを返すサブクエリ（uniques（）サブクエリなど）は失敗します。

サブクエリは、別のサブクエリ内にネストできます。クエリでは、ネストされているかどうかに関係なく、最大3つのサブクエリを使用できます。

SINCE / UNTILで明示的に指定されていない限り、サブクエリの時間範囲は外部クエリの時間範囲と同じになります。

サブクエリの実行

クエリの実行中、各サブクエリは独立して実行され、その結果は外部クエリで定数値または値のセットとして使用されます。この実行モデルにより、サブクエリは外部クエリの属性と値を参照しない場合があります。

クエリ期間の制限は、サブクエリを含むクエリに対して適用されます。これは、すべてのサブクエリと外部クエリが期間制限内に実行を完了する必要があることを意味します。

サブクエリが返すことができる結果の最大数は、 LIMITの最大値と同じです：2,000。

サブクエリとネストされた集計

それらは似ているように見えますが、サブクエリをネストされた集計と混同しないでください。ネストされた集計では、ネストされたクエリの結果を集計できます。ネストされた集計はFROM句で使用され、サブクエリはSELECTステートメントとWHERE句で使用されます。

制限

• サブクエリは、NRQLアラート条件ではサポートされていません。サブクエリを使用するクエリでは、データに対して複数のパスを作成する必要があるため、サブクエリはストリーミングアラートと互換性がありません。
• クエリが複数の結果セットを返す原因となるTIMESERIES句とCOMPARE WITH句は、サブクエリではサポートされていません。
• サブクエリはFACET句には表示できませんが、 FACET CASESで使用されるWHERE句には表示できます。

サブクエリの例

サブクエリの例を次に示します。

FROM Transaction SELECT count(*) 
WHERE duration > (FROM Transaction SELECT average(duration))

FROM Transaction SELECT average(duration) WHERE entityGuid IN
  (FROM Relationship SELECT targetEntityGuid 
  WHERE sourceEntityGuid = 'MjUyMDUyOHxOUjF8V09SS0xPQUR8NzYzMDQ' 
  AND relationshipType = 'CONTAINS') SINCE 1 day ago

FROM TransactionError SELECT * WHERE guid = (FROM Transaction SELECT latest(guid) FACET accountId ORDER BY average(duration) LIMIT 1)

FROM Transaction SELECT average(duration) - 
  (FROM Transaction SELECT average(duration) 
  SINCE 7 days ago) TIMESERIES

FROM Transaction SELECT uniques(accountId) WHERE guid IN
  (FROM Transaction SELECT uniques(guid) WHERE duration > 
  (FROM Transaction SELECT percentile(duration, 99)))

SELECT concat('This transaction duration: ', duration, '; average transaction duration: ', 
  (SELECT average(duration) FROM Transaction), precision: 4) FROM Transaction