プロジェクト参照

Foundry のプロジェクトは、関連する作業をまとめる概念上の境界と、アクセス権を適用および管理するためのセキュリティ境界の両方を定義します。プロジェクトの境界を越えてデータを使用する場合は、特に注意が必要です。

リソースを参照する

プロジェクト参照は、より高い権限を持つユーザー（通常はデータセットまたはパイプラインの所有者）が、ほかのプロジェクトでデータを検出および使用できるようにする仕組みです。データセットがプロジェクトにインポートされることを明示的に了承することで、プロジェクト間のデータ移動をさらに慎重に確認できるようにします。

リソースを参照するには、プロジェクトのルートレベルにあるプロジェクトナビゲーションパネルに移動します。+追加ボタンをクリックして、データセットまたはテンプレートへの参照を追加します。下の画像では、データセット flights と training_data、および Code Workbook テンプレート scatterplot template が、プロジェクトに参照として追加されています。これにより、プロジェクト内の Code Repositories と Code Workbooks で flights と training_data を入力として使用でき、プロジェクト内の Code Workbooks で scatterplot template テンプレートを使用できます。

• リソースを参照するには、そのリソースに対する compass:import-resource-from（通常は閲覧者ロールに含まれる権限）と、保存先プロジェクトに対する compass:import-resource-to（通常は編集者ロールに含まれる権限）が必要です。
• これらのロールは、カスタムロールを使用してカスタマイズできます。

プロジェクトに範囲が限定されたワークブック

新しい Code Workbooks はすべて、プロジェクトに範囲が限定されています。つまり、プロジェクトの境界に従い、プロジェクトにスコープが限定されたトークンを使用します。

プロジェクトに範囲が限定されたワークブックでは、次の制約が適用されます。

• すべての入力データセットとテンプレートは、プロジェクトの範囲内にある必要があります。ワークブックと同じプロジェクト内にあるか、プロジェクトに参照として追加されている必要があります。
• すべての出力データセットは、ワークブックと同じプロジェクト内にある必要があります。
• ジョブトークンを使用した Foundry サービスへの API 呼び出しは失敗します。

プロジェクトに範囲が限定されたワークブックに、これらの制約に準拠していない入力または出力がある場合、該当するトランスフォームのビルドは失敗し、Job Spec は更新されません。

プロジェクトに範囲が限定されたワークブックでは、制約に準拠していない入力と出力がプロジェクト範囲ダイアログに表示されます。必要な権限がある場合は、このダイアログから、範囲外の入力データセットとテンプレートへの参照を追加できます。または、プロジェクトのルートにあるプロジェクト概要パネルを使用できます。

プロジェクトに範囲が限定されたワークブックでは、制約に準拠していない入力と出力には赤いアイコンも表示されます。

ワークブックでプロジェクト範囲の限定を有効にする

プロジェクト範囲の限定がデフォルトで有効になる前に作成されたワークブックでは、プロジェクト範囲の限定を有効にするよう求めるダイアログが表示されます。プロジェクト範囲ダイアログには、選択したブランチで制約に準拠していない入力と出力が表示されます。master ブランチでプロジェクト範囲の限定を有効にする前に、これらの問題を解決する必要があります。プロジェクト範囲の限定を有効にしない場合、ワークブックは従来どおりユーザートークンで実行されます。引き続きワークブックで通常どおり作業、編集、ビルドの実行ができます。また、Foundry API へのアクセスや、プロジェクトの範囲外にあるインポート済みデータセットの使用なども引き続き可能です。

プロジェクト範囲の限定は、master ブランチでのみ有効にできます。master ブランチでプロジェクト範囲の限定を有効にした後も、ほかのブランチには制約に準拠していない入力や出力が残っている場合があります。これらは、該当するブランチのプロジェクト範囲ダイアログに表示されます。プロジェクト範囲の限定を一度有効にすると、UI から無効にすることはできません。