汎用コネクター

汎用コネクターは、任意の外部システムへの接続を表すために使用できます。このコネクターは、ほかのコネクターで利用可能な標準の機能に直接対応しているわけではありません。ただし、コード内で使用するコネクターとしてのみ使用する場合は、バッチ同期、ファイルおよびテーブルエクスポート、ストリーミング同期、ストリーミングエクスポート、メディア同期、Webhook など、標準機能に代わる機能をコードで作成できます。

汎用コネクターに適切なワーカー、資格情報、およびエクスポート制御を設定すると、開発者はそれを使用して、任意の外部システムに接続するコードを作成できます。ソースの所有者がネットワーク、ワーカー、資格情報、およびエクスポート制御をまとめて設定することで、資格情報が指定された外部システムでのみ使用され、接続を確立するさまざまなコード環境でエクスポートマーキングが適用されるようにできます。

対応している機能

セットアップ

汎用コネクターは、Data Connection アプリケーションからではなく、コードリポジトリ環境のサイドバーにある新規接続から作成してください。ただし、設定済みの汎用コネクターは、Data Connection でほかのコネクターとともに表示されます。

コードリポジトリから直接汎用コネクターをセットアップする方法の詳細は、外部トランスフォームのチュートリアルを参照してください。

ネットワーク

汎用コネクターはコード内で使用する必要があるため、Foundry ワーカー接続のみを使用できます。Palantir からのインバウンドトラフィックを受け入れられるシステムには直接接続のエグレスポリシーを使用し、Palantir からのインバウンドトラフィックを受け入れられないプライベートネットワーク内のシステムには Agent プロキシのエグレスポリシーを使用します。

Agent プロキシのエグレスポリシーを使用する場合、Agent は宛先アドレスに到達できる必要があり、宛先システムは Agent からの接続を許可するように設定されている必要があります。Agent のネットワークについて、詳しくはこちら。

設定オプション

概念的には、汎用コネクターは、まとめて使用することを意図したネットワーク設定、資格情報、およびエクスポート可能なマーキングを組み合わせたものと考えることができます。

• ネットワーク設定は、この汎用コネクターを使用するコードから到達可能にするシステムを指定します。
• 資格情報は、接続を成功させるために利用可能でなければならないシークレット値を指定します。
• エクスポート可能なマーキングは、Palantir プラットフォームから指定されたネットワーク宛先へ安全に送信できるデータを指定します。

上記の機能を提供するため、汎用コネクターには次の設定オプションがあります。

コード内で汎用コネクターを使用する

このセクションでは、Foundry のさまざまなコード環境から汎用コネクターを使用する方法について、追加情報を紹介します。

Python 外部トランスフォーム

汎用コネクターはコードリポジトリにインポートできます。この汎用コネクターを使用すると、外部システムに接続し、ソースの資格情報にアクセスするコードを作成できます。

ソースベースの外部トランスフォームについて、詳しくはこちら。

Compute Module

汎用コネクターは Compute Module にインポートできます。この汎用コネクターを使用すると、外部システムとやり取りする Compute Module を作成できます。

TypeScript 関数

汎用コネクターは TypeScript 関数のコードリポジトリにインポートできます。この汎用コネクターを使用すると、fetch を使用して外部システムを直接呼び出すことができます。

Python 関数

汎用コネクターは Python 関数のコードリポジトリにインポートできます。この汎用コネクターを使用すると、Python の requests ライブラリを使用して外部システムを直接呼び出すことができます。

汎用コネクターの変換

ポート443を使用する DNS アドレスのエグレスポリシーがソースに1個だけアタッチされている場合、汎用コネクターを REST API ソースに変換できます。

この変換を行うと、開発者はコード内で使用できる組み込み HTTP クライアントにアクセスでき、外部システムとやり取りするコードをすぐに作成できるようになります。