テキストベースのクエリ デザイナーのユーザー インターフェイス (レポート ビルダー)

デザイン時に、データ ソースでサポートされているクエリ言語でクエリを指定し、クエリを実行し、結果を表示するには、テキスト ベースのクエリ デザイナーを使用します。 複数の Transact-SQL ステートメント、カスタム データ処理拡張機能のクエリまたはコマンド構文、および式としてのクエリを指定できます。 テキスト ベースのクエリ デザイナーはクエリを前処理せず、あらゆる種類のクエリ構文に対応できるため、これは多くの種類のデータ ソースで既定のクエリ デザイナー ツールになっています。

重要

ユーザーは、クエリを作成して実行する際にデータ ソースにアクセスします。 したがって、データ ソースに対する最小限の権限 (読み取り専用権限など) を付与する必要があります。

テキスト ベースのクエリ デザイナーでは、ツール バーと次の 2 つのペインが表示されます。

• [クエリ] クエリの種類に応じて、クエリ テキスト、テーブル名、またはストアド プロシージャ名が表示されます。 すべての種類のデータ ソースですべての種類のクエリが使用できるとは限りません。 たとえば、テーブル名はデータ ソースの種類が OLE DB の場合にのみサポートされます。

• [結果] デザイン時にクエリの実行結果が表示されます。

テキスト ベースのクエリ デザイナーのツール バー

テキスト ベースのクエリ デザイナーで使用できるツール バーは、コマンドの種類に関係なく 1 つだけです。 次の表は、ツール バーの各ボタンとその機能を示しています。

Button	説明
[テキストとして編集]	テキスト ベースのクエリ デザイナーと、グラフィカル クエリ デザイナー間で切り替えます。 すべての種類のデータ ソースでグラフィカル クエリ デザイナーがサポートされているとは限りません。
[インポート]	ファイルまたはレポートから既存のクエリをインポートします。 サポートされているファイルの種類は sql と rdl だけです。
	クエリを実行し、その結果セットを結果ペインに表示します。
[コマンドの種類]	[Text] 、 [StoredProcedure] 、または [TableDirect] を選択します。 パラメーターを受け取るストアド プロシージャの場合、ツール バーの [実行] をクリックすると、 [クエリ パラメーターの定義] ダイアログ ボックスが表示され、必要な値を入力できます。 サポートされるコマンドの種類は、データ ソースの種類によって異なります。 たとえば、 [TableDirect] がサポートされるのは、OLE DB と ODBC だけです。 注:ストアド プロシージャから複数の結果セットが返された場合、最初の結果セットのみを使ってデータセットが設定されます。

コマンドの種類 (Text)

SQL Server データセットを作成するとき、既定ではリレーショナル クエリ デザイナーが表示されます。 テキスト ベースのクエリ デザイナーに切り替えるには、ツール バーの [テキストとして編集] 切り替えボタンをクリックします。 テキスト ベースのクエリ デザイナーは、クエリ ペインと結果ペインの 2 つのペインで構成されています。 次の図に各ペインの名称を示します。

次の表に各ペインの機能を示します。

ペイン	機能
クエリ	Transact-SQL クエリ テキストを表示します。 Transact-SQL クエリを記述または編集する際に、このペインを使用します。
結果	クエリの結果を表示します。 クエリを実行するには、任意のペインで右クリックして、 [実行] をクリックするか、ツール バーの [実行] ボタンをクリックします。

例

次のクエリは、Person スキーマの AdventureWorks2022 データベースの ContactType テーブルから名前の一覧を返します。

SELECT Name FROM Person.ContactType  

ツール バーの [実行] をクリックすると、 クエリ ペインのコマンドが実行され、その結果が 結果 ペインに表示されます。 結果セットには、所有者や販売担当者など 20 種類の連絡先の一覧が表示されます。

コマンドの種類 (StoredProcedure)

[コマンドの種類] で [StoredProcedure] を選択した場合、テキスト ベースのクエリ デザイナーには、クエリ ペインと結果ペインの 2 つのペインが表示されます。 ストアド プロシージャ名をクエリ ペインに入力し、ツール バーの [実行] をクリックします。 ストアド プロシージャでパラメーターを使用する場合、 [クエリ パラメーターの定義] ダイアログ ボックスが表示されます。 ストアド プロシージャのパラメーター値を入力します。 すべてのストアド プロシージャの入力パラメーターについて、レポート パラメーターが作成されます。

次の図に、ストアド プロシージャを実行したときのクエリ ペインと結果ペインを示します。 この場合、入力パラメーターは定数です。

次の表に各ペインの機能を示します。

ペイン	機能
クエリ	ストアド プロシージャの名前と入力パラメーターを表示します。
結果	クエリの結果を表示します。 クエリを実行するには、任意のペインで右クリックして、 [実行] をクリックするか、ツール バーの [実行] ボタンをクリックします。

例

次のクエリでは、uspGetWhereUsedProductID という AdventureWorks2022 ストアド プロシージャを呼び出します。 クエリを実行する場合は、製品 ID 番号パラメーターの値を入力する必要があります。

uspGetWhereUsedProductID  

[実行] ( ! ) ボタンをクリックします。 クエリ パラメーターの入力画面が表示されたら、次の表にある値を入力します。

パラメーター	値
@StartProductID	820
@CheckDate	20010115

指定した日付について、結果セットには、指定したコンポーネント番号を使用している 13 の製品 ID の一覧が表示されます。

コマンドの種類 (TableDirect)

[コマンドの種類] で [TableDirect] を選択した場合、テキスト ベースのクエリ デザイナーには、クエリ ペインと結果ペインの 2 つのペインが表示されます。 テーブルを入力し、 [実行] ボタンをクリックすると、そのテーブルのすべての列が返されます。

例

データ ソースの種類が OLE DB の場合、次のデータセット クエリでは、AdventureWorks2022 データベースから、すべての種類の連絡先を結果セットとして取得します。

Person.ContactType

テーブル名「Person.ContactType」を入力すると、Transact-SQL ステートメントの SELECT * FROM Person.ContactType を作成することになります。

参照

リレーショナル クエリ デザイナーのユーザー インターフェイス (レポート ビルダー)
クエリ デザイン ツール (SSRS)