特定の条件に基づいてデータの集計とセグメント化を行うには、Workivaプラットフォーム内にテーブルおよびスプレッドシートとして保存されているデータに基づいてクエリを作成します。例えば、場所ごと、または前年比で収入の分析を行うためにクエリを作成することなどが可能です。
クエリを作成する方法は次の通りです。
- ドラッグアンドドロップのビルダーモードでフィールド、フィルタ、およびリレーションシップを定義する。
- 構造化照会言語（SQL）に精通したユーザーの場合は、SQLエディタで構文を作成する。
- 開始点として既存のクエリをコピーする。
- Workiva接続を介し、[クエリを作成]コマンドを使用して、自動化ワークフロー（またはチェーン）を構築する。
注： クエリの名前または説明の表示や編集を行うには、[クエリのプロパティ]をクリックします。
クエリを構築する
クエリを作成する際には、クエリに含めるソースを選択し、さらにクエリに関する次の事項を定義します。
- フィールド：クエリ結果に表示する情報を定義するため
- フィルター：特定のアカウント、地域、または期間にフォーカスを置くなど、選択した条件を満たすレコードのみを含めるため
- 計算：複数の列に基づいて値を導き出すため（例：列の合計や文字列の連結など）
- リレーションシップ：複数のソースからの関連データを結合させるため
ステップ1：クエリを作成する
- [作成する]をクリックし、[クエリ]を選択します。
- [クエリのプロパティ]の右パネルから：
- クエリとその意図を識別するために、一意の名前と説明を入力します。
- [制限]に、返されるレコードの最大数を入力します。
- 重複を避けるなどの目的のために異なる値を持つレコードのみを返すには、[個別の行のみを表示]を選択します。
ステップ2：クエリのソースを追加する
クエリのフィールドまたはフィルターとして含めるデータを選択するには、[ソース]の左側のパネルから[ソースの追加]をクリックし、Workivaプラットフォームでアクセス可能なテーブルとスプレッドシートのソース列から選択します。
ステップ3：クエリのフィールドを定義する
特定の列または完全なソースをクエリ結果に追加するには、[ソース]パネルでそれらを選択し、[フィールドに追加]をクリックするか[フィールド]タブの下にドラッグします。
注：[ソース]パネルの参照をスムーズに行うために、[すべて展開する]、または[すべて折りたたむ]のどちらかをクリックして、すべての列を表示または非表示にすることができます。特定のソースまたは列を検索するには、[フィルターを表示する]をクリックして名前で検索します。
クエリのフィールドを追加したら、それぞれのプロパティまたは計算を必要に応じて定義します 。
ステップ4：クエリのフィルタとパラメータを設定する
特定の条件を満たすレコードのみを結果に含めるには、フィルターを作成して、特定のアカウントまたは期間に当てはまる結果に制限するなど、クエリの条件を設定します。
クエリを実行する際に、リアルタイムでデータをスライスしてダイスするなどの条件を選択するには、フィルターまたは計算で使用するパラメータを作成します。
ステップ5：ソースのリレーションシップを定義する
クエリに複数のソースを含める場合は、[リレーションシップ]タブを選択し、それらのレコードを結合または組み合わせる方法を定義します 。
| 結合 | 戻り値 |
|---|---|
| 左結合 | 左側のソースからのすべてのレコード、および 右側のソースで一致するすべてのレコード |
| 右結合 | 右側のソースからのすべてのレコード、および 左側のソースで一致するすべてのレコード |
| 内部結合 | 両方 のソースで一致したレコードのみ |
| 完全結合 | 両方 のソースからのすべてのレコード |
ステップ6：クエリ結果をレイアウトする
デフォルトでは、クエリ結果はフラットに表示されます。この場合、すべてのフィールドはテーブルのように個別の列として表示されます。データの要約をスムーズに行うため、選択したディメンションに基づいてクロス集計として水平方向および垂直方向に結果をレイアウトすることができます。クロス集計を設定するには、[レイアウト]を選択して[クロス集計]をクリックし、行、列、値として使用するフィールドを指定します 。
ステップ7：クエリを保存して権限を設定する
- [保存]をクリックします。
注：クエリを保存すると、[リレーションシップが必要]として表示されるすべてのソースは自動的に削除されます。これらのソースを保持するには、他のソースとのリレーションシップを定義する必要があります 。
- 必要に応じてクエリの名前と説明を編集します。
- クエリを保存するフォルダを選択し、[クエリを保存]をクリックします。
- クエリを他のユーザーと共有するには、[権限]をクリックし、各共同編集者のアクセス権限を選択します 。
- [保存]をクリックします。
クエリをSQL構文として作成する
SQLに精通したユーザーの場合は、SQLエディタで構文を作成することができます。
注：データの整合性を確保するために、SQLエディタは[SELECT]などの読み取り専用ステートメントに対応していますが、[INSERT]や[DELETE]などの読み取り/書き込みステートメントには対応していません 。
- [作成する]をクリックし、[クエリ]を選択します。
- [プロパティ]の右パネルから：
- クエリとその意図を識別するために、一意の名前と説明を入力します。
- [制限]に、返されるレコードの最大数を入力します。
- 重複を避けるなどの目的のために異なる値を持つレコードのみを返すには、[個別の行のみを表示]を選択します。
- [ソース]の左側のパネルから[ソースを追加]をクリックし、Workivaプラットフォーム上でアクセス可能なテーブルやスプレッドシートの列からクエリ内のフィールドまたはフィルタとして含めるデータを選択します。
- [SQL]をクリックし、ソースとフィルタの条件に基づいて結果に含めるデータを定義するためにSQL構文を入力します。
注：クエリの複雑さによっては、SQLエディタの開始後に[ビルダー]をクリックすると構文を保持できない場合があります。
ソースまたは列を構文に含める作業を素早く行うには、[ソース]パネルでソースまたは列を右クリックし、[クエリに追加]を選択します。注：[ソース]パネルの参照をスムーズに行うために、[すべて展開する]、または[すべて折りたたむ]のどちらかをクリックして、すべての列を表示または非表示にすることができます。特定のテーブルまたは列を探すには、[フィルターを表示する]をクリックして名前で検索します。
- データをリアルタイムでスライスしてダイスするなど、特定の条件を満たすレコードのみをクエリの結果に含めるには、クエリを実行する際にパラメータを選択します。クエリのパラメータを定義するには、[パラメータを作成]または[パラメータ]をクリックして、フィルタリングするデータ型とそのオプションの表示方法を指定します 。
注：クエリ結果を常に特定のレコードにスコープするなど、永続的なフィルタを設定するには、条件をSQL構文として定義します。
- デフォルトでは、クエリ結果はフラットに表示されます。この場合、すべてのフィールドはテーブルのように個別の列として表示されます。データの要約を行うため、選択したディメンションに基づいてクロス集計として水平方向および垂直方向に結果をレイアウトすることができます。クロス集計を設定するには、[レイアウト]を選択して[クロス集計]をクリックし、行、列、値として使用するフィールドを指定します 。
- [保存] をクリックし、クエリの保存先フォルダを選択して[クエリを保存]をクリックします。
- 他のユーザーとクエリを共有するには、[権限]をクリックして各共同編集者のアクセス権限を選択し、[保存]をクリックします。
既存のクエリで開始する
作成を容易に行うために、類似する内容のクエリのコピーを開始点として保存できます。
- 既存のクエリをコピーするには、次のいずれかの方法を実行します。
- クエリで、[保存]、[名前を付けて保存]をクリックする。
- [ホーム]からクエリのメニューを開き、[コピー]を選択する。
- クエリで、[保存]、[名前を付けて保存]をクリックする。
- 新しいクエリの名前、説明、場所を入力し、[クエリを保存]をクリックします。
- 必要に応じて、新しいクエリのフィールド、フィルタ、パラメータ、リレーションシップ、または構文の内容を更新します。
- [保存]をクリックします。
クエリをリセットする
ビルダーまたはSQLエディタで、クエリへに加えた変更を取り消して以前保存したバージョンに戻すには、[リセット]をクリックします。