詳細情報:
Data 360 SQL の移行に関する考慮事項、ガイドライン、および制限事項 (ベータ)
カスタム SQL クエリを Data 360 SQL に移行するときは、次の考慮事項、ガイドライン、制限事項に留意してください。
考慮事項
- Data 360 SQL では、従来の TrinoSQL バージョンではなく、Data 360 Direct SQL (HyperSQL) バージョンが使用されます。
- 従来の SQL と Data 360 SQL では、NULL 値の処理が異なります。従来の SQL では、NULL 値は常に最後に配置されます。Data 360 SQL は昇順の場合はデフォルトで [NULLS LAST] に設定されますが、降順の場合は [NULLS FIRST] に変更されます。
- Data 360 SQL はオフセット表記 (+00:00 など) を使用して日付を UTC で返しますが、従来の SQL は Zulu サフィックス (Z など) を使用します。
- Data 360 SQL では、大規模データクエリがサポートされ、従来の SQL と比較してエクスペリエンスページ時間 (EPT) が改善されています。
- 基準値が同じ場合、従来の SQL と Data 360 SQL ではデフォルトのタイブレークロジックが異なります。このため、タイブレークのシナリオでは 2 つのシステム間で行の順序が異なります。この視覚的な行シフトは予期される動作であり、データは失われません。
- Data 360 SQL では、値テーブルアセットのページネーションがサポートされ、無限スクロールでデータをオンデマンドで取得することで、大規模なデータセットを効率的に処理できます。
ガイドライン
- カスタム SQL ウィジェットを移行する前に、ダッシュボード JSON またはアセット XMD ファイルをバックアップします。このステップでは、条件付き書式ルールが保持されます。
- クエリが正しく機能するように、すべての列の別名と識別子を二重引用符で囲みます。Data 360 SQL では大文字と小文字が区別され、データに完全に一致するにはこの形式が必要です。
- 条件付き書式の破損を防ぎ、自由形式のクエリで大文字と小文字の一貫性を維持するには、SELECT Field_c AS "Field_c" などの別名を使用します。従来の SQL と Data 360 SQL のどちらも、別名を使用する場合、別名が引用符で囲まれていない場合でも、クエリで定義された大文字と小文字が保持されます。ただし、別名のない項目の場合、Data 360 SQL は元のデータソースの大文字/小文字に戻ります。
- TO_UNIXTIME などの従来の SQL 関数のクエリを確認し、Data 360 SQL の同等の関数に変換します。
- データの正確性を維持するには、クエリに NULLS LAST を明示的に追加するか、並び替えロジックを確認します。Data 360 SQL ではデフォルトの null 順序が変更されるため、テーブルとグラフで予期しない結果になります。
- UI でのデータの表示の問題を回避するために、項目ごとに一意の別名を使用します。
- ダッシュボードが機能し続けるように、カスタム SQL ウィジェットでグローバル検索条件を使用する場合、ファセットが正しく機能することを確認します。ネストされた複雑な SQL では、絞り込みの問題が発生することが多く、データが不正確になったり、視覚化が損なわれたりします。
- テーブルウィジェットで [ページ設定された読み込みを無効化] オプションを有効にしても、クエリはすぐに再実行されません。テーブルには、以前のページ設定された状態から切り捨てられたデータが表示されます。すべての行を読み込むには、ダッシュボードを保存して再読み込みします。問題が続く場合は、次の点を確認してください。
- ステップが従来の集計種別である。
- データ SQL とページネーションゲートが有効になっている。
- サポートされている構文および分析関数にアクセスするには、カスタム SQL エディターで Data 360 SQL オプションの横にある [情報] アイコンをクリックします。
制限事項
- キーの大文字/小文字が想定された形式と一致しない場合、色とスタイルは表示されなくなります。この問題は、Data 360 SQL ではキーの元の大文字/小文字が保持されますが、従来の XMD マッピングでは通常小文字のキーが想定されているために発生します。
- Data 360 SQL には、一部の従来の SQL 関数に対する直接的な同等機能がありません。この不一致により、移行時に自由形式の数式が壊れます。
この記事で問題は解決されましたか?
ご意見をお待ちしております。
