Microsoft SQL Server データベースをデータポータルに接続して、データを可視化し、分析できます。データベース テーブルまたはカスタムクエリを使用して、インタラクティブなレポートとダッシュボードを作成します。データベースに直接アクセスできない関係者やチームメンバーと、これらの分析情報を共有できます。
サポート対象のバージョン
Microsoft SQL Server コネクタでは、V7.2 JDBC ドライバを使用します。このコネクタは MS SQL Server でテストされており、以下の古いバージョンと互換性があります。
- 2017
- 2016
- 2014
- 2012
お使いのデータベースのバージョンが V7.2 JDBC ドライバと互換性があるかどうかを確認するには、MS SQL Server のバージョンの互換性に関するドキュメントをご覧ください。
Microsoft SQL Server に接続する方法
データポータルのデータソースは、1 つの Microsoft SQL Server データベース テーブル、または指定したカスタムクエリに接続できます。
Microsoft SQL Server データベースに接続する手順は次のとおりです。
- データポータルにログインします。
- データポータルのホームページで、 [作成] をクリックして、 [データソース] を選択します。
- Microsoft SQL Server コネクタを選択します。
- 接続オプションのいずれかを使って、データベースへのアクセス権を設定します。
- [AUTHENTICATE] をクリックします。そのデータベース内のテーブルのリストが表示されます。
- リストからテーブルを選択するか、カスタムクエリを入力します。
- [接続] をクリックします。
これで、指定したテーブルのすべての列をレポートの中でフィールドとして使えるようになります。
接続オプション
ホスト名または IP アドレスを使用して接続する
接続で [基本] を選択します。接続の詳細を入力します。
- ホスト名または IP アドレス
- ポート（省略可）
- データベース
- ユーザー名
- パスワード
JDBC URL を使用して接続する
接続で [JDBC URL] を選択します。接続の 詳細を入力します。
- JDBC URL
例
jdbc:sqlserver://HOSTNAME[:PORT];databaseName=DATABASE
- ユーザー名
- パスワード
IPv6 リテラル アドレスを使用して接続するには、アドレスを角かっこで囲みます 次に例を示します。
jdbc:sqlserver://[2001:db8:1:1:1:1:1:1]/your_db
SSL を使用して接続する
データポータルでは、TLS（Transport Layer Security）プロトコル（TLS 1.2）を使用して、サーバーへの接続を保護（暗号化）できます。TLS は SSL（セキュア ソケット レイヤ）とも呼ばれます。
保護された接続を使用するには、[SSL を有効にする] を選択して、SSL 設定ファイルを指定します。
データポータルでは SSL の使用は必須ではありませんが、データベース構成で必要になる場合があります。詳細については、データベース ベンダーにお問い合わせください。
クライアント認証を使用して接続する
[クライアント認証を有効にする] チェックボックスをオンにすると、データベースにアクセスする際に、必要に応じてクライアントの秘密鍵とクライアント証明書をアップロードできます。
データポータルではクライアント認証の使用は必須ではありませんが、データベース構成で必要になる場合があります。詳細については、データベース ベンダーにお問い合わせください。
カスタムクエリ
1 つの表に接続する代わりに、SQL クエリを指定するには [カスタムクエリ] オプションを選択します。データポータルでは、データベースに対するクエリが生成されると、このカスタム SQL を内部 SELECT ステートメントとして使用します。
カスタム SQL クエリには、1 つのステートメントのみを含めることがます。たとえば以下は、複数の SQL ステートメントが含まれるため機能しません 。
DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;
SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;
データポータルのクエリは 3 ～ 5 分後にタイムアウトする場合があります。カスタムクエリがタイムアウトした場合は、次の方法で問題を解決してみてください。
- 実行速度を上げるために、クエリを簡素化します。
- データベースでクエリを実行し、結果を別のテーブルに保存してからデータソース内の新しいテーブルに接続します。
サポートされるデータタイプ
データポータルは、データベースの組み込みデータタイプを、統合されたデータタイプ一式にマッピングします。データポータルがサポートされていない表やクエリで列を検出すると、その列についてはフィールドが作成されません。ファイアウォールとデータベースへのアクセス
データポータルがファイアウォールの内側にあるデータベースに接続してクエリを実行できるようにするには、次のいずれかの IP アドレスへのアクセスを可能にする必要があります。 また、これらのアドレスからのトラフィックを受け入れるようにデータベースを設定する必要があります。詳しい手順については、該当するデータベースの各ドキュメントをご覧ください。
IP アドレス
次のアドレスは、データポータルのグローバル インフラストラクチャ用に予約されています。
142.251.74.0/232001:4860:4807::/48（省略可、IPv6 をサポートするプラットフォームの場合）
データポータル Pro サブスクリプションでデータ所在地を有効にしている場合は、代わりに次のアドレスを使用してください。
142.251.56.0/242001:4860:4815::/48（省略可、IPv6 をサポートするプラットフォームの場合）
Microsoft SQL Server コネクタの制限事項
- このコネクタを使用すると、1 クエリあたり最大 15 万行のクエリを実行できます。この上限値を超えたデータは切り捨てられます。
- 列見出し（フィールド名）には ASCII 文字のみを使用する必要があります。ASCII 以外の文字はサポートされていません。
トラブルシューティング
一般的なエラー メッセージとその解決方法については、データポータルのトラブルシューティング ガイドをご覧ください。
ライセンス
Microsoft SQL Server コネクタは、MIT ライセンスに基づいて配布された SQL Server 用 Microsoft JDBC ドライバを使って開発されました。