次の方法で共有

AdventureWorks テンプレート ドキュメント

このドキュメントでは、Microsoft の AdventureWorks パイプライン テンプレートを設定して使用し、Azure Synapse Analytics と Retail データベース テンプレートを使用して AdventureWorks データセットの探索をすぐに開始する方法について説明します。

概要

AdventureWorks は、Microsoft アプリケーションのデモに使用される架空のスポーツ用品小売業者です。 このケースでは、Synapse Pipelines を使用して小売データを Retail データベース テンプレートにマップし、Azure Synapse 内でさらなる分析を行う方法の例として使用しています。

前提条件

テンプレートを見つける

テンプレートを見つけるには、次の手順を実行します。

  1. Synapse ワークスペースに移動します。 ホーム ページから、[ナレッジ センター] を選択し、[ギャラリーの参照] を選択します。 Synapse ギャラリーが開きます。 ワークスペースにインストールするデータセット、スクリプト、パイプラインなどを検索することができます。

  2. [パイプライン] を選択し、「AdventureWorks」というキーワードで検索結果をフィルター処理します。

  3. AdventureWorks テンプレートを選択し、[続行] を選択します。

これらの手順を実行すると、テンプレートの概要ページが表示されます。

テンプレートを構成する

このテンプレートは最小限の構成で済むように設計されています。 テンプレートの概要ページからパイプラインの初期開始構成のプレビューを確認し、[パイプラインを開く] を選択して、自分のワークスペースにリソースを作成することができます。 テンプレート内の 31 個のリソースがすべて作成されたという通知が表示され、コミットまたは発行前にこれらを確認することができます。 テンプレートには以下のコンポーネントがあります。

  • 17 個のパイプライン: これらは、データがターゲット テーブルに正しく読み込まれるようにスケジュールされており、ソース テーブルごとの 1 つのパイプラインに加え、スケジュールされたものが含まれています。
  • 14 個のデータ フロー: ソース システムからデータを読み込み、ターゲット データベースに配置するためのロジックが含まれています。

AdventureWorks データセットを別のデータベースに読み込んだ場合は、そのデータセットを指すようにデータフロー ソースを更新することができます。 それ以外の場合は、次の手順で、テンプレートに定義されているスキーマと一致するソース DB とターゲット DB を作成します。

データセット、ソース モデル、ターゲット モデル

Excel 形式の AdventureWorks データセットは、この GitHub サイトからダウンロードできます。 さらに、ソース データベースとターゲット データベースの両方のスキーマ定義にアクセスできます。 Synapse のデータベース デザイナーを使用して、先ほどダウンロードした Excel のスキーマを使用してソース データベースとターゲット データベースを再作成します。 データベース デザイナーの詳細については、このドキュメントを参照してください。

データベースを作成したら、ワークスペース DB のソースとシンクの設定のドロップダウンを編集して、データ フローが正しいテーブルを指していることを確認します。 データをソース モデルに読み込むには、サンプル データセットに用意されている CSV ファイルを、テーブルに指定されている正しいフォルダーに配置します。 それが完了したら、後はパイプラインを実行するだけです。

パイプラインのトラブルシューティング

パイプラインが正常に実行されなかった場合にエラーを確認するには、主にいくつかの点があります。

  • データセット スキーマ。 CSV ファイルのデータ設定が正確であることを確認します。 行ヘッダーを含めた場合は、データベース テーブルの [行のヘッダー] オプションがオンになっていることを確認します。
  • データ フロー ソース。 スキーマ例に指定されているものと異なる列またはテーブル名を使用した場合は、データ フローのステップを実行して、列が正しくマップされていることを確認する必要があります。
  • データ フロー シンク。 ターゲット データベース上のスキーマとデータ形式の構成は、データ フロー テンプレートと一致させる必要があります。 前述のように、何か変更があった場合は、それらの項目をそろえる必要があります。

関連するコンテンツ