プロジェクトリファレンスの使用

プロジェクトリファレンスは、通常、データセットまたはパイプラインのオーナーであるより高い権限を持つユーザーが、他のプロジェクトで自分のデータの発見と使用を許可するためのメカニズムを提供します。中間プロジェクトは、パイプラインの一部を所有しているユーザーが、データセットの分類解除、キュレーション、またはそれらのシェア可能なバージョンを配布し、下流の消費者が利用できるようにする、権限の境界または発見のハブとして使用できます。

プロジェクトリファレンスは、データセットがプロジェクトからエクスポートされたり、プロジェクトにインポートされたりするときに明示的に認識することで、プロジェクト間でデータを移動する際のチェック層を追加します。

手順

コードエディタは、変換から生成される出力はコードリポジトリのプロジェクトスコープ内になければならないとユーザーに通知します。たとえば、ユーザーのコードリポジトリが "Data Cleaning Project" というプロジェクトにある場合、ユーザーのコードリポジトリからの出力は "Data Cleaning Project" 内にしか存在できず、他のプロジェクトには存在できません。
プロジェクトスコープ外からの入力データセットがある場合、コードエディタはそのデータセットをプロジェクトリファレンスとして追加する必要があるとフラグを立てます。電球のアイコンをクリックすると、入力データセットをプロジェクトリファレンスとして追加できます。
プロジェクト外のデータセットへのリファレンスは、プロジェクト＆ファイルからも追加できます。
リポジトリの言語パッケージが古い場合、それらが更新されるまでプロジェクトスコープを強制することはできません。コードリポジトリはこれらが更新する必要があるとフラグを立て、表示される更新ボタンをクリックするとこれを解決します。
プロジェクトリファレンスは、プロジェクトスコープ外のデータセットを入力データセットとしてのみ追加できます。出力データセットとしては追加できません。プロジェクトスコープ外のデータセットに出力しようとすると、AccessOutsideProjectDenied エラーがトリガーされます。

プロジェクトリファレンスと権限

リソースを参照するには、リソースに対して compass:import-resource-from（通常は Viewer ロールから展開されます）と、宛先のプロジェクトに対して compass:import-resource-to（通常は Editor ロールから展開されます）の権限を持っている必要があります。これらの権限は、カスタムロールを使用してカスタマイズできます。

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