データ ソースのタイム ゾーンのサポート

タイム ゾーンのサポートは、データ ソースごとにオンまたはオフにできます。たとえば、データ ソースがすでに目的のタイム ゾーンにある場合は、そのデータ ソースに対するタイム ゾーンのサポートを無効にできます。

Atlassian Analytics でタイム ゾーンを設定して、チャートの日付と時刻の値を調整します。また、相対的な日付変数 ({TODAY}、{CURRENT_MONTH.START} など) とフィルターも調整します。

すべてのダッシュボードにはタイム ゾーンが設定されています。初期設定で、新しいダッシュボードはワークスペースの既定のタイム ゾーンを使用しますが、必要に応じてダッシュボードのタイム ゾーンを個別にカスタマイズできます。

タイム ゾーンのサポートに用意されているオプション

タイム ゾーン変換をデータに適用するかどうか、どのタイプのタイム ゾーン変換を適用するかをデータ ソースごとに選択できます。データ ソース設定でタイム ゾーン サポートを変更する方法をご紹介します。

タイム ゾーンのサポートには、次の 3 つのオプションがあります。

無効

データにタイム ゾーン変換を適用しません。データ ソースで目的のタイム ゾーンがすでに使用されている場合は、この設定を使用します。

タイム ゾーン

クエリに SET TIME ZONE 'timezone_name' 句を追加します。

[Time zone] オプションは、名前が付けられたタイム ゾーンをサポートするデータ ソースにのみ使用できます。

UTC オフセット

UTC の時刻から時間を加算または減算して、データ ソースの datetime 値を調整します。UTC オフセットは、ダッシュボードのタイム ゾーン設定に基づいて自動的に入力され、必要に応じて夏時間も考慮されます。

タイム ゾーンと UTC オフセット

特に SQL モード クエリを主に使用する場合は、[UTC offset] オプションに [Time zone] オプションを使用することをお勧めします。

次のデータ ソースには、タイム ゾーンのサポート オプションがあります。

• Amazon Redshift

• MySQL

• PostgreSQL

タイム ゾーン構文

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

データ ソースの "タイム ゾーン" が選択されている場合、Atlassian Analytics は適切な構文を自動的に適用して、データ型が timestamptz または timestamp である列の値を変換します。ただし、MySQL でサポートされるのは、データ型が timestamp である列の値変換だけです。

SQL モード クエリの場合

SQL モード クエリで「タイム ゾーン」オプションが機能するようにするには、日時列に書式設定を追加する必要があります。

SQLモード クエリに必要な構文が不明な場合は、次の手順に従います。

1. ビジュアル モード クエリに日付列を追加します。

2. 列の集計メニューで目的の時間バケットを選択します (例えば、日、時間など)。

3. 高度なドロワーを展開して、自動生成された SQL をプレビューし、列に適用されている構文を表示します。

PostgreSQL および Redshift クエリの場合

1. TO_CHAR または ::text を使用して、timestamp 列と timestamptz 列をテキストにキャストします。

2. SELECT ステートメントでは、timestamp 列で次の構文を使用します。datetime_column AT TIME ZONE 'UTC'

たとえば、Created at というタイムスタンプ列がある場合、SQL クエリに次の SELECT ステートメントを使用します。

MySQL クエリの場合

次のクエリを実行して、MySQL データベースに必要なタイム ゾーン テーブルがロードされているかどうかを確認します。SELECT * FROM mysql.time_zone_name;

結果がない場合は、タイム ゾーン テーブルを入力する方法の手順に関する MySQL のドキュメントをご覧ください。

タイム ゾーン テーブルをデータベースに読み込みたくない場合は、代わりにデータ ソースの UTC オフセットを使用します。

Google BigQuery クエリの場合

Google BigQuery は、タイムスタンプのデータ型を持つ列の UTC オフセットのみをサポートします。

timestamp 列で次の構文を使用します。TIMESTAMP_ADD(timestamp_column, INTERVAL {UTC_OFFSET.RAW} HOUR)

SQL Server クエリの場合

SQL Server は、データ型が日時の列に対する UTC オフセットのみをサポートします。

datetime 列で次の構文を使用します。DATEADD(hour, {UTC_OFFSET.RAW}, datetime_column)