ノートブックを実行してデータを変換する

Notebook アクティビティを使用して、data Factory パイプラインの一部としてMicrosoft Fabricで作成したnotebooksを実行します。 ノートブック を使用すると、Apache Spark ジョブを実行して、データ ワークフローの一部としてデータを取り込んだり、クリーンアップしたり、変換したりできます。 Fabricでパイプラインに Notebook アクティビティを簡単に追加できます。このガイドでは、各手順について説明します。

前提条件

開始するには、次の前提条件を満たしている必要があります。

• プロビジョニングされた capacity を持つMicrosoft Fabric テナントにアクセスできる必要があります。 無料試用版でFabricをお試しください。
• Fabric workspaceその容量に割り当てられます。

• ワークスペースにノートブックが作成されている。 新しいノートブックを作成するには、「ノートブックMicrosoft Fabric作成方法を参照してください。

ノートブック アクティビティを作成する

1. ワークスペースに新しいパイプラインを作成します。

2. パイプラインの [アクティビティ] ペイン内でノートブックを検索し、それを選択してパイプライン キャンバスに追加します。

   

3. まだ選択されていない場合は、キャンバスで新しいノートブック アクティビティを選択します。

   

   [全般設定] タブを構成するには、全般設定のガイダンスを参照してください。

ノートブックの設定を構成する

[Settings](設定) タブを選択します。

[ 接続] で、ノートブックの実行の認証方法を選択し、必要な資格情報を指定します。

[ノートブック] ドロップダウンから既存のノートブックを選択し、必要に応じてノートブックに渡すパラメーターを指定します。

ノートブック アクティビティでの Fabric ワークスペース ID (WI) の使用

1. ワークスペース ID を作成する

   ワークスペースで WI を有効にする必要があります (読み込みに少し時間がかかる場合があります)。 Fabric ワークスペースにワークスペース ID を作成します。 WI はパイプラインと同じワークスペースに作成する必要があることに注意してください。

   ワークスペース ID に関するドキュメントを確認してください。

2. テナント レベルの設定を有効にする

   次のテナント設定を有効にします (既定では無効になっています):Service プリンシパルはパブリック API Fabric呼び出すことができます。

   この設定は、Fabric管理ポータルで有効にすることができます。 この設定の詳細については、 管理者 API のサービス プリンシパル認証の有効化に関する記事を参照してください。

3. ワークスペース ID にワークスペースのアクセス許可を付与する

   ワークスペースを開き、[アクセスの管理] を選択し、ワークスペース ID にアクセス許可を割り当てます。 ほとんどのシナリオでは、共同作成者アクセスで十分です。 ノートブックがパイプラインと同じワークスペースにない場合は、パイプラインのワークスペースで作成したワークアイテム (WI) に、ノートブックのワークスペースで少なくとも「共同作成者」のアクセス権を割り当てる必要があります。

   ワークスペースへのアクセス権をユーザーに付与する方法に関するドキュメントを参照してください。

Notebook アクティビティの基本パラメーターの自動設定

ベース パラメーターを自動的に設定 すると、ノートブックで定義されているパラメーターが自動的に検出され、パイプラインの作成時に Notebook アクティビティに設定されます。 この機能により、手動構成が減り、エラーが回避され、パイプラインがノートブック ロジックに合わせて維持されます。

前提条件

• ノートブックには パラメーター セルを含める必要があります。
• このセルで定義されている変数のみがパラメーターとして検出されます。

どのように機能するのか

Notebook アクティビティでノートブックを選択する場合:

• [設定] で [基本パラメーター] に切り替えると、ノートブックからパラメーターが自動的に取得されます。
• [基本パラメーター] セクションには、次のものが設定されます。
  • Names
  • 種類
  • 既定の値

自動設定されたパラメーターを確認し、(必要に応じて) パラメーター値をオーバーライドできます。

主要な動作

• ノートブックを選択すると、パラメーターが自動的に設定されます。
• ノートブックを変更すると、パラメーター リストが更新されます。
• パラメーターセルなし → パラメーターは入力されません。

セッション タグを設定する

ノートブック ジョブの実行にかかる時間を最小限に抑えるために、必要に応じてセッション タグを設定できます。 セッション タグを設定すると、既存の Spark セッションを再利用するように Spark に指示され、起動時間が最小限に抑えられます。 セッション タグには任意の文字列値を使用できます。 セッションが存在しない場合は、タグ値を使用して新しいセッションが作成されます。

パイプラインを保存して実行またはスケジュールする

パイプライン エディターの上部にある [ ホーム ] タブに切り替え、[保存] ボタンを選択してパイプラインを保存します。 [ 実行 ] を選択して直接実行するか、特定の時間または間隔で実行をスケジュールする スケジュール を設定します。 パイプラインの実行の詳細については、「パイプラインの実行 をスケジュールする」を参照してください。

実行後、パイプラインの実行を監視し、キャンバスの下にある [出力 ] タブから実行履歴を表示できます。

既知の問題

• サービス プリンシパルを使用してセマンティック リンク コードを含むノートブックを実行するには、機能上の制限があり、セマンティック リンク機能のサブセットのみをサポートします。 詳細については、 サポートされているセマンティック リンク関数 を参照してください。 他の機能を使用するには、サービス プリンシパルを使用して セマンティック リンクを手動で認証することをお勧めします。
• Notebookアクティビティは地域をまたいでノートブックを呼び出すことには対応していません。

関連するコンテンツ

• パイプラインの実行を監視する方法