注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
Code Repositories では、公開ライブラリと Foundry で生成されたライブラリをインポートして使用できます。以下の情報は、Python ライブラリにのみ適用されます。
Python ライブラリを検索するには、コードリポジトリ環境の左パネルにあるパッケージタブをクリックします。検索ボックスを使用して、利用可能なライブラリを検索します。
ライブラリ名をクリックすると、ライブラリの詳細とライブラリを追加オプションが表示されます。このオプションを選択すると、推奨バージョンのライブラリがこのブランチに追加されます。

ライブラリを追加すると、Code Assist の依存関係が更新され、ライブラリで利用可能なパッケージからモジュールをインポートできるようになります。
Python ライブラリを追加する際に、必須のアーティファクトリポジトリをコードリポジトリに追加し、プロジェクトで参照する必要がある場合があります。この場合、この操作の確認を求めるダイアログが表示されます。
依存関係のダイアログでは、必須のリポジトリのうち、アクセス権がないものが強調表示されます。ライブラリを使用するには、これらのリポジトリへのアクセス権が必要です。
Code Repositories は、ライブラリで利用可能な取得元リポジトリを検索し、自動的に使用しようとします。特定の取得元リポジトリが必要な場合は、リポジトリのアーティファクト設定ページで直接設定できます。
特定のバージョンが必要な場合は、設定ボタンをクリックし、リストから必要なバージョンを選択して、そのバージョンを_固定_できます。これにより、トランスフォームとテストの実行に使用するバージョンをそれぞれ異なるものに設定できます。
ライブラリの特定のバージョンを固定すると、そのバージョンは meta.yaml ファイルに追加されますが、Task Runner ではインストールされません。チェックが正常に完了したことを確認してから、Code Assist を再起動し、meta.yaml ファイルへの変更を適用します。その後、リポジトリで選択したバージョンのライブラリを使い始めることができます。
特定のバージョンを固定する際は注意してください。バージョンを固定すると、コードに重要な更新が適用されなくなる可能性があります。必ず依存関係を確認し、更新してください。

リポジトリへの Python ライブラリの追加と削除は、ほかのコード変更と同じように扱われます。変更をコミットし、保護されたブランチにマージする必要があります。プルリクエストでは、ライブラリの変更は meta.yaml ファイルの変更として表示されます。
プルリクエストを作成すると、.lock 形式のファイルでマージ競合が発生することがあります。これは、このブランチで作業している間に更新が行われた場合に発生します。この場合は、両方の変更を受け入れて、プルリクエストを進めます。

この機能は非推奨であり、お使いの環境では利用できない場合があります。
ライブラリが共有チャネルに公開されている場合(Python ライブラリを公開するを参照)、Python サブプロジェクトの build.gradle を編集する必要があります。_隠し_ファイルを変更するため、先に「隠しファイルを表示」を選択してください。Python トランスフォームのプロジェクトには、共有ライブラリが公開されているチャネルへのアクセス権が必要です。Python トランスフォームのサブプロジェクトフォルダー内にある build.gradle ファイル(リポジトリのルートにあるものではありません)の末尾に、以下を追加します。これにより、apply plugin: がすでに実行された状態で、追加した内容が正しく処理されます。
Copied!1 2 3transformsPython { sharedChannels "libs" }
通常、Python ライブラリを使用する際にリポジトリ設定にアクセスする必要はありません。必要なアーティファクトリポジトリは、Python パッケージを追加すると自動的に追加されます。設定タブで、参照されている Python リポジトリのリストを直接編集することは避けてください。
共有ライブラリを使用すると、関連するリポジトリへの参照がプロジェクトに追加されます。参照されているリポジトリのリストは、リポジトリの設定タブにある「アーティファクト」セクションで確認できます。
共有ライブラリの依存関係をアーティファクトのパッケージ検索からではなく手動で追加した場合は、アーティファクト設定から、そのライブラリを使用するリポジトリの取得元リポジトリにライブラリのリポジトリを追加する必要があります。パッケージ検索を使用すればこの操作は自動的に行われるため、依存関係を手動で追加することは推奨されません。
Task Runner は、より新しいリポジトリでのみ利用できます。隠しファイルを表示し、templateConfig.json ファイルを確認すると、リポジトリのバージョンを確認できます。
parentTemplateId が transforms の場合は、parentTemplateVersion が 8.220.0 以降であり、Python 子テンプレートが 1.484.0 以降であることを確認してください。parentTemplateId が python-library の場合は、parentTemplateVersion が 1.497.0 以降であることを確認してください。この機能を有効にするには、リポジトリをアップグレードできます。
Task Runner が有効になっている場合、左パネルのライブラリタブからパッケージを追加しても、新しい Code Assist ワークスペースはプロビジョニングされなくなります。代わりに、現在の環境にリクエストしたパッケージのインストールが開始され、その基となるプロセスのすべてのログが返されます。
インストールに成功すると、新しい環境に合わせてロックファイルが更新されます。インストールに失敗すると、Task Runner の下部パネルにエラーメッセージが表示され、問題をさらに調査するために使用できます。
Task Runner は run 環境のみを更新し、現在、テスト専用の依存関係のインストールには対応していません。
以下の情報は、管理者および上級ユーザーのみを対象としています。
meta.yaml ファイルmeta.yaml ファイルの編集はエラーが発生しやすいため、避けてください。代わりに、ライブラリ検索インターフェースからライブラリを追加する方法を優先してください。
コードリポジトリで Python ライブラリを使用するには、conda_recipe/meta.yaml ファイルにそのライブラリが含まれている必要があります。リポジトリのライブラリ検索インターフェースからライブラリを追加すると、このファイルにも自動的に追加されます。
Copied!1 2 3 4 5 6requirements: ... run: - python ... - {LIBRARY NAME} # 共有ライブラリの名前に置き換えます。
ライブラリを追加したら、meta.yaml ファイルの上部にある「依存関係を更新」をクリックします。これにより、Code Assist が新しい依存関係で更新され、利用可能なパッケージからモジュールをインポートできるようになります。
詳細については、meta.yaml ファイルを参照してください。

