カスタマイズ可能なクエリからデータ製品を作成する

カスタマイズ可能なパラメータとクエリを使用して、データを動的に表示するデータ プロダクトを作成できます。 コンシューマーは、データ製品の生成に使用される結果を返すカスタム クエリとして機能するパラメータを指定できます。 カスタマイズ可能なクエリを使用することで、データ製品をより頻繁に再利用でき、消費者は必要な特定のデータを受け取ることができます。

カスタマイズ可能なクエリをサポートするデータ プロダクトを作成するには、必要なパラメータを追加して定義し、パラメータを変数として使用する SQL クエリを作成する必要があります。 消費者はデータ製品をサブスクライブし、サブスクリプションの詳細に必要なパラメータを指定します。

必須ロール
共同作業者の役割:編集者

このビデオは、このドキュメントのコンセプトとタスクを学ぶための視覚的な方法を提供します。

データソース接続の追加

プロジェクトにデータ ソース接続を追加して、リモート データに接続します。

  1. プロジェクト内で Assets ページに移動し、 New Asset > Connect to a data sourceをクリックします。
  2. データ ソース接続を選択し、必要な資格情報を入力します。 これらの資格情報はサブスクリプション後に消費者にデータ製品を配信するために使用されるため、適切な資格情報セットを使用するようにしてください。
  3. クリック作成するデータ ソース接続を検証します。

パラメータセットの作成

パラメータ セットに必要なパラメータを追加して定義します。 データ製品リクエストの詳細を表示してパラメータを作成できます。

  1. アセットページから、新規アセット > 再利用可能なパラメータセットの定義をクリックします。
  2. 必要なパラメータごとに次のプロパティを定義します。
    • 名前: パラメータの名前を入力します。
    • タイプ: 入力を送信するデータ型を指定します。 型のパラメータEmailそしてEncryptedカスタマイズ可能なクエリでは現在サポートされていません。
    • プロンプト: ユーザーにパラメータを尋ねるプロンプトを定義します。
    • デフォルト値: 同様の応答が予想される場合は、プロパティを事前に入力できます。
  3. クリック保存パラメータを確認します。

カスタマイズ可能なパラメータを持つSQLクエリの作成

指定されたパラメータを使用してデータ製品を生成する SQL クエリを定義します。

  1. プロジェクトページから、新しいアセット > データの動的ビューを作成する。
  2. データ資産を定義するには、次のフィールドに入力します。
    • 名前: データ資産の名前を入力します。
    • 説明: クエリの目的を説明します。
    • 繋がり: SQL クエリをサポートする接続を選択します。 サポートされている接続については、 SQLからデータ製品を作成するを参照してください。
    • パラメータセット: クエリを作成するパラメータ セットを選択します。
    • タグ（オプション） : アセットを見つけやすくするためにタグを追加します。
  3. SQL クエリで、各パラメータをデータ値に接続します。 クエリ内のすべてのパラメータ名がパラメータ セット内の対応する名前と一致していることを確認します。 次の構文を使用してパラメータを指定します。'#{parameter_1_name}#' 。

パラメータ付きの SQL クエリを記述する例として、次のコード サンプルとグラフィックを使用します。

SELECT * FROM {DATABASE.NAME}
WHERE
    {DATABASE.NAME.COLUMN1} = '#{parameter_1_name}#' AND
{DATABASE.NAME.COLUMN2} = '#{parameter_2_name}#';

パラメータに接続された完全なSQLクエリの例を示すグラフィック

  1. 各パラメータのサンプル値を入力して、データプレビューを生成します。 クエリ フィールドで定義されたすべてのパラメータにはサンプル値が含まれている必要があります。 サンプル値を空白のままにするには、クエリ フィールドからパラメータを削除します。
  2. クリック作成するパラメータ セットを SQL クエリに接続します。 クエリが正常に検証されたかどうかは、プロジェクトのアセット ページで確認できます。

データ製品にカスタマイズ可能なクエリを追加する

プロジェクト オプションを使用してデータ プロダクトを作成します。

  1. Data Product Hub ナビゲーションメニューから、［ データ製品の作成 ］をクリックします。
  2. データ製品の名前を入力し、プロジェクトから追加タイル。
  3. クリックアイテムを選択クエリを追加します。 高度なフィルターを使用すると、データ資産のリストからクエリをすばやく簡単に見つけて追加できます。
  4. あなたの接続ステータス確認してドラフトを作成します。 ドラフトが正常に作成されると、データ製品の静的ビジュアライゼーションが生成され、公開後に消費者が閲覧できるようになります。

次のステップ

データ・プロダクトのドラフトを作成したら、データ・プロダクトを完成させるを参照して、データ・プロダクトの公開準備を完了させてください。

詳細情報