カスタム テーブルと列を作成する

データ ソースにカスタム列またはカスタム テーブルを生成するための SQL を記述します。Atlassian Analytics では、データ結果が保存されるのではなく、SQL が保存されてビジュアル モード クエリに直接挿入されます。

カスタムの列とテーブルの一般的なユース ケースをいくつか紹介します。

• CASE ステートメントを使用して、行を分類する列を作成します。

• 複数のテーブルを結合するカスタム テーブルを作成して、データベースをフラット化します。

• セントからドルへの換算など、簡単な計算列を作成します。

• チームメイト用に標準的な主要メトリックと計算を定義します。

カスタム列を作成する

カスタム列を作成するには:

1. グローバル ナビゲーションから [Data (データ)] を選択します。

2. カスタム列を追加するデータ ソースを選択します。

3. [スキーマ] タブに移動します。

4. カスタム列を追加するテーブルを展開します。

5. Select Add custom column.

6. カスタム列を作成するために必要な設定と SQL を指定します。

7. Select Add column to save.

When you create a custom column, it will appear like any other column in the table when you’re in the Schema tab. But when you view its column properties, you’ll see that its SQL type is custom.

カスタム列の準備ができたら、それをビジュアル モードのクエリで使用できます。カスタム列の使用方法に関する詳細をご確認ください。

カスタム列の設定

グループ化

If you’re creating a category or other groupable value, select Dimension. If your value is numeric, select Measure.

集計

If you’re aggregating a measure, such as taking a count or an average of something, select the Aggregated checkbox.

タイプ

If your custom column is a dimension, select the data type of your column. Measures are given type Number by default.

これは、カスタム列を指定のデータ タイプに変換するためのものではありません。Atlassian Analytics に対して列の使用方法を指示することだけを目的としています。列のデータ タイプを変換するには、カスタム列の SQL クエリでデータ ソースに固有の構文を使用します。

SQL

カスタム列を生成するための SQL クエリを指定します。該当するデータ ソース タイプに固有の SQL 構文を必ず使用してください。

カスタム列では、その作成先のテーブルの列のみを使用できるため、SQL を指定する際には、SELECT キーワードまたは FROM 句を含めないでください。スキーマ内の複数のテーブルを使用するカスタム列を作成する必要がある場合は、代わりにカスタム テーブルを作成する必要があります。

カスタム列の例

jira_issue テーブルでは、time_spent_secs 列を常に分に変換するのが望ましいと考えられます。チャートを作成するたびに time_spent_secs を 60 で割るのではなく、それを自動的に行うカスタム列を作成します。

このカスタム列を作成するには、次のようにします。

1. In the Schema tab of our data source’s settings, we expand the Jira issue table.

2. We select Add custom column.

3. カスタム列の名前と説明を指定します。

4. For the Grouping, we select Measure because our custom column will only contain numeric values.

5. We deselect Aggregated.

6. For the SQL, we use time_spent_secs/60.

7. We select Add column to save.

カスタム テーブルを作成する

カスタム テーブルは、カスタム列とは異なり、スキーマ内の複数のテーブルの列を使用して作成できます。これは、2 つのテーブルをフラット化する場合に特に役立ちます。

カスタム テーブルを作成するには:

1. グローバル ナビゲーションから [Data (データ)] を選択します。

2. カスタム テーブルを追加するデータ ソースを選択します。

3. [スキーマ] タブに移動します。

4. Select Add custom table.

5. カスタム テーブルに名前を付けます。

6. カスタム テーブルを作成するための SQL を指定します。カスタム テーブルは、カスタム列とは異なり、完全な SQL ステートメントを使用して作成できます。ただし、SQL ステートメントの末尾をセミコロン (;) にしないでください。Atlassian Analytics では、この SQL がサブクエリとしてビジュアル モード クエリに注入されるため、末尾にセミコロンがあると失敗します。

7. Optionally select Format query to apply formatting to your SQL statement.

8. Select Add table to save.

When you create a custom table, it will appear like any other table in the Schema tab You’ll know which tables are custom tables because they’ll have a tag labeled Custom table next to their table name.

カスタム テーブルが準備できたら、ビジュアル モードのクエリで使用できます。カスタム テーブルの使用方法に関する詳細をご確認ください。

Atlassian Analytics により SQL が評価され、エラーがあればスキーマ ビューアーにエラー メッセージが表示されます。SQL ステートメントにエイリアスを設定することは避けてください。代わりに、最初にカスタム テーブルを保存してから、通常のテーブルで一般に行うように列エイリアンスを設定します。SQL クエリ内のエイリアスが列名と一致しない場合、該当する列を照会したときにエラーが発生します。