プロジェクト参照の使用

プロジェクト参照は、より高い権限を持つユーザー（通常はデータセットやパイプラインの所有者）が、他のプロジェクトで自身のデータを検索して使用できるようにする仕組みです。中間プロジェクトは、権限の境界やデータ検索のハブとして使用できます。パイプラインの一部を所有するユーザーは、中間プロジェクトでデータセットのマーキングを解除したり、共有可能なバージョンを整理したり、その他の方法で配布したりすることで、下流の利用者が利用できるようにできます。

プロジェクト参照では、データセットがプロジェクトからエクスポートされる際やプロジェクトにインポートされる際に明示的に確認することで、プロジェクト間のデータ移動に対するチェックを強化します。

手順

1. コードエディターは、トランスフォームから生成される出力を、コードリポジトリが属するプロジェクトの範囲内に置く必要があることをユーザーに通知します。たとえば、コードリポジトリが「Data Cleaning Project」というプロジェクトにある場合、そのコードリポジトリからの出力は「Data Cleaning Project」にのみ配置でき、他のプロジェクトには配置できません。
2. プロジェクトの範囲外にある入力データセットが存在する場合、コードエディターはそのデータセットをプロジェクト参照として追加する必要があることを示します。電球アイコンをクリックすると、入力データセットをプロジェクト参照として追加できます。
3. プロジェクト外のデータセットへの参照は、プロジェクトとファイルからも追加できます。
4. リポジトリの言語パッケージが古い場合、更新するまではプロジェクトの範囲を強制できません。Code Repositories はこれらのパッケージを更新する必要があることを示します。表示される更新ボタンをクリックすると、この問題を解決できます。
5. プロジェクトの範囲外にあるデータセットは、入力データセットとしてのみプロジェクト参照を追加できます。出力データセットとしては追加できません。プロジェクトの範囲外にあるデータセットに出力しようとすると、AccessOutsideProjectDenied エラーが発生します。

プロジェクト参照と権限

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

コードリポジトリ内のコードを変更するには、そのリポジトリで参照されているデータセットに関連するすべてのマーキングへのアクセス権が必要です。