Share via

Azure SQL の接続の種類 (SSRS)

  • [アーティクル]

Microsoft Azure SQL データベース は、ホストされているクラウドベースのリレーショナル データベースで、SQL Server テクノロジを利用して構築されています。 SQL Database からのデータをレポートに含めるには、 SQL Databaseの種類のレポート データ ソースに基づいたデータセットが必要です。 このビルトイン データ ソースの種類は、 SQL Database データ拡張機能に基づいています。 このデータ ソースの種類を使用して、 SQL Databaseからのデータに接続し、そのデータを取得します。

このデータ拡張機能は、接続文字列とは個別に管理される、複数の値を持つパラメーター、サーバー集計、および資格情報をサポートしています。

SQL Database は、オンプレミスの SQL Server のインスタンスと似ています。 SQL Database からは、一部の例外を除き、 SQL Serverと同じようにデータを取得できます。

注意

SQL Databaseへの接続を開くときに、接続タイムアウトを 30 秒に設定してください。

詳細については、「Microsoft Azure SQL Database」を参照してください。

このトピックの情報を使用して、データ ソースを構築してください。 ステップ バイ ステップの手順については、「データ接続を追加および確認する (レポート ビルダーおよび SSRS)」を参照してください。

Connection String

SQL Database に接続する場合、クラウド内のデータベース オブジェクトに接続します。 オンサイトのデータベースと同様に、ホストされているデータベースには、複数のテーブル、ビュー、およびストアド プロシージャを含むスキーマが複数存在している場合があります。 クエリ デザイナーで、使用するデータベース オブジェクトを指定します。 接続文字列でデータベースを指定しない場合は、管理者によって割り当てられた既定のデータベースに接続されます。

データ ソースへの接続に使用する接続情報および資格情報については、データベース管理者に問い合わせてください。 AdventureWorks というホストされているサンプル データベースを指定する接続文字列の例を次に示します。

Data Source=<host>;Initial Catalog=AdventureWorks; Encrypt=True;

また、 [データ ソースのプロパティ] ダイアログ ボックスを使用して、ユーザー名やパスワードなどの資格情報を入力します。 User Id オプションと Password オプションは、接続文字列に自動的に付加されます。これらを接続文字列の一部として入力する必要はありません。

接続文字列の例について詳しくは、「データ接続文字列を作成する - レポート ビルダーおよび SSRS」を参照してください。

資格情報

Windows 認証 (統合セキュリティ) はサポートされていません。 Windows 認証を使用して SQL Database に接続しようとすると、エラーが発生します。 SQL Database でサポートされているのが SQL Server 認証 (ユーザー名とパスワード) のみであるため、ユーザーは SQL Databaseに接続するたびに資格情報 (ログインとパスワード) を入力する必要があります。

データベースにアクセスするには、十分な資格情報が必要です。 クエリによっては、他の権限 (ストアド プロシージャを実行したり、テーブルやビューにアクセスしたりするために必要な権限) が必要な場合があります。 外部データ ソースの所有者は、十分な資格情報を構成して、ユーザーが必要とするデータベース オブジェクトに対する読み取り専用アクセスを提供する必要があります。

レポート作成クライアントから、次のオプションを使用して資格情報を指定します。

  • 保存されているユーザー名とパスワードを使用する。 レポート データを格納するデータベースがレポート サーバーとは別のサーバーに存在する場合に発生するダブル ホップに対処するには、資格情報を Windows 資格情報として使用するオプションを選択します。 データ ソースに接続した後に、認証されているユーザーの権限を借用するオプションもあります。

  • 資格情報を必要としない。 このオプションを使用するには、レポート サーバーで自動実行アカウントを構成しておく必要があります。 詳細については、「自動実行アカウントの構成 (レポート サーバー構成マネージャー)」を参照してください。

詳細については、「データ接続文字列を作成する - レポート ビルダーおよび SSRS」または「レポート データ ソースに関する資格情報と接続情報を指定する」を参照してください。

クエリ

クエリでは、レポート データセット用に取得するデータを指定します。 クエリの結果セットの列には、データセットのフィールド コレクションが設定されます。 クエリで複数の結果セットが返された場合にレポートによって処理されるのは、クエリから取得された最初の結果セットだけです。 SQL Server と SQL Databaseの間には、サポートされるデータベースのサイズなど、いくつか違いがありますが、 SQL Databaseに対するクエリの作成方法と SQL Server データベースに対するクエリの作成方法はほぼ同じです。 Transact-SQL では、BACKUP などの一部の SQL Database ステートメントがサポートされていませんが、これらはレポート クエリで使用するステートメントではありません。 詳細については、「SQL Server の接続の種類 (SSRS)」を参照してください。