Conda は、言語に依存しないオープンソースのパッケージおよび環境マネージャーです。Code Repositories では、パッケージの依存関係を解決し、独立した環境にパッケージをインストールするために使用されます。詳細については、Conda の公式ドキュメント ↗ または環境作成の概要を参照してください。
Code Repositories でチェックが実行されると、meta.yaml ファイルに記載されているパッケージのリストに対して Conda 環境が解決され、拡張子が .lock の非表示の Conda ロックファイルが生成されます。これらのロックファイルには Conda 環境が保存されます。この解決済みの環境により、コードをコミットした際の後続のチェックで Conda の依存関係の解決が高速になります。
次の場合、Conda 環境が再解決され、新しいロックファイルが書き込まれます。
meta.yaml ファイル内のパッケージのリストに変更があった場合。環境が再解決され、新しいロックファイルが書き込まれると、最初のコミットハッシュは SUPERSEDED になり、その後にロックファイルを書き換える別のコミットハッシュが続きます。環境の再解決が必要な場合、チェックの実行に時間がかかることがあります。
Palantir Foundry 内で公開されたライブラリは、Foundry の外部からダウンロードできます。
トークンをほかのアプリケーションやユーザーと共有しないでください。悪意のある第三者が、なりすましに使用するおそれがあります。
<identifier> を確認します。対象の Python ライブラリのコードリポジトリに移動します。ブラウザーの URL は、https://<stack-url>/workspace/data-integration/code/repos/<identifier>/contents/refs%2Fheads%2F<branch> のような形式になっているはずです。URL 内で、ri.stemma.main.repository.XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX のような形式の <identifier> を見つけます。curl -H "Authorization: Bearer $TOKEN" https://$STACK_URL/artifacts/api/repositories/$IDENTIFIER/contents/release/conda/$PLATFORM/repodata.json
ここで、$TOKEN はユーザートークン、$STACK_URL は前のステップの <stack-url>、$IDENTIFIER は前のステップの <identifier>、$PLATFORM はリポジトリのプラットフォーム(例:noarch、linux-64)です。上記のコマンドの出力は、ライブラリの内容(含まれるパッケージ)のインデックスです。各パッケージは <name>-<version>-<build-string>.tar.bz2 という形式です。curl -H "Authorization: Bearer $TOKEN" https://$STACK_URL/artifacts/api/repositories/$IDENTIFIER/contents/release/conda/$PLATFORM/$PACKAGE ここで、$PLATFORM はパッケージのプラットフォーム(例:noarch、linux-64)、$PACKAGE は <name>-<version>-<build-string>.tar.bz2 という形式です。Task Runner でコマンドを手動で指定することで、パッケージのインストールを手動で開始できます。
たとえば、pandas をインストールするには、下部パネルの Task Runner タブを選択し、次のコマンドを入力します。
install --packageSpecs=pandas
Task Runner は、次のコマンドもサポートしています。
uninstall:実行環境からパッケージをアンインストールします。
parentTemplateId が transforms の場合は、Python 子テンプレートが 1.525.0 以上であることを確認してください。同様に、リポジトリの parentTemplateId が python-library の場合は、parentTemplateVersion が 1.525.0 以上であることを確認してください。uninstall --packageSpecs=<eg.numpy>。formatCode:リポジトリ内のファイルをフォーマットします。コードのフォーマットには Black を、フォーマッターのカスタム設定には pyproject.toml を使用します。詳細については、Black フォーマッターの設定ファイルのドキュメント ↗ を参照してください。whoneeds:現在の実行環境で、あるパッケージのインストールを必要とするパッケージのツリーを表示します。
parentTemplateId が transforms の場合は、Python 子テンプレートが 1.522.0 以上であることを確認してください。同様に、リポジトリの parentTemplateId が python-library の場合は、parentTemplateVersion が 1.522.0 以上であることを確認してください。whoneeds --packageSpec=<eg.transforms>tasks:実行可能なすべてのタスクを一覧表示します。