「日付バケット」コントロールをセットアップする

「日付バケット」コントロールを使用すると、接続されたチャートに使用される時間バケットを変更できます。

「日付バケット」コントロールのセットアップには、主に次の 2 つの手順が必要です。

1. ダッシュボードに「日付バケット」コントロールを作成します。

2. 「日付バケット」コントロールをチャートに接続します。

「日付バケット」コントロールを作成する

ダッシュボードに「日付バケット」コントロールを追加する方法は次のとおりです。

1. 「日付バケット」コントロールを追加するダッシュボードを開きます。

2. ダッシュボードのサイドバーから [Add control] > [Date bucket] を選択します。コントロールを設定するためのポップアップが表示されます。

3. オプションで、コントロールの [Name] を変更します。

4. 既定値には、ダッシュボードを開くときに使用する既定の時間バケットを選択します。

5. 追加 を選択します 。

6. 新しく作成した「日付バケット」コントロールをダッシュボードのどこかに配置します。

「日付バケット」コントロールをチャートに接続する

「日付バケット」コントロールを作成したら、フィルターに使い始める前に、そのコントロールをチャートに接続する必要があります。クエリで対応するダッシュボード変数を使用することで、チャートに接続します。

ビジュアル モード クエリの場合

ビジュアル モード クエリを使用して「日付バケット」コントロールをチャートに接続する方法は次のとおりです。

1. 新しいチャートを作成するか、ダッシュボードの既存チャートを編集して、チャート エディターを開きます。日付または日時の列を含むチャートが必要です。

2. 日付または日時の列を含むビジュアル モード クエリを編集します。

3. 列の集計メニューを開き、次に「日付バケット」コントロールの名前を選択します。

4. [Run query (クエリを実行)] を選択します。結果テーブルは、データに新しいフィルターが適用された状態で更新されます。

5. チャートを保存するには、[Save to dashboard] を選択します。

SQL モード クエリの場合

次の形式を使用してダッシュボード変数を使うことで、SQL モード クエリの「日付バケット」コントロールを接続します。 {DATE_BUCKET_NAME.BUCKET('"table_name"."column_name"')}

• DATE_BUCKET_NAME をコントロールの名前に置き換えます。

• テーブル列の参照は一重引用符で囲む必要があります。

• Atlassian Data Lake にクエリを実行する場合は、二重引用符 (") をバッククォート (`) に変更してください。

• GROUP BY 句では、SELECT ステートメントで提供されたものと同じ列エイリアスを使用します。

これは「日付バケット」コントロールを Jira 作業項目の作成日に関連付ける方法の例です。

「日付バケット」の値を取得する

「日付バケット」コントロールの値を取得するには、{DATE_BUCKET_NAME} を使用します。値はすべて小文字の文字列 (day、week、year など) として返されます。これは「日付バケット」コントロールの現在値に応じて異なる計算を実行する場合に便利です。