For AI agents: the complete documentation index is available at https://docs.dataplatform.ovh.net/ja/llms.txt, the full documentation bundle is available at https://docs.dataplatform.ovh.net/ja/llms-full.txt, and this page is available as Markdown at https://docs.dataplatform.ovh.net/ja/tutorials-external-datasets.md.
  • 🇯🇵 日本語
  • データモデルの作成と構築 - 外部データセット

    このチュートリアルでは、Lakehouse Managerを使用して「はじめに」チュートリアルの2番目のステップを行い、データ処理エンジンを使用して3番目のステップを行う方法を説明します

    目的

    このチュートリアルでは、Lakehouse Managerを使用して「はじめに」チュートリアルの2番目のステップ、データ処理エンジンを使用して3番目のステップを行う方法を説明します。

    データをテーブルで整理する

    プライマリスキーマを作成する

    データモデルにテーブルを追加する

    Warning

    外部データセットを作成したことを確認してください。外部データセットを作成する手順はこちらにあります。

    メタデータを抽出したら、次は Tables ダッシュボード に移動します。ここでは、すべてのデータの 統合されたクエリ可能なビューを構築 します。

    空の Tables ページは次のように表示されます。

    Lakehouse Manager

    All tables タブでは、すべてのデータにアクセスできます。 New View タブでは、データの一部のみを表示するビューを作成できます。これにより、大規模なチームでの協力が容易になります。このチュートリアルはシンプルなものなので、 All tables タブで作業してください。

    次に、プライマリテーブルとその属性を作成することに集中しましょう。

    まず、画面の左側にある青い ➕ アイコンの上にカーソルを合わせます。これにより、作成オプションが表示されます。

    • ファイルをアップロード
    • コネクタソースから作成
    • 空のテーブルを作成
    Info

    このチュートリアルでは、コネクタソースから作成 を進めます。

    Lakehouse Manager

    コネクタソースから作成 をクリックすると、前のステップで表示されたソースのリストが表示されます。追加したいソースをクリックし、 次へ をクリックして進みます。ここで、作成した外部データセットのいずれかを選択できます。ここでは、他のデフォルト設定を変更する必要はありません。

    Info

    テーブルを構築し、一度テーブルを読み込み、後で読み込みアクションを生成する オプションは無効にでき、各ステップを個別に実行することもできます。これは、Tables ガイドで詳しく説明されています。

    作成 をクリックし、同じ手順を2番目のテーブルでも繰り返します。

    Lakehouse Manager Lakehouse Manager
    Info

    Tables ページで変更を加えるたびに、視覚的な構成が 自動的に保存 されることに注意してください。

    この段階で、Tables ページは次のように表示されます。

    Lakehouse Manager

    テーブル内の一部の属性が 太字 で表示されていることに気づくかもしれません。プラットフォームは、それらが プライマリキー であったことを自動的に検出しました。つまり、テーブル内の各データ行を一意に識別するために使用される属性(または属性のセット)です。

    Info

    任意のテーブルのプライマリキーを手動で変更するには、マウスカーソルを属性の上に合わせ、 ⭐ アイコンをクリックします。

    Warning

    外部データセット を使用していると、テーブル内の一部の属性が 太字 で表示されていることに気づくかもしれません。プラットフォームは、それらが プライマリキー であったことを自動的に検出しました。つまり、テーブル内の各データ行を一意に識別するために使用される属性(または属性のセット)です。 Lakehouse Manager Engine は、より大規模なデータエンジンであり、デフォルトではプライマリキーの概念は存在しません。したがって、太字 で表示される属性は表示されません。

    Lakehouse Manager
    Info

    プラットフォームは、Analyzer ステップでキャプチャされたメタデータ情報を使用して、テーブルを自動的に作成し、属性名とタイプを割り当てます。提供されたソースファイルはそのまま使用できますが、実際のプロジェクトでは、Tables ページにドラッグアンドドロップする前に、Analyzer を使用してデータソースを確認する必要があります。

    テーブルを結合する

    Lakehouse Manager に、テーブル間の関係を伝える必要があります。

    親/子関係にあるテーブルを結合します。 は、特定の主題についての詳細情報を持つテーブルです。例えば、シカゴの特定の日付の天気です。 テーブルは、複数の親テーブルを参照します。別の言い方をすれば、子テーブルは親テーブルから値を継承します(現実の子供のように、ただし子供は2人以上の親を持つことができます!)。

    テーブル stations_rides は子テーブルです。日付と駅ごとの乗車情報を含みます。しかし、日付についての詳細情報は含まれていません。両方のテーブルに date がプライマリキーとしてあります。したがって、 chicago_calendar_full 親テーブルを stations_rides 子テーブルにリンクすると、1年間の各日の乗車情報に天気情報が自動的に追加されます。

    まず、 chicago_calendar_full 親テーブルをクリックして選択し、次にテーブルの下部にある白い円をクリックします。

    Lakehouse Manager

    子テーブル stations_rides に矢印をドラッグして、ドロップ/クリック解除します。画面は次のように表示されます。

    Lakehouse Manager

    集約テーブルを作成する

    次に、ソース(主に乗車、日付、温度)からすべての重要なデータを1つのテーブルに集約します。このテーブルは、最終アプリケーションで使用されます。集約テーブルは、複数のソーステーブルからデータを統合します。

    最初の集約テーブルを作成するには、青い ➕ アイコンをクリックします。 空のテーブルを作成 を選択すると、新しいテーブル構成が表示され、名前(例: dataset_history)を設定して保存できます。

    Lakehouse Manager

    次に、ソーステーブル stations_rides から datestation_id をテーブル dataset_history にドラッグアンドドロップし、これらの属性をプライマリキーとして設定します。

    Lakehouse Manager

    以下の属性を dataset_history に移動し、キーとして設定しないでください(これらは各行の単純なデータであり、一意ではないため)。

    元のテーブルドラッグアンドドロップする属性
    stations_rideslat / lng / rides / station_name
    chicago_calendar_fullmonth / temperature / week_day / week_day_label / weekend /
    Lakehouse Manager

    最後に、数値温度データを理解できるカテゴリ(寒い、暑いなど)に変換するのに役立つ新しい属性を作成する必要があります。

    まず、テーブル dataset_history をクリックすると、上部に ➕ アイコンが表示されます。これで、テーブル内で属性を作成または編集できます。

    属性を次のように定義します。

    属性名タイプ性質
    cat_temperature文字列次元
    Lakehouse Manager
    Info

    この属性は、現在物理的に指定されていませんが、心配しないでください! これは、別のコンポーネントである Data Processing Engine で間もなく行われます。

    Tables についてさらに学ぶ

    ビルドを完了する

    Warning

    最後の素早いチェック ✋! 次のステップに進む前に、データモデルがスクリーンショットと完全に同じであることを確認してください。属性が欠けている場合、チュートリアルの後続のステップで止まる可能性があります。

    Lakehouse Manager

    次に、青い ➕ アイコンの下にある Build アイコンをクリックして、実際にテーブルと属性をデータセットに作成/更新します。これにより、データがテーブルに読み込まれるわけではありません(これは次の記事で行われます)。これは、基盤となるデータセット内のテーブルと属性に論理スキーマを適用するだけです。

    Lakehouse Manager
    Info

    データの視覚的な論理スキーマは自動的に保存されますが、テーブルへの変更は、ビルドされない限りプラットフォームの他の部分に表示されません。

    このチュートリアルのビルドタスクは、数分で完了するはずです。完了したら、次に進むことができます。

    バーチャル属性で関連するメトリクスを追加する

    このモデルへのデータの物理的な処理(ETL/ELT)に進む前に、後で分析に使用する追加のメトリクスを準備しましょう。このチュートリアルに従って構築している最終アプリケーションには、特定の駅での1日の乗車数 を示すチャートが含まれています。

    Lakehouse Manager

    ただし、このチャートをプライマリソースに直接構築するための必要なデータはありません。特定の駅の1日の平均乗車数を示すメトリクスが必要です。このメトリクスは、クエリとダッシュボードで使用できます。

    しかし、プラットフォームを使用してそれをどのように計算しますか? その方法の1つは、バーチャル属性 を作成することです。バーチャル属性を使用すると、SQL式を計算できます。これらは オンデマンドで計算 され、データベースに保存されません。最終ダッシュボードのクエリまたはチャートで使用できます。

    Info

    バーチャル属性の追加または編集には、スキーマの再構築が必要ありません。

    Attributes ページに切り替えます。このページには、データモデル内のすべての物理的およびバーチャル属性と、プロジェクト内のラインナージが表示されます。

    Lakehouse Manager

    新しい属性 ボタンをクリックして、バーチャル属性を作成します。

    Lakehouse Manager

    作成ウィンドウでは、領域として Virtual を選択していることを確認します。

    Lakehouse Manager

    次に、これらの2つの属性とそれぞれのSQLコードを追加します。

    属性名SQL
    avg_rides_per_day_per_stationSUM(rides)/COUNT(DISTINCT CONCAT(CAST(date AS VARCHAR), CAST(station_id AS VARCHAR)))
    yearmonthSUBSTR(CAST(date as VARCHAR),1,7)

    yearmonth 属性は、 yyyy-mm 形式の年と月を提供します。後で使用します。

    Info

    インポートされたデータから新しい属性/メトリクスを生成するために、2つの異なる方法を使用したことに注意してください: テーブルに物理属性を追加するバーチャル属性 です。

    • 新しい物理属性を追加すると、ストレージを使用し、Data Processing Engine で物理的に定義する必要がありますが、これにより、データモデル全体を変更せずに、その仕様を編集できるため、より厳密になります。
    • バーチャル属性は、スケーリング時に修正する必要がある場合、管理が難しくなる可能性がありますが、素早く簡単に設定できます。

    Actions

    アクション は、データに対する単一の物理操作です。アクションは、ワークフロー と呼ばれる自動化されたデータ処理パイプラインを生成するために、ステージに組織化できます。

    Data Processing Engine の Actions メニューをクリックしてください。前のステップで自動的に生成された 2 つの Load アクションが表示されるはずです。

    DPE Actions

    これらの Load アクションは、Lakehouse Manager で作成したスキーマに従って、ソースからデータを物理的に抽出し、データウェアハウスに読み込みます。

    さらに多くのアクションを作成する

    Info

    Marketplace では、データ処理プロジェクトを開始するために、カタログ化されたアクションを10種類以上提供しています:load アクション、aggregate アクション、delete アクションなど。カタログに必要なものが見つからない場合は、custom アクションを使用して、データパイプラインの一部として Python 3+ の任意のコードを実行 できます。

    カスタムアクションについてさらに詳しく

    このチュートリアルでは、前の部分で作成した dataset_history テーブルにデータを集約するために使用されるアクションを作成します。

    New action をクリックし、Platform Store から Aggregate action テンプレートを選択します。

    DPE agg action 1

    集約アクションを構成するには、2 つの簡単なステップがあります。

    • (1) ソーステーブルを選択します: stations_rides
    • (2) 宛先テーブルを選択します: dataset_history

    数秒後、Data Processing Engine は自動的にすべての必要な結合条件を見つけ、属性をマッピングします。

    ドロップダウンメニューを使用して、結合条件を INNER join に変更します。これにより、dataset_history テーブルのレコードに null フィールドがないことを確保できます。

    DPE agg action 2

    属性は自動的にマッピングされています。属性 rides を見つけ、これは集約したいメトリクスです。これを SUM 関数に切り替えます。その他の場所では、MAX 関数をそのままにしておいてください:ほとんどの DBMS では、GROUP BY 句の一部ではない属性に集約句を適用する必要があります。

    DPE agg action 4

    最後に、以前に作成したカテゴリ属性 cat_temperature を定義します。下に示すように、青いオプションのドロップダウンで < map > (「マッピング」の略) オプションをクリックし、< sql > に切り替えます。

    DPE agg action 3

    以下の SQL コマンドをコピーして貼り付けます。

    CASE 
    WHEN MAX(chicago_calendar_full.temperature)<40 THEN 'very cold'
    WHEN MAX(chicago_calendar_full.temperature)<48 THEN 'cold'
    WHEN MAX(chicago_calendar_full.temperature)<55 THEN 'medium'
    WHEN MAX(chicago_calendar_full.temperature)<62 THEN 'hot'
    ELSE 'very hot'
    END
    Warning

    Aggregate action の構成で宛先属性をマッピングしないと、アクションを実行するとエラーが発生します。宛先フィールドを空のままにしたい場合は、マッピングされた属性のリストから単に削除してください。

    集約アクションについてさらに詳しく

    右上の Create をクリックします。

    DPE agg action 3

    これで、このチュートリアルに必要なすべてのアクションを生成しました

    Info

    もちろん、実際のプロジェクトでは、3 つ以上のアクションがある可能性があります。必要に応じて、アクションをフォルダに整理し、名前を変更できます。特にチームメンバーと協力して作業している場合は、複数のリポジトリを使用できます。アクションのリポジトリはバージョン管理でき、外部の Git リポジトリと同期することもできます。専用の製品ドキュメント ページを参照して、その方法をさらに詳しく学んでください!

    製品ドキュメントで Actions についてさらに詳しく

    Workflows

    ワークフローは、アクションを... アクションにするための映画の脚本のようなものです。 🎬

    ワークフロー内では、アクションが連続したステージに組織化されます。ステージ内では、すべてのアクションが並列で実行されますが、ステージは常に前のステージの後に実行されます。同じアクションを、同じワークフロー内で複数回使用できます。ワークフローは、アクションと同様に、手動で実行したり、スケジュールで実行したり、API 呼び出しでトリガーしたりできます。

    Info

    ステージは、計画した順序で1つずつ実行される ことを覚えておくことが重要です、ステージ内のアクションはすべて同時に実行されます これは、ステージ内のアクションの順序は重要ではないが、ワークフロー内のステージの順序は重要であることを意味します。

    最初のワークフローを作成するには、Workflow タブに移動し、New Workflow をクリックします。好みの設定に移動するか、ヘッダー名をダブルクリックして、新しい名前 Import Chicago Data を設定します。

    DPE workflow 1

    まず、Add a stage をクリックして、2 つの異なるステージを定義します。次に、各ステージにアクションを追加するには、ドロップダウン検索セレクターを使用します。各ステージのガイドとして、提供されたスクリーンショットに従います。

    DPE workflow 2

    ワークフローを作成 (create) した後、Play をクリックします。

    Info

    ワークフローを最初に実行するときは、数分 ⏳ かかる場合があります。合計時間は10分を超えないはずです。そうでない場合は、サポートチームにお問い合わせください。

    ワークフローが実行されている間、トリガーを使用して 毎日実行するようにスケジュール することができます。

    ワークフローの Preferences タブに移動し、左下のトリガーウィジェットを下にスクロールします。 +Add をクリックします。

    DPE workflow 4

    トリガーの種類を CRON に、モードを Simple に選択します。 Daily タブに移動し、下の画像に示すように、オプションのリストから Every 1 day(s) を選択します。

    DPE workflow 4

    Confirm ボタンをクリックして、任意の名前で新しいトリガーイベントを作成し、デフォルトで Trigger イベントテーブルに表示される Launch Endpoint の下に追加します。

    DPE workflow 5
    Info

    ワークフローの好みの設定では、さらに多くの設定を行うことができます。具体的には、水平および垂直にスケーリング することができます。データ処理を加速するために ワークロードセグメンテーション を使用し、環境 を使用してこれらの設定を繰り返し使用するために保存することもできます。

    実行好みの設定についてさらに詳しく

    Warning

    ワークフローに修正を加えた場合は、画面の右上の Save ボタンをクリックすることを忘れないでください。アクションはバージョン管理できるリポジトリに保存されますが、ワークフローや環境はそのようなものではありません。オートセーブ はワークフローと環境の両方に対して無効になっています。

    ジョブ

    このセクションを締めくくるために、Data Processing Engineコンポーネントの最後のタブであるジョブについて、いくつかの言葉を紹介します。

    ジョブタブは、Data Processing Engineでトリガーされたすべての実行をまとめ、高度なメトリクスレポートを含みます。ジョブは、実行中、キューイング中、過去の実行の3つの主要なカテゴリにリストされます。最後に実行されたジョブを確認することで、たった今起動したワークフローの状態を確認できます。

    DPE ジョブ

    これで、Getting Started チュートリアルのData Engineeringセクションは完了しました 🌟

    データが正しく読み込まれたかどうかを確認する良い方法は、Lakehouse Managerに戻り、テーブルに読み込まれた行数を確認することです。リストビューモードを開き、rows列を確認してください。フィールドに数字が表示されている場合(読み込まれた行数を示す)は、すべてうまく動作しました。

    読み込まれた行

    Getting Startedチュートリアルを続ける場合は、step-4: the Analytics Managerに直接進むことができます。

    さらに詳しく

    当社のソリューションを実装するためのトレーニングや技術サポートが必要な場合は、営業担当者にお問い合わせください、またはこのリンクをクリックして見積もりを依頼し、当社のプロフェッショナルサービスの専門家にプロジェクトのカスタム分析を依頼してください。

    Data Platformを構築するチームと直接質問し、フィードバックを共有し、交流するには、専用のDiscordチャネルに参加してください。

    OVHcloudサービスについてサポートが必要な場合は、当社のヘルプセンターでリクエストを作成してください。

    当社のユーザーコミュニティに参加してください。