データ ソースのタイム ゾーンのサポート
タイム ゾーンのサポートは、データ ソースごとにオンまたはオフにできます。たとえば、データ ソースがすでに目的のタイム ゾーンにある場合は、そのデータ ソースに対するタイム ゾーンのサポートを無効にできます。
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モード クエリに必要な構文が不明な場合は、次の手順に従います。
-
ビジュアル モード クエリに日付列を追加します。
-
列の集計メニューで目的の時間バケットを選択します (例えば、日、時間など)。
-
高度なドロワーを展開して、自動生成された SQL をプレビューし、列に適用されている構文を表示します。
PostgreSQL および Redshift クエリの場合
-
TO_CHARまたは::textを使用して、timestamp 列と timestamptz 列をテキストにキャストします。 -
SELECTステートメントでは、timestamp 列で次の構文を使用します。datetime_column AT TIME ZONE 'UTC'
たとえば、「
Created at
」 というタイムスタンプ列がある場合、SQL クエリに次の
SELECT
ステートメントを使用します。
SELECT TO_CHAR(("Created at" AT TIME ZONE 'UTC'), 'YYYY-MM-DD"T"HH24":"MI:SS')
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)
この内容はお役に立ちましたか?