クエリフォールディングインジケーター

[アーティクル]
05/22/2024

Note

この記事を読む前に、「Power Query でのクエリ評価とクエリフォールディングの概要」を読んで、Power Query でのフォールディング処理の仕組みをよく理解することをお勧めします。

クエリフォールディングインジケーターは、フォールドするステップとフォールドしないステップを理解するのに役立ちます。

クエリ折りたたみインジケーターを使用すると、折りたたみを壊すような変更を行ったことが明らかになります。この機能は、問題をより簡単に迅速に解決し、そもそものパフォーマンスの問題を回避し、クエリについてより適切な洞察を得るのに役立ちます。ほとんどの場合、ステップがフォールドされることもあり、フォールドされないこともあります。しかし、結果がそれほど明らかではないケースも多くあり、これらのケースについてはステップ診断インジケータ (動的、不透明、および不明) で説明されています。

Note

クエリ折りたたみインジケーター機能は、Power Query Online でのみ使用できます。

クエリ折りたたみ診断の解釈

ステップの隣にあるクエリフォールディングインジケーターを調べるときに理解することが最も重要なことは、診断状態が連続的ではないということです。つまり、そのステップのインジケーターでは、クエリ全体が、その時点までに、フォールディングされるかどうかが示されます。クエリがフォールドしないことを示すインジケーターの後にフォールドすることを示すインジケーターが続いている場合、そのポイントまでのクエリはフォールドしていることを意味します。

この解釈は、SQL ソースに対する単純なクエリでも機能します。たとえば、AdventureWorks サンプルデータベースを使用して、Production.Product テーブルに接続し、データをロードします。 Power Query ナビゲーターを介してこのサンプルを読み込むと、次のクエリが得られます。

let
  Source = Sql.Database("ServerName", "AdventureWorks"),
  Navigation = Source{[Schema = "Production", Item = "Product"]}[Data]
in
  Navigation

このコードがクエリフォールディングインジケーターでどのように表示されるかを調べると、最初のステップが決定的ではないことがわかります。ただし、2 番目のステップではフォールドされます。これは、その時点までのクエリがフォールドされることを意味します。

フォールディングインジケーターウィンドウのソースとナビゲーションのステップのスクリーンショット。

この例では、最初のステップはフォールドすることを確認できません (決定的ではありません) が、データを最初にロードしたときに生成される最後のステップはフォールドします。最初のステップ ([ソース]、および場合によっては他の [ナビゲーション] ステップ) がどのように処理されるかは、コネクタによって異なります。たとえば SQL を使う場合は、カタログテーブルの値として処理されますが、これはフォールディングされません。ただし、そのコネクタのデータを選択するとすぐにフォールドされます。

逆に、この表示はクエリがあるポイントまでフォールドされてから、その後フォールディングが停止することも意味します。すべてが折りたたまれることを示すステップの折りたたみインジケーターがある場合とは異なり、非折りたたみインジケーターがある場合でも、すべてが折りたたまれないことを意味するわけではありません。そうではなく、フォールディングされるのは "すべてではない" ことを意味します。一般に、最後のフォールディングインジケーターまでのすべてがフォールドされ、その後さらに操作が行われます。

前述の例を変更して、フォールドされない変換 (Capitalize Each Word) を指定できます。

let
  Source = Sql.Database("ServerName", "AdventureWorks"),
  Navigation = Source{[Schema = "Production", Item = "Product"]}[Data],
  #"Capitalized each word" = Table.TransformColumns(Navigation, {{"Name", each Text.Proper(_), type text}})
in
  #"Capitalized each word"

クエリフォールディングインジケーターには、最後のステップがフォールドされないことを除いて、前と同じインジケーターがあります。この最後のステップまではすべてデータソースで実行され、最後のステップはローカルで実行されます。

フォールディングインジケーターウィンドウのソース、ナビゲーション、Capitalize Each Word の各ステップのスクリーンショット。

ステップ診断インジケーター

クエリフォールディングインジケーターは、基礎となるクエリプランを使用し、レポートするにはクエリに関する情報を取得できる必要があります。現在、クエリプランはテーブルのみをサポートしているため、一部のケース (リスト、レコード、プリミティブ) はフォールディングとしてレポートされません。同様に、定数テーブルは不透明として報告されます。

インジケーター	アイコン	説明
折りたたみ		このフォールディングインジケーターは、このステップまでのクエリがデータソースによって評価されることを示します。
フォールディングされない		このフォールディングされないインジケーターは、このステップまでのクエリの一部がデータソースの外部で評価されることを示します。これを最後のフォールディングインジケーター (存在する場合) と比較して、パフォーマンスが上がるようにクエリを並べ替えることができるかどうかを確認できます。
フォールディングされる可能性がある		フォールディングされる可能性があるインジケーターはまれです。これらは、クエリがフォールドされる「可能性がある」ことを意味します。これらは、クエリから結果を取得するときに、フォールドされるかどうかが実行時に決定されること、およびクエリプランが動的であることを示します。これらのインジケーターは、ODBC または OData 接続でのみ表示される可能性があります。
非透過的		不透明のインジケーターは、何らかの理由により結果として得られるクエリプランが不確定であることを示します。これは通常、真の「定数」テーブルが存在するか、その変換またはコネクタがインジケーターおよびクエリプランツールでサポートされていないことを示します。
不明		不明なインジケーターは、エラーまたはテーブル以外のもの (レコード、リスト、プリミティブなど) に対してクエリプランの評価を実行しようとしたことにより、クエリプランが存在しないことを表します。