新しいクエリを作成するか、グラフィカル クエリ デザイナーで表示できる既存のクエリを開く場合、既定でリレーショナル クエリ デザイナーを使用できます。 クエリは、次の方法で指定できます。

  • クエリを対話形式で作成します。 データベース スキーマ別に編成された、テーブル、ビュー、ストアド プロシージャ、およびその他のデータベース アイテムの階層ビューが表示されるリレーショナル クエリ デザイナーを使用します。 テーブルまたはビューから列を選択するか、ストアド プロシージャまたはテーブル値関数を指定します。 フィルター条件を指定して、取得するデータの行数を制限します。 パラメーター オプションを設定してレポートの実行時にフィルターをカスタマイズします。

  • クエリを入力するか、貼り付けます。 テキスト ベースのクエリ デザイナーは、Transact-SQL テキストを直接入力する、クエリ テキストを別のソースから貼り付ける、リレーショナル クエリ デザイナーでは作成できない複雑なクエリを入力する、クエリ ベースの式を入力する、などの場合に使用します。

  • ファイルまたはレポートから既存のクエリをインポートします。 クエリ デザイナーの [クエリのインポート] ボタンを使用して、.sql ファイルまたは .rdl ファイルを参照し、クエリをインポートします。

テキスト ベースのクエリ デザイナーでは、次の 2 つのモードがサポートされています。

詳細については、「リレーショナル クエリ デザイナーのユーザー インターフェイス (レポート ビルダー)」および「テキストベースのクエリ デザイナーのユーザー インターフェイス (レポート ビルダー)」を参照してください。

SQL Database で使用されるグラフィカル クエリ デザイナーには、要約データのみを取得するクエリの作成に役立つグループ化と集計のサポートが組み込まれています。 Transact-SQL 言語の機能には、GROUP BY 句、DISTINCT キーワード、および集計 (SUM、COUNT など) があります。 テキスト ベースのクエリ デザイナーでは、グループ化と集計を含めて Transact-SQL 言語が完全にサポートされています。 Transact-SQL の詳細については、「Transact-SQL リファレンス (データベース エンジン)」を参照してください。

Text の種類のクエリの使用

テキスト ベースのクエリ デザイナーでは、Transact-SQL コマンドを入力して、データセット内のデータを定義します。 たとえば、次の Transact-SQL クエリでは、マーケティング アシスタントであるすべての従業員の名前を選択します。

SELECT  
  HumanResources.Employee.BusinessEntityID  
  ,HumanResources.Employee.JobTitle  
  ,Person.Person.FirstName  
  ,Person.Person.LastName  
FROM  
  Person.Person  
  INNER JOIN HumanResources.Employee  
    ON Person.Person.BusinessEntityID = HumanResources.Employee.BusinessEntityID  
WHERE HumanResources.Employee.JobTitle = 'Marketing Assistant'

ツール バーの [実行] ボタン ( ! ) をクリックすると、クエリが実行され、結果セットが表示されます。

このクエリをパラメーター化するには、クエリ パラメーターを追加します。 たとえば、WHERE 句を次の構文に変更します。

WHERE HumanResources.Employee.JobTitle = (@JobTitle)

クエリの実行時に、クエリ パラメーターに対応するレポート パラメーターが自動的に作成されます。 詳細については、このトピックの「 クエリ パラメーター 」を参照してください。

StoredProcedure の種類のクエリの使用

データセット クエリのストアド プロシージャは、次のいずれかの方法で指定できます。

  • [データセットのプロパティ] ダイアログ ボックスで、 [ストアド プロシージャ] オプションを設定します。 ドロップダウン リストからストアド プロシージャまたはテーブル値関数を選択します。

  • リレーショナル クエリ デザイナーのデータベース ビュー ペインで、ストアド プロシージャまたはテーブル値関数を選択します。

  • テキスト ベースのクエリ デザイナーで、ツール バーから [StoredProcedure] を選択します。

ストアド プロシージャまたはテーブル値関数を選択したら、クエリを実行できます。 入力パラメーター値の入力を要求されます。 クエリの実行時に、入力パラメーターに対応するレポート パラメーターが自動的に作成されます。 詳細については、このトピックの「 クエリ パラメーター 」を参照してください。

ストアド プロシージャから取得した最初の結果セットだけがサポートされます。 ストアド プロシージャから複数の結果セットが返された場合、最初の結果セットだけが使用されます。

既定値が指定されたパラメーターがストアド プロシージャに含まれている場合、パラメーターの値として DEFAULT キーワードを使用してその値にアクセスできます。 クエリ パラメーターがレポート パラメーターにリンクされている場合は、レポート パラメーターの入力ボックスで DEFAULT キーワードを入力または選択できます。

ストアド プロシージャの詳細については、「ストアド プロシージャ (データベース エンジン)」を参照してください。

パラメーター

入力パラメーターを含むクエリ変数またはストアド プロシージャがクエリ テキストに含まれている場合、対応するデータセットのクエリ パラメーターとレポートのレポート パラメーターが自動的に生成されます。 クエリ テキストには、各クエリ変数の DECLARE ステートメントを含めないでください。

たとえば、次の SQL クエリでは、 EmpIDという名前のレポート パラメーターが作成されます。

SELECT FirstName, LastName FROM HumanResources.Employee E INNER JOIN  
       Person.Contact C ON  E.ContactID=C.ContactID   
WHERE EmployeeID = (@EmpID)

レポート パラメーターの既定のデータ型は Text です。各レポート パラメーターには自動的に作成されたデータセットが設定され、使用可能な値のドロップダウン リストで使用されます。 レポート パラメーターを作成した後に、既定値の変更が必要になる場合があります。 詳細については、「レポート パラメーター (レポート ビルダーおよびレポート デザイナー)」をご覧ください。

解説

代替データ拡張機能

SQL Server データベースからのデータの取得は、ODBC のデータ ソースの種類を使用して行うこともできます。 OLE DB を使用した SQL Database への接続はサポートされていません。

詳細については、「ODBC 接続の種類 (SSRS)」を参照してください。

プラットフォームおよびバージョン情報

プラットフォームとバージョンのサポートについて詳しくは、「Reporting Services でサポートされるデータ ソース (SSRS)」をご覧ください。

Azure SQL データベースと Microsoft Entra ID

Microsoft Entra ID (旧称 Azure Active Directory) で Azure SQL データベースを使用できます。

このシナリオは、以下の項目を正しく設定した場合にサポートされます。

  • SQL Server 用の Active Directory 認証ライブラリ (ADALSQL) がレポート サーバーにインストールされている。
  • Active Directory フェデレーション サービス (AD FS) が、オンプレミスの Active Directory (AD) と Microsoft Entra ID 全体で連携するように構成されている。
  • Kerberos の制約付き委任 (KCD) がレポート サーバーから ADFS サーバーに対して構成されている。
  • レポートを表示するユーザーとして Azure SQL Database に対する認証を受けるようにレポート/データ ソースを構成している。

操作方法に関するトピック

データ接続、データ ソース、およびデータセットを操作する手順について説明します。

データ接続を追加および確認する (レポート ビルダーおよび SSRS)

共有データセットまたは埋め込みデータセットの作成 (レポート ビルダーおよび SSRS)

データセットへのフィルターの追加 (レポート ビルダーおよび SSRS)

次に示すセクションでは、レポート データの概念が詳細に説明されているほか、データに関連するレポートのパーツを定義しカスタマイズし使用する手順が説明されています。

レポート データセット (SSRS)
レポートのデータへのアクセスの概要について説明します。

データ接続文字列を作成する - レポート ビルダーおよび SSRS
データ接続とデータ ソースについて説明します。

レポート埋め込みデータセットと共有データセット (レポート ビルダーおよび SSRS)
埋め込みデータセットと共有データセットについて説明します。

データセット フィールド コレクション (レポート ビルダーおよび SSRS)
クエリによって生成されるデータセット フィールド コレクションについて説明します。

Reporting Services でサポートされるデータ ソース (SSRS)。
各データ拡張機能のプラットフォームおよびバージョン サポートに関する詳細な情報です。

参照

Microsoft Azure SQL Database
レポート パラメーター (レポート ビルダーおよびレポート デザイナー)
データのフィルター、グループ化、および並べ替え (レポート ビルダーおよび SSRS)
式 (レポート ビルダーおよび SSRS